Podsumowanie
Pobiera lub ustawia tytuł dokumentu.
Składnia
tytul =document.title;
tytul
jest ł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;
nowyTytul
jest nowym tytułem dokumentu. Przypisanie to ma wpływ na wartość zwracaną przezdocument.title
oraz wyświetlany tytuł dokumentu (np. w pasku tytułowym okna), ale nie wpływa na DOM dokumentu (np. zawartość elementu<title>
w dokumencie HTML).
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>
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).