الفرق بين المراجعتين لصفحة: «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>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 هذه الصّفحة] للمزيد عن هذه المبادئ. | انظر [https://developer.mozilla.org/en-US/docs/Mozilla/Gecko/Script_security#Security_checks هذه الصّفحة] للمزيد عن هذه المبادئ. | ||
مراجعة 07:45، 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 |
|---|---|---|---|---|---|
| الدعم الأساسي | نعم | نعم | نعم | نعم | نعم |