نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
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 للإشارة إلى ...
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.children
تُعيد الخاصيّة children القابلة للقراءة فقط والمُعرّفة على الواجهة ParentNode كائنا من النّوع HTMLCollection الذي يحتوي على جميع العناصِرِ الأولاد الخاصّة بالعقدة التي استُدعَت عليها. البنية العامة var children = node.children;
القيمة القيمة المُعادة عبارة عن كائن من النّوع HTMLCollection والذي هو مجموعة حيّة ومُرتّبة من عناصر DOM الذين هم أولاد العقدة. يُمكنك الوصول إلى العقد الأولاد كل على حدة في المجموعة عبر استعمال إمّا التّابع item() على المجموعة أو باستعمال طريقة الوصول إلى المصفوفات في JavaScript. إن لم يكن ...
التابع .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 ...
العمل مع JavaScript في ريلز
يغطي هذا الدليل وظيفة Ajax/JavaScript المضمّنة في ريلز (والمزيد)؛ وسوف يمكنك من إنشاء تطبيقات Ajax غنية وديناميكية بكل سهولة! ستتعلم بعد قراءة هذا الدليل: أساسيات Ajax. جافاسكربت الواضحة (Unobtrusive JavaScript). كيف يساعدك مساعدو ريلز المدمجون (built-in helpers). كيفية التعامل مع Ajax من طرف الخادم. الجوهرة Turbolinks. مقدمة لفهم Ajax لفهم أجاكس، يجب أولًا فهم ما يفعله متصفّح الويب بشكل طبيعي. عندما تكتب http://localhost:3000 في شريط عنوان المتصفّح وتضغط على "Go" ، يقدّم المتصفح ("العميل") طلبًا للخادم، ويفرز الاستجابة ثم يجلب ...
التابع .width() في jQuery
إعادة العرض الحالي المحسوب للعنصر الأول من مجموعة العناصر المُطابقة، أو ضبط عرض CSS لكل عنصر في مجموعة العناصر المُطابقة. .width() القيمة المعادة يُعيد كائنًا من النوع Number. الوصف إعادة العرض الحالي المحسوب للعنصر الأول من مجموعة العناصر المُطابقة. .width() أُضيف مع الإصدار: 1.0. لا يقبل هذا الشكل أي وسائط. الفرق بين .css(width) و .width() هو أن الأخير يعيد قيمة البكسل بدون وحدة (على سبيل المثال، 400) في حين أن الأول يعيد القيمة مع وحدات سليمة (على سبيل المثال، 400px). ...
التابع .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 دون ...
التابع .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( ...
الوصول إلى الخاصيات في 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. هناك أدوات تستخدم سلاسل التوثيق النصية لإنتاج توثيق عبر شبكة الإنترنت، أو تسمح للمستخدم بتصفح الشيفرة بصورة تفاعلية؛ لذا ينصح باستخدام سلاسل التوثيق النصية في الشيفرة التي تكتبها. يجب أن يكون السطر الأول قصيرًا ومقتضبًا ويقدّم لمحة مختصرة عن الغرض من إنشاء الكائن، ولأجل الاختصار يجب أن لا يتضمن السطر الأول اسم الكائن أو نوعه؛ فهناك وسائل أخرى ...
نظرة عامة على Action Cable في ريلز
ستتعرف في هذا الدليل على كيفية عمل Action Cable وكيفية استخدام WebSockets لدمج ميزات الوقت الفعلي في تطبيق ريلز. بعد قراءة هذا الدليل، ستتلعم: ماهية Action Cable وكيفية دمج الواجهة الخلفية والأمامية الخاصة به. كيفية إعداد Action Cable. كيفية إعداد القنوات. النشر وإعداد المعمارية لتشغيل Action Cable. المقدمة يدمج Action Cable مقابس الويب WebSockets مع باقي تطبيق ريلز بسلاسة. يسمح ذلك بكتابة الميزات في الوقت الحقيقي في روبي بنفس الأسلوب والشكل كبقية تطبيقات ريلز، مع الاستمرار في الأداء وقابلية التطوير. ...
التابع .on() في jQuery
.on( events [, selector ] [, data ], handler ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر بالعناصر المحدَّدة. .on( events [, selector ] [, data ], handler ) أُضيف مع الإصدار: 1.7. events سلسلة نصية تحتوي على نوع حدث واحد، أو عدَّة أنواع أحداث مفصولة بمسافة فارغة بالإضافة إلى مجالات أسماء (namespaces) (اختياريَّا) مثل "click"، أو "keydown.myPlugin". selector سلسلة نصية تمثِّل اسم المحدِّد الذي يرشِّح أحفاد (descedants) العناصر ...
Document.pointerLockElement
تُعيد هذه الخاصيّة القابلة للقراءة فقط مجموعة العناصر التي تقع ضمن هدف أحداث الفأرة أثناء قفل مؤشّر الفأرة. تُعيد القيمة null في حالة كان القفل مُعلّقا، أو في حالة كان المُؤشّر غير مُقفل، أو إذا ما كان الهدف يقع في مُستند آخر. البنية العامة var element = document.pointerLockElement;
القيمة المُعادة تكون إمّا كائنًا من النّوع Element أو القيمة null. دعم المتصفحات الميزة Chrome Internet Explorer Firefox Opera Safari الدعم الأساسي 53 نعم نعم 40 نعم انظر أيضًا Document.exitPointerLock() Element.requestPointerLock() مصادر ...
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 بدلًا من اختفائها دون سدًى. استَبدل هذا ...
التابع .height() في jQuery
يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة أو يغير الطول لكل العناصر المتطابقة. .height() القيم المعادة عدد من النوع Number. الوصف يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة سابقًا. .height() أضيف مع الإصدار 1.0، ولا يقبل هذا التابع أي معاملات. الفرق بين التابع .css( "height" ) والتابع .height() هو أن الأخير يعيد قيمة الطول بدون واحدة (يعيد 400 مثلًا)، بينما يعيد التابع الأول قيمة الطول مع واحدة (يعيد 400px مثلًا). يفضل استعمال ...
الخاصية .jquery في jQuery
الخاصية .jquery القيم المعادة تعيد سلسلة نصية من النوع String. الوصف يُسند إلى هذه الخاصِّية سلسلة نصية تحتوي على رقم إصدار jQuery. jquery أُضيف مع الإصدار: 1.0. الخاصِّيَّة .jquery هي سلسلة نصية تحتوي على رقم إصدار jQuery مثل "1.5.0" أو "1.4.4"، وتُسند إلى نموذج jQuery الأولي، ويشار إليها عادةً عبر الاسم البديل $.fn. أمثلة تحديد إن كان كائنٌ ما هو كائن jQuery: $(function() {
// أصبحت الصفحة جاهزة
});
استعمال اختصار للشكل $(document).ready() ووسيط لكتابة شيفرة الفشل الآمن (failsafe) في 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) ...
دمج التصريحات في TypeScript
مقدمة تصِف بعض المبادئ الفريدة الموجودة في لغة TypeScript شكل كائنات JavaScript على مستوى الأنواع. مبدأ دمج التصريحات (declaration merging) من المزايا التي تنفرد بها TypeScript. سيُساعد فهم هذا المبدأ على العمل مع شيفرة JavaScript الموجودة مسبقًا. إضافة إلى أنّها توفّر قدرة على إعمال مبادئ تجريد (abstraction concepts) أكثر تقدّمًا. نعني بدمج التصريحات في هذه الصفحة بأنّ المترجم يدمج تصريحين مختلفين لهما نفس الاسم في تعريف واحد. يمتلك هذا التعريف المندمج مزايا التصريحين الأصليّين. يُمكن دمج أي عدد من التصريحات، ...
Document.visibilityState
تُعيد الخاصيّة Document.visibilityState القابلة للقراءة فقط حالةَ ظهور المُستند، أي سياق وضوح العنصر الحالي. إذ من المُفيد معرفة ما إذا كان المُستند في الخلفيّة أو في تبويب (لسان، tab) غير مرئي حاليًّا، أو أنّ الصّفحة قد حُمّلت فقط من أجل ما قبل التّصيير (pre-rendering). القيم المُمكنة هي كما يلي: 'visible': تُشير إلى أنّ مُحتويات الصّفحة قد تكون ظاهرة ولو جزئيّا. هذا يعني بأنّ الصفحة موجودة على تبويب أمامي في نافذة غيرِ مُصغّرة. 'hidden': مُحتويات الصّفحة غير واضحة للمستخدم. هذا يعني ...
Document.getElementsByClassName()
يُعيد التّابع Document.getElementsByClassName() كائنًا مُشابهًا للمصفوفات يحتوي على جميع العناصر الأولاد التي تحمل نفس اسم الصّنف (class name) المُعطى. عند استدعائه على كائن المُستند، فسيُبحَثُ في كامل المُستند، ما يشمل العقدة الجذر. يُمكن كذلك استدعاء التّابع getElementsByClassName() على أي عنصر؛ وسيُعيد العناصر الأولاد للعنصر الجذر المُحدَّد ذات أسماء الأصناف المعطاة. البنية العامة var elements = document.getElementsByClassName(names);
// أو
var elements = rootElement.getElementsByClassName(names);
elements كائنٌ حيّ من النّوع HTMLCollection الذي يُمثّل مجموعة العناصِر التي وُجدت. names سلسلةٌ نصيّةٌ تُمثّل قائمة أسماء الأصناف المرغوب ...
توسعة Sass
توفر Sass عددًا من التّخصيصات المتقدِّمة لأجل المستخدمين ذوي المتطلبات الفريدة. استخدام هذه الميزات يتطلب فهمًا جيدًا للغة Ruby. تعريف دوال مخصَّصةٍ في Sass يمكن للمستخدمين تعريف دوال Sass خاصةً بهم باستخدام Ruby API. انظر لمزيدٍ من المعلومات توثيق الدوال. التخزين المؤقت (Cache Stores) تُخزِّن Sass مؤقتًا الملفّات المُحلّلة (parsed documents) وبذلك يمكن إعادة استخدامها دون إعادة تحليلها إلّا إن حدثت تغيرات في الملف. افتراضيًا، ستكتب Sass هذه الملفات المُخزّنة مؤقتًا في مكانٍ في نظام الملفات (filesystem) المشار إليه في ...
التابع .attr() في jQuery
يُستَخدَم التّابع .attr() للحصول على قيمة خاصيّة HTML لأوّل عنصر من مجموعة العناصر المُطابِقة، أو تعيين خاصيّة HTML أو عدة خاصيّات لكل عنصر مُطابِق. attr( attributeName ). القيمة المعادة سلسلة نصيّة على شكل الكائن String. الوصف الحصول على قيمة خاصيّة HTML لأوّل عنصر من مجموعة العناصر المُطابِقة. attr( attributeName ). أضيفت في الإصدار: 1.0. attributeName سلسلة نصيّة من الكائن String، تُمثِّل اسم خاصيّة HTML المطلوب الحصول على قيمتها. يحصل التّابع .attr() على قيمة خاصيّة HTML لأول عنصر فقط من المجموعة ...
المُنشِئ الحافظ للنوع (Type-Safe Builder) في لغة Kotlin
المُنشِئ الحافظ للنوع (Type-Safe Builder) يُتاح بناءُ المُنشِئ الستاتيكيّ الحافظ للنوع في لغة Kotlin باستخدام الدوال ذات التسمية المعبِّرة كمُنشِئ (builder) بالإضافة إلى قيم حرفية (literals) للدوال مع المستقبِل (receiver)، إذ يسمح المُنشِئ الحافظ للنوع ببناء لغات مُخصَّصة المجال (DSL) بالاعتماد على Kotlin بما يتناسب مع إنشاء بُنى البيانات الهرميّة المعقَّدة بطريقةٍ نصف تصريحية (semi-declarative)، وهذه بعض الأمثلة من حالات استخدامه: توليد ترميزٍ (markup) باستخدام شيفرة Kotlin مثل HTML أو XML تصميم أجزاء واجهات المستخدم (UI) برمجيًا مثل Anko ضبط ...
التابع jQuery.htmlPrefilter() في jQuery
jQuery.htmlPrefilter( html ) القيم المعادة يعيد سلسلةً نصيةً (String). الوصف يعدِّل ويرشِّح هذا التابع سلاسل HTML النصية الممرَّرة عبر توابع التعديل (manipulation) في jQuery. jQuery.htmlPrefilter( html ) أُضيف مع الإصدار: 1.12/2.2. html سلسلة نصية تحتوي على شيفرة HTML التي يراد تطبيق العمليَّة عليها. إنَّ الحاجة إلى استدعاء هذا التابع بشكل مباشر أمرٌ نادر الحدوث، إذ يستعمل بدلًا من ذلك كنقطة دخول لتعديل توابع التعديل الموجودة. إن أردنا مثلًا إزالة الوسم <del> من محتوى HTML الوارد، فاستعمل هذا التابع مثلما موضح ...
التابع jQuery.htmlPrefilter() في jQuery
jQuery.htmlPrefilter( html ) القيم المعادة يعيد سلسلةً نصيةً (String). الوصف يعدِّل ويرشِّح هذا التابع سلاسل HTML النصية الممرَّرة عبر توابع التعديل (manipulation) في jQuery. jQuery.htmlPrefilter( html ) أُضيف مع الإصدار: 1.12/2.2. html سلسلة نصية تحتوي على شيفرة HTML التي يراد تطبيق العمليَّة عليها. إنَّ الحاجة إلى استدعاء هذا التابع بشكل مباشر أمرٌ نادر الحدوث، إذ يستعمل بدلًا من ذلك كنقطة دخول لتعديل توابع التعديل الموجودة. إن أردنا مثلًا إزالة الوسم <del> من محتوى HTML الوارد، فاستعمل هذا التابع مثلما موضح ...
الدالة cgi.print_directory() في بايثون
تنسّق الدالة المجلّد الحالي بصيغة HTML. البنية العامة cgi.print_directory()
انظر أيضًا الدالة cgi.print_environ(): تنسّق الدالة بيئة الصدفة بصيغة HTML. الدالة cgi.print_form(): تنسّق الدالة النموذج بصيغة HTML. الدالة cgi.print_environ_usage(): تطبع الدالة قائمة من متغيرات البيئة المفيدة (المستخدمة من قبل CGI) بصيغة HTML. مصادر صفحة Common Gateway Interface support في توثيق بايثون الرسمي.
الدالة cgi.print_environ() في بايثون
تنسّق الدالة بيئة الصدفة بصيغة HTML. البنية العامة cgi.print_environ()
انظر أيضًا الدالة cgi.print_form(): تنسّق الدالة النموذج بصيغة HTML. الدالة cgi.print_directory(): تنسّق الدالة المجلّد الحالي بصيغة HTML. الدالة cgi.print_environ_usage(): تطبع الدالة قائمة من متغيرات البيئة المفيدة (المستخدمة من قبل CGI) بصيغة HTML. مصادر صفحة Common Gateway Interface support في توثيق بايثون الرسمي.
الدالة cgi.print_environ_usage() في بايثون
تطبع الدالة قائمة من متغيرات البيئة المفيدة (المستخدمة من قبل CGI) بصيغة HTML. البنية العامة cgi.print_environ_usage()
انظر أيضًا الدالة cgi.print_environ(): تنسّق الدالة بيئة الصدفة بصيغة HTML. الدالة cgi.print_form(): تنسّق الدالة النموذج بصيغة HTML. الدالة cgi.print_directory(): تنسّق الدالة المجلّد الحالي بصيغة HTML. مصادر صفحة Common Gateway Interface support في توثيق بايثون الرسمي.
تعديل الخاصيات في jQuery
جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل خاصية محددة لعنصر (أو مجموعة من العناصر). توصف أغلبية هذه التوابع على أنها «توابع ضابطة» (setters)، إذ تضبط وتغير قيمة خاصية محددة. هنالك قلة من هذه التوابع توصف على أنها «توابع جالبة» (getters) مثل .attr() و .html() و .val() لأنها تجلب معلومات من عناصر DOM لاستخدامها لاحقًا. (إن كنت تود إجراء تعديل على العنصر نفسه، فارجع إلى قسم «تعديل العناصر»). .addClass() يُضيف هذا التّابع الصّنف أو الأصناف المُحدَّدة لكل ...
الدالة cgi.print_form() في بايثون
تنسّق الدالة النموذج بصيغة HTML. البنية العامة cgi.print_form(form)
المعاملات form النموذج المراد تنسيقه بواسطة الدالة. انظر أيضًا الدالة cgi.print_environ(): تنسّق الدالة بيئة الصدفة بصيغة HTML. الدالة cgi.print_directory(): تنسّق الدالة المجلّد الحالي بصيغة HTML. الدالة cgi.print_environ_usage(): تطبع الدالة قائمة من متغيرات البيئة المفيدة (المستخدمة من قبل CGI) بصيغة HTML. مصادر صفحة Common Gateway Interface support في توثيق بايثون الرسمي.
Document.title
تُعيد أو تضبِط عنوان المُستند. البنية العامة var docTitle = document.title
المُتغيّر docTitle سلسلةٌ نصيّةٌ تحتوي على عنوان المُستند. إن كان عنوان المُستند قد ضُبِط بالخاصيّة document.title، فسيُعيد القيمة المضبوطة، أو يُعيد العنوان المضبوط في اللغة الهيكليّة (مثل HTML أو SVG، انظر المُلاحظات أسفله). document.title = newTitle;
المُتغيّر newTitle هو العنوان الجديد للمُستند. هذا التّعيين يُؤثّر على القيمة المُعادة للخاصيّة document.title، ويؤثّر كذلك على العنوان المعروض للمُستند (كعنوان نافذة المُتصفّح مثلًا)، ويُؤثّر كذلك على مُكوّنات DOM في المُستند (أي مُحتوى ...
التابع .wrapInner() في jQuery
.wrapInner( wrappingElement ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف تغليف شيفرة HTML حول محتوى كل عنصر في مجموعة العناصر المُطابقة. .wrapInner( wrappingElement ) أُضيف مع الإصدار: 1.2. wrappingElement شيفرة HTML أو تعبير مُحدد أو كائن jQuery أو عنصر DOM يحدد شيفرة تغليف محتوى العناصر المُطابقة. وهو من النوع Selector أو htmlString أو Element أو jQuery. .wrapInner( function ) أُضيف مع الإصدار: 1.4. function دالة على الشكل Function( Integer index ) => String. وهي دالة رد نداء تُنشئ شيفرة HTML لتغليف محتوى العناصر ...
محدد الخاصيات ذات السابقة [name|="value"] في jQuery
محدد الخاصيات ذات السابقة [name|="value"] الوصف تحديد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تساوي السلسلة النصيّة المُعطاة أو تبدأ بتلك السلسلة النصيّة متبوعةً بشرطة (-). jQuery( "[attribute|='value']" ) أضيفت في الإصدار: 1.0. attribute اسم خاصيّة HTML. value قيمة خاصيّة HTML، يُمكِن أن تكون مُعرِّفًا صالحًا (valid identifier) أو سلسلةً نصيّةً موضوعةً بين علامتي اقتباس. أُضيف هذا المُحدِّد إلى مواصفات CSS للتعامل مع خاصيّات HTML في تلك اللغة. أمثلة إيجاد كافّة الرّوابط التي تمتلك الخاصيّة hreflang ذات اللغة الإنجليزيّة، ...
محدد الخاصيات التي فيها كلمة [name~="value"] في jQuery
محدد الخاصيات التي فيها كلمة [name~="value"] الوصف تحديد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تحتوي على الكلمة المُعطاة محدودةً بينها بمسافات فارغة. jQuery( "[attribute~='value']" ) أضيفت في الإصدار: 1.0. attribute اسم خاصيّة HTML. value قيمة خاصيّة HTML. يُمكِن أن تكون مُعرِّفًا صالحًا (valid identifier) أو سلسلةً نصيّةً موضوعةً بين علامتي اقتباس. يُطابِق هذا المُحدِّد السلسلة النصيّة المُختَبَرَة مع كل كلمة من قيمة خاصيّة HTML، حيث تُعرَّف الكلمة كسلسلة نصيّة مفصولة بينها بمسافات فارغة. يُطابِق المُحدِّد إن كانت السلسلة ...
التابع HTMLCalendar.formatmonth() في بايثون
يعيد التابع تقويم الشهر المعطى بصيغة جدول HTML. البنية العامة formatmonth(theyear, themonth, withyear=True)
المعاملات theyear السنة المطلوبة. themonth الشهر المطلوب (من 1 إلى 12). withyear معامل اختياري يحمل قيمة منطقية. إن أخذ هذا المعامل القيمة True فإنّ التابع سيضيف السنة إلى ترويسة جدول HTML المعاد. أما إن أخذ االمعامل القيمة False فتقتصر الترويسة على اسم الشهر فقط. القيمة المعادة سلسلة نصية تتضمّن تقويم الشهر المطلوب في السنة المطلوبة بهيئة جدول HTML. أمثلة يبين المثال التالي آلية عمل التابع: >>> from ...
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 قيمةٌ مُهملَة تعرض عقد الخصائص ...
محدد الخاصيات التي تبدأ بـ [name^="value"] في jQuery
محدد الخاصيات التي تبدأ بـ [name^="value"] الوصف تحديد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تبدأ بالضّبط بالسلسلة النصيّة المُعطاة. jQuery( "[attribute^='value']" ) أضيفت في الإصدار: 1.0. attribute اسم خاصيّة HTML. value قيمة خاصيّة HTML. يُمكِن أن تكون مُعرِّفًا صالحًا (valid identifier) أو سلسلةً نصيّةً موضوعةً بين علامتي اقتباس. يُفيد هذا المُحدِّد في تحديد العناصر في صفحات مُنتَجَة من قبل أُطُر عمل من جهة الخادم (server-side frameworks) والتي تُنتِج HTML مع وضع مُعرِّفات مُمنهجة للعناصر، ولكن على الرغم من ...
التابع .text() في jQuery
يجلب هذا التابع المحتوى النصي المرتبط بكل عنصر في مجموعة العناصر المطابقة بالإضافة إلى العناصر الأحفاد لهم، أو يغيِّر المحتوى النصي للعناصر المطابقة. .text() القيم المعادة يعيد سلسلة نصية من النوع String. الوصف يجلب هذا التابع المحتوى النصي المرتبط بكل عنصر في مجموعة العناصر المطابقة بالإضافة إلى المحتوى النصي للعناصر الأحفاد أيضًا. .text() أُضيف مع الإصدار: 1.0. ولا يقبل هذا التابع أية وسائط. يمكن استعمال التابع .text() في مستندات XML ومستندات HTML كلاهما خلافًا للتابع .html(). يعيد التابع سلسلة نصية ...
الدالة strip_tags() في PHP
(PHP 4, PHP 5, PHP 7) تُزِيل الدالة strip_tags() وسوم HTML و PHP من سلسلة نصية. الوصف string strip_tags ( string $str [, string $allowable_tags ] )
تحاول الدالة strip_tags() إعادة سلسلة نصية بعد تجريدها من جميع علامات NULL bytes و HTML و PHP من المعامل str المعطى. المعاملات str السلسلة النصية المدخلة. allowable_tags يمكنك استخدام المعامل الثاني الاختياري لتحديد الوسوم التي لا ينبغي إزالتها. ملاحظات ملاحظة: تُحذَف أيضًا تعليقات HTML ووسوم PHP. هذا الأمر مضبوطٌ في أساس هذه الدالة ولا ...
عرض (100 السابقة | 100 التالية) (20 | 50 | 100 | 250 | 500).