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

المراجعة الحالية بتاريخ 14:30، 7 أكتوبر 2022

تُمثّل الواجهة Document أي صفحة ويب مُحمّلة في المُتصفح وتعمل كنُقطة بداية للوصول إلى مُحتوى الصّفحة، أي شجرة DOM التي تشمل عناصر مثل <body> و <table>، إضافة إلى العديد من العناصر الأخرى. وتُوفِّر إمكانيّة التّعامل بشكل عمومي للمُستند، مثل كيفيّة الحصول على عنوان URL الخاصّ بالصّفحة وكيفيّة إنشاء عناصر جديدة في المُستند.

تصِفُ الواجهة Document الخصائص (properties) والتّوابع (methods) الشّائعة لأي نوع كان من المُستندات. واعتمادًا على نوع المُستند (مثل HTML، و XML، و SVG وغيرها)، يُمكن أن تتوفّر واجهة برمجيّة (API) أكبر وأكثر تخصّصا: مُستندات HTML المُقدّمَة مع نوع المُحتوى text/html، تعتمد كذلك على الواجهة HTMLDocument، أمّا مُستندات XML و SVG فتعتمد الواجهة XMLDocument.

الدّالة البانيّة

`Document()‎`

تُنشئ كائنًا جديدًا من النّوع Document.

الخصائص

هذه الواجهة ترِثُ كذلك من الواجهة Node والواجهة EventTarget.

`Document.all`

توفّر إمكانيّة الوصول إلى جميع العناصر في المُستند. وهي خاصيّة مهمَلة غير قياسيّة لا يجب استعمالها.

`Document.async`

تُستعمل مع الخاصيّة Document.load للإشارة إلى أنّ الطلب غير مُتزامن وهي خاصيّة مهمَلة.

`Document.body`

تُعيد عقدة العنصر <body> أو <frameset> الخاصّة بالمستند الحاليّ.

`Document.characterSet`

خاصيّة قابلة للقراءة فقط تُعيد مجموعة المحارف المُستعمَلة من طرف المُستند.

`Document.charset`

اسم مُستعار للخاصيّة Document.characterSet، استعملها عوضا عن هذه الخاصيّة. لاحظ أنَّ هذه الخاصية للقراءة فقط وقد أهملت ولا يجدر بك استخدامها.

`Document.compatMode`

خاصيّة قابلة للقراءة فقط تدل على ما إذا كان المُستند قد قُدِّم في وضع quirks أو نمط strict. وهي تجريبيّة لا يجب استعمالها في شيفرة إنتاجيّة.

`Document.contentType`

خاصيّة تجريبيّة، قابلة للقراءة فقط، تُعيد قيمة Content-Type من ترويسة MIME الخاصّة بالمُستند الحالي.

`Document.doctype`

تُعيد تعريف نوع المُستند (DTD) الخاصّ بالمُستند الحالي. وهي للقراءة فقط.

`Document.documentElement`

تُعيد العنصر Element الذي يُمثّل الولد المُباشِر للمُستند. ولمُستندات HTML، فهذا عادة ما يكون العنصر HTMLElement. وهي للقراءة فقط.

`Document.documentURI`

تُعيد مكان المُستند على شكل سلسلة نصيّة (string). وهي للقراءة فقط.

`Document.domConfig`

تُعيد كائنا من النّوع DOMConfiguration، لا تستخدمها لأنّها مُهملة.

`Document.fullscreen`

خاصيّة محذوفة كانت تُعيد القيمة true في وضع ملء الشّاشة.

`Document.fullscreenEnabled`

تُعيد قيمة منطقيّة تُشير إلى ما إذا كان وضع ملء الشاشة مُتاحا أو لا.

`Document.hidden`

خاصيّة قابلة للقراءة فقط تُعيد قيمة منطقيّة تُشير إلى ما إذا كانت الصّفحة مخفيّة أو لا.

`Document.implementation`

تُعيد تطبيق DOM المُرتبط بالمُستند الحالي، وهي للقراءة فقط.

`Document.inputEncoding`

اسم مُستعار للخاصيّة Document.characterSet. استعملها عوضًا عن هذه الخاصيّة.

`Document.lastStyleSheetSet`

تُعيد اسم آخر صفحة أنماط تمّ تفعيلها. وتحمِل القيمة null إلى أن تُغيّر صفحة النّمط المُختارة عبر ضبط قيمة للخاصيّة selectedStyleSheetSet.

`Document.mozSyntheticDocument`

تُعيد قيمة منطقيّة Boolean، تُساوي القيمة true فقط في حالة كان المُستند تركيبيّا (synthetic)، مثل صورة، فيديو، ملفّ نصي أو ما شابه ذلك. هذه خاصيّة غير قياسيّة، قد لا تعمل على جميع المُتصفحات.

`Document.mozFullScreenElement`

تُعيد العنصر المتواجد في وضع ملء الشّاشة للمُستند الحالي. وهي للقراءة فقط؛ كما أنّها غير قياسيّة وقد لا تعمل دومًا.

`Document.mozFullScreenEnabled`

تُعيد القيمة true في حالة نجاح استدعاء Element.mozRequestFullscreen()‎ في المُستند الحالي. وهي للقراءة فقط؛ كما أنّها غير قياسيّة وقد لا تعمل دوما.

`Document.preferredStyleSheetSet`

تُعيد مجموعة صفحات الأنماط المُفضّلة حسب ما ضبطه كاتب الصّفحة. وهي للقراءة فقط.

`Document.scrollingElement`

تُعيد مرجِعا للعنصر الذي يلفّ المُستند. وهي للقراءة فقط.

`Document.selectedStyleSheetSet`

تُعيد أيّ مجموعة من مجموعات صفحات الأنماط الجاري استعمالها حاليّا.

`Document.styleSheetSets`

تُعيد قائمة بمجموعات صفحات الأنماط المُتاحة على المُستند. وهي للقراءة فقط.

`Document.timeline`

تُعيد تمثيلا للخط الزمني الافتراضي في المُستند الحالي. وهي للقراءة فقط.

`Document.undoManager`

خاصيّة تجريبيّة، قابلة للقراءة فقط…

`Document.visibilityState`

تُعيد سلسلة نصيّة تدل على حالة وضوح المُستند. القيم المُمكنة هي visible و hidden و prerender و unloaded. وهي للقراءة فقط.

`Document.xmlEncoding`

تُعيد التّرميز حسب ما تمّ ضبطه من طرف تعريف XML، وهي خاصيّة مهمَلة.

`Document.xmlStandalone`

خاصيّة محذوفة كانت تُعيد القيمة المنطقيّة true إن كان تعريف XML يُحدّد بأنّ المُستند قائم بذاته (أي لو كان جزء خارجي من تعريف نوع المُستند DTD يُؤثّر على مُحتوى المُستند)، أمّا غير ذلك فيُعيد false.

`Document.xmlVersion`

خاصيّة محذوفة كانت تُعيد رقم الإصدار حسب ما تمّ تحديده في تعريف XML أو تُعيد "1.0" إن لم يتواجد التّعريف.

الواجهة Document موسّعةٌ بالواجهة ParentNode:

`ParentNode.children`

تُعيد نسخة حيّة من HTMLCollection تحتوي على جميع الكائنات من النّوع Element التي تُمثّل أولاد عقدة العنصر الأب ParentNode هذه. وهي خاصيّة قابلة للقراءة فقط.

`ParentNode.firstElementChild`

تُعيد العنصر الذي يُمثل أول ولد من أولاد عقدة العنصر ParentNode هذه، أو تُعيد القيمة null في حالة لم يتواجد أي عنصر. وهي خاصيّة قابلة للقراءة فقط.

`ParentNode.lastElementChild`

تُعيد العنصر الذي يُمثل آخر ولد من أولاد عقدة العنصر ParentNode هذه، أو تُعيد القيمة null في حالة لم يتواجد أي عنصر. وهي خاصيّة قابلة للقراءة فقط.

`ParentNode.childElementCount`

يُعيد قيمة من النّوع unsigned long تُمثّل عدد أولاد الكائن. وهي خاصيّة قابلة للقراءة فقط.

امتداد لمُستند HTML

ترِث الواجهة Document من الواجهة HTMLDocument لمُستندات HTML، وقد أصبحت امتدادًا لهذه المُستندات منذ الإصدار الخامس من HTML (أي HTML5).

`Document.alinkColor`

خاصيّة مهمَلة تُستعمل للحصول على أو ضبط لون الروابط المُفعّلة في جسم المُستند.

`Document.anchors`

تُعيد قائمة بجميع الروابط (anchors) المتواجدة في المُستند.

`Document.applets`

خاصيّة مهمَلة تُعيد قائمة مُرتّبة للتّطبيقات الصّغيرة (applets) في المُستند.

`Document.bgColor`

تُستعمل للحصول على أو ضبط لون خلفيّة المُستند الحالي، وهي خاصيّة مهمَلة.

`Document.cookie`

تُعيد قائمة بملفّات تعريف الارتباط (cookies) مفصولة بفاصلة منقوطة (;) للمُستند أو تُستعمل لضَبط ملفّ تعريف ارتباط.

`Document.defaultView`

تُعيد مرجعا لكائن النّافذة. وهي للقراءة فقط.

`Document.designMode`

تُستعمل للحصول على أو ضبط إمكانيّة تعديل كامل المُستند.

`Document.dir`

تُستعمل للحصول على أو ضبط إتجاهيّة المُستند (rtl/ltr). وهي للقراءة فقط.

`Document.domain`

تُستعمل للحصول على أو ضبط نطاق المُستند الحالي.

`Document.embeds`

تُعيد قائمة بعناصر <embed> المُضمّنة ضمن المُستند الحالي. وهي للقراءة فقط.

`Document.fgColor`

تُستعمل للحصول على أو ضبط لون الواجهة أو لون النّص للمُستند الحالي.

`Document.forms`

تُعيد قائمة بعناصر <form> المتواجدة في المُستند الحالي. وهي للقراءة فقط.

`Document.head`

تُعيد عنصر <head> الخاصّ بالمستند الحالي. وهي للقراءة فقط.

`Document.height`

خاصيّة محذوفة، تُستعمل للحصول على أو ضبط ارتفاع المُستند الحالي.

`Document.images`

تُعيد قائمة بالصور المتواجدة في المُستند الحالي. وهي للقراءة فقط.

`Document.lastModified`

تُعيد تاريخ آخر تعديل للمُستند. وهي للقراءة فقط.

`Document.linkColor`

تُستعمل للحصول على أو ضبط لون الرّوابط في المُستند، وهي خاصيّة مُهملة لا يجب استعمالها.

`Document.links`

خاصيّة قابلة للقراءة فقط تُعيد قائمة بجميع الروابط في المُستند.

`Document.location`

خاصيّة قابلة للقراءة فقط تُعيد رابط URI الخاصّ بالمُستند الحالي.

`Document.plugins`

خاصيّة قابلة للقراءة فقط تُعيد قائمة بجميع الإضافات المُتوفّرة.

`Document.readyState`

خاصيّة قابلة للقراءة فقط تُعيد حالة التحميل للمُستند.

`Document.referrer`

خاصيّة قابلة للقراءة فقط تُعيد رابط URI الصّفحة التي أحيلت منها الصّفحة الحاليّة.

`Document.scripts`

خاصيّة قابلة للقراءة فقط تُعيد جميع عناصر <script> في المُستند.

`Document.title`

تُعيد أو تضبِط عنوان المُستند الحالي.

`Document.URL`

خاصيّة قابلة للقراءة فقط تُعيد مكان المُستند على شكل سلسلة نصيّة.

`Document.vlinkColor`

تُعيد أو تضبِط لون الرّوابط التي تمت زيارتها. وهي خاصيّة مُهملة.

`Document.width`

خاصيّة محذوفة تُعيد عرض المُستند الحالي.

خصائص مضمنة من الواجهة `DocumentOrShadowRoot`

تشمل واجهة Document الخصائص التّاليّة المُعرَّفة على مجموعة DocumentOrShadowRoot. لاحظ بأنّ هذا مُطبَّق على مُتصفّح Chrome فقط في الوقت الحالي؛ وبقيّة المُتصفحات لا تزال تُطبّقها مُباشرة على واجهة Document.

`Document.activeElement`

تُعيد هذه الخاصيّة القابلة للقراءة فقط عنصر Element المتواجد في شجرة الظّل (shadow tree) المفعّلة حاليًا (أي المركَّز عليها، focus).

`Document.fullscreenElement`

تُعيد هذه الخاصيّة القابلة للقراءة فقط العنصر الذي في وضع ملء الشّاشة في هذا المُستند.

`Document.pointerLockElement`

تُعيد هذه الخاصيّة القابلة للقراءة فقط مجموعة العناصر التي تقع ضمن هدف أحداث الفأرة أثناء قفل مؤشّر الفأرة. تُعيد القيمة null في حالة كان القفل مُعلّقا، أو في حالة كان المُؤشّر غير مُقفل، أو إذا ما كان الهدف يقع في مُستند آخر. هذه الخاصيّة تجريبيّة.

`Document.styleSheets`

تُعيد هذه الخاصيّة القابلة للقراءة فقط كائنًا من النّوع StyleSheetList أو كائنا من النّوع CSSStyleSheet لصفحات الأنماط المربوطة أو المُضمّنة في المُستند صراحةً.

معالجات الأحداث

`Document.onafterscriptexecute`

تُمثّل شيفرة معالجة الحدث afterscriptexecute. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.

`Document.onbeforescriptexecute`

تُمثّل شيفرة معالجة الحدث beforescriptexecute. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.

`Document.oncopy`

تُمثّل شيفرة معالجة الحدث copy . وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.

`Document.oncut`

تُمثّل شيفرة معالجة الحدث cut . وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.

`Document.onfullscreenchange`

تُمثّل شيفرة مُعالجة الحدث fullscreenchange.

`Document.onfullscreenerror`

تُمثّل شيفرة مُعالجة الحدث fullscreenerror.

`Document.onpaste`

تُمثّل شيفرة مُعالجة الحدث paste. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.

`Document.onpointerlockchange`

تُمثّل شيفرة مُعالجة الحدث pointerlockchange. وهي خاصيّة تجريبيّة، لا تستعملها في شيفرة إنتاجيّة.

`Document.onpointerlockerror`

تُمثّل شيفرة مُعالجة الحدث pointerlockerror. وهي خاصيّة تجريبيّة، لا تستعملها في شيفرة إنتاجيّة.

`Document.onreadystatechange`

تُمثّل شيفرة مُعالجة الحدث readystatechange.

`Document.onselectionchange`

تُمثّل شيفرة مُعالجة الحدث selectionchange. وهي خاصيّة تجريبيّة، لا تستعملها في شيفرة إنتاجيّة.

`Document.onvisibilitychange`

تُمثّل شيفرة مُعالجة الحدث visibilitychange.

`Document.onwheel`

تُمثّل شيفرة مُعالجة الحدث wheel. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.

الواجهة Document موسّعةٌ بالواجهة GlobalEventHandlers:

`GlobalEventHandlers.onabort`

تُمثّل شيفرة مُعالجة الحدث abort.

`GlobalEventHandlers.onanimationcancel`

تُمثّل شيفرة مُعالجة الحدث animationcancel الذي يُشير إلى أنّ تحريك CSS قد تمّ إلغاؤه. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.

`GlobalEventHandlers.onanimationend`

تُمثّل شيفرة مُعالجة الحدث animationend الذي يُشير إلى أنّ تحريك CSS قد توقّف عن الحركة. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.

`GlobalEventHandlers.onanimationiteration`

تُمثّل شيفرة مُعالجة الحدث animationiteration الذي يُشير إلى أنّ تحريك CSS قد بدأ في تشغيل دورة جديدة من دورات التّحريك. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.

`GlobalEventHandlers.onanimationstart`

تُمثّل شيفرة مُعالجة الحدث animationstart الذي يُشير إلى أنّ تحريك CSS قد بدأ في التّشغيل. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.

`GlobalEventHandlers.onauxclick`

تُمثّل شيفرة مُعالجة الحدث auxclick الذي يُشير إلى أنّ زرا غير رئيسي قد ضُغِط عليه في جهاز إدخال (الزر الأوسط في فأرة الحاسوب مثلا). وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.

`GlobalEventHandlers.onblur`

تُمثّل شيفرة مُعالجة الحدث blur.

`GlobalEventHandlers.onerror`

تُمثّل شيفرة مُعالجة الحدث error وهو مُعالج أحداث من النّوع OnErrorEventHandler.

`GlobalEventHandlers.onfocus`

تُمثّل شيفرة مُعالجة الحدث focus.

`GlobalEventHandlers.oncancel`

تُمثّل شيفرة مُعالجة الحدث cancel.

`GlobalEventHandlers.oncanplay`

تُمثّل شيفرة مُعالجة الحدث canplay.

`GlobalEventHandlers.oncanplaythrough`

تُمثّل شيفرة مُعالجة الحدث canplaythrough.

`GlobalEventHandlers.onchange`

تُمثّل شيفرة مُعالجة الحدث change.

`GlobalEventHandlers.onclick`

تُمثّل شيفرة مُعالجة الحدث click.

`GlobalEventHandlers.onclose`

تُمثّل شيفرة مُعالجة الحدث close.

`GlobalEventHandlers.oncontextmenu`

تُمثّل شيفرة مُعالجة الحدث contextmenu.

`GlobalEventHandlers.oncuechange`

تُمثّل شيفرة مُعالجة الحدث cuechange.

`GlobalEventHandlers.ondblclick`

تُمثّل شيفرة مُعالجة الحدث dblclick.

`GlobalEventHandlers.ondrag`

تُمثّل شيفرة مُعالجة الحدث drag.

`GlobalEventHandlers.ondragend`

تُمثّل شيفرة مُعالجة الحدث dragend.

`GlobalEventHandlers.ondragenter`

تُمثّل شيفرة مُعالجة الحدث dragenter.

`GlobalEventHandlers.ondragexit`

تُمثّل شيفرة مُعالجة الحدث dragexit.

`GlobalEventHandlers.ondragleave`

تُمثّل شيفرة مُعالجة الحدث dragleave.

`GlobalEventHandlers.ondragover`

تُمثّل شيفرة مُعالجة الحدث dragover.

`GlobalEventHandlers.ondragstart`

تُمثّل شيفرة مُعالجة الحدث dragstart.

`GlobalEventHandlers.ondrop`

تُمثّل شيفرة مُعالجة الحدث drop.

`GlobalEventHandlers.ondurationchange`

تُمثّل شيفرة مُعالجة الحدث durationchange.

`GlobalEventHandlers.onemptied`

تُمثّل شيفرة مُعالجة الحدث emptied.

`GlobalEventHandlers.onended`

تُمثّل شيفرة مُعالجة الحدث ended.

`GlobalEventHandlers.ongotpointercapture`

تُمثّل شيفرة مُعالجة الحدث gotpointercapture.

`GlobalEventHandlers.oninput`

تُمثّل شيفرة مُعالجة الحدث input.

`GlobalEventHandlers.oninvalid`

تُمثّل شيفرة مُعالجة الحدث invalid.

`GlobalEventHandlers.onkeydown`

تُمثّل شيفرة مُعالجة الحدث keydown.

`GlobalEventHandlers.onkeypress`

تُمثّل شيفرة مُعالجة الحدث keypress.

`GlobalEventHandlers.onkeyup`

تُمثّل شيفرة مُعالجة الحدث keyup.

`GlobalEventHandlers.onload`

تُمثّل شيفرة مُعالجة الحدث load.

`GlobalEventHandlers.onloadeddata`

تُمثّل شيفرة مُعالجة الحدث loadeddata.

`GlobalEventHandlers.onloadedmetadata`

تُمثّل شيفرة مُعالجة الحدث loadedmetadata.

`GlobalEventHandlers.onloadend`

تُمثّل شيفرة مُعالجة الحدث loadend (عند توقّف تقدّم تحميل مورد مُعيّن).

`GlobalEventHandlers.onloadstart`

تُمثّل شيفرة مُعالجة الحدث loadstart (عند بدء تحميل مورد مُعيّن).

`GlobalEventHandlers.onlostpointercapture`

تُمثّل شيفرة مُعالجة الحدث lostpointercapture.

`GlobalEventHandlers.onmousedown`

تُمثّل شيفرة مُعالجة الحدث mousedown.

`GlobalEventHandlers.onmouseenter`

تُمثّل شيفرة مُعالجة الحدث mouseenter.

`GlobalEventHandlers.onmouseleave`

تُمثّل شيفرة مُعالجة الحدث mouseleave.

`GlobalEventHandlers.onmousemove`

تُمثّل شيفرة مُعالجة الحدث mousemove.

`GlobalEventHandlers.onmouseout`

تُمثّل شيفرة مُعالجة الحدث mouseout.

`GlobalEventHandlers.onmouseover`

تُمثّل شيفرة مُعالجة الحدث mouseover.

`GlobalEventHandlers.onmouseup`

تُمثّل شيفرة مُعالجة الحدث mouseup.

`GlobalEventHandlers.onmousewheel`

تُمثّل شيفرة مُعالجة الحدث mousewheel.

`GlobalEventHandlers.onwheel`

تُمثّل شيفرة مُعالجة الحدث wheel.

`GlobalEventHandlers.onpause`

تُمثّل شيفرة مُعالجة الحدث pause.

`GlobalEventHandlers.onplay`

تُمثّل شيفرة مُعالجة الحدث play.

`GlobalEventHandlers.onplaying`

تُمثّل شيفرة مُعالجة الحدث playing.

`GlobalEventHandlers.onpointerdown`

تُمثّل شيفرة مُعالجة الحدث pointerdown.

`GlobalEventHandlers.onpointermove`

تُمثّل شيفرة مُعالجة الحدث pointermove.

`GlobalEventHandlers.onpointerup`

تُمثّل شيفرة مُعالجة الحدث pointerup.

`GlobalEventHandlers.onpointercancel`

تُمثّل شيفرة مُعالجة الحدث pointercancel.

`GlobalEventHandlers.onpointerover`

تُمثّل شيفرة مُعالجة الحدث pointerover.

`GlobalEventHandlers.onpointerout`

تُمثّل شيفرة مُعالجة الحدث pointerout.

`GlobalEventHandlers.onpointerenter`

تُمثّل شيفرة مُعالجة الحدث pointerevent.

`GlobalEventHandlers.onpointerleave`

تُمثّل شيفرة مُعالجة الحدث pointerleave.

`GlobalEventHandlers.onpointerlockchange`

تُمثّل شيفرة مُعالجة الحدث pointerlockchange. وهي خاصيّة تجريبيّة، لا تستعملها في شيفرة إنتاجيّة.

`GlobalEventHandlers.onpointerlockerror`

تُمثّل شيفرة مُعالجة الحدث pointerlockerror. وهي خاصيّة تجريبيّة، لا تستعملها في شيفرة إنتاجيّة.

`GlobalEventHandlers.onprogress`

تُمثّل شيفرة مُعالجة الحدث progress.

`GlobalEventHandlers.onratechange`

تُمثّل شيفرة مُعالجة الحدث ratechange.

`GlobalEventHandlers.onreset`

تُمثّل شيفرة مُعالجة الحدث reset.

`GlobalEventHandlers.onscroll`

تُمثّل شيفرة مُعالجة الحدث scroll.

`GlobalEventHandlers.onseeked`

تُمثّل شيفرة مُعالجة الحدث seeked.

`GlobalEventHandlers.onseeking`

تُمثّل شيفرة مُعالجة الحدث seeking.

`GlobalEventHandlers.onselect`

تُمثّل شيفرة مُعالجة الحدث select.

`GlobalEventHandlers.onselectstart`

تُمثّل شيفرة مُعالجة الحدث selectionchange، الذي يحدث عندما يبدأ المُستخدم بتظليل جزء جديد من النّص في صفحة الويب مثلًا.

`GlobalEventHandlers.onselectionchange`

تُمثّل شيفرة مُعالجة الحدث selectionchange، الذي يحدث عندما يتغيّر النّص المُظلَّل في صفحة ويب.

`GlobalEventHandlers.onshow`

تُمثّل شيفرة مُعالجة الحدث show.

`GlobalEventHandlers.onsort`

تُمثّل شيفرة مُعالجة الحدث sort. وهي خاصيّة تجريبيّة، لا تستعملها في شيفرة إنتاجيّة.

`GlobalEventHandlers.onstalled`

تُمثّل شيفرة مُعالجة الحدث stalled.

`GlobalEventHandlers.onsubmit`

تُمثّل شيفرة مُعالجة الحدث submit.

`GlobalEventHandlers.onsuspend`

تُمثّل شيفرة مُعالجة الحدث suspend.

`GlobalEventHandlers.ontimeupdate`

تُمثّل شيفرة مُعالجة الحدث timeupdate.

`GlobalEventHandlers.onvolumechange`

تُمثّل شيفرة مُعالجة الحدث volumechange.

`GlobalEventHandlers.ontouchcancel`

تُمثّل شيفرة مُعالجة الحدث touchcancel.

`GlobalEventHandlers.ontouchend`

تُمثّل شيفرة مُعالجة الحدث touchend.

`GlobalEventHandlers.ontouchmove`

تُمثّل شيفرة مُعالجة الحدث touchmove.

`GlobalEventHandlers.ontouchstart`

تُمثّل شيفرة مُعالجة الحدث touchstart.

`GlobalEventHandlers.ontransitioncancel`

تُمثّل شيفرة مُعالجة الحدث transitioncancel الذي يُشير إلى أنّ انتقال CSS قد أُلغي.

`GlobalEventHandlers.ontransitionend`

تُمثّل شيفرة مُعالجة الحدث transitionend الذي يُشير إلى أنّ انتقال CSS قد انتهى.

`GlobalEventHandlers.onwaiting`

تُمثّل شيفرة مُعالجة الحدث waiting.

التّوابع

هذه الواجهة ترِثُ كذلك من الواجهة Node والواجهة EventTarget.

`Document.adoptNode()‎`

يتبنّى عقدة عنصر من مُستند خارجي.

`Document.captureEvents()‎`

انظر Window.captureEvents. وهو تابع مُهمل.

`Document.caretRangeFromPoint()‎`

يحصل على كائن من النّوع Range لقطعة المُستند حسب الإحداثيات المُحدّدة. وهو تابع غير قياسي.

`Document.createAttribute()‎`

يُنشئ نُسخة جديدة من الكائن Attr ويُعيدها.

`Document.createAttributeNS()‎`

يُنشئ عقدة سِمة (attribute node) جديدة في مساحة اسم (namespace) مُعطاة ويُعيدها.

`Document.createCDATASection()‎`

يُنشئ عُقدة CDATA جديدة ويُعيدها.

`Document.createComment()‎`

يُنشئ عقدة تعليق جديدة ويُعيدها.

`Document.createDocumentFragment()‎`

يُنشئ قطعة مُستند جديدة.

`Document.createElement()‎`

يُنشئ عنصرًا جديدًا باسم وسم HTML المُعطى.

`Document.createElementNS()‎`

يُنشئ عنصرا جديدا باسم الوسم المُعطى وعنوان URI الخاصّ بمجال الأسماء (namespace URI).

`Document.createEntityReference()‎`

يُنشئ كائن مرجع كِيان (entity reference) جديد ويُعيده. وهو تابع محذوف.

`Document.createEvent()‎`

يُنشئ كائن حدث (event object).

`Document.createNodeIterator()‎`

يُنشئ كائنًا من النّوع NodeIterator.

`Document.createProcessingInstruction()‎`

يُنشئ كائنًا جديدًا من النّوع ProcessingInstruction.

`Document.createRange()‎`

يُنشئ كائنًا من النّوع Range

`Document.createTextNode()‎`

يُنشئ عقدة نصيّة (text node).

`Document.createTouch()‎`

يُنشئ كائنًا من النّوع Touch. وهو تابع مُهمل.

`Document.createTouchList()‎`

يُنشئ كائنًا من النّوع TouchList.

`Document.createTreeWalker()‎`

يُنشئ كائنًا من النّوع TreeWalker.

`Document.enableStyleSheetsForSet()‎`

يُفعِّل صفحات الأنماط لمجموعة صفحات الأنماط المُحدّدة.

`Document.exitPointerLock()‎`

يحرِّرك قفل المُؤشّر. وهو تابع تجريبيّ.

`Document.getAnimations()‎`

يُعيد مصفوفة كائنات من النوع Animation التي تعمل حاليًا، والتي عناصرها الهدَفُ هي من أولاد (عناصر سليلة) المُستند. وهو تابع تجريبيّ.

`Document.getElementsByClassName()‎`

يُعيد قائمة عناصر ذات اسم الصّنف المُعطى.

`Document.getElementsByTagName()‎`

يُعيد قائمة عناصر ذات اسم الوسم المُعطى.

`Document.getElementsByTagNameNS()‎`

يُعيد قائمة عناصر ذات اسم الوسم ومساحة الاسم المُعطاة.

`Document.importNode()‎`

يُعيد نُسخة عقدة من مُستند خارجي.

`Document.normalizeDocument()‎`

يُبدِل الكيانات، يُطبِّع العقد النّصيّة إلى غير ذلك. وهو تابع محذوف.

`Document.releaseCapture()‎`

يقوم بتحرير التقاط الفأرة إن كان على عنصر ما في المُستند. وهو تابع غير قياسي.

`Document.releaseEvents()‎`

انظر Window.releaseEvents()‎. وهو تابع غير قياسي.

`Document.routeEvent()‎`

انظر Window.routeEvent()‎. وهو تابع محذوف.

`Document.mozSetImageElement()‎`

يسمح بتغيير العنصر المُستعمل كصورة خلفيّة حسب مُعرّف عنصر (element ID) مُعطى. وهو تابع غير قياسي.

الواجهة Document موسّعةٌ بالواجهة ParentNode:

`document.getElementById()‎`

يُعيد مرجِع كائن يُشير إلى العنصر المُعرَّف (بالمُعرِّف ID الذي يُمرّر إلى التّابع في سلسلة نصيّة).

`document.querySelector()‎`

يُعيد أول عقدة عنصر داخل المُستند - حسب ترتيب المُستند - والتي تُوافق المُحدِّدات (selectors) المُعطاة.

`document.querySelectorAll()‎`

يُعيد قائمة بجميع عقد العناصر التي تُوافق المُحدِّدات المُعطاة داخل المُستند.

الواجهة Document موسّعةٌ بالواجهة XPathEvaluator:

`document.createExpression()‎`

يُجمّع استعلام XPathExpression، والذي يُمكن استعماله بعد ذلك لإجراء تقديرات evaluations يُمكن تكرارها.

`document.createNSResolver()‎`

يُنشئ كائنا من النّوع XPathNSResolver.

`document.evaluate()‎`

يقوم بتقدير تعبير XPath.

مُلحق لمُستندات HTML

ترِث الواجهة Document من الواجهة HTMLDocument لمُستندات HTML، وقد أصبحت موسّعة بها منذ الإصدار HTML5.

`document.clear()‎`

لا يقوم هذا التّابع بأي شيء في مُعظم المُتصفحات المُعاصرة، ما يشمل النسخ الجديدة من فايرفوكس وInternet Explorer. وهو تابع غير قياسي ومُهمل.

`document.close()‎`

يُغلق مجرى (stream) الكتابة لمُستند قد فُتح بالتّابع document.open()‎.

`document.execCommand()‎`

يقوم بتنفيذ أمر تنسيق على مُستند قابل للتّعديل.

`document.getElementsByName()‎`

يُعيد قائمة عناصر تُوافق أسماؤها الاسم المُعطى.

`document.hasFocus()‎`

يُعيد القيمة true في حالة كان التّركيز الحاليّ على أي مكان من المُستند المُحدّد.

`document.open()‎`

يفتح المُستند للكتابة.

`document.queryCommandEnabled()‎`

يُعيد القيمة true في حالة أمكن تنفيذ أمر التّنسيق في المجال الحالي.

`document.queryCommandIndeterm()‎`

يُعيد القيمة true في حالة كان أمر التّنسيق غير مُعرَّف على المجال الحالي.

`document.queryCommandState()‎`

يُعيد القيمة true في حالة تمّ تنفيذ أمر التّنسيق على المجال الحالي.

`document.queryCommandSupported()‎`

يُعيد القيمة true في حالة كان أمر التّنسيق مدعوما على المجال الحالي.

`document.queryCommandValue()‎`

يُعيد القيمة الحاليّة الخاصّة بالمجال الحالي لأمر تنسيق ما.

`document.write()‎`

يكتب مقطعًا نصيًّا على المُستند.

`document.writeln()‎`

يكتب سطرًا من النصّ على المُستند.

توابع مضمنة من الواجهة `DocumentOrShadowRoot`

تشمل واجهة Document التوابع التّاليّة المُعرَّفة على مجموعة DocumentOrShadowRoot. لاحظ بأنّ هذا مُطبَّق على مُتصفّح Chrome فقط في الوقت الحالي؛ وبقيّة المُتصفحات لا تزال تُطبّقها مُباشرة على واجهة Document.

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

مواصفة Page Visibility أضافت onvisibilitychange.
مواصفة Selection API أضافت هذه المواصفة onselectstart و onselectionchange.
مواصفة Document Object Model (DOM) Level 1 Specification، التعريف البدئي للواجهة.
مواصفة Document Object Model (DOM) Level 2 Core Specification، أبدلت DOM 1.
مواصفة Document Object Model (DOM) Level 3 Core Specification، أبدلت DOM 2.
مواصفة DOM، نَوَتْ إبدالDOM 3.
معيار HTML Living Standard، تحويل الواجهة HTMLDocument إلى امتداد للواجهة Document.
مواصفة Document Object Model (DOM) Level 3 XPath Specification تعريف الواجهة XPathEvaluator. التي تُوسّع الواجهة Document.
مواصفة Page Visibility‏ (Second Edition) التي وسّعت الواجهة Document بإضافة الخاصيتين visibilityState وhidden.
مواصفة HTML Editing APIs التي وسّعت الواجهة Document.
مواصفة CSS Object Model (CSSOM) View Module التي وسّعت الواجهة Document.
مواصفة CSS Object Model‏ (CSSOM) التي وسّعت الواجهة Document.
مواصفة Pointer Lock التي وسّعت الواجهة Document.

@@ سطر 2: / سطر 2: @@
 تُمثّل الواجهة <code>Document</code> أي صفحة ويب مُحمّلة في المُتصفح وتعمل كنُقطة بداية للوصول إلى مُحتوى الصّفحة، أي شجرة DOM التي تشمل عناصر مثل <code>[[HTML/body|<body>]]</code> و <code>[[HTML/table|<nowiki><table></nowiki>]]</code>، إضافة إلى العديد من [[:تصنيف:HTML Elements|العناصر الأخرى]]. وتُوفِّر إمكانيّة التّعامل بشكل عمومي للمُستند، مثل كيفيّة الحصول على عنوان URL الخاصّ بالصّفحة وكيفيّة إنشاء عناصر جديدة في المُستند.
-تصِفُ الواجهة <code>Document</code> الخصائص (properties) والتّوابع (methods) الشّائعة لأي نوع كان من المُستندات. واعتمادًا على نوع المُستند (مثل HTML، و XML، و SVG وغيرها)، يُمكن أن تتوفّر واجهة برمجيّة (API) أكبر وأكثر تخصّصا: مُستندات HTML المُقدّمَة مع نوع المُحتوى <code>text/html</code>، تعتمد كذلك على الواجهة <code>[[JavaScript/HTMLDocument|HTMLDocument]]</code>، أمّا مُستندات XML و SVG فتعتمد الواجهة <code>XMLDocument</code>.
+تصِفُ الواجهة <code>Document</code> الخصائص (properties) والتّوابع (methods) الشّائعة لأي نوع كان من المُستندات. واعتمادًا على نوع المُستند (مثل HTML، و XML، و SVG وغيرها)، يُمكن أن تتوفّر واجهة برمجيّة (API) أكبر وأكثر تخصّصا: مُستندات [[HTML]] المُقدّمَة مع نوع المُحتوى <code>text/html</code>، تعتمد كذلك على الواجهة <code>[[JavaScript/HTMLDocument|HTMLDocument]]</code>، أمّا مُستندات XML و SVG فتعتمد الواجهة <code>XMLDocument</code>.
 ==الدّالة البانيّة==
 ===<code>[[JavaScript/Document/Document|Document()]]‎</code>===
@@ سطر 21: / سطر 21: @@
 ===<code>[[JavaScript/Document/compatMode|Document.compatMode]]</code>===
 خاصيّة قابلة للقراءة فقط تدل على ما إذا كان المُستند قد قُدِّم في وضع quirks أو [[JavaScript/Strict Mode|نمط strict]]. وهي تجريبيّة لا يجب استعمالها في شيفرة إنتاجيّة.
-===<code>[[JavaScript/Document/contentType|Document.contentType]]</code>===
+===<code>Document.contentType</code>===
 خاصيّة تجريبيّة، قابلة للقراءة فقط، تُعيد قيمة Content-Type من ترويسة MIME الخاصّة بالمُستند الحالي.
 ===<code>[[JavaScript/Document/doctype|Document.doctype]]</code>===
 تُعيد تعريف نوع المُستند (DTD) الخاصّ بالمُستند الحالي. وهي للقراءة فقط.
@@ سطر 55: / سطر 56: @@
 تُعيد مرجِعا للعنصر الذي يلفّ المُستند. وهي  للقراءة فقط.
 ===<code>[[JavaScript/Document/selectedStyleSheetSet|Document.selectedStyleSheetSet]]</code>===
-تُعيد أيًّا مجموعة من مجموعات صفحات الأنماط الجاري استعمالها حاليّا.
+تُعيد أيّ مجموعة من مجموعات صفحات الأنماط الجاري استعمالها حاليّا.
 ===<code>[[JavaScript/Document/styleSheetSets|Document.styleSheetSets]]</code>===
 تُعيد قائمة بمجموعات صفحات الأنماط المُتاحة على المُستند. وهي  للقراءة فقط.
@@ سطر 178: / سطر 180: @@
 تُمثّل شيفرة مُعالجة الحدث <code>[[JavaScript/Events/abort|abort]]</code>.
 ===<code>GlobalEventHandlers.onanimationcancel</code>===
-تُمثّل شيفرة مُعالجة الحدث <code>[[JavaScript/Events/animationcancel|animationcancel]]</code> الذي يُشير إلى أنّ تحريك CSS قد تمّ إلغاؤه. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.
+تُمثّل شيفرة مُعالجة الحدث <code>[[JavaScript/Events/animationcancel|animationcancel]]</code> الذي يُشير إلى أنّ تحريك [[CSS]] قد تمّ إلغاؤه. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.
 ===<code>GlobalEventHandlers.onanimationend</code>===
 تُمثّل شيفرة مُعالجة الحدث <code>[[JavaScript/Events/animationend|animationend]]</code> الذي يُشير إلى أنّ تحريك CSS قد توقّف عن الحركة. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.
@@ سطر 403: / سطر 405: @@
 ===<code>[[JavaScript/Document/normalizeDocument|Document.normalizeDocument()‎]]</code>===
 يُبدِل الكيانات، يُطبِّع العقد النّصيّة إلى غير ذلك. وهو تابع محذوف.
-===<code>Document.releaseCapture()‎</code>===
+===<code>[[JavaScript/Document/releaseCapture|Document.releaseCapture()‎]]</code>===
 يقوم بتحرير التقاط الفأرة إن كان على عنصر ما في المُستند. وهو تابع غير قياسي.
 ===<code>[[JavaScript/Document/releaseEvents|Document.releaseEvents()‎]]</code>===
 انظر <code>[[JavaScript/Window/releaseEvents|Window.releaseEvents()‎]]</code>. وهو تابع غير قياسي.
@@ سطر 467: / سطر 470: @@
 يُعيد كائنا من النّوع <code>[[JavaScript/CaretPosition|CaretPosition]]</code> يحتوي على عقدة DOM التي تحتوي على علامة الإقحام، وإزاحة المحارف (character offset)  الخاصّ بعلامة الإقحام في تلك العقدة.
-==المواصفات==
+==مصادر ومواصفات==
 *مواصفة [https://www.w3.org/TR/page-visibility/#onvisiblitychange-event-handler Page Visibility] أضافت <code>onvisibilitychange</code>.
 *مواصفة [https://w3c.github.io/selection-api/ Selection API] أضافت هذه المواصفة <code>onselectstart</code> و <code>onselectionchange</code>.

المراجعة الحالية بتاريخ 14:30، 7 أكتوبر 2022

الدّالة البانيّة

Document()‎

الخصائص

Document.all

Document.async

Document.contentType

Document.domConfig

Document.fullscreen

Document.inputEncoding

Document.mozSyntheticDocument

Document.mozFullScreenElement

Document.mozFullScreenEnabled

Document.undoManager

Document.xmlEncoding

Document.xmlStandalone

Document.xmlVersion

امتداد لمُستند HTML

Document.alinkColor

Document.anchors

Document.applets

Document.bgColor

Document.height

Document.linkColor

Document.vlinkColor

Document.width

خصائص مضمنة من الواجهة DocumentOrShadowRoot