نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
HTML/Topics/Document Metadata
تحتوي البيانات الوصفية على معلومات عن الصفحة، التي تتضمن المعلومات حول الأنماط (styles) والسكربتات، والبيانات المُساعدة للبرمجيات (مثل محركات البحث والمتصفحات ...إلخ.) التي تستخدم الصفحة أو تعرضها. العنصر الوصف <base> تحديد أساس روابط URL لجميع الروابط النسبية (relative URLs) الموجودة في المستند. لا يجوز استخدام أكثر من عنصر <base> في المستند. <head> توفير معلوماتٍ عامةً عن المستند (أي بيانات وصفية)، بما في ذلك عنوان المستند وروابط إلى السكربتات الموجودة فيها وصفحات الأنماط. <link> تحديد العلاقات بين المستند الحالي وبين مورد خارجي (external resource)؛ ...
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
تحتوي هذه الصفحة على قائمة بعناصر HTML، منظمةً حسب وظيفتها ليسهل عليك الوصول إلى مبتغاك. العنصر الجذر العنصر الوصف <html> تمثيل العنصر الرئيسي في مستندات HTML، ويُشار إليه أحيانًا باسم «العنصر الجذر» (root element). يجب أن تكون جميع العناصر الأخرى في المستند سليلةً (descendants، أي أبناء مباشرين وغير مباشرين) له. البيانات الوصفية تحتوي البيانات الوصفية على معلومات عن الصفحة، التي تتضمن المعلومات حول الأنماط (styles) والسكربتات، والبيانات المُساعدة للبرمجيات (مثل محركات البحث والمتصفحات ...إلخ.) التي تستخدم الصفحة أو تعرضها. العنصر الوصف ...
التابع 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 ...
HTML/Topics/Scripting
لإنشاء محتوى تفاعلي في تطبيقات الويب، فتدعم HTML استخدام لغات السكربتات، وخصوصًا JavaScript، وهنالك عدِّة عناصر متوافرة لدعم هذه الإمكانية. العنصر الوصف <canvas> استخدم العنصر <canvas> مع الواجهة البرمجية الخاصة به لترسم الرسومات وتحركها. <noscript> يُعرِّف العنصر <noscript> قسمًا من شيفرات HTML التي ستُضاف إلى الصفحة إذا لم يكن العنصر <script> مدعومًا في المتصفح أو كان استخدام شيفرات JavaScript معطلًا من قِبل المستخدم. <script> تضمين أو الإشارة إلى سكربت قابل للتنفيذ.
HTML/Topics/Table
تُستعمَل هذه العناصر لإنشاء والتعامل مع البيانات المجدولة. العنصر الوصف <caption> تمثيل عنوان الجدول، وعلى الرغم من أنَّه يجب أن يكون أوّل ابن للعنصر <table> لكن يمكن باستخدام CSS وضعه في أي مكان نسبةً إلى الجدول. <col> تعريف عمود ضمن أحد الجداول، ويُستخدم لإعطاء هيكل تنظيمي للخلايا المتشابهة، ويكون موجودًا داخل عنصر <colgroup>. <colgroup> تعريف مجموعة أعمدة ضمن أحد الجداول. <table> تمثيل البيانات المجدّولة، أي المعلومات التي يُعبّر عنها عبر جدول ثنائي الأبعاد. <tbody> يُجمِّع العنصر <tbody> عنصر <tr> أو أكثر كجسم للعنصر <table>. <td> تعريف خلية في الجدول الذي ...
التابع .html() في jQuery
يجلب هذا التابع محتوى HTML لأول عنصر في مجموعة العناصر المطابقة أو يغير محتوى HTML لكل العناصر المطابقة. ()html. القيم المعادة يعيد سلسلة نصية من النوع String. الوصف يجلب هذا التابع محتوى HTML لأول عنصر في مجموعة العناصر المطابقة. .html() أضيفت مع الإصدار: 1.0، ولا يقبل هذا التابع أي معاملات. هذا التابع غير متوافر في صفحات XML. في صفحة HTML، يمكن استعمال التابع ()html. لجلب محتوى أي عنصر. إذا طابق تعبير المحدد أكثر من عنصر، فسيُعاد محتوى HTML للعنصر الأول ...
أنواع الروابط في HTML
تشير أنواع الروابط في مستندات HTML إلى العلاقة بين مستندين، والتي يُشير فيها أحدهما إلى الآخر باستخدام العنصر <a> أو <area> أو <link>. alternate يمكن تطبيق نوع الروابط alternate على العنصر <a> أو <area> أو <link>. إذا كان العنصر هو <link> وكانت تحتوي الخاصية rel أيضًا على النوع stylesheet، فهذا الرابط يعرِّف أنماطًا بديلةً، وفي تلك الحالة يجب أن تكون الخاصية title موجودةً وقيمتها ليست فارغةً. إذا ضبطت الخاصية type إلى application/rss+xml أو application/atom+xml فهذا الرابط يشير إلى ملف التغذية، ...
HTML/Topics/Forms
توفِّر HTML عددًا من العناصر التي يمكن أن تتكامل مع بعضها لإنشاء نماذج يمكن للمستخدمين ملأها وإرسالها إلى خادوم الويب لمعالجها. العنصر الوصف <button> يُمثِّل العنصر <button> زرًا قابلًا للضغط. <datalist> يحتوي العنصر <datalist> على عناصر <option> التي تُمثِّل القيم المتوافرة لعناصر النماذج الأخرى. <fieldset> تجميع عدِّة عناصر ولافتات (<label>) ضمن نموذج في مستند HTML؛ مما يجعل نماذجك أسهل استخدامًا وأوضح. <form> تمثيل قسم في المستند الذي يحتوي على عناصر يستطيع المستخدم التفاعل معها لإرسال بيانات إلى خادوم الويب. <input> يُستخدَم العنصر <input> لإنشاء عناصر تفاعلية للنماذج في ...
HTML/Topics/Multimedia
تدعم HTML تضمين الوسائط المتعددة مثل الصور والصوت والفيديو. العنصر الوصف <area> تعريف منطقة في خريطة لصورة، ويمكن أن ترتبط تلك المنطقة (اختياريًا) مع رابط فائق. لا يمكن استخدام هذا العنصر إلا ضمن عنصر <map>. <audio> تضمين المحتوى الصوتي في المستندات، وقد يحتوي على ملف مصدري واحد أو أكثر التي تُمثَّل باستخدام الخاصية src أو عبر العنصر <source>، وسيختار المتصفح أنسب الملفات الصوتية لتشغيلها. <img> تمثيل صورة في المستند. <map> يُستخدَم العنصر <map> مع عنصر <area> لتعريف خريطة للصورة (أي منطقة قابلة للنقر في الصورة). <track> يُستخدَم العنصر <track> داخل ...
HTML/Topics/Edits
تسمح لنا هذه العناصر بالإشارة إلى أنَّ جزءًا من النص قد جرى تغييره. العنصر الوصف <del> تمثيل نص حُذِفَ من المستند، وهذا النص يُعرَض عادةً ويتوسطه خط (strike-through) لكن ذلك ليس إجباريًا. <ins> تمثيل نص أُضيف إلى المستند، وهذا النص يُعرَض عادةً وتحته خط لكن ذلك ليس إجباريًا.
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> الخارجي. ورغم أنّك تستطيع تعيين قيمة ...
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.getElementById()
يُعيد التّابع Document.getElementById() كائنًا من النّوع Element يُمثّل العنصر ذو المُعرّف (id) الذي يُوافق السلسلة النّصيّة المُحدّدة. ولأنّ مُعرّفات العناصر لا بدّ لها أن تكون فريدة عند إنشائها، فهي مُفيدة للوصول إلى عنصرٍ مُعيّنٍ بسرعة. إن أردت الوصول إلى عنصر لا يملك مُعرّفًا، يُمكنك استعمال التّابع querySelector() للوصول إلى العنصر بأيّ مُحدِّدٍ كيفما كان. البنية العامة var element = document.getElementById(id);
element كائنٌ من النّوع Element يُمثّل عنصر DOM الذي يوافق مُعرّفه المُعرّف المُعطى، أو القيمة null في حالة لم يوجد ...
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: " ...
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.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.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 ...
HTML/Topics/Embedded Content
إضافةً إلى الوسائط المتعددة، يمكن تضمن مختلف أنواع المحتوى في مستندات HTML، حتى لو لم يكن من السهل دومًا التعامل مع ذاك المحتوى. العنصر الوصف <embed> يُمثِّل العنصر <embed> نقطة إدراج لتطبيق خارجي أو لمحتوى تفاعلي (أي بصيغة أخرى: إضافة plug-in). <object> يُمثِّل العنصر <object> موردًا خارجيًا، والذي يمكن أن يُعامل كصورة، أو كمورد سيُعالَج عبر إضافة خارجية. <param> يُعرِّف العنصر <param> معاملات (parameters) للعنصر <object>. <source> يُحدِّد العنصر <source> عدِّة مصادر لملفات الوسائط المتعددة ضمن العنصر<picture> أو <audio> أو <video>. وهذا العنصر فارغ، وأكثر استخدام شائع له هو توفير محتوى الوسائط المتعددة ...
HTML/Topics/Main Root
العنصر الوصف <html> تمثيل العنصر الرئيسي في مستندات HTML، ويُشار إليه أحيانًا باسم «العنصر الجذر» (root element). يجب أن تكون جميع العناصر الأخرى في المستند سليلةً (descendants، أي أبناء مباشرين وغير مباشرين) له.
HTML/Topics/Content Sectioning
تسمح العناصر التقسيمية لنا بتنظيم محتوى المستند وتقسيمه إلى أقسام منطقية، إذ تُستعمَل هذه العناصر لإنشاء تخطيط هيكلي للصفحة، بما في ذلك ترويسة الصفحة وتذييلها، وعناصر الترويسات. العنصر الوصف <body> تمثيل محتوى مستند HTML، ولا يجوز أن يكون هنالك أكثر من عنصر <body> واحد في المستند. <address> توفير معلومات التواصل للمحتوى الموجود في أقرب عنصر<article> أو <body> أب، وإذا كان سيوفر المعلومات لعنصر <body> أب فستُطبَّق المعلومات على كامل المستند. <article> تمثيل جزء من المستند أو الصفحة أو التطبيق أو الموقع الغرض منها هو القدرة على إعادة توزيعها واستخدامها بشكل ...
HTML/Topics/Text Content
عناصر المحتوى النصي تُستخدَم لتنظيم أجزاء من المحتوى الموجودة في العنصر <body>، وهي مفيدة لتعريف الغرض من المحتوى الموجود داخلها، مما يفيد في فهرسة الصفحة أو زيادة قابلية الوصول إليها. العنصر الوصف <blockquote> يُشير العنصر <blockquote> (اسم هذا العنصر اختصارٌ للعبارة HTML Block Quotation Element) إلى أنَّ النص الموجود داخله هو نص اقتباس طويل. يُعرَض هذا العنصر عادةً مع إضافة محاذاة قبله (راجع قسم الملاحظات في هذه المقالة لمعرفة كيفية تغيير طريقة العرض). يمكن توفير رابط URL لمصدر الاقتباس عبر الخاصية cite، أما التمثيل ...
HTML/Topics/Interactive Elements
توفِّر HTML مجوعةً من العناصر التي تساعد في إنشاء عناصر تفاعلية يستطيع المستخدم التفاعل معها. العنصر الوصف <details> يُستخدم العنصر <details> لعرض معلومات إضافية للمستخدم يمكنه إظهارها وإخفاؤها متى شاء. يمكن وضع أيّ نوع من المحتوى ضمن العنصر <details>، وتكون محتوياته مخفيةً افتراضيةً (إلا إذا ضُبِطَت الخاصية open). <summary> يُستخدم العنصر <summary> لعرض خلاصة أو لافتة أو عنوان لمحتويات العنصر<details>.
Document.forms
تُعيد الخاصّية forms مجموعة من النّوع HTMLCollection تحتوي على جميع عناصِر <form> في المُستند. ملاحظة: يُمكنك كذلك استعمال الخاصيّة HTMLFormElement.elements للحصول على قائمةٍ بعناصِر نماذج الإدخال بشكلٍ مُشابه. البنية العامة collection = document.forms;
القيمة كائنٌ من النّوع HTMLCollection يُمثّل قائمةً بجميع النّماذج في المُستند. كلّ عنصر من المجموعة يُعدّ من النّوع HTMLFormElement ويُمثّل عنصر <form> وحيد. إن لم يوجد أي نموذج في المُستند، فالمجموعة المُعادة ستكون فارغة بطولٍ يُساوي صفرًا. أمثلة الحصول على معلومات نموذج مُعيّن: <!DOCTYPE html>
<html lang="en">
...
Document.images
تُعيد الخاصيّة Document.images مجموعة الصور الموجودة في مُستند HTML الحاليّ. البنية العامة var imageCollection = document.images;
القيمة مجموعةٌ من النّوع HTMLCollection تحتوي على قائمة بجميع الصّور الموجودة في المُستند الحالي. كلّ عنصر في المجموعة يُعدّ من النّوع HTMLImageElement ويُمثّل عنصر صورة واحد. ملاحظات حول استعمال الخاصية يُمكنك استعمال إمّا طريقة المصفوفات أو التّابع item() على المجموعة المُعادة للوصول إلى عناصر المجموعة. المثالان التّاليّان لهما نفس التّأثير: firstImage = imageCollection(0);
firstImage = imageCollection[0];
مُلاحظة: الخاصيّة Document.images مُتاحة في مُستندات HTML فقط. مثال ...
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.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> أو ...
الدالة jQuery() في jQuery
تعيد هذه الدالة مجموعةً من العناصر المطابقة التي إمَّا وُجدَت في شجرة DOM بناءً على الوسائط المُمرَّرة، أو أنشئت بتمرير سلسلة نصية تحتوي على محتوى HTML. jQuery( selector [, context ] ) القيم المعادة تعيد كائنًا من النوع jQuery. الوصف تقبل هذه الدالة سلسلة نصية تحتوي على محدِّد CSS يُستعمَل لمطابقة مجموعة من العناصر. jQuery( selector [, context ] ) أُضيفت مع الإصدار: 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد. context عنصر DOM، أو كائن Document، أو كائن 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>). ...
التابع .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: ...
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 ...
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() يسمح لك بالكتابة فوق المستند الحالي ...
HTML/Topics/Inline Text Semantics
تُستخدَم العناصر النصية لإضفاء معنى أو بنية أو تنسيق إلى كلمة أو سطر أو أي نص. العنصر الوصف <a> يُنشِئ العنصر <a> (اسمه اختصار للكلمة anchor) رابطًا فائقًا (hyperlink) لصفحات الويب الأخرى أو للملفات أو لأقسم الصفحة الحالية أو لعنواين البريد الإلكتروني. <abbr> تمثيل اختصار وتوفير شرح له، وعند إضافة الشرح يجب أن تحتوي الخاصية title على الشرح الكامل لهذا الاختصار فقط ولا يسمح بأي قيمة أخرى. <b> تمثيل نص يختلف تنسيقه عن تنسيق النص العادي، دون أن يكون له أهمية أو أولوية على بقية النص، ويُعرَض عادةً ...
Document.getElementsByTagName()
يُعيد التّابع Document.getElementsByTagName() كائنًا من النّوع HTMLCollection يحتوي على جميع العناصر ذات اسم الوسم (tag name) المُعطى. عند استدعائه على كائن المُستند، فسيُبحَثُ في كامل المُستند، ما يشمل العقدة الجذر. القيمة المُعادة حيّة، أي أنّها تُحدّث نفسها تلقائيّا للبقاء مُتزامنةً مع شجرة DOM دون الحاجة إلى استدعاء التّابع Document.getElementsByTagName() مرّة أخرى. البنية العامة var elements = document.getElementsByTagName(name);
elements كائنٌ حيّ من النّوع HTMLCollection (لكن انظر الملاحظات أدناه) يُمثّل مجموعة العناصِر التي وُجدت مرتّبةً حسب طريقة عرضها في شجرة DOM. name ...
Document.readyState
تصِفُ الخاصيّة Document.readyState حالة تحميل المُستند. البنية العامة var string = document.readyState;
القيم يُمكن للخاصيّة أن تحمِل القيم التّاليّة: "loading" المُستند لا يزال قيد التّحميل "interactive" تحميل المُستند قد انتهى، لكنّ الموارد الفرعيّة كالصّور وصفحات الأنماط والإطارات لا تزال قيد التّحميل "complete" انتهى تحميل المُستندِ وجميع موارِده الفرعيّة. هذه الحالة تُشير إلى أنّ الحدث load سيُطلَق فورًا. يُطلَق الحدث readystatechange على كائن المُستند document عند كلّ تغيّر لقيمة هذه الخاصيّة. أمثلة الحالات المُختلفة لجاهزيّة المُستند: switch (document.readyState) {
case ...
Document.createDocumentFragment()
يُنشئُ التّابع Document.createDocumentFragment() كائنا فارغًا من النّوع DocumentFragment. البنية العامة var fragment = document.createDocumentFragment();
fragment مرجِع يُشير إلى كائن فارغ من النّوع DocumentFragment. وصف كائنات DocumentFragment هي عقدُ DOM. ولا تكون أبدًا جزءًا من شجرة DOM الأساسيّة. الغرض منها يكون عادةً إنشاء قطعة مُستندٍ (document fragment) ثمّ إضافة عناصرَ إليها، ثمّ إضافة قطعة المُستند إلى شجرة DOM. وتُبدَلُ قطعة المستند في شجرة DOM بجميع أولادها. ولأنّ قطعة المُستند تُخزَّن في الذّاكرة ولا تكون جزءًا من شجرة DOM الرّئيسيّة، فإضافة أولاد ...
التابع .parent() في jQuery
.parent( [selector ] ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يجلب هذا التابع العنصر الأب لكل عنصر في مجموعة العناصر المطابقة، ويمكن أن يرشِّح أيضًا تلك العناصر التي أعادها اختياريًا باستعمال محدِّد. .parent( [selector ] ) أضيف مع الإصدار 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد لمطابقة العناصر التي يجلبها التابع عند إعطاء التابع .parent() كائن jQuery يمثل مجموعة من عناصر DOM، فسيبحث عن العنصر الأب المباشر لكل عنصر من هذه العناصر في شجرة DOM ثمَّ سينشئ ...
Document.cookie
تُستعمل هذه الخاصيّة للحصول على ملفّات الارتباط (cookies) المُرتبطة بالمُستند الحالي وضبطها، للتعامل مع ملفّات الارتباط ببساطة أكثر، انظر إطار العمل البسيط هذا. البنية العامة الحصول على جميع ملفّات تعريف الارتباط المتاحة allCookies = document.cookie;
المُتغيّر allCookies أعلاه عبارة عن سلسلة نصيّة تحتوي على قائمة بجميع ملفات الارتباط مفصولة بفاصلة منقوطة (;)، وهي على شكل مفتاح=قيمة. ضبط ملفّ ارتباط جديد document.cookie = newCookie;
في الشيفرة أعلاه، المُتغيّر newCookie عبارة عن سلسلة نصيّة على شكل مفتاح=قيمة. لاحظ أنّك تستطيع أن تضبط أو تُحدّث ...
التابع .keydown() في jQuery
.keydown( handler ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع معالج حدث معين مع الحدث keydown (الضغط على مفتاح في لوحة المفاتيح) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر. .keydown( handler ) أُضيف مع الإصدار: 1.0. handler دالة من الشكل Function( Event eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُستدعى فيها الحدث. .keydown( [eventData ], handler ) أُضيف مع الإصدار: 1.4.3. eventData أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى ...
التابع .parents() في jQuery
.parents([selector ]) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يجلب هذا التابع جميع العناصر الآباء (العنصر الأب [parent] والأجداد [ancestors]) لكل عنصر في مجموعة العناصر المطابقة، ويمكن أن يرشِّح أيضًا تلك العناصر التي أعادها اختياريًا باستعمال محدِّد. .parents( [selector ] ) أضيف مع الإصدار 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد لمطابقة العناصر التي يجلبها التابع عند إعطاء التابع .parents() كائن jQuery يمثل مجموعة من عناصر DOM، فسيبحث عن جميع العناصر الآباء لكل عنصر من هذه العناصر في ...
التابع .keyup() في jQuery
.keyup( handler ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع معالج حدث معين مع الحدث keyup (الضغط على مفتاح في لوحة المفاتيح) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر. .keyup( handler ) أُضيف مع الإصدار: 1.0. handler دالة من الشكل Function( Event eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُستدعى فيها الحدث. .keyup( [eventData ], handler ) أُضيف مع الإصدار: 1.4.3. eventData أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى ...
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 في حالة ...
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 دالة من الشكل ...
التابع .keypress() في jQuery
.keypress( handler ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع معالج حدث معين مع الحدث keypress (الضغط على مفتاح في لوحة المفاتيح) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر. .keypress( handler ) أُضيف مع الإصدار: 1.0. handler دالة من الشكل Function( Event eventObject )، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُستدعى فيها الحدث. .keypress( [eventData ], handler ) أُضيف مع الإصدار: 1.4.3. eventData أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى ...