الفرق بين المراجعتين لصفحة: «JavaScript/Document/open»

من موسوعة حسوب
إضافة الصّفحة
 
لا ملخص تعديل
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:<code>Document.open()‎</code>}}</noinclude>
<noinclude>{{DISPLAYTITLE:<code>Document.open()‎</code>}}</noinclude>
يفتح التّابع <code>Document.open‎()‎</code> المستند للكتابة عليه بالتّابع <code>Document.write‎()‎</code>.
يفتح التّابع <code>Document.open‎()‎</code> المستند للكتابة عليه بالتّابع <code>[[JavaScript/Document/write|Document.write‎()‎]]</code>.


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


لا تخلط بين هذا التّابع والتّابع <code>window.open‎()‎</code>، فالتّابع <code>Document.open‎()‎</code> يسمح لك بالكتابة فوق المستند الحالي أو الإضافة إلى آخره، أمّا التّابع <code>window.open‎()‎</code> فيوفّر طريقةً لفتح نافذة جديدة، تاركًا المستند الحاليّ سليمًا. ولأنّ الكائن <code>window‎</code> هو الكائن العمومي، فاستدعاء التّابع <code>open‎()‎</code> يقوم بنفس تأثير استدعاء التّابع <code>window.open‎()‎</code>. ويمكنك إغلاق المستند المفتوح باستعمال التّابع <code>document.close‎()‎</code>.
لا تخلط بين هذا التّابع والتّابع <code>[[JavaScript/Window/open|window.open‎()‎]]</code>، فالتّابع <code>Document.open‎()‎</code> يسمح لك بالكتابة فوق المستند الحالي أو الإضافة إلى آخره، أمّا التّابع <code>window.open‎()‎</code> فيوفّر طريقةً لفتح نافذة جديدة، تاركًا المستند الحاليّ سليمًا. ولأنّ الكائن <code>[[JavaScript/Window|window‎]]</code> هو الكائن العمومي، فاستدعاء التّابع <code>open‎()‎</code> يقوم بنفس تأثير استدعاء التّابع <code>window.open‎()‎</code>. ويمكنك إغلاق المستند المفتوح باستعمال التّابع <code>[[JavaScript/Document/close|document.close‎()‎]]</code>.
 
انظر [https://developer.mozilla.org/en-US/docs/Mozilla/Gecko/Script_security#Security_checks هذه الصّفحة] للمزيد عن هذه المبادئ.


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


==مصادر ومواصفات==
==مصادر ومواصفات==
* مواصفة [https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-72161170 Document Object Model (DOM) Level 2 HTML Specification]
* مواصفة [https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-72161170 Document Object Model (DOM) Level 2 HTML Specification].


  [[تصنيف:JavaScript]]
  [[تصنيف:JavaScript]]

المراجعة الحالية بتاريخ 11:15، 31 مارس 2018

يفتح التّابع 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
الدعم الأساسي نعم نعم نعم نعم نعم

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