نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
Document()
تنبيه: هذه الميّزة غير قياسية وليست متواجدة على مسار قياسيات. لا تستعملها في المواقع الإنتاجية: إذ لن تعمل لجميع المُستخدمين. وقد تكون هناك عدّة حالات من عدم التوافقيّة بين المتصفحات وقد تتغيّر طريقة تصرّف الميّزة في المُستقبل. الدالة البانية Document تُنشئ كائنًا جديدًا من النوع Document، وهو صفحة ويب مُحمّلة في المُتصفّح، ويَعمل كنقطة بداية للوصول إلى مُحتوى الصّفحة. البنية العامة var document = new Document()
المعاملات لا توجد معاملات. دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم ...
Document
تُمثّل الواجهة Document أي صفحة ويب مُحمّلة في المُتصفح وتعمل كنُقطة بداية للوصول إلى مُحتوى الصّفحة، أي شجرة DOM التي تشمل عناصر مثل <body> و <table>، إضافة إلى العديد من العناصر الأخرى. وتُوفِّر إمكانيّة التّعامل بشكل عمومي للمُستند، مثل كيفيّة الحصول على عنوان URL الخاصّ بالصّفحة وكيفيّة إنشاء عناصر جديدة في المُستند. تصِفُ الواجهة Document الخصائص (properties) والتّوابع (methods) الشّائعة لأي نوع كان من المُستندات. واعتمادًا على نوع المُستند (مثل HTML، و XML، و SVG وغيرها)، يُمكن أن تتوفّر واجهة ...
HTML/Topics/Document Metadata
تحتوي البيانات الوصفية على معلومات عن الصفحة، التي تتضمن المعلومات حول الأنماط (styles) والسكربتات، والبيانات المُساعدة للبرمجيات (مثل محركات البحث والمتصفحات ...إلخ.) التي تستخدم الصفحة أو تعرضها. العنصر الوصف <base> تحديد أساس روابط URL لجميع الروابط النسبية (relative URLs) الموجودة في المستند. لا يجوز استخدام أكثر من عنصر <base> في المستند. <head> توفير معلوماتٍ عامةً عن المستند (أي بيانات وصفية)، بما في ذلك عنوان المستند وروابط إلى السكربتات الموجودة فيها وصفحات الأنماط. <link> تحديد العلاقات بين المستند الحالي وبين مورد خارجي (external resource)؛ ...
ParentNode.childElementCount
تُعيد الخاصيّة ParentNode.childElementCount القابلة للقراءة فقط قيمة من النّوع unsigned long تُمثّل عدد العناصِر الأولاد لعنصر مُعيّن. البنية العامة var count = node.childElementCount;
count يحمل القيمة المُعادة، وهي عدد صحيح من النّوع unsigned long. node كائن من النوع Document أو DocumentFragment أو Element. مثال var foo = document.getElementById("foo");
if (foo.childElementCount > 0) {
// افعل شيئا ما
}
إضافة لدعم المتصفحات غير المدعومة تُضيف الشيفرة التّالية دعم الخاصيّة على كلّ من Document وDocumentFragment لمُتصفّحي IE9 وSafari. ;(function(constructor) ...
Document.lastElementChild
تُعيد الخاصيّة Document.lastElementChild القابلة للقراءة فقط آخر عنصِرٍ ابن للكائن، أو القيمة null إن لم يكن هناك أي عنصرٍ ابن. البنية العامة var element = node.lastElementChild;
مثال <ul id="foo">
<li>القيمة الأولى</li>
<li>القيمة الثّانية</li>
<li>القيمة الثّالثة</li>
</ul>
<script>
var foo = document.getElementById('foo');
// تُسجّل القيمة الثّالثة
console.log(foo.lastElementChild.textContent);
</script>
إضافة لدعم المتصفحات غير المدعومة الشيفرة التّالية تكتب فوق الكائن lastElementChild الذي يعد كائنًا من النّوع prototype وتُضيف دعم كلّ من Document وDocumentFragment لمُتصفّحي IE9 وSafari. لكنّها تعيد مصفوفةً عوضًا عن مجموعة من النّوع HTMLCollection. ...
ParentNode.firstElementChild
تُعيد الخاصيّة ParentNode.firstElementChild القابلة للقراءة فقط أول عنصِرٍ ابن للكائن، أو القيمة null إن لم يكن هناك أي عنصرٍ ابن. البنية العامة var element = node.firstElementChild;
مثال <ul id="foo">
<li>القيمة الأولى</li>
<li>القيمة الثّانية</li>
<li>القيمة الثّالثة</li>
</ul>
<script>
var foo = document.getElementById('foo');
// تُسجّل القيمة الأولى
console.log(foo.firstElementChild.textContent);
</script>
إضافة لدعم المتصفحات غير المدعومة الشيفرة التّالية تكتب فوق الكائن firstElementChild الذي يعدّ كائنًا من النّوع prototype وتُضيف دعم كلّ من Document وDocumentFragment لمُتصفّحي IE9 وSafari. لكنّها تعيد مصفوفةً عوضًا عن مجموعة من النّوع HTMLCollection. ;(function(constructor) ...
Document.createAttribute()
يُنشئُ التّابع Document.createAttribute() عقدةَ خاصيّة (attribute node) جديدةً ويُعيدها. الكائن المُنشأ يُعدّ عقدةً تُطبّق الواجهة Attr. لا يُلزِم DOM نوع الخصائص التّي يُمكن إضافتها بهذه الطّريقة. لاحِظ أنّ السلسلة النّصيّة المُعطاة كمعامِل تُحوّل إلى أحرفٍ صغيرة (lowercase). البنية العامة attribute = document.createAttribute(name)
المعاملات name سلسلةٌ نصيّة تحتوي اسم الخاصيّة. القيمة المعادة عقدة من النّوع Attr. الاستثناءات استثناء INVALID_CHARACTER_ERR في حالة احتوى المُعامل محارف غير صالحة لخصائص XML. مثال var node = document.getElementById("div1");
var a = document.createAttribute("my_attrib");
a.value = "newVal";
node.setAttributeNode(a);
console.log(node.getAttribute("my_attrib")); // "newVal"
دعم ...
التابع .live() في jQuery
.live( events, handler ) أهمل مع الإصدار: 1.7، وحذف مع الإصدار: 1.9. القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع معالج حدث معين بجميع العناصر التي طابقت المحدِّد الحالي الآن وفي المستقبل. .live( events, handler ) أُضيف مع الإصدار: 1.3. events سلسلة نصية تحتوي على نوع حدث JavaScript مثل "click" أو "keydown". يمكن للسلسلة النصية بدءًا من الإصدار jQuery 1.4 أن تحتوي على أنواع أحداث متعدِّدة مفصولةً بمسافة فارغة، أو أسماء أحداث مخصَّصة. handler دالة من الشكل ...
Document.createTextNode()
يُنشئ التّابع Document.createTextNode() عقدةً نصيّةً جديدة. البنية العامة var text = document.createTextNode(data);
text عقدةٌ نصيّة. data سلسلةٌ نصيّة تحتوي على البيانات المرغوب إضافتها إلى العقدة النّصيّة. أمثلة <!DOCTYPE html>
<html lang="en">
<head>
<title>createTextNode example</title>
<script>
function addTextNode(text) {
var newtext = document.createTextNode(text),
p1 = document.getElementById("p1");
p1.appendChild(newtext);
}
</script>
</head>
<body>
<button onclick="addTextNode('نعم ');">YES!</button>
<button onclick="addTextNode('لا ');">NO!</button>
<button onclick="addTextNode('نستطيع ');">WE CAN!</button>
<hr />
<p id="p1">أول سطرٍ من الفقرة</p>
</body>
</html>
دعم المتصفحات الميزة Chrome Internet Explorer Firefox Opera Safari الدعم ...
Document.getElementById()
يُعيد التّابع Document.getElementById() كائنًا من النّوع Element يُمثّل العنصر ذو المُعرّف (id) الذي يُوافق السلسلة النّصيّة المُحدّدة. ولأنّ مُعرّفات العناصر لا بدّ لها أن تكون فريدة عند إنشائها، فهي مُفيدة للوصول إلى عنصرٍ مُعيّنٍ بسرعة. إن أردت الوصول إلى عنصر لا يملك مُعرّفًا، يُمكنك استعمال التّابع querySelector() للوصول إلى العنصر بأيّ مُحدِّدٍ كيفما كان. البنية العامة var element = document.getElementById(id);
element كائنٌ من النّوع Element يُمثّل عنصر DOM الذي يوافق مُعرّفه المُعرّف المُعطى، أو القيمة null في حالة لم يوجد ...
Document.documentURI
تُعيد الخاصيّة documentURI الخاصّة بالواجهة Document مكان المستند على شكل سلسلة نصية. هذه الخاصّية قابلة للقراءة فقط في معيار DOM المُعاصر. البنية العامّة var string = document.documentURI;
ملاحظات مستندات HTML تمتلك خاصيّة document.URL التي تُعيد نفس القيمة. الفرق بينهما هو أنّ documentURI مُتاحة على جميع أنواع المستندات. دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari قابليّة القراءة والكتابة نعم نعم نعم ؟ نعم قابلية القراءة فقط 43 نعم لا ؟ لا مصادر ومواصفات مواصفة DOM. مواصفة Document Object Model ...
Document.children
تُعيد الخاصيّة children القابلة للقراءة فقط والمُعرّفة على الواجهة ParentNode كائنا من النّوع HTMLCollection الذي يحتوي على جميع العناصِرِ الأولاد الخاصّة بالعقدة التي استُدعَت عليها. البنية العامة var children = node.children;
القيمة القيمة المُعادة عبارة عن كائن من النّوع HTMLCollection والذي هو مجموعة حيّة ومُرتّبة من عناصر DOM الذين هم أولاد العقدة. يُمكنك الوصول إلى العقد الأولاد كل على حدة في المجموعة عبر استعمال إمّا التّابع item() على المجموعة أو باستعمال طريقة الوصول إلى المصفوفات في JavaScript. إن لم يكن ...
Document.doctype
تُعيد تعريف نوع المُستند (DTD) المُرتبط بالمُستند الحاليّ. الكائن المُعاد يُطبّق الواجهة DocumentType. استعمل DOMImplementation.createDocumentType() لإنشاء الواجهة DocumentType. البنية العامّة doctype = document.doctype;
doctype خاصيّة قابلة للقراءة فقط. مثال var doctypeObj = document.doctype;
console.log(
"doctypeObj.name: " + doctypeObj.name + "\n" +
"doctypeObj.internalSubset: " + doctypeObj.internalSubset + "\n" +
"doctypeObj.publicId: " ...
التابع jQuery.parseHTML() في jQuery
jQuery.parseHTML( data [, context ] [, keepScripts ] ) القيم المعادة يعيد مصفوفةً (Array). الوصف يفسِّر هذا التابع سلسلة نصية تحتوي على شيفرة HTML ثمَّ يعيد مصفوفة من عقد DOM. jQuery.parseHTML( data [, context ] [, keepScripts ] ) أُضيف مع الإصدار: 1.8. data سلسلة نصية تحوي شيفرة HTML التي يراد تفسيرها. context عنصرٌ يمثِّل السياق الذي سيُنشَأ فيه محتوى HTML المُفسَّر. القيمة الافتراضيَّة هي العنصر document. keepScripts قيمةٌ منطقيَّةٌ تحدِّد إن كان يراد إضافة السكربتات الموجودة في شيفرة HTML ...
التابع jQuery.parseHTML() في jQuery
jQuery.parseHTML( data [, context ] [, keepScripts ] ) القيم المعادة يعيد مصفوفةً (Array). الوصف يفسِّر هذا التابع سلسلة نصية تحتوي على شيفرة HTML ثمَّ يعيد مصفوفة من عقد DOM. jQuery.parseHTML( data [, context ] [, keepScripts ] ) أُضيف مع الإصدار: 1.8. data سلسلة نصية تحوي شيفرة HTML التي يراد تفسيرها. context عنصرٌ يمثِّل السياق الذي سيُنشَأ فيه محتوى HTML المُفسَّر. القيمة الافتراضيَّة هي العنصر document. keepScripts قيمةٌ منطقيَّةٌ تحدِّد إن كان يراد إضافة السكربتات الموجودة في شيفرة HTML ...
التابع .ready() في jQuery
.ready( handler ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف ينفِّذ هذا التابع دالةً عندما تكون شجرة DOM جاهزة. .ready( handler ) أُضيف مع الإصدار: 1.0. handler الدالة المراد تنفيذها بعد أن تصبح DOM جاهزة. يوفر التابع .ready() طريقة لتشغيل شيفرة JavaScript حالما يصبح بالإمكان تعديل DOM بشكل آمن. يُعدُّ هذا الوقت غالبًا أفضل الأوقات لإنجاز مهامٍ ضرورية قبل أن يشاهد المستخدم الصفحة أو يتفاعل معها مثل إضافة معالجات أحداث أو تهيئة إضافات معيَّنة. عندما تُضاف دوال متعدِّدة عبر ...
التابع .ajaxSend() في jQuery
.ajaxSend( handler ) القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع .ajaxSend( handler ) في إرفاق دالة لتنفيذها قبل إرسال طلب Ajax، يُعدُّ هذا التّابع حدثًا من أحداث Ajax. .ajaxSend( handler ) أضيفت في الإصدار 1.0. handler دالة على الشكل Function( Event event, jqXHR jqXHR, PlainObject ajaxOptions )، وهي الدالة المطلوب استدعاؤها. عندما يكون طلب Ajax على وشك أن يُرسَل، تُطلِق jQuery الحدث ajaxSend. تُنفَّذ حينها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع .ajaxSend(). لمشاهدة مثال عملي عن هذا التّابع نُجهِّز طلب بسيط ...
التابع .ajaxComplete() في jQuery
.ajaxComplete( handler ) القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع .ajaxComplete() لتسجيل مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال طلبات Ajax. يُعدُّ هذا التّابع حدثًا من أحداث Ajax. .ajaxComplete( handler ) أضيفت في الإصدار: 1.0. handler دالة على الشكل Function( Event event, jqXHR jqXHR, PlainObject ajaxOptions )،وهي الدالة التي ستُستدعى. حالما يكتمل تنفيذ طلب Ajax، تُطلَق jQuery الحدث ajaxComplete، وتُنفَّذ عندها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع.ajaxComplete() . لمشاهدة مثال عملي عن هذا التّابع نُجهِّز طلب بسيط لتحميل Ajax: <button ...
Document.body
تعيد هذه الخاصية عُقدة العنصر <body> أو <frameset> الخاصّة بالمُستند الحالي، أو تعيد null إن لم يتواجد أي عنصر من هذا القبيل. البنية العامة var objRef = document.body;
document.body = objRef;
مثال // نضع في ملفّ HTML:
// <body id="oldBodyElement"></body>
alert(document.body.id); // "oldBodyElement"
var aNewBodyElement = document.createElement("body");
aNewBodyElement.id = "newBodyElement";
document.body = aNewBodyElement;
alert(document.body.id); // "newBodyElement"
ملاحظات document.body يمثِّل العنصر الذي يحتوي على مُحتوى المُستند. في مُستندات ذات مُحتويات <body>، يُعاد العنصر <body>، أمّا في مُستندات <frameset>، فسيُعاد العنصر <frameset> الخارجي. ورغم أنّك تستطيع تعيين قيمة ...
التابع .ajaxSuccess() في jQuery
.ajaxSuccess( handler ) القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع .ajaxSuccess() لإرفاق دالة لتنفيذها عند اكتمال تنفيذ طلب Ajax، يُعدُّ هذا التّابع حدثًا من أحداث Ajax. .ajaxSuccess( handler ) أضيفت في الإصدار: 1.0. handler دالة على الشكل Function( Event event, jqXHR jqXHR, PlainObject ajaxOptions, PlainObject data )، وهي الدالة المطلوب استدعاؤها. عندما يكتمل تنفيذ طلب Ajax، تُطلِق jQuery الحدث ajaxSuccess، وتُنفَّذ عندها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع .ajaxSuccess(). لمشاهدة مثال عملي عن هذا التّابع نُجهِّز طلب بسيط لتحميل Ajax: ...
التابع .ajaxError() في jQuery
.ajaxError( handler ) القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع .ajaxError() لتسجيل مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال تنفيذ طلب Ajax مع حدوث خطأ، يُعدُّ هذا التّابع حدثًا من أحداث Ajax. .ajaxError( handler ) أضيفت في الإصدار 1.0. handler دالة على الشكل Function( Event event, jqXHR jqXHR, PlainObject ajaxSettings, String thrownError )، وهي الدالة المطلوب استدعاؤها. حالما يكتمل تنفيذ طلب Ajax، تُطلِق jQuery الحدث ajaxError. وتُنفَّذ عندها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع .ajaxError(). ملاحظة: لا يُستدعى مُعالِج الأحداث ...
التابع .ajaxStart() في jQuery
.ajaxStart( handler ) القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع .ajaxStart() في تسجيل مُعالِج الأحداث (Event handler) لاستدعائه عند بدء أول طلب Ajax، يُعدُّ هذا التّابع حدثًا من أحداث Ajax. .ajaxStart( handler ) أضيفت في الإصدار: 1.0. handler يُمثِّل الدالة المطلوب استدعاؤها. عندما يكون طلب Ajax على وشك أن يُرسَل، تتحقّق jQuery ما إذا كانت هناك طلبات Ajax أخرى، وإن لم يكن هناك أي طلب قيد المعالجة تُطلِق jQuery الحدث ajaxStart، وتُنفَّذ عندها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع .ajaxStart(). ...
التابع .ajaxStop() في jQuery
.ajaxStop( handler ) القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع .ajaxStop() في تسجيل مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال تنفيذ جميع طلبات Ajax، يُعدُّ هذا التّابع حدثًا من أحداث Ajax. .ajaxStop( handler ) أضيفت في الإصدار: 1.0. handler يُمثِّل الدالة المطلوب استدعاؤها. عندما يكتمل تنفيذ طلب Ajax، تتحقّق jQuery ما إذا كانت هناك طلبات Ajax أخرى، وإن لم يكن هناك أي طلب تُطلِق jQuery الحدث ajaxStop، وتُنفَّذ عندها كافّة مُعالجات الأحداث المُسجَّلة مع التّابع .ajaxStop(). يُطلَق الحدث ajaxStop أيضًا ...
التابع jQuery.sub() في jQuery
jQuery.sub( ) أهمل مع الإصدار: 1.7. حذف مع الإصدار: 1.9. القيم المعادة يعيد كائنًا من النوع jQuery. الوصف ينشئ هذا التابع نسخةً جديدةً من jQuery للتمكن من تعديل خاصِّيَّاتها وتوابعها دون المساس بالمكتبة الأصليَّة. jQuery.sub( ) أُضيفت مع الإصدار: 1.5. لا يقبل هذا التابع أية وسائط. أهمل هذا التابع بدءًا من الإصدار jQuery 1.7 وسيُنقل إلى إضافةٍ في الإصدار jQuery 1.8. هنالك حالتان خاصَّتان أنشئ التابع jQuery.sub() من أجلهما. الحالة الأولى هي من أجل توفير طريقة للتحكم بتوابع jQuery دون ...
التابع jQuery.sub() في jQuery
jQuery.sub( ) أهمل مع الإصدار: 1.7. حذف مع الإصدار: 1.9. القيم المعادة يعيد كائنًا من النوع jQuery. الوصف ينشئ هذا التابع نسخةً جديدةً من jQuery للتمكن من تعديل خاصِّيَّاتها وتوابعها دون المساس بالمكتبة الأصليَّة. jQuery.sub( ) أُضيفت مع الإصدار: 1.5. لا يقبل هذا التابع أية وسائط. أهمل هذا التابع بدءًا من الإصدار jQuery 1.7 وسيُنقل إلى إضافةٍ في الإصدار jQuery 1.8. هنالك حالتان خاصَّتان أنشئ التابع jQuery.sub() من أجلهما. الحالة الأولى هي من أجل توفير طريقة للتحكم بتوابع jQuery دون ...
الوصول إلى الخاصيات في JavaScript
طرائق الوصول إلى الخاصيات توفِّر وصولًا إلى خاصيات أحد الكائنات باستخدام طريقة النقط أو طريقة الأقواس. البنية العامة object.property
object['property']
الوصف يمكننا عدّ الكائنات على أنها مصفوفات ترابطية (أي associative array، ويُطلَق عليها أيضًا map و dictionary و hash و lookup table)، وتكون المفاتيح (keys) في المصفوفة هي أسماء خاصيات الكائن. من الشائع عند حديثنا عن خاصيات الكائنات التفريق بين الخاصيات (properties) والدوال التابعة للكائن، لكن تقنيًا تكون الدوال هي خاصيات مُنشَأة من الكائن Function. هنالك طريقتان للوصول إلى خاصيات الكائنات: ...
التابع jQuery.isXMLDoc() في jQuery
jQuery.isXMLDoc( node ) أهمل مع الإصدار: 3.3. القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كانت عقدة DOM المُمرَّر إليه ضمن مستند XML (أو هل هو مستند XML) أم لا. jQuery.isXMLDoc( node ) أُضيف مع الإصدار: 1.1.4. node عقدة DOM التي يراد التحقُّق منها لمعرفة إن كانت ضمن مستند XML. أمثلة التحقُّق من عقدة DOM لمعرفة إن كانت ضمن مستند XML: jQuery.isXMLDoc( document ) // false
jQuery.isXMLDoc( document.body ) // false
مصادر صفحة التابع ()jQuery.isXMLDoc في توثيق jQuery ...
التابع jQuery.isXMLDoc() في jQuery
jQuery.isXMLDoc( node ) أهمل مع الإصدار: 3.3. القيم المعادة يعيد قيمةً منطقيَّةً (Boolean). الوصف يتحقَّق هذا التابع إن كانت عقدة DOM المُمرَّر إليه ضمن مستند XML (أو هل هو مستند XML) أم لا. jQuery.isXMLDoc( node ) أُضيف مع الإصدار: 1.1.4. node عقدة DOM التي يراد التحقُّق منها لمعرفة إن كانت ضمن مستند XML. أمثلة التحقُّق من عقدة DOM لمعرفة إن كانت ضمن مستند XML: jQuery.isXMLDoc( document ) // false
jQuery.isXMLDoc( document.body ) // false
مصادر صفحة التابع ()jQuery.isXMLDoc في توثيق jQuery ...
سلاسل التوثيق النصية في بايثون
يمكن أن تكون العبارة الأولى في كتلة الدالة سلسلة نصّية، وتمثّل سلسلة التوثيق النصية الخاصة بتلك الدالة ويطلق عليها أيضًا تسمية docstring. هناك أدوات تستخدم سلاسل التوثيق النصية لإنتاج توثيق عبر شبكة الإنترنت، أو تسمح للمستخدم بتصفح الشيفرة بصورة تفاعلية؛ لذا ينصح باستخدام سلاسل التوثيق النصية في الشيفرة التي تكتبها. يجب أن يكون السطر الأول قصيرًا ومقتضبًا ويقدّم لمحة مختصرة عن الغرض من إنشاء الكائن، ولأجل الاختصار يجب أن لا يتضمن السطر الأول اسم الكائن أو نوعه؛ فهناك وسائل أخرى ...
سلاسل التوثيق النصية في بايثون
يمكن أن تكون العبارة الأولى في كتلة الدالة سلسلة نصّية، وتمثّل سلسلة التوثيق النصية الخاصة بتلك الدالة ويطلق عليها أيضًا تسمية docstring. هناك أدوات تستخدم سلاسل التوثيق النصية لإنتاج توثيق عبر شبكة الإنترنت، أو تسمح للمستخدم بتصفح الشيفرة بصورة تفاعلية؛ لذا ينصح باستخدام سلاسل التوثيق النصية في الشيفرة التي تكتبها. يجب أن يكون السطر الأول قصيرًا ومقتضبًا ويقدّم لمحة مختصرة عن الغرض من إنشاء الكائن، ولأجل الاختصار يجب أن لا يتضمن السطر الأول اسم الكائن أو نوعه؛ فهناك وسائل أخرى ...
Document.links
تُعيد الخاصية document.links مجموعةً تحتوي على جميع عناصر و<area> الموجودة في المُستند مع قيمة للخاصيّة href. البنية العامة nodeList = document.links;
مثال var links = document.links;
for(var i = 0; i < links.length; i++) {
var linkHref = document.createTextNode(links[i].href);
var lineBreak = document.createElement("br");
document.body.appendChild(linkHref);
document.body.appendChild(lineBreak);
}
دعم المتصفحات الميزة Chrome Edge Firefox Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مواصفة HTML Living Standard مواصفة Document Object Model (DOM) Level 2 HTML Specification
Document.pointerLockElement
تُعيد هذه الخاصيّة القابلة للقراءة فقط مجموعة العناصر التي تقع ضمن هدف أحداث الفأرة أثناء قفل مؤشّر الفأرة. تُعيد القيمة null في حالة كان القفل مُعلّقا، أو في حالة كان المُؤشّر غير مُقفل، أو إذا ما كان الهدف يقع في مُستند آخر. البنية العامة var element = document.pointerLockElement;
القيمة المُعادة تكون إمّا كائنًا من النّوع Element أو القيمة null. دعم المتصفحات الميزة Chrome Internet Explorer Firefox Opera Safari الدعم الأساسي 53 نعم نعم 40 نعم انظر أيضًا Document.exitPointerLock() Element.requestPointerLock() مصادر ...
Document.URL
خاصيّة document.URL قابلة للقراءة فقط تُعيد مكان المُستند (أي عنوان URL) في سلسلةٍ نصيّة. البنية العامة var string = document.URL
مثال في الجزء الخاصّ بلغة JavaScript، نضع: document.getElementById("url").textContent = document.URL;
جزء HTML: <p id="urlText">
URL:<br/>
<span id="url">مكان المُستند سيظهرُ هنا</span>
</p>
دعم المتصفحات الميزة Chrome Internet Explorer Firefox Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مواصفة HTML Living Standard حدّدت هذه المُواصفة أنّ الخاصيّة سلسلة نصيّة من النّوع USVString عوضا عن DOMString. مواصفة Document Object ...
Document.createTreeWalker()
يُنشئ التّابع Document.createTreeWalker() كائنًا جديدًا من النّوع TreeWalker ويُعيده. البنية العامة treeWalker = document.createTreeWalker(root, whatToShow, filter, entityReferenceExpansion);
المعاملات root العقدة Node الجذر لمرور الكائن TreeWalker. عادةً ما يكون عنصرًا مملوكًا من طرف المُستند. whatToShow قيمة اختياريّةٌ من النّوع unsigned long تُمثّل قيمة bitmask تُنشأُ عبر دمج الخاصيّات الثّابتة الخاصّة بالكائن NodeFilter. وهي طريقة جيّدة لترشيح بعض أنواع العقد. القيمة الافتراضيّة هي 0xFFFFFFFF وتُمثّل الثّابتة SHOW_ALL. الثّابتة القيمة الرّقميّة الوصف NodeFilter.SHOW_ALL -1 (وهي القيمة القصوى للنّوع unsigned long) اعرض جميع العقد. ...
التابع jQuery.readyException() في jQuery
jQuery.readyException( error ) القيم المعادة يعيد مُحدِّدًا (Selector). الوصف يعالج هذا التابع الأخطاء التي رميت في الدوال المُغلَّفَة في jQuery() بشكل متزامن. jQuery.readyException( error ) أُضيفت مع الإصدار: 3.1. error خطأٌ رُمِيَ في الدالة المُغلَّفَة في jQuery(). يُطلق هذا التابع عدما يُرمَى خطأٌ في الدالة المغلَّفة في jQuery() أو jQuery( document ).ready() أو ما شابههما. يعيد هذا التابع افتراضيًّا رَمْيَ الخطأ عىل شكل timeout وبذلك يُسجل دخولها إلى الطرفيَّة (console) وتمرَّر إلى window.onerror بدلًا من اختفائها دون سدًى. استَبدل هذا ...
التابع jQuery.readyException() في jQuery
jQuery.readyException( error ) القيم المعادة يعيد مُحدِّدًا (Selector). الوصف يعالج هذا التابع الأخطاء التي رميت في الدوال المُغلَّفَة في jQuery() بشكل متزامن. jQuery.readyException( error ) أُضيفت مع الإصدار: 3.1. error خطأٌ رُمِيَ في الدالة المُغلَّفَة في jQuery(). يُطلق هذا التابع عدما يُرمَى خطأٌ في الدالة المغلَّفة في jQuery() أو jQuery( document ).ready() أو ما شابههما. يعيد هذا التابع افتراضيًّا رَمْيَ الخطأ عىل شكل timeout وبذلك يُسجل دخولها إلى الطرفيَّة (console) وتمرَّر إلى window.onerror بدلًا من اختفائها دون سدًى. استَبدل هذا ...
Document.head
تُعيد الخاصية document.head العنصر <head> الخاصّ بالمُستند الحالي. إن كان للمُستند أكثر من عنصر <head> واحد، فالقيمة المُعادة ستُمثّل العنصر الأول. البنية العامة var objRef = document.head;
مثال // نضع ما يلي
// في ملفّ
// HTML
// <head id="my-document-head">
var aHead = document.head;
alert(aHead.id); // "my-document-head";
alert( document.head === document.querySelector("head") ); // true
ملاحظات الخاصيّة document.head للقِراءة فقط. مُحاولة ضبط قيمة لها سيفشَل دون أي أخطاء، أو سيرمي خطأ TypeError في مُتصفّح Firefox في حالة كان المستند في نمط strict. دعم المتصفحات الميزة Chrome Edge ...
Document.documentElement
تُعيد عنصر Element الذي هو العنصر الجذر في المستند document (على سبيل المثال، العنصر <html> في مستندات HTML). البنية العامّة var element = document.documentElement;
مثال var rootElement = document.documentElement;
var firstTier = rootElement.childNodes;
for (var i = 0; i < firstTier.length; i++) {
// نفّذ عمليّة ما مع كل واحد من الأولاد المُباشِرين للعنصر الجذر
// firstTier[i]
}
في المثال أعلاه، المتغير firstTier هو كائن من النوع NodeList الذي يحوي الأولاد المُباشِرين للعنصر الجذر. ملاحظات مُستندات HTML تحتوي في ...
Document.forms
تُعيد الخاصّية forms مجموعة من النّوع HTMLCollection تحتوي على جميع عناصِر <form> في المُستند. ملاحظة: يُمكنك كذلك استعمال الخاصيّة HTMLFormElement.elements للحصول على قائمةٍ بعناصِر نماذج الإدخال بشكلٍ مُشابه. البنية العامة collection = document.forms;
القيمة كائنٌ من النّوع HTMLCollection يُمثّل قائمةً بجميع النّماذج في المُستند. كلّ عنصر من المجموعة يُعدّ من النّوع HTMLFormElement ويُمثّل عنصر <form> وحيد. إن لم يوجد أي نموذج في المُستند، فالمجموعة المُعادة ستكون فارغة بطولٍ يُساوي صفرًا. أمثلة الحصول على معلومات نموذج مُعيّن: <!DOCTYPE html>
<html lang="en">
...
التابع .keydown() في jQuery
.keydown( handler ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع معالج حدث معين مع الحدث keydown (الضغط على مفتاح في لوحة المفاتيح) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر. .keydown( handler ) أُضيف مع الإصدار: 1.0. handler دالة من الشكل Function( Event eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُستدعى فيها الحدث. .keydown( [eventData ], handler ) أُضيف مع الإصدار: 1.4.3. eventData أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى ...
التابع .height() في jQuery
يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة أو يغير الطول لكل العناصر المتطابقة. .height() القيم المعادة عدد من النوع Number. الوصف يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة سابقًا. .height() أضيف مع الإصدار 1.0، ولا يقبل هذا التابع أي معاملات. الفرق بين التابع .css( "height" ) والتابع .height() هو أن الأخير يعيد قيمة الطول بدون واحدة (يعيد 400 مثلًا)، بينما يعيد التابع الأول قيمة الطول مع واحدة (يعيد 400px مثلًا). يفضل استعمال ...
Document.evaluate()
يُنشئ التّابع Document.evaluate() كائنًا من النّوع XPathResult مبني على تعبير XPath ومعاملات معطاة أخرى. البنية العامة var xpathResult = document.evaluate(
xpathExpression,
contextNode,
namespaceResolver,
resultType,
result
);
xpathExpression سلسة نصيّة تُمثّل تعبير XPath المرغوب تقديره (evaluate). contextNode يُحدّد عقدة السّياق للاستعلام (انظر مواصفة XPath). من الشّائع تمرير كائن المستند document كعقدة سياق. namespaceResolver دالّة تُمرَّر لها سابقات مجالات الأسماء (namespace prefixes) لتُعيد سلسلةً نصيّة تُمثّل عنوان URI مجال الأسماء المرتبط بالسّابقة المُمرَّرة. ستُستعمل لحلّ السّابقات داخل تعبير XPath ...
الخاصية .jquery في jQuery
الخاصية .jquery القيم المعادة تعيد سلسلة نصية من النوع String. الوصف يُسند إلى هذه الخاصِّية سلسلة نصية تحتوي على رقم إصدار jQuery. jquery أُضيف مع الإصدار: 1.0. الخاصِّيَّة .jquery هي سلسلة نصية تحتوي على رقم إصدار jQuery مثل "1.5.0" أو "1.4.4"، وتُسند إلى نموذج jQuery الأولي، ويشار إليها عادةً عبر الاسم البديل $.fn. أمثلة تحديد إن كان كائنٌ ما هو كائن jQuery: $(function() {
// أصبحت الصفحة جاهزة
});
استعمال اختصار للشكل $(document).ready() ووسيط لكتابة شيفرة الفشل الآمن (failsafe) في jQuery ...
Document.images
تُعيد الخاصيّة Document.images مجموعة الصور الموجودة في مُستند HTML الحاليّ. البنية العامة var imageCollection = document.images;
القيمة مجموعةٌ من النّوع HTMLCollection تحتوي على قائمة بجميع الصّور الموجودة في المُستند الحالي. كلّ عنصر في المجموعة يُعدّ من النّوع HTMLImageElement ويُمثّل عنصر صورة واحد. ملاحظات حول استعمال الخاصية يُمكنك استعمال إمّا طريقة المصفوفات أو التّابع item() على المجموعة المُعادة للوصول إلى عناصر المجموعة. المثالان التّاليّان لهما نفس التّأثير: firstImage = imageCollection(0);
firstImage = imageCollection[0];
مُلاحظة: الخاصيّة Document.images مُتاحة في مُستندات HTML فقط. مثال ...
التابع .keyup() في jQuery
.keyup( handler ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع معالج حدث معين مع الحدث keyup (الضغط على مفتاح في لوحة المفاتيح) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر. .keyup( handler ) أُضيف مع الإصدار: 1.0. handler دالة من الشكل Function( Event eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُستدعى فيها الحدث. .keyup( [eventData ], handler ) أُضيف مع الإصدار: 1.4.3. eventData أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى ...
الدالة get_resource_type() في PHP
(PHP 4 >= 4.0.2, PHP 5, PHP 7) تُعيد الدالة get_resource_type() نوع المورد المُعطى لها. الوصف string get_resource_type ( resource $handle )
تُعطي هذه الدالة نوع المورد المُعطى لها. المعاملات handle مقبض للمورد المطلوب تقييمه. القيم المعادة عندما يكون المقبض handle عبارة عن مورد، فستُعيد هذه الدالة سلسلة نصّيّة تُمثِّل نوعه. وإن لم تتعرّف هذه الدالة على النّوع تكون القيمة المُعادة هي السلسلة النصّيّة Unknown. إن لم يكن المقبض handle موردًا ستولِّد هذه الدالة خطأً وتُعيد القيمة NULL. سجل التغييرات الإصدار ...
Document.timeline
تنبيه: هذه تقنيّة تجريبيّة، انظر جدول دعم المُتصفحات قبل استعمال هذه الخاصيّة في شيفرة إنتاجيّة. تُعيد الخاصيّة القابلة للقراءة فقط timeline المُعرَّفة على الواجهة Document الخطَّ الزمني الافتراضي للمُستند الحالي. هذا الخط الزّمني كائن خاص من النوع DocumentTimeline الذي يُنشأ تلقائيا عند تحميل الصّفحة. الخطّ الزمني فريد لكل مستند ويبقى طيلة مُدّة بقاء المُستند حيًّا، ما يشمل استدعاءات التّابع document.open(). تُحسب القيم الزمنية لهذا الخط الزمني حسب حدّ ثابت (fixed offset) من السّاعة العموميّة بحيث يُكافئ وقتُ الصّفر (zero time) ...
Document.getElementsByName()
يُعيد التّابع Document.getElementsByName() قائمة العقد ذات الخاصيّة name المعطاة في مستند HTML. البنية العامة elements = document.getElementsByName(name)
elements كائن حيّ من النّوع NodeList يُمثّل مجموعة العناصر التي وُجدت. name قيمة الخاصيّة name الخاصّة بالعنصر. مثال <!DOCTYPE html>
<html lang="en">
<head>
...
</head>
<body>
<form name="up"><input type="text"></form>
<div name="down"><input type="text"></div>
<script>
var up_forms = document.getElementsByName("up");
console.log(up_forms[0].tagName); // "FORM"
</script>
</body>
</html>
ملاحظات الخاصيّة name تعمل فقط على مستندات HTML و XHTML. يُعيد التّابع كائنًا حيًّا من النّوع NodeList يحتوي مجموعة العناصر ذات الاسم الذي يوافق المعامل المعطى، مثل عناصر <meta> و <object> أو ...
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() يسمح لك بالكتابة فوق المستند الحالي ...
Document.createDocumentFragment()
يُنشئُ التّابع Document.createDocumentFragment() كائنا فارغًا من النّوع DocumentFragment. البنية العامة var fragment = document.createDocumentFragment();
fragment مرجِع يُشير إلى كائن فارغ من النّوع DocumentFragment. وصف كائنات DocumentFragment هي عقدُ DOM. ولا تكون أبدًا جزءًا من شجرة DOM الأساسيّة. الغرض منها يكون عادةً إنشاء قطعة مُستندٍ (document fragment) ثمّ إضافة عناصرَ إليها، ثمّ إضافة قطعة المُستند إلى شجرة DOM. وتُبدَلُ قطعة المستند في شجرة DOM بجميع أولادها. ولأنّ قطعة المُستند تُخزَّن في الذّاكرة ولا تكون جزءًا من شجرة DOM الرّئيسيّة، فإضافة أولاد ...
دمج التصريحات في TypeScript
مقدمة تصِف بعض المبادئ الفريدة الموجودة في لغة TypeScript شكل كائنات JavaScript على مستوى الأنواع. مبدأ دمج التصريحات (declaration merging) من المزايا التي تنفرد بها TypeScript. سيُساعد فهم هذا المبدأ على العمل مع شيفرة JavaScript الموجودة مسبقًا. إضافة إلى أنّها توفّر قدرة على إعمال مبادئ تجريد (abstraction concepts) أكثر تقدّمًا. نعني بدمج التصريحات في هذه الصفحة بأنّ المترجم يدمج تصريحين مختلفين لهما نفس الاسم في تعريف واحد. يمتلك هذا التعريف المندمج مزايا التصريحين الأصليّين. يُمكن دمج أي عدد من التصريحات، ...
التابع .keypress() في jQuery
.keypress( handler ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع معالج حدث معين مع الحدث keypress (الضغط على مفتاح في لوحة المفاتيح) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر. .keypress( handler ) أُضيف مع الإصدار: 1.0. handler دالة من الشكل Function( Event eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُستدعى فيها الحدث. .keypress( [eventData ], handler ) أُضيف مع الإصدار: 1.4.3. eventData أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى ...
الدالة nl2br() في PHP
(PHP 4, PHP 5, PHP 7) تُضيف الدالة nl2br() العنصر <br> في لغة HTML قبل كل سطر في السلسلة النصية. الوصف string nl2br ( string $string [, bool $is_xhtml = TRUE ] )
تُعيد الدالة nl2br() سلسلة نصية تحتوي على العنصر <br> قبل كل سطر فيها (يُشار إلى السطر الجديد بالرموز \r\n و \n\r و \n و \r). المعاملات str السلسلة النصية المُدخلة. is_xhtml لبيان ضرورة استعمال الوسوم المتوافقة مع لغة XHTML من عدمه (أي استخدام <br /> بدلًا من <br>). ...
Document.visibilityState
تُعيد الخاصيّة Document.visibilityState القابلة للقراءة فقط حالةَ ظهور المُستند، أي سياق وضوح العنصر الحالي. إذ من المُفيد معرفة ما إذا كان المُستند في الخلفيّة أو في تبويب (لسان، tab) غير مرئي حاليًّا، أو أنّ الصّفحة قد حُمّلت فقط من أجل ما قبل التّصيير (pre-rendering). القيم المُمكنة هي كما يلي: 'visible': تُشير إلى أنّ مُحتويات الصّفحة قد تكون ظاهرة ولو جزئيّا. هذا يعني بأنّ الصفحة موجودة على تبويب أمامي في نافذة غيرِ مُصغّرة. 'hidden': مُحتويات الصّفحة غير واضحة للمستخدم. هذا يعني ...
Document.cookie
تُستعمل هذه الخاصيّة للحصول على ملفّات الارتباط (cookies) المُرتبطة بالمُستند الحالي وضبطها، للتعامل مع ملفّات الارتباط ببساطة أكثر، انظر إطار العمل البسيط هذا. البنية العامة الحصول على جميع ملفّات تعريف الارتباط المتاحة allCookies = document.cookie;
المُتغيّر allCookies أعلاه عبارة عن سلسلة نصيّة تحتوي على قائمة بجميع ملفات الارتباط مفصولة بفاصلة منقوطة (;)، وهي على شكل مفتاح=قيمة. ضبط ملفّ ارتباط جديد document.cookie = newCookie;
في الشيفرة أعلاه، المُتغيّر newCookie عبارة عن سلسلة نصيّة على شكل مفتاح=قيمة. لاحظ أنّك تستطيع أن تضبط أو تُحدّث ...
الدالة jQuery() في jQuery
تعيد هذه الدالة مجموعةً من العناصر المطابقة التي إمَّا وُجدَت في شجرة DOM بناءً على الوسائط المُمرَّرة، أو أنشئت بتمرير سلسلة نصية تحتوي على محتوى HTML. jQuery( selector [, context ] ) القيم المعادة تعيد كائنًا من النوع jQuery. الوصف تقبل هذه الدالة سلسلة نصية تحتوي على محدِّد CSS يُستعمَل لمطابقة مجموعة من العناصر. jQuery( selector [, context ] ) أُضيفت مع الإصدار: 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد. context عنصر DOM، أو كائن Document، أو كائن jQuery ...
Document.getElementsByClassName()
يُعيد التّابع Document.getElementsByClassName() كائنًا مُشابهًا للمصفوفات يحتوي على جميع العناصر الأولاد التي تحمل نفس اسم الصّنف (class name) المُعطى. عند استدعائه على كائن المُستند، فسيُبحَثُ في كامل المُستند، ما يشمل العقدة الجذر. يُمكن كذلك استدعاء التّابع getElementsByClassName() على أي عنصر؛ وسيُعيد العناصر الأولاد للعنصر الجذر المُحدَّد ذات أسماء الأصناف المعطاة. البنية العامة var elements = document.getElementsByClassName(names);
// أو
var elements = rootElement.getElementsByClassName(names);
elements كائنٌ حيّ من النّوع HTMLCollection الذي يُمثّل مجموعة العناصِر التي وُجدت. names سلسلةٌ نصيّةٌ تُمثّل قائمة أسماء الأصناف المرغوب ...
Document.domain
تُستعمل للحصول على نطاقِ أصلِ المُستند الحالي أو ضبطه. وذلك حسب سياسة الأصل الواحد (same origin policy). البنية العامة var domainString = document.domain;
document.domain = string;
مثال // للمُستند
// www.example.xxx/good.html
// يُغلق هذا البرنامج النّافذة
var badDomain = "www.example.xxx";
if (document.domain == badDomain) {
window.close(); // هذا مُجرّد مثال، إذ أنّ هذا السّطر لا يقوم بأي شيء في بعض الأحيان
}
// إن كان الرّابط مثلا
// https://wiki.hsoub.com/JavaScript/Document
// فستُضبط القيمة التّاليّة للمُتغيّر
// "wiki.hsoub.com"
var domain = document.domain;
ملاحظات تُعيد هذه الخاصيّة القيمة null في حالة ...
Document.readyState
تصِفُ الخاصيّة Document.readyState حالة تحميل المُستند. البنية العامة var string = document.readyState;
القيم يُمكن للخاصيّة أن تحمِل القيم التّاليّة: "loading" المُستند لا يزال قيد التّحميل "interactive" تحميل المُستند قد انتهى، لكنّ الموارد الفرعيّة كالصّور وصفحات الأنماط والإطارات لا تزال قيد التّحميل "complete" انتهى تحميل المُستندِ وجميع موارِده الفرعيّة. هذه الحالة تُشير إلى أنّ الحدث load سيُطلَق فورًا. يُطلَق الحدث readystatechange على كائن المُستند document عند كلّ تغيّر لقيمة هذه الخاصيّة. أمثلة الحالات المُختلفة لجاهزيّة المُستند: switch (document.readyState) {
case ...
توسعة Sass
توفر Sass عددًا من التّخصيصات المتقدِّمة لأجل المستخدمين ذوي المتطلبات الفريدة. استخدام هذه الميزات يتطلب فهمًا جيدًا للغة Ruby. تعريف دوال مخصَّصةٍ في Sass يمكن للمستخدمين تعريف دوال Sass خاصةً بهم باستخدام Ruby API. انظر لمزيدٍ من المعلومات توثيق الدوال. التخزين المؤقت (Cache Stores) تُخزِّن Sass مؤقتًا الملفّات المُحلّلة (parsed documents) وبذلك يمكن إعادة استخدامها دون إعادة تحليلها إلّا إن حدثت تغيرات في الملف. افتراضيًا، ستكتب Sass هذه الملفات المُخزّنة مؤقتًا في مكانٍ في نظام الملفات (filesystem) المشار إليه في ...
التابع .parent() في jQuery
.parent( [selector ] ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يجلب هذا التابع العنصر الأب لكل عنصر في مجموعة العناصر المطابقة، ويمكن أن يرشِّح أيضًا تلك العناصر التي أعادها اختياريًا باستعمال محدِّد. .parent( [selector ] ) أضيف مع الإصدار 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد لمطابقة العناصر التي يجلبها التابع عند إعطاء التابع .parent() كائن jQuery يمثل مجموعة من عناصر DOM، فسيبحث عن العنصر الأب المباشر لكل عنصر من هذه العناصر في شجرة DOM ثمَّ سينشئ ...
التابع .on() في jQuery
.on( events [, selector ] [, data ], handler ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر بالعناصر المحدَّدة. .on( events [, selector ] [, data ], handler ) أُضيف مع الإصدار: 1.7. events سلسلة نصية تحتوي على نوع حدث واحد، أو عدَّة أنواع أحداث مفصولة بمسافة فارغة بالإضافة إلى مجالات أسماء (namespaces) (اختياريَّا) مثل "click"، أو "keydown.myPlugin". selector سلسلة نصية تمثِّل اسم المحدِّد الذي يرشِّح أحفاد (descedants) العناصر ...
التابع .parents() في jQuery
.parents([selector ]) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يجلب هذا التابع جميع العناصر الآباء (العنصر الأب [parent] والأجداد [ancestors]) لكل عنصر في مجموعة العناصر المطابقة، ويمكن أن يرشِّح أيضًا تلك العناصر التي أعادها اختياريًا باستعمال محدِّد. .parents( [selector ] ) أضيف مع الإصدار 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد لمطابقة العناصر التي يجلبها التابع عند إعطاء التابع .parents() كائن jQuery يمثل مجموعة من عناصر DOM، فسيبحث عن جميع العناصر الآباء لكل عنصر من هذه العناصر في ...
Document.createNodeIterator()
يُعيد التّابع Document.createNodeIterator() كائنًا جديدًا من النّوع NodeIterator. البنية العامة var nodeIterator = document.createNodeIterator(root, whatToShow, filter);
المعاملات root العقدة الجذر التي سيبدأ منها مرور الكائن NodeIterator. whatToShow قيمة اختياريّةٌ من النّوع unsigned long تُمثّل قيمة bitmask تُنشأُ عبر دمج الخاصيّات الثّابتة الخاصّة بالكائن NodeFilter. وهي طريقة جيّدة لترشيح بعض أنواع العقد. القيمة الافتراضيّة هي 0xFFFFFFFF وتُمثّل الثّابتة SHOW_ALL. الثّابتة القيمة الرّقميّة الوصف NodeFilter.SHOW_ALL -1 (وهي القيمة القصوى للنّوع unsigned long) اعرض جميع العقد. NodeFilter.SHOW_ATTRIBUTE 2 قيمةٌ مُهملَة تعرض عقد الخصائص ...
Document.getElementsByTagName()
يُعيد التّابع Document.getElementsByTagName() كائنًا من النّوع HTMLCollection يحتوي على جميع العناصر ذات اسم الوسم (tag name) المُعطى. عند استدعائه على كائن المُستند، فسيُبحَثُ في كامل المُستند، ما يشمل العقدة الجذر. القيمة المُعادة حيّة، أي أنّها تُحدّث نفسها تلقائيّا للبقاء مُتزامنةً مع شجرة DOM دون الحاجة إلى استدعاء التّابع Document.getElementsByTagName() مرّة أخرى. البنية العامة var elements = document.getElementsByTagName(name);
elements كائنٌ حيّ من النّوع HTMLCollection (لكن انظر الملاحظات أدناه) يُمثّل مجموعة العناصِر التي وُجدت مرتّبةً حسب طريقة عرضها في شجرة DOM. name ...
Document.importNode()
يُنشئ التّابع Document.importNode() نسخةً جديدةً من العقدة Node أو قطعة المُستند DocumentFragment المُحدّدة من مستندٍ آخر ليُمكِنَ إدخالها إلى المستند الحاليّ. لكنّها لا تُدخل إلى شجرة المُستند، لفعل ذلك، عليك استدعاء تابع مثل Node.appendChild() أو Node.insertBefore(). البنية العامة var node = document.importNode(externalNode, deep);
externalNode الكائن الجديد من النّوع Node أو DocumentFragment المرغوب استيراده إلى المستند الحالي. قيمة الخاصيّة parentNode الخاصّة بالعقدة الجديدة تكون null لأنّ العقدة لم تُدخَل بعدُ إلى شجرة المستند. deep قيمةٌ منطقيّة من النّوع Boolean تُشير إلى ...
استخدام لغة Kotlin في نطاق JavaScript
تتيح لغة Kotlin إمكانيّة استهداف لغة JavaScript من خلال تحويل (transpiling) شيفرات Kotlin إلى ما يماثلها في JavaScript ؛ إذ تستهدف بالوقت الحاليّ معيارECMAScript 5.1، ومن المُخطَّط له أيضًا التوافق مع معيار ECMAScript 2015 لاحقًا. عند استخدام لغة Kotlin بهدف كتابة شيفرات JavaScript فستُحوَّل الشيفرات المكتوبة بلغة Kotlin (بعدِّها جزءًا من المشروع والمكتبة القياسيّة في Kotlin) إلى شيفرة JavaScript، ولكنّ هذا لا يشمل أيًّا ممّا يتعلَّق ببيئة JDK أو JVM أو Java أو أيّ من منصّاتها أو مكتباتها المُستخدَمة، ويُستبعَد ...
Document.getElementsByTagNameNS()
يُعيد التّابع Document.getElementsByTagNameNS() قائمةً تحتوي على جميع العناصر ذات اسم الوسم (tag name) التّابع لمجال الأسماء (namespace) المعطيين. عند استدعائه على كائن المُستند، فسيُبحَثُ في كامل المُستند، ما يشمل العقدة الجذر. البنية العامة elements = document.getElementsByTagNameNS(namespace, name)
القيم elements كائنٌ حيّ من النّوع NodeList (لكن انظر الملاحظة أدناه) يُمثّل مجموعة العناصِر التي وُجدت مرتّبةً حسب طريقة عرضها في شجرة DOM. namespace عنوان URI مجال الأسماء المبحوث عنه (انظر element.namespaceURI). name سلسلةٌ نصيّةٌ تُمثّل أسماء العناصِر المبحوث عنها. السلسلة النّصيّة الخاصّة ...
التابع .width() في jQuery
إعادة العرض الحالي المحسوب للعنصر الأول من مجموعة العناصر المُطابقة، أو ضبط عرض CSS لكل عنصر في مجموعة العناصر المُطابقة. .width() القيمة المعادة يُعيد كائنًا من النوع Number. الوصف إعادة العرض الحالي المحسوب للعنصر الأول من مجموعة العناصر المُطابقة. .width() أُضيف مع الإصدار: 1.0. لا يقبل هذا الشكل أي وسائط. الفرق بين .css(width) و .width() هو أن الأخير يعيد قيمة البكسل بدون وحدة (على سبيل المثال، 400) في حين أن الأول يعيد القيمة مع وحدات سليمة (على سبيل المثال، 400px). ...
التابع .innerHeight() في jQuery
يعيد هذا التابع قيمة الطول الحالي (تتضمن قيمة الحواشي فقط دون الإطار) لأول عنصر في مجموعة العناصر المطابقة أو يغير الطول الداخلي لكل العناصر المطابقة. .innerHeight() القيم المعادة يعيد عدد من النوع Number. الوصف يعيد هذا التابع قيمة الطوال الحالي (من ضمنها قيمة الحواشي فقط دون إطار) لأول عنصر في مجموعة العناصر المطابقة. .innerHeight() أضيف مع الإصدار: 1.2.6، ولا يقبل هذا التابع أي معاملات. يعيد هذا التابع قيمة طول العنصر، وتدخل قيمة الحواشي العليا والسفلى ضمن تلك القيمة، بواحدة البكسل. ...
التابع .focus() في jQuery
.focus( handler ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف ربط دالة معالج أحداث بحدث "focus" من JavaScript، أو إطلاق هذا الحدث على عنصر. .focus( handler ) أُضيف مع الإصدار: 1.0. handler دالة على الشكل Function( Event eventObject )، تُنفَّذ في كل مرة يُطلَق فيها الحدث. .focus( [eventData ], handler ) أُضيف مع الإصدار: 1.4.3. eventData كائن يحتوي على البيانات التي ستُمرر إلى معالج الحدث، ويمكن أن يكون من أي نوع من أنواع JavaScript. handler دالة على الشكل Function( ...
التابع .innerWidth() في jQuery
يعيد هذا التابع قيمة العرض الحالي (تدخل قيمة الحواشي ضمنها فقط) لأول عنصر من مجموعة العناصر المطابقة أو يغير العرض الداخلي لكل العناصر المطابقة. .innerWidth() القيم المعادة يعيد عدد من النوع Number. الوصف يعيد هذا التابع قيمة العرض الحالي (من ضمنها قيمة الحواشي ودون قيمة الإطار) لأول عنصر من مجموعة العناصر المطابقة. .innerWidth() أضيف مع الإصدار: 1.2.6، ولا يقبل هذا التابع أي معاملات. يعيد هذا التابع عرض العنصر، من ضمنها الحواشي اليمنى واليسرى، بواحدة البكسل. إن كان كائن jQuery فارغًا ...
التابع .outerHeight() في jQuery
يجلب هذا التابع قيمة الارتفاع الخارجي (outer height، تتضمن الحواشي padding، والإطار border، والهامش margin اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة، أو يغير قيمة الارتفاع الخارجي لكل العناصر المطابقة. .outerHeight( [includeMargin ] ) القيم المعادة يعيد عددًا من النوع Number. الوصف يجلب هذا التابع قيمة الارتفاع الخارجي (outer height، تتضمن الحواشي [padding]، والإطار [border]، والهامش [margin] اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة. .outerHeight( [includeMargin ] ) أضيف مع الإصدار 1.2.6. includeMargin قيمة منطقيَّة (boolean) تحدِّد إن ...
التابع .outerWidth() في jQuery
يجلب هذا التابع قيمة العرض الخارجي (outer width، تتضمن الحواشي padding، والإطار border، والهامش margin اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة، أو يغير قيمة العرض الخارجي لكل العناصر المطابقة. .outerWidth( [includeMargin ] ) القيم المعادة يعيد عددًا من النوع Number. الوصف يجلب هذا التابع قيمة العرض الخارجي (outer height، تتضمن الحواشي [padding]، والإطار [border]، والهامش [margin] اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة. .outerWidth( [includeMargin ] ) أضيف مع الإصدار 1.2.6. includeMargin قيمة منطقيَّة (boolean) تحدِّد إن ...
التابع IO.popen في روبي
ينفذ التابع popen الأمر المعطى كعملية فرعية (subprocess) مع توصيل المجرَيَين القياسيين للدخل والخرج للعملية الفرعية مع المجرى IO المُعاد. يمكن الحصول على على معرف العملية (PID) عبر التابع pid. في حال إعطاء كتلة، فستُنفذ روبي التعليمة كعملية فرعية مرتبطة بروبي عبر أنبوب (pipe). سيُمرّر الطرف المقابل لروبي كوسيط إلى الكتلة. في نهاية الكتلة، ستغلق روبي الأنبوب وتعيّن قيمة $?. في هذه الحالة، سيعيد التابع popen قيمة الكتلة. البنية العامة popen([env,] cmd, mode="r" [, opt])→ io
popen([env,] cmd, mode="r" [, opt]) {|io| ...
العمل مع JavaScript في ريلز
يغطي هذا الدليل وظيفة Ajax/JavaScript المضمّنة في ريلز (والمزيد)؛ وسوف يمكنك من إنشاء تطبيقات Ajax غنية وديناميكية بكل سهولة! ستتعلم بعد قراءة هذا الدليل: أساسيات Ajax. جافاسكربت الواضحة (Unobtrusive JavaScript). كيف يساعدك مساعدو ريلز المدمجون (built-in helpers). كيفية التعامل مع Ajax من طرف الخادم. الجوهرة Turbolinks. مقدمة لفهم Ajax لفهم أجاكس، يجب أولًا فهم ما يفعله متصفّح الويب بشكل طبيعي. عندما تكتب http://localhost:3000 في شريط عنوان المتصفّح وتضغط على "Go" ، يقدّم المتصفح ("العميل") طلبًا للخادم، ويفرز الاستجابة ثم يجلب ...
نظرة عامة على Action Cable في ريلز
ستتعرف في هذا الدليل على كيفية عمل Action Cable وكيفية استخدام WebSockets لدمج ميزات الوقت الفعلي في تطبيق ريلز. بعد قراءة هذا الدليل، ستتلعم: ماهية Action Cable وكيفية دمج الواجهة الخلفية والأمامية الخاصة به. كيفية إعداد Action Cable. كيفية إعداد القنوات. النشر وإعداد المعمارية لتشغيل Action Cable. المقدمة يدمج Action Cable مقابس الويب WebSockets مع باقي تطبيق ريلز بسلاسة. يسمح ذلك بكتابة الميزات في الوقت الحقيقي في روبي بنفس الأسلوب والشكل كبقية تطبيقات ريلز، مع الاستمرار في الأداء وقابلية التطوير. ...
الصنف String في روبي
السلاسل النصية (string) هي سلسلة تحتوي على حرف واحد أو أكثر وقد تحتوي على حروف أبجدية، مثل أرقام ورموز، ويكون كل حرف (أو رمز أو رقم) ممثلاً ببايت. السلاسل النصية في لغة البرمجة روبي عبارة عن كائنات (Objects)، وعلى عكس لغات البرمجة الأخرى، فإن النصوص قابلة للتغيير (Mutable) والتي تعني أننا نستطيع تعديل النصوص بدلًا من إنشاء نصوص جديدة. علامتا الاقتباس المزدوجتين والمفردتين يتم إنشاء السلاسل النصية (string) في لغة روبي باستعمال علامات الاقتباس المزدوجة (مثل "string") أو المفردة (مثل ...
نظرة سريعة على التخزين المؤقت في ريلز
هذا الدليل عبارة عن مدخل يطلعك على كيفية تسريع تطبيق ريلز عبر التخزين المؤقت. يعني التخزين المؤقت تخزين المحتوى الذي أُنشِئ أثناء دورة الاستجابة للطلب وإعادة استخدامه عند الاستجابة لطلبات مشابهة. غالبًا ما يكون التخزين المؤقت الطريقة الأكثر فاعلية لتعزيز أداء التطبيق. من خلال التخزين المؤقت، يمكن لمواقع الويب التي تعمل على خادم واحد مع قاعدة بيانات واحدة الحفاظ على تحميل الآلاف من المستخدمين المتزامنين. يوفر ريلز مجموعة مميزة من ميزات التخزين المؤقت. سوف يعلمك هذا الدليل نطاق وغرض كل ...
التابع .bind() في jQuery
.bind( eventType [, eventData ], handler ) القيمة المعادة كائن jQuery. أُهمِل هذا التّابع في الإصدار: 3.0. الوصف يُستخدَم التّابع .bind() في إرفاق مُعالِج أحداث (Event handler) لحدثٍ ما للعناصر. .bind( eventType [, eventData ], handler ) أضيفت في الإصدار: 1.0. eventType سلسلة نصيّة، وتُمثِّل أنواع حدث DOM مثل click، أو submit، أو أسماء مُخصَّصة للأحداث. eventData أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل كائن يحتوي على البيانات التي ستُمرَّر إلى مُعالِج ...
Document.characterSet
الخاصّية Document.characterSet القابلة للقراءة فقط تعيد ترميز المحارف (character encoding) الخاصّ بالمُستند الحالي. ترميز المحارف هو مجموعة المحارف (character set) المُستخدمة لعرض المُستند، والذي يُمكن أن يُغايِر الترميز المُعيَّن من طرف الصّفحة (يُمكن للمُستخدم أن يغيّر ترميز المحارف). الخاصّيتان document.charset و document.inputEncoding هما اسمان مُستعاران قديمان للخاصية document.characterSet لا تستعمل أيّا منهما بعد الآن. البنية العامة var string = document.characterSet
مثال <button onclick="console.log(document.characterSet);">
Show character set
</button>
<!-- يعرِضُ طقم الأحرُف، مثل "ISO-8859-1" أو "UTF-8" -->
دعم المتصفحات الميزة Chrome Edge ...
Document.queryCommandSupported()
يشير التّابع Document.queryCommandSupported() إلى ما إذا كان أمر التّحرير المعطى مدعومًا من طرف المتصفّح أم لا. البنية العامة isSupported = document.queryCommandSupported(command);
command الأمر المرغوب التّعرّف على ما إذا كان مدعومًا أم لا. القيمة المعادة قيمة منطقيّة من النّوع Boolean تكون true إن كان الأمر مدعومًا وتكون false إن لم يكن كذلك. مثال var flg = document.queryCommandSupported("SelectAll");
if(flg) {
// نفّذ عمليّةً ما
}
ملاحظات يعيد الأمر 'paste' القيمة false في حالة لم يكن الأمر متاحًا إضافةً إلى حالة كون السكربت المستدعي ...
Document.fullscreenElement
تُعيد الخاصية Document.fullscreenElement القابلة للقراءة فقط العنصر Element الذي في وضع ملء الشاشة حاليًا ضمن عناصر المستند الحالي، أو تُعيد القيمة null في حالة لم يكن وضع ملء الشاشة مُفعلًا. ورغم أن هذه الخاصية قابلة للقراءة فقط، إلا أنّها لن ترمي استثناءً عند تغيير قيمتها (حتى في نمط strict)، وستُتجاهل أية عمليّة ضبط قيمة لها. البنية العامة var element = document.fullscreenElement;
ستكون قيمة المتغيّر element هي إشارةٌ إلى العنصر الموجود في وضع ملء الشاشة حاليًا، أو القيمة null في حالة ...
Document.createCDATASection()
يُنشئُ التّابع Document.createCDATASection() عقدةَ قسم CDATA جديدةً ويُعيدها. البنية العامة CDATASectionNode = document.createCDATASection(data)
CDATASectionNode يُمثّل عقدةً من النّوع CDATASection. data سلسلةٌ نصيّة تحتوي على البيانات المرغوب إضافتها إلى قسم CDATA. مثال var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml")
var cdata = docu.createCDATASection('هنا عقدة البيانات');
docu.getElementsByTagName('xml')[0].appendChild(cdata);
alert(new XMLSerializer().serializeToString(docu));
// ستَعرضُ
// <xml><![CDATA[هنا عقدة البيانات]]></xml>
ملاحظات يعمل هذا مع مستندات XML فقط، ولا يعمل مع مستندات HTML (لأنّ مُستندات HTML لا تدعم أقسام CDATA)؛ مُحاولة استعمال التّابع مع مُستندات HTML سترمي الاستثناء NOT_SUPPORTED_ERR. سترمي كذلك الاستثناء NS_ERROR_DOM_INVALID_CHARACTER_ERR ...
Document.caretPositionFromPoint()
تنبيه: هذه تقنيّة تجريبيّة، انظر جدول دعم المتصفّحات قبل استخدام هذا التّابع في شيفرة إنتاجيّة. يعيد التّابع Document.caretPositionFromPoint() كائنًا من النّوع CaretPosition يحتوي على عقدة DOM ومكان علامة الإقحام (caret) وحدود محارف (character offset) العلامة داخل هذه العقدة. البنية العامة var caretPosition = document.caretPositionFromPoint(float x, float y);
المعاملات x الإحداثيّ الأفقيّ لنقطة ما. y الإحداثيّ العمودي لنقطة ما. القيمة المعادة كائن من النّوع CaretPosition. مثال يقوم المثال التّالي بإدخال فراغ سطريً (line break) أينما ضغطت. جزء HTML: <p>Lorem ipsum dolor ...
Document.createExpression()
يُجمّع التّابع Document.createExpression() استعلام XPathExpression، والذي يُمكن استعماله بعد ذلك لإجراء تقديرات (evaluations) يُمكن تكرارها. البنية العامة xpathExpr = document.createExpression(xpathText, namespaceURLMapper);
xpathText سلسلة نصيّة تُمثّل تعبير XPath المرغوب تجميعه. namespaceURLMapper دالّة تربط سابقة مجال أسماءٍ (namespace prefix) برابط URL مجال أسماءٍ أو القيمة null إن لم يكن ذلك مطلوبًا. القيمة المعادة كائنٌ من النّوع XPathExpression.
Document.elementFromPoint()
تنبيه: هذه تقنيّة تجريبيّة، انظر جدول دعم المتصفّحات قبل استخدام هذا التّابع في شيفرة إنتاجيّة. يعيد التّابع Document.elementFromPoint() العنصر الموجود في أعلى الإحداثيّات المعطاة (حسب إطار العرض [viewport]). إن كان العنصر في النّقطة المحدّدة خاصًّا بمستند آخر (مثل مستند فرعيّ لعنصر iframe مثلًا)، فالعنصر الأب للمستند الفرعيّ هو الذي يُعاد (أي عنصر iframe نفسه). إن كان العنصر في النّقطة المُعطاة مجهولًا (anonymous) أو محتوًى مولَّدًا عبر XBL، مثل شريط التمرير (scroll bar) في صندوقٍ نصيّ، فأول عنصرٍ أبٍ غير مجهولٍ ...
Document.onfullscreenchange
الخاصيّة Document.onfullscreenchange مُعالِج أحداثٍ للحدث fullscreenchange الذي يُطلَق عندما يلِج أو يخرج مُستندٌ من وضع ملء الشّاشة. البنية العامة targetDocument.onfullscreenchange = fullscreenChangeHandler;
مثال document.onfullscreenchange = function ( event ) {
console.log("هناك تغيّر في وضع ملء الشّاشة")
};
document.documentElement.onclick = function () {
// يجب استدعاء التّابع
// requestFullscreen()
// داخل مُعالج أحداث لكي لا يفشَل استدعاؤه
document.documentElement.requestFullscreen();
}
دعم المتصفحات الميزة Chrome Internet Explorer Firefox Opera Safari الدعم الأساسي 45 47 وراء full-screen-api.unprefix.enabled ؟ ؟ ؟ ...
Document.implementation
تُعيد كائنًا من النّوع DOMImplementation مرتبط بالمستند الحالي. البنية العامة DOMImpObj = document.implementation;
مثال var modName = "HTML";
var modVer = "2.0";
var conformTest = document.implementation.hasFeature( modName, modVer );
alert( "DOM " + modName + " " + modVer + " supported?: " + conformTest );
يعرض المثال نافذة تنبيه مُحتواها DOM HTML 2.0 supported?: true إذا كانت وحدة DOM المستوى الثّاني مدعومة. قائمة أسماء وحدات (Core، و HTML، و XML، ...إلخ.) متوافرة في قسم Conformance Section الخاصّ بالمستوى الثّاني من DOM. ملاحظات ...
Document.location
تُعيد الخاصيّة Document.location القابلة للقِراءة فقط كائنًا من النّوع Location، والذي يحتوي على معلومات حول عنوان URL الخاصّ بالمُستند ويُتيح توابع لتعديل عنوان URL هذا وتحميل عنوان URL آخر. ورغم أنّ الخاصيّة Document.location للقِراءة فقط، إلا أنّك تستطيع تعيين سلسلة نصيّة من النّوع DOMString لها كذلك. ما يعني بأنّك تستطيع التّعامل مع هذه الخاصيّة بصفتها سلسلة نصيّة عاديّة في مُعظم الحالات. والسّطران التّاليّان مُتكافئان: document.location = 'http://www.example.com'
document.location.href = 'http://www.example.com'
للحصول على عنوان URL المُستندِ وحده، يُمكنك استعمال الخاصيّة document.URL كذلك. ...
Document.createComment()
يُنشئُ التّابع Document.createComment() عقدةَ تعليق جديدةً ويُعيدها. البنية العامة CommentNode = document.createComment(data)
data سلسلةٌ نصيّة تحتوي على التعليق المرغوب إضافته. مثال var docu = new DOMParser().parseFromString('<xml></xml>', "application/xml");
var comment = docu.createComment('هذا تعليق');
docu.getElementsByTagName('xml')[0].appendChild(comment);
alert(new XMLSerializer().serializeToString(docu));
// تعرض
// <xml><!--هذا تعليق--></xml>
مصادر ومواصفات مواصفة createComment
Document.elementsFromPoint()
تنبيه: هذه تقنيّة تجريبيّة، انظر جدول دعم المتصفّحات قبل استخدام هذا التّابع في شيفرة إنتاجيّة. يعيد التّابع Document.elementsFromPoint() مصفوفة بجميع العناصر الموجودة في نقطة الإحداثيّات المعطاة (حسب إطار العرض [viewport]). البنية العامة var elements = document.elementsFromPoint(x, y);
x الإحداثيّات الأفقيّة لنقطة ما. y الإحداثيّات الرأسية لنقطة ما. القيمة المعادة مصفوفة كائنات من النّوع Element. مثال جزء HTML: <div>
<p>محتوى نصيّ</p>
</div>
<p>العناصر في الإحداثيّات 30 و 20</p>
<div id="output"></div>
جزء JavaScript: var output = document.getElementById("output");
if (document.elementsFromPoint) {
var elements = document.elementsFromPoint(30, ...
Document.queryCommandEnabled()
يشير التّابع Document.queryCommandEnabled() إلى ما إذا كان أمر التّحرير المعطى مفعّلًا من طرف المتصفّح أم لا. البنية العامة isEnabled = document.queryCommandEnabled(command);
command الأمر المرغوب التّعرّف على ما إذا كان مدعومًا أو لا. القيمة المعادة قيمة منطقيّة من النّوع Boolean تكون true إن كان الأمر مُفعّلًا وتكون false إن لم يكن كذلك. مثال var flg = document.queryCommandEnabled("SelectAll");
if(flg) {
document.execCommand("SelectAll", false, null); // الأمر مُفعّل، لذا نفّذه
}
ملاحظات بالنّسبة للأمران 'cut' و'copy' فإنّ التّابع يعيد القيمة true فقط إن استدعيَ في ...
Document.fullscreenEnabled
تُعيد الخاصية Document.fullscreenEnabled القابلة للقراءة فقط كائنًا من النوع Boolean يُشير إلى ما إذا كان وضع ملء الشاشة مُتاحًا أم لا. وضع ملء الشاشة مُتاح للصفحات التي لا تحتوي على إضافات ذات نوافِذَ في أي من مُستنداتها فقط، وفي حالة كانت جميع عناصر <iframe> التي تحوي المُستند ذات خاصيّة allowfullscreen مضبوطة. ورغم أن هذه الخاصية قابلة للقراءة فقط، إلا أنّها لن ترمي استثناءً عند تغيير قيمتها (حتى في نمط strict)، وستُتجاهل أية عمليّة ضبط قيمة لها. البنية العامة var isFullscreenAvailable ...
Document.dir
الخاصيّة Document.dir خاصيّةٌ من النّوع DOMString تُمثّل اتّجاهيّة النّص في المُستند، إمّا من اليسار إلى اليمين (وهو الخيار الافتراضي) أو من اليمين إلى اليسار. القيَم المُمكنة هي 'rtl' أي من اليمين إلى اليسار، والقيمة 'ltr' التّي تعني من اليسار إلى اليمين. البنية العامة dirStr = document.dir;
document.dir = dirStr;
دعم المتصفحات الميزة Chrome Internet Explorer Firefox Opera Safari الدعم الأساسي نعم نعم نعم ؟ ؟ مصادر ومواصفات مواصفة HTML Living Standard.
Document.defaultView
في المُتصفحات، تُعيد الخاصيّة Document.defaultView الكائن window المُرتبط بالمستند، أو القيمة null إن لم يكن متوافرًا. البنية العامة var win = document.defaultView;
الخاصيّة قابلة للقراءة فقط. دعم المتصفحات الميزة Chrome Edge Firefox Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مواصفة HTML Living Standard. مواصفة HTML5.
Document.exitPointerLock()
مُلاحظة: هذه الخاصيّة تجريبيّة، انظر جدول دعم المتصفحات قبل استعمالها في شيفرةٍ إنتاجيّة. يُحرّر التّابع Document.exitPointerLock() قفل مؤشّر الفأرة بشكل غير مُتزامنٍ حسب طلبٍ سابقٍ من Element.requestPointerLock. للتحقّق من نجاح أو فشل الطّلب، لابدّ من الاستماع للحدثين pointerlockchange وpointerlockerror. البنية العامة document.exitPointerLock();
دعم المتصفحات الميزة Chrome Edge Firefox Internet Explorer Opera Safari الدعم الأساسي نعم (قد تحتاج إلى السّابقة -webkit في إصدارات قديمة) نعم نعم، مع السّابقة -moz 50 دون سابقة ؟ ؟ ؟ انظر أيضًا Document.pointerLockElement Element.requestPointerLock مصادر ومواصفات ...
Document.compatMode
تدلّ على ما إذا كان المُستند قد قُدِّم في نمط التجاوزات (Quirks Mode) أو نمط المعايير (Standards Mode). البنية العامّة mode = document.compatMode
القيم "BackCompat" في حالة كان المُستند في نمط التجاوزات (Quirks Mode). "CSS1Compat" في حالة كان المُستند في نمط المعايير (Standards Mode). مثال if (document.compatMode == "BackCompat") {
// نمط
// Quirks
}
مصادر ومواصفات مواصفة DOM: Document.compatMode. مواصفة MSDN: compatMode property.
Document.createEvent()
مُلاحظة: لقد أُهمِلت الكثير من التوابع التي تُستعمل مع التّابع createEvent، هذه التّوابع تشمل التّابع initCustomEvent وتوابع أخرى. استعمل دوال بناء الأحداث عوضًا عنها. يُنشئُ التّابع Document.createEvent() حدثًا من النّوع المُحدّد. يجب تهيئة الكائن المُعاد قبل أن يُمكنَ تمريره إلى التّابع dispatchEvent. البنية العامة var event = document.createEvent(type);
event الكائن الجديد من النّوع Event. type سلسلةٌ نصيّةٌ تُمثّل نوع الحدث المرغوب إنشاؤه. القيم المُمكنة تشمل "UIEvents" و"MouseEvents" و"MutationEvents" و"HTMLEvents". انظر قسم المُلاحظات أدناه للمزيد من التّفاصيل. أمثلة // أنشئ الحدث
var ...
Document.adoptNode()
يتبنّى التّابع Document.adoptNode() عقدة خارجيّة، وتُحذف العقدة وشجرتها الفرعيّة من المُستند الأصلي (إن كان موجودًا)، وتتغيّر قيمة المُستند المالِك ownerDocument إلى المُستند الحاليّ. ويُمكن بعد ذلك إدخال العقدة إلى المُستند الحاليّ. البنية العامة node = document.adoptNode(externalNode);
node يُمثّل العقدة المُتبنّاة والتي مالِكها هو المُستند الحالي وعقدتها الأب parentNode ذات قيمةٍ null، وذلك لأنّها لم تُدخَل بعدُ إلى شجرة المُستند. لاحِظ أنّ كلّا من node وexternalNode سيُصبحان نفس الكائن بعد الاستدعاء. externalNode هي العقدة التي ستُتبنّى من مُستند آخر. مثال var ...