Document.title
< JavaScript | Document
تُعيد أو تضبِط عنوان المُستند.
البنية العامة
var docTitle = document.title;URL
المُتغيّر docTitle سلسلةٌ نصيّةٌ تحتوي على عنوان المُستند. إن كان عنوان المُستند قد ضُبِط بالخاصيّة document.title، فسيُعيد القيمة المضبوطة، أو يُعيد العنوان المضبوط في اللغة الهيكليّة (مثل HTML أو SVG، انظر المُلاحظات أسفله).
document.title = newTitle;
المُتغيّر newTitle هو العنوان الجديد للمُستند. هذا التّعيين يُؤثّر على القيمة المُعادة للخاصيّة document.title، ويؤثّر كذلك على العنوان المعروض للمُستند (كعنوان نافذة المُتصفّح مثلا)، ويُؤثّر كذلك على مُكوّنات DOM في المُستند (أي مُحتوى العنصر <title> في مُستندات HTML مثلا).
مثال
في الجزء الخاصّ بلغة JavaScript، نضع:
<!DOCTYPE html>
<html>
<head>
<title>مرحبا بالعالم</title>
</head>
<body>
<script>
alert(document.title); // تُعيد السلسلة النّصيّة: مرحبا بالعالم
document.title = "وداعًا";
alert(document.title); // تُعيد السلسلة النّصيّة: وداعًا
</script>
</body>
</html>
ملاحظات
هذه الخاصيّة تعمل مع مُستندات HTML وSVG وXUL وغيرها في مُتصفّح Firefox. القيمة البدئيّة في مُستندات HTML لهذه الخاصيّة هي مُحتوى العنصر <title>.
مصادر ومواصفات
- مواصفة DOM Level 2 HTML
- مواصفة HTML5