الفرق بين المراجعتين لصفحة: «JavaScript/Document»
طلا ملخص تعديل |
|||
| سطر 1: | سطر 1: | ||
=Document= | =Document= | ||
تُمثّل الواجهة <code>Document</code> أي صفحة ويب مُحمّلة في المُتصفح وتعمل كنُقطة بداية للوصول إلى مُحتوى الصّفحة، أي شجرة DOM التي تشمل عناصر مثل <body> و | تُمثّل الواجهة <code>Document</code> أي صفحة ويب مُحمّلة في المُتصفح وتعمل كنُقطة بداية للوصول إلى مُحتوى الصّفحة، أي شجرة DOM التي تشمل عناصر مثل <code><body></code> و <code><table></code>، إضافة إلى العديد من العناصر الأخرى. وتُوفِّر إمكانيّة التّعامل بشكل عمومي للمُستند، مثل كيفيّة الحصول على عنوان URL الخاصّ بالصّفحة وكيفيّة إنشاء عناصر جديدة في المُستند. | ||
EventTarget <= Node <= Document | EventTarget <= Node <= Document | ||
تصِفُ الواجهة <code>Document</code> الخصائص (properties) والتّوابع (methods) الشّائعة لأي نوع كان من المُستندات. واعتمادا على نوع المُستند (مثل HTML، XML، SVG وغيرها)، يُمكن أن تتوفّر واجهة برمجيّة (API) أكبر وأكثر تخصّصا: مُستندات HTML المُقدّمَة مع نوع المُحتوى <code>text/html</code>، تعتمد كذلك على الواجهة <code>HTMLDocument</code>، أمّا مُستندات XML و SVG فتعتمد الواجهة <code>XMLDocument</code>. | تصِفُ الواجهة <code>Document</code> الخصائص (properties) والتّوابع (methods) الشّائعة لأي نوع كان من المُستندات. واعتمادا على نوع المُستند (مثل HTML، XML، SVG وغيرها)، يُمكن أن تتوفّر واجهة برمجيّة (API) أكبر وأكثر تخصّصا: مُستندات HTML المُقدّمَة مع نوع المُحتوى <code>text/html</code>، تعتمد كذلك على الواجهة <code>HTMLDocument</code>، أمّا مُستندات XML و SVG فتعتمد الواجهة <code>XMLDocument</code>. | ||
| سطر 12: | سطر 12: | ||
==الخصائص== | ==الخصائص== | ||
هذه الواجهة ترِثُ كذلك من الواجهة <code>Node</code> والواجهة <code>EventTarget</code>. | هذه الواجهة ترِثُ كذلك من الواجهة <code>Node</code> والواجهة <code>EventTarget</code>. | ||
===Document.all=== | ===Document.all=== | ||
توفّر إمكانيّة الوصول إلى جميع العناصر في المُستند. وهي خاصيّة مهمَلة غير قياسيّة لا يجب استعمالها. | توفّر إمكانيّة الوصول إلى جميع العناصر في المُستند. وهي خاصيّة مهمَلة غير قياسيّة لا يجب استعمالها. | ||
===Document.async=== | ===Document.async=== | ||
تُستعمل مع الخاصيّة <code>Document.load</code> للإشارة إلى أنّ الطلب غير مُتزامن وهي خاصيّة مهمَلة. | تُستعمل مع الخاصيّة <code>Document.load</code> للإشارة إلى أنّ الطلب غير مُتزامن وهي خاصيّة مهمَلة. | ||
===Document.body=== | ===Document.body=== | ||
تُعيد عقدة العنصر <code><body></code> أو <code><frameset></code> الخاصّة بالمستند الحاليّ. | تُعيد عقدة العنصر <code><body></code> أو <code><frameset></code> الخاصّة بالمستند الحاليّ. | ||
===Document.characterSet === | ===Document.characterSet === | ||
خاصيّة قابلة للقراءة فقط تُعيد مجموعة المحارف المُستعمَلة من طرف المُستند. | خاصيّة قابلة للقراءة فقط تُعيد مجموعة المحارف المُستعمَلة من طرف المُستند. | ||
===Document.charset === | ===Document.charset === | ||
اسم مُستعار للخاصيّة <code>Document.characterSet</code>، استعملها عوضا عن هذه الخاصيّة. لاحظ أنَّ هذه الخاصية للقراءة فقط وقد أهملت ولا يجدر بك استخدامها. | اسم مُستعار للخاصيّة <code>Document.characterSet</code>، استعملها عوضا عن هذه الخاصيّة. لاحظ أنَّ هذه الخاصية للقراءة فقط وقد أهملت ولا يجدر بك استخدامها. | ||
===Document.compatMode=== | ===Document.compatMode=== | ||
خاصيّة قابلة للقراءة فقط تدل على ما إذا كان المُستند قد قُدِّم في وضع quirks أو وضع strict. وهي تجريبيّة لا يجب استعمالها في شيفرة إنتاجيّة. | خاصيّة قابلة للقراءة فقط تدل على ما إذا كان المُستند قد قُدِّم في وضع quirks أو وضع strict. وهي تجريبيّة لا يجب استعمالها في شيفرة إنتاجيّة. | ||
===Document.contentType=== | ===Document.contentType=== | ||
خاصيّة تجريبيّة، قابلة للقراءة فقط، تُعيد قيمة Content-Type من ترويسة MIME الخاصّة بالمُستند الحالي. | خاصيّة تجريبيّة، قابلة للقراءة فقط، تُعيد قيمة Content-Type من ترويسة MIME الخاصّة بالمُستند الحالي. | ||
===Document.doctype === | ===Document.doctype === | ||
تُعيد تعريف نوع المُستند (DTD) الخاصّ بالمُستند الحالي. وهي للقراءة فقط. | تُعيد تعريف نوع المُستند (DTD) الخاصّ بالمُستند الحالي. وهي للقراءة فقط. | ||
===Document.documentElement=== | ===Document.documentElement=== | ||
تُعيد العنصر <code>Element</code> الذي يُمثّل الولد المُباشِر للمُستند. ولمُستندات HTML، فهذا عادة ما يكون العنصر <code>HTMLElement</code>. وهي للقراءة فقط. | تُعيد العنصر <code>Element</code> الذي يُمثّل الولد المُباشِر للمُستند. ولمُستندات HTML، فهذا عادة ما يكون العنصر <code>HTMLElement</code>. وهي للقراءة فقط. | ||
===Document.documentURI=== | ===Document.documentURI=== | ||
تُعيد مكان المُستند على شكل سلسلة نصيّة (string). وهي للقراءة فقط. | تُعيد مكان المُستند على شكل سلسلة نصيّة (string). وهي للقراءة فقط. | ||
===Document.domConfig=== | ===Document.domConfig=== | ||
تُعيد كائنا من النّوع <code>DOMConfiguration</code>، لا تستخدمها لأنّها مُهملة. | تُعيد كائنا من النّوع <code>DOMConfiguration</code>، لا تستخدمها لأنّها مُهملة. | ||
===Document.fullscreen=== | ===Document.fullscreen=== | ||
خاصيّة محذوفة كانت تُعيد القيمة true في وضع ملء الشّاشة. | خاصيّة محذوفة كانت تُعيد القيمة true في وضع ملء الشّاشة. | ||
===Document.hidden=== | ===Document.hidden=== | ||
خاصيّة قابلة للقراءة فقط تُعيد قيمة منطقيّة تُشير إلى ما إذا كانت الصّفحة مخفيّة أو لا. | خاصيّة قابلة للقراءة فقط تُعيد قيمة منطقيّة تُشير إلى ما إذا كانت الصّفحة مخفيّة أو لا. | ||
===Document.implementation=== | ===Document.implementation=== | ||
تُعيد تطبيق DOM المُرتبط بالمُستند الحالي، وهي للقراءة فقط. | تُعيد تطبيق DOM المُرتبط بالمُستند الحالي، وهي للقراءة فقط. | ||
===Document.inputEncoding=== | ===Document.inputEncoding=== | ||
اسم مُستعار للخاصيّة <code>Document.characterSet</code>. استعملها عوضا عن هذه الخاصيّة. | اسم مُستعار للخاصيّة <code>Document.characterSet</code>. استعملها عوضا عن هذه الخاصيّة. | ||
===Document.lastStyleSheetSet=== | ===Document.lastStyleSheetSet=== | ||
تُعيد اسم آخر صفحة أنماط تمّ تفعيلها. وتحمِل القيمة null إلى أن تُغيّر ورقة التّنسيق عبر ضبط قيمة للخاصيّة <code>selectedStyleSheetSet</code>. | تُعيد اسم آخر صفحة أنماط تمّ تفعيلها. وتحمِل القيمة null إلى أن تُغيّر ورقة التّنسيق عبر ضبط قيمة للخاصيّة <code>selectedStyleSheetSet</code>. | ||
===Document.mozSyntheticDocument=== | ===Document.mozSyntheticDocument=== | ||
تُعيد قيمة منطقيّة Boolean، تُساوي القيمة true فقط في حالة كان المُستند تركيبيّا (synthetic)، مثل صورة، فيديو، ملفّ نصي أو ما شابه ذلك. هذه خاصيّة غير قياسيّة، قد لا تعمل على جميع المُتصفحات. | تُعيد قيمة منطقيّة Boolean، تُساوي القيمة true فقط في حالة كان المُستند تركيبيّا (synthetic)، مثل صورة، فيديو، ملفّ نصي أو ما شابه ذلك. هذه خاصيّة غير قياسيّة، قد لا تعمل على جميع المُتصفحات. | ||
===Document.mozFullScreenElement=== | ===Document.mozFullScreenElement=== | ||
تُعيد العنصر المتواجد في وضع ملء الشّاشة للمُستند الحالي. وهي للقراءة فقط؛ كما أنّها غير قياسيّة وقد لا تعمل دوما. | تُعيد العنصر المتواجد في وضع ملء الشّاشة للمُستند الحالي. وهي للقراءة فقط؛ كما أنّها غير قياسيّة وقد لا تعمل دوما. | ||
===Document.mozFullScreenEnabled=== | ===Document.mozFullScreenEnabled=== | ||
تُعيد القيمة true في حالة نجاح استدعاء <code>Element.mozRequestFullscreen()</code> في المُستند الحالي. وهي للقراءة فقط؛ كما أنّها غير قياسيّة وقد لا تعمل دوما. | تُعيد القيمة true في حالة نجاح استدعاء <code>Element.mozRequestFullscreen()</code> في المُستند الحالي. وهي للقراءة فقط؛ كما أنّها غير قياسيّة وقد لا تعمل دوما. | ||
===Document.preferredStyleSheetSet=== | ===Document.preferredStyleSheetSet=== | ||
تُعيد مجموعة صفحات الأنماط المُفضّلة حسب ما ضبطه كاتب الصّفحة. وهي للقراءة فقط. | تُعيد مجموعة صفحات الأنماط المُفضّلة حسب ما ضبطه كاتب الصّفحة. وهي للقراءة فقط. | ||
===Document.scrollingElement=== | ===Document.scrollingElement=== | ||
تُعيد مرجِعا للعنصر الذي يلفّ المُستند. وهي للقراءة فقط. | تُعيد مرجِعا للعنصر الذي يلفّ المُستند. وهي للقراءة فقط. | ||
===Document.selectedStyleSheetSet=== | ===Document.selectedStyleSheetSet=== | ||
تُعيد أيا مجموعة من مجموعات صفحات الأنماط الجاري استعمالها حاليّا. | تُعيد أيا مجموعة من مجموعات صفحات الأنماط الجاري استعمالها حاليّا. | ||
===Document.styleSheetSets=== | ===Document.styleSheetSets=== | ||
تُعيد قائمة بمجموعات صفحات الأنماط المُتاحة على المُستند. وهي للقراءة فقط. | تُعيد قائمة بمجموعات صفحات الأنماط المُتاحة على المُستند. وهي للقراءة فقط. | ||
===Document.timeline=== | ===Document.timeline=== | ||
تُعيد تمثيلا للخط الزمني الافتراضي في المُستند الحالي. وهي للقراءة فقط. | تُعيد تمثيلا للخط الزمني الافتراضي في المُستند الحالي. وهي للقراءة فقط. | ||
===Document.undoManager=== | ===Document.undoManager=== | ||
خاصيّة تجريبيّة، قابلة للقراءة فقط… | خاصيّة تجريبيّة، قابلة للقراءة فقط… | ||
===Document.visibilityState=== | ===Document.visibilityState=== | ||
تُعيد سلسلة نصيّة تدل على حالة وضوح المُستند. القيم المُمكنة هي <code>visible</code> ،<code>hidden</code> ،<code>prerender</code>، و<code>unloaded</code>. وهي للقراءة فقط. | تُعيد سلسلة نصيّة تدل على حالة وضوح المُستند. القيم المُمكنة هي <code>visible</code> ،<code>hidden</code> ،<code>prerender</code>، و<code>unloaded</code>. وهي للقراءة فقط. | ||
===Document.xmlEncoding=== | ===Document.xmlEncoding=== | ||
تُعيد التّرميز حسب ما تمّ ضبطه من طرف تعريف XML، وهي خاصيّة مهمَلة. | تُعيد التّرميز حسب ما تمّ ضبطه من طرف تعريف XML، وهي خاصيّة مهمَلة. | ||
===Document.xmlStandalone=== | ===Document.xmlStandalone=== | ||
خاصيّة محذوفة منذ Gecko 10.0، كانت تُعيد القيمة المنطقيّة true إن كان تعريف XML يُحدّد بأنّ المُستند قائم بذاته (أي لو كان جزء خارجي من تعريف نوع المُستند DTD يُؤثّر على مُحتوى المُستند)، أمّا غير ذلك فيُعيد false. | خاصيّة محذوفة منذ Gecko 10.0، كانت تُعيد القيمة المنطقيّة true إن كان تعريف XML يُحدّد بأنّ المُستند قائم بذاته (أي لو كان جزء خارجي من تعريف نوع المُستند DTD يُؤثّر على مُحتوى المُستند)، أمّا غير ذلك فيُعيد false. | ||
===Document.xmlVersion=== | ===Document.xmlVersion=== | ||
خاصيّة محذوفة منذ Gecko 10.0، كانت تُعيد رقم الإصدار حسب ما تمّ تحديده في تعريف XML أو تُعيد "1.0" إن لم يتواجد التّعريف. | خاصيّة محذوفة منذ Gecko 10.0، كانت تُعيد رقم الإصدار حسب ما تمّ تحديده في تعريف XML أو تُعيد "1.0" إن لم يتواجد التّعريف. | ||
الواجهة Document مُمتدّةٌ بالواجهة ParentNode: | الواجهة Document مُمتدّةٌ بالواجهة ParentNode: | ||
===ParentNode.children=== | ===ParentNode.children=== | ||
تُعيد نسخة حيّة من <code>HTMLCollection</code> تحتوي على جميع الكائنات من النّوع<code>Element</code> التي تُمثّل أولاد عقدة العنصر الأب <code>ParentNode</code> هذه. وهي خاصيّة قابلة للقراءة فقط. | تُعيد نسخة حيّة من <code>HTMLCollection</code> تحتوي على جميع الكائنات من النّوع<code>Element</code> التي تُمثّل أولاد عقدة العنصر الأب <code>ParentNode</code> هذه. وهي خاصيّة قابلة للقراءة فقط. | ||
===ParentNode.firstElementChild=== | ===ParentNode.firstElementChild=== | ||
تُعيد العنصر الذي يُمثل أول ولد من أولاد عقدة العنصر <code>ParentNode</code> هذه، أو تُعيد القيمة null في حالة لم يتواجد أي عنصر. وهي خاصيّة قابلة للقراءة فقط. | تُعيد العنصر الذي يُمثل أول ولد من أولاد عقدة العنصر <code>ParentNode</code> هذه، أو تُعيد القيمة null في حالة لم يتواجد أي عنصر. وهي خاصيّة قابلة للقراءة فقط. | ||
===ParentNode.lastElementChild=== | ===ParentNode.lastElementChild=== | ||
تُعيد العنصر الذي يُمثل آخر ولد من أولاد عقدة العنصر <code>ParentNode</code> هذه، أو تُعيد القيمة null في حالة لم يتواجد أي عنصر. وهي خاصيّة قابلة للقراءة فقط. | تُعيد العنصر الذي يُمثل آخر ولد من أولاد عقدة العنصر <code>ParentNode</code> هذه، أو تُعيد القيمة null في حالة لم يتواجد أي عنصر. وهي خاصيّة قابلة للقراءة فقط. | ||
===ParentNode.childElementCount=== | ===ParentNode.childElementCount=== | ||
يُعيد قيمة من النّوع <code>unsigned long</code> تُمثّل عدد أولاد الكائن. وهي خاصيّة قابلة للقراءة فقط. | يُعيد قيمة من النّوع <code>unsigned long</code> تُمثّل عدد أولاد الكائن. وهي خاصيّة قابلة للقراءة فقط. | ||
== امتداد لمُستند HTML == | == امتداد لمُستند HTML == | ||
ترِث الواجهة Document من الواجهة <code>HTMLDocument</code> لمُستندات HTML، وقد أصبحت امتدادا لهذه المُستندات منذ الإصدار الخامس من HTML (أي HTML5). | ترِث الواجهة Document من الواجهة <code>HTMLDocument</code> لمُستندات HTML، وقد أصبحت امتدادا لهذه المُستندات منذ الإصدار الخامس من HTML (أي HTML5). | ||
===Document.alinkColor=== | ===Document.alinkColor=== | ||
خاصيّة مهمَلة تُستعمل للحصول على أو ضبط لون الروابط المُفعّلة في جسم المُستند. | خاصيّة مهمَلة تُستعمل للحصول على أو ضبط لون الروابط المُفعّلة في جسم المُستند. | ||
===Document.anchors=== | ===Document.anchors=== | ||
تُعيد قائمة بجميع المراسي (anchors) في المتواجد في المُستند. | تُعيد قائمة بجميع المراسي (anchors) في المتواجد في المُستند. | ||
===Document.applets=== | ===Document.applets=== | ||
خاصيّة مهمَلة تُعيد قائمة مُرتّبة للتّطبيقات الصّغيرة (applets) في المُستند. | خاصيّة مهمَلة تُعيد قائمة مُرتّبة للتّطبيقات الصّغيرة (applets) في المُستند. | ||
===Document.bgColor === | ===Document.bgColor === | ||
تُستعمل للحصول على أو ضبط لون خلفيّة المُستند الحالي، وهي خاصيّة مهمَلة. | تُستعمل للحصول على أو ضبط لون خلفيّة المُستند الحالي، وهي خاصيّة مهمَلة. | ||
===Document.cookie=== | ===Document.cookie=== | ||
تُعيد قائمة بملفّات تعريف الارتباط (cookies) مفصولة بفاصلة منقوطة (;) للمُستند أو تُستعمل لضَبط ملفّ تعريف ارتباط. | تُعيد قائمة بملفّات تعريف الارتباط (cookies) مفصولة بفاصلة منقوطة (;) للمُستند أو تُستعمل لضَبط ملفّ تعريف ارتباط. | ||
===Document.defaultView=== | ===Document.defaultView=== | ||
تُعيد مرجعا لكائن النّافذة. وهي للقراءة فقط. | تُعيد مرجعا لكائن النّافذة. وهي للقراءة فقط. | ||
===Document.designMode=== | ===Document.designMode=== | ||
تُستعمل للحصول على أو ضبط إمكانيّة تعديل كامل المُستند. | تُستعمل للحصول على أو ضبط إمكانيّة تعديل كامل المُستند. | ||
===Document.dir=== | ===Document.dir=== | ||
تُستعمل للحصول على أو ضبط إتجاهيّة المُستند (rtl/ltr). وهي للقراءة فقط. | تُستعمل للحصول على أو ضبط إتجاهيّة المُستند (rtl/ltr). وهي للقراءة فقط. | ||
===Document.domain=== | ===Document.domain=== | ||
تُستعمل للحصول على أو ضبط نطاق المُستند الحالي. | تُستعمل للحصول على أو ضبط نطاق المُستند الحالي. | ||
===Document.embeds=== | ===Document.embeds=== | ||
تُعيد قائمة بعناصر <code><embed></code> المُضمّنة ضمن المُستند الحالي. وهي للقراءة فقط. | تُعيد قائمة بعناصر <code><embed></code> المُضمّنة ضمن المُستند الحالي. وهي للقراءة فقط. | ||
| سطر 105: | سطر 149: | ||
document.fgColor | document.fgColor | ||
تُستعمل للحصول على أو ضبط لون الواجهة أو لون النّص للمُستند الحالي. | تُستعمل للحصول على أو ضبط لون الواجهة أو لون النّص للمُستند الحالي. | ||
===Document.forms=== | ===Document.forms=== | ||
تُعيد قائمة بعناصر <code><form></code> المتواجدة في المُستند الحالي. وهي للقراءة فقط. | تُعيد قائمة بعناصر <code><form></code> المتواجدة في المُستند الحالي. وهي للقراءة فقط. | ||
===Document.head=== | ===Document.head=== | ||
تُعيد عنصر <code><head></code> الخاصّ بالمستند الحالي. وهي للقراءة فقط. | تُعيد عنصر <code><head></code> الخاصّ بالمستند الحالي. وهي للقراءة فقط. | ||
===Document.height=== | ===Document.height=== | ||
خاصيّة محذوفة، تُستعمل للحصول على أو ضبط ارتفاع المُستند الحالي. | خاصيّة محذوفة، تُستعمل للحصول على أو ضبط ارتفاع المُستند الحالي. | ||
===Document.images=== | ===Document.images=== | ||
تُعيد قائمة بالصور المتواجدة في المُستند الحالي. وهي للقراءة فقط. | تُعيد قائمة بالصور المتواجدة في المُستند الحالي. وهي للقراءة فقط. | ||
===Document.lastModified=== | ===Document.lastModified=== | ||
تُعيد تاريخ آخر تعديل للمُستند. وهي للقراءة فقط. | تُعيد تاريخ آخر تعديل للمُستند. وهي للقراءة فقط. | ||
===Document.linkColor=== | ===Document.linkColor=== | ||
تُستعمل للحصول على أو ضبط لون الرّوابط في المُستند، وهي خاصيّة مُهملة لا يجب استعمالها. | تُستعمل للحصول على أو ضبط لون الرّوابط في المُستند، وهي خاصيّة مُهملة لا يجب استعمالها. | ||
===Document.links=== | ===Document.links=== | ||
خاصيّة قابلة للقراءة فقط تُعيد قائمة بجميع الروابط في المُستند. | خاصيّة قابلة للقراءة فقط تُعيد قائمة بجميع الروابط في المُستند. | ||
===Document.location=== | ===Document.location=== | ||
خاصيّة قابلة للقراءة فقط تُعيد رابط URI الخاصّ بالمُستند الحالي. | خاصيّة قابلة للقراءة فقط تُعيد رابط URI الخاصّ بالمُستند الحالي. | ||
===Document.plugins=== | ===Document.plugins=== | ||
خاصيّة قابلة للقراءة فقط تُعيد قائمة بجميع الإضافات المُتوفّرة. | خاصيّة قابلة للقراءة فقط تُعيد قائمة بجميع الإضافات المُتوفّرة. | ||
===Document.readyState=== | ===Document.readyState=== | ||
خاصيّة قابلة للقراءة فقط تُعيد حالة التحميل للمُستند. | خاصيّة قابلة للقراءة فقط تُعيد حالة التحميل للمُستند. | ||
===Document.referrer=== | ===Document.referrer=== | ||
خاصيّة قابلة للقراءة فقط تُعيد رابط URI الصّفحة التي أحيلت منها الصّفحة الحاليّة. | خاصيّة قابلة للقراءة فقط تُعيد رابط URI الصّفحة التي أحيلت منها الصّفحة الحاليّة. | ||
===Document.scripts === | ===Document.scripts === | ||
خاصيّة قابلة للقراءة فقط تُعيد جميع عناصر <code><script></code> في المُستند. | خاصيّة قابلة للقراءة فقط تُعيد جميع عناصر <code><script></code> في المُستند. | ||
===Document.title=== | ===Document.title=== | ||
تُعيد أو تضبِط عنوان المُستند الحالي. | تُعيد أو تضبِط عنوان المُستند الحالي. | ||
===Document.URL=== | ===Document.URL=== | ||
خاصيّة قابلة للقراءة فقط تُعيد مكان المُستند على شكل سلسلة نصيّة. | خاصيّة قابلة للقراءة فقط تُعيد مكان المُستند على شكل سلسلة نصيّة. | ||
===Document.vlinkColor=== | ===Document.vlinkColor=== | ||
تُعيد أو تضبِط لون الرّوابط التي تمت زيارتها. وهي خاصيّة مُهملة. | تُعيد أو تضبِط لون الرّوابط التي تمت زيارتها. وهي خاصيّة مُهملة. | ||
===Document.width=== | ===Document.width=== | ||
خاصيّة محذوفة تُعيد عرض المُستند الحالي. | خاصيّة محذوفة تُعيد عرض المُستند الحالي. | ||
==خصائص تم ضمّها من مجموعة الدّوال المُساعدة (mixin) DocumentOrShadowRoot== | ==خصائص تم ضمّها من مجموعة الدّوال المُساعدة (mixin) DocumentOrShadowRoot== | ||
تشمل واجهة Document الخصائص التّاليّة المُعرَّفة على مجموعة DocumentOrShadowRoot. لاحظ بأنّ هذا مُطبَّق على مُتصفّح Chrome فقط في الوقت الحالي؛ وبقيّة المُتصفحات لا تزال تُطبّقها مُباشرة على واجهة Document. | تشمل واجهة Document الخصائص التّاليّة المُعرَّفة على مجموعة DocumentOrShadowRoot. لاحظ بأنّ هذا مُطبَّق على مُتصفّح Chrome فقط في الوقت الحالي؛ وبقيّة المُتصفحات لا تزال تُطبّقها مُباشرة على واجهة Document. | ||
===DocumentOrShadowRoot.activeElement=== | ===DocumentOrShadowRoot.activeElement=== | ||
تُعيد هذه الخاصيّة القابلة للقراءة فقط عنصر <code>Element</code> المتواجد في شجرة الظّل (shadow tree) ذات التّركيز. | تُعيد هذه الخاصيّة القابلة للقراءة فقط عنصر <code>Element</code> المتواجد في شجرة الظّل (shadow tree) ذات التّركيز. | ||
===Document.fullscreenElement=== | ===Document.fullscreenElement=== | ||
تُعيد هذه الخاصيّة القابلة للقراءة فقط العنصر الذي يُعتبر في وضع ملء الشّاشة في هذا المُستند. | تُعيد هذه الخاصيّة القابلة للقراءة فقط العنصر الذي يُعتبر في وضع ملء الشّاشة في هذا المُستند. | ||
===DocumentOrShadowRoot.pointerLockElement=== | ===DocumentOrShadowRoot.pointerLockElement=== | ||
تُعيد هذه الخاصيّة القابلة للقراءة فقط مجموعة العناصر التي تقع ضمن هدف أحداث الفأرة أثناء قفل مؤشّر الفأرة. تُعيد القيمة null في حالة كان القفل مُعلّقا، أو في حالة كان المُؤشّر غير مُقفل، أو إذا ما كان الهدف يقع في مُستند آخر. هذه الخاصيّة تجريبيّة. | تُعيد هذه الخاصيّة القابلة للقراءة فقط مجموعة العناصر التي تقع ضمن هدف أحداث الفأرة أثناء قفل مؤشّر الفأرة. تُعيد القيمة null في حالة كان القفل مُعلّقا، أو في حالة كان المُؤشّر غير مُقفل، أو إذا ما كان الهدف يقع في مُستند آخر. هذه الخاصيّة تجريبيّة. | ||
===DocumentOrShadowRoot.styleSheets=== | ===DocumentOrShadowRoot.styleSheets=== | ||
تُعيد هذه الخاصيّة القابلة للقراءة فقط كائنا من النّوع <code>StyleSheetList</code> أو كائنا من النّوع <code>CSSStyleSheet</code> لصفحات الأنماط المربوطة أو المُضمّنة في المُستند صراحةً. | تُعيد هذه الخاصيّة القابلة للقراءة فقط كائنا من النّوع <code>StyleSheetList</code> أو كائنا من النّوع <code>CSSStyleSheet</code> لصفحات الأنماط المربوطة أو المُضمّنة في المُستند صراحةً. | ||
==مُدبّرات الأحداث== | ==مُدبّرات الأحداث== | ||
===Document.onafterscriptexecute=== | ===Document.onafterscriptexecute=== | ||
تُمثّل شيفرة تدبير الحدث <code>afterscriptexecute</code>. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات. | تُمثّل شيفرة تدبير الحدث <code>afterscriptexecute</code>. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات. | ||
===Document.onbeforescriptexecute=== | ===Document.onbeforescriptexecute=== | ||
تُمثّل شيفرة تدبير الحدث <code>beforescriptexecute</code>. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات. | تُمثّل شيفرة تدبير الحدث <code>beforescriptexecute</code>. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات. | ||
===Document.oncopy=== | ===Document.oncopy=== | ||
تُمثّل شيفرة تدبير الحدث <code>copy</code> . وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات. | تُمثّل شيفرة تدبير الحدث <code>copy</code> . وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات. | ||
===Document.oncut=== | ===Document.oncut=== | ||
تُمثّل شيفرة تدبير الحدث <code>cut</code> . وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات. | تُمثّل شيفرة تدبير الحدث <code>cut</code> . وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات. | ||
مراجعة 20:01، 6 مارس 2018
Document
تُمثّل الواجهة Document أي صفحة ويب مُحمّلة في المُتصفح وتعمل كنُقطة بداية للوصول إلى مُحتوى الصّفحة، أي شجرة DOM التي تشمل عناصر مثل <body> و
، إضافة إلى العديد من العناصر الأخرى. وتُوفِّر إمكانيّة التّعامل بشكل عمومي للمُستند، مثل كيفيّة الحصول على عنوان URL الخاصّ بالصّفحة وكيفيّة إنشاء عناصر جديدة في المُستند.
EventTarget <= Node <= Document
تصِفُ الواجهة الخصائص (properties) والتّوابع (methods) الشّائعة لأي نوع كان من المُستندات. واعتمادا على نوع المُستند (مثل HTML، XML، SVG وغيرها)، يُمكن أن تتوفّر واجهة برمجيّة (API) أكبر وأكثر تخصّصا: مُستندات HTML المُقدّمَة مع نوع المُحتوى ، تعتمد كذلك على الواجهة ، أمّا مُستندات XML و SVG فتعتمد الواجهة .
الدّالة البانيّة
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.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
خاصيّة محذوفة منذ Gecko 10.0، كانت تُعيد القيمة المنطقيّة true إن كان تعريف XML يُحدّد بأنّ المُستند قائم بذاته (أي لو كان جزء خارجي من تعريف نوع المُستند DTD يُؤثّر على مُحتوى المُستند)، أمّا غير ذلك فيُعيد false.
Document.xmlVersion
خاصيّة محذوفة منذ Gecko 10.0، كانت تُعيد رقم الإصدار حسب ما تمّ تحديده في تعريف 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
خاصيّة محذوفة تُعيد عرض المُستند الحالي.
خصائص تم ضمّها من مجموعة الدّوال المُساعدة (mixin) DocumentOrShadowRoot
تشمل واجهة Document الخصائص التّاليّة المُعرَّفة على مجموعة DocumentOrShadowRoot. لاحظ بأنّ هذا مُطبَّق على مُتصفّح Chrome فقط في الوقت الحالي؛ وبقيّة المُتصفحات لا تزال تُطبّقها مُباشرة على واجهة Document.
DocumentOrShadowRoot.activeElement
تُعيد هذه الخاصيّة القابلة للقراءة فقط عنصر Element المتواجد في شجرة الظّل (shadow tree) ذات التّركيز.
Document.fullscreenElement
تُعيد هذه الخاصيّة القابلة للقراءة فقط العنصر الذي يُعتبر في وضع ملء الشّاشة في هذا المُستند.
DocumentOrShadowRoot.pointerLockElement
تُعيد هذه الخاصيّة القابلة للقراءة فقط مجموعة العناصر التي تقع ضمن هدف أحداث الفأرة أثناء قفل مؤشّر الفأرة. تُعيد القيمة null في حالة كان القفل مُعلّقا، أو في حالة كان المُؤشّر غير مُقفل، أو إذا ما كان الهدف يقع في مُستند آخر. هذه الخاصيّة تجريبيّة.
DocumentOrShadowRoot.styleSheets
تُعيد هذه الخاصيّة القابلة للقراءة فقط كائنا من النّوع StyleSheetList أو كائنا من النّوع CSSStyleSheet لصفحات الأنماط المربوطة أو المُضمّنة في المُستند صراحةً.
مُدبّرات الأحداث
Document.onafterscriptexecute
تُمثّل شيفرة تدبير الحدث afterscriptexecute. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.
Document.onbeforescriptexecute
تُمثّل شيفرة تدبير الحدث beforescriptexecute. وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.
Document.oncopy
تُمثّل شيفرة تدبير الحدث copy . وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.
Document.oncut
تُمثّل شيفرة تدبير الحدث cut . وهي خاصيّة غير قياسيّة قد لا تعمل في جميع المُتصفحات.
Document
text/html
HTMLDocument
XMLDocument