DOM:document.title
z Mozilla Developer Center, polskiego centrum programistów Mozilli.
Spis treści |
[edytuj] Podsumowanie
Pobiera lub ustawia tytuł dokumentu.
[edytuj] Składnia
tytul = document.title;
-
tytuljest łańcuchem znaków zawierającym tytuł dokumentu. Jeśli tytuł został nadpisany poprzez ustawieniedocument.title, zwraca tę wartość. W przeciwnym wypadku zwraca tytuł określony w znaczniku (zobacz poniższe Uwagi).
document.title = nowyTytul;
-
nowyTytuljest nowym tytułem dokumentu. Przypisanie to ma wpływ na wartość zwracaną przezdocument.titleoraz wyświetlany tytuł dokumentu (np. w pasku tytułowym okna), ale nie wpływa na DOM dokumentu (np. zawartość elementu<title>w dokumencie HTML).
[edytuj] Przykład
<html> <head> <title>Hello World!</title> </head> <body> <script> alert(document.title); // wyswietla "Hello World!" document.title = "Goodbye World!"; alert(document.title); // wyswietla "Goodbye World!" </script> </body> </html>
[edytuj] Uwagi
Własność ta ma zastosowanie w HTML, SVG, XUL i innych dokumentach w Gecko.
Dla dokumentów HTML początkową wartością document.title jest zawartość tekstowa elementu <title>. Dla XUL-a jest to wartość atrybutu title elementu window lub innego elementu XUL najwyższego poziomu.
W XUL-u próba dostępu do document.title zanim jeszcze dokument zostanie w pełni załadowany może skutkować niepożądanym zachowaniem (document.title może zwrócić pusty łańcuch znaków, a ustawienie document.title może nie mieć żadnego efektu).