Document.open()‎

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث

يفتح التّابع Document.open‎()‎ المستند للكتابة عليه بالتّابع Document.write‎()‎.

البنية العامة

document.open();

مثال

// تُعاد كتابة محتويات المستند لأنّ المستند يُهيّئ من جديد من طرف التّابع
// open(). 
document.write("<html><p>احذفني</p></html>"); 
document.open(); 
// المستند فارغ

ملاحظات

إن كان المستند موجودًا في الهدف، فسيحذف هذا التّابع محتوياته (انظر المثال أعلاه).

ويُستدعى التّابع Document.open‎()‎ تلقائيًّا عند استدعاء التّابع Document.write‎()‎ بعد أن تُحمَّل الصّفحة، لكنّ هذا الأمر غير مُعرّفٍ في مواصفة W3C.

لا تخلط بين هذا التّابع والتّابع window.open‎()‎، فالتّابع Document.open‎()‎ يسمح لك بالكتابة فوق المستند الحالي أو الإضافة إلى آخره، أمّا التّابع window.open‎()‎ فيوفّر طريقةً لفتح نافذة جديدة، تاركًا المستند الحاليّ سليمًا. ولأنّ الكائن window‎ هو الكائن العمومي، فاستدعاء التّابع open‎()‎ يقوم بنفس تأثير استدعاء التّابع window.open‎()‎. ويمكنك إغلاق المستند المفتوح باستعمال التّابع document.close‎()‎.

إن لم ترغب في إنشاء مُدخلٍ في تاريخ الصّفحة (history entry)، فأبدِل open‎()‎ بالاستدعاء open‎("text/html", "replace")‎.

دعم المتصفّحات

الميزة Chrome Firefox Internet Explorer Opera Safari
الدعم الأساسي نعم نعم نعم نعم نعم

مصادر ومواصفات