نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
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: ...