نتائج البحث

ما هو DOM الافتراضي (Virtual DOM)؟ DOM الافتراضي (أو اختصارًا VDOM) هو مفهوم برمجي نحتفظ فيه بالتمثيل المثالي أو الافتراضي لواجهة المستخدم ضمن الذاكرة مع مزامنته مع DOM الحقيقي عن طريق مكتبة مثل React DOM. تُدعى هذه العمليّة بالمطابقة (reconciliation). تُمكِّن هذه الطريقة واجهة برمجة التطبيق التصريحية في React، حيث تُخبِر React الحالة التي تريد أن تكون بها واجهة المستخدم لديك، فتحرص React على مطابقة DOM مع تلك الحالة. يُجرِّد هذا التعامل مع الخاصيّات، ومعالجة الأحداث، وتحديث DOM اليدوي الذي ...

تُعيد كائنًا من النّوع DOMImplementation مرتبط بالمستند الحالي. البنية العامة DOMImpObj = document.implementation; مثال var modName = "HTML"; var modVer = "2.0"; var conformTest = document.implementation.hasFeature( modName, modVer ); alert( "DOM " + modName + " " + modVer + " supported?: " + conformTest ); يعرض المثال نافذة تنبيه مُحتواها DOM HTML 2.0 supported?: true إذا كانت وحدة DOM المستوى الثّاني مدعومة. قائمة أسماء وحدات (Core، و HTML، و XML، ...إلخ.) متوافرة في قسم Conformance Section الخاصّ بالمستوى الثّاني من DOM. ملاحظات ...

تُشكِّل العناصر أصغر بنية لتطبيقات React. يصف العنصر ما الذي تود رؤيته على الشّاشة: const element = <h1>أهلًا بالعالم</h1>; على عكس عناصر DOM الخاصّة بالمتصفّح، تكون عناصر React عبارة عن كائنات مُجرّدة سهلة الإنشاء، ويعتني React DOM بتحديث DOM لمُطابقة عناصر React. ملاحظة: قد يخلط المرء العناصر مع مفهوم أكثر انتشارًا وهو المُكوِّنات (components)، سنتحدّث عن المُكوِّنات بالتفصيل في القسم الخاص بها. إنّ العناصر هي الشيء الذي تُصنَع منه المُكوِّنات، ومن المُفضَّل أن تقرأ ذلك القسم قبل المتابعة. تصيير العنصر إلى ...

يُنشئُ التّابع Document.createDocumentFragment()‎ كائنا فارغًا من النّوع DocumentFragment. البنية العامة var fragment = document.createDocumentFragment(); fragment مرجِع يُشير إلى كائن فارغ من النّوع DocumentFragment. وصف كائنات DocumentFragment هي عقدُ DOM. ولا تكون أبدًا جزءًا من شجرة DOM الأساسيّة. الغرض منها يكون عادةً إنشاء قطعة مُستندٍ (document fragment) ثمّ إضافة عناصرَ إليها، ثمّ إضافة قطعة المُستند إلى شجرة DOM. وتُبدَلُ قطعة المستند في شجرة DOM بجميع أولادها. ولأنّ قطعة المُستند تُخزَّن في الذّاكرة ولا تكون جزءًا من شجرة DOM الرّئيسيّة، فإضافة أولاد ...

jQuery.contains( container, contained )‎ القيم المعادة يعيد قيمة منطقيَّة (Boolean). الوصف يتحقَّق هذا التابع إن كان عنصر DOM معيَّن هو عنصر سليل (ancestor) من عنصر DOM آخر. jQuery.contains( container, contained )‎ أُضيف مع الإصدار: 1.4. container عنصر DOM الذي قد يحوي العنصر contained المعطى. contained العنصر DOM الذي سيتأكد التابع من أنَّه عنصرٌ سليلٌ من العنصر container. يعيد التابع ‎$.contains()‎ القيمة true إن كان العنصر contained المعطى هو عنصر سليل من العنصر container المعطى أيضًا سواءً كان ذلك العنصر ابنًا ...

jQuery.contains( container, contained )‎ القيم المعادة يعيد قيمة منطقيَّة (Boolean). الوصف يتحقَّق هذا التابع إن كان عنصر DOM معيَّن هو عنصر سليل (ancestor) من عنصر DOM آخر. jQuery.contains( container, contained )‎ أُضيف مع الإصدار: 1.4. container عنصر DOM الذي قد يحوي العنصر contained المعطى. contained العنصر DOM الذي سيتأكد التابع من أنَّه عنصرٌ سليلٌ من العنصر container. يعيد التابع ‎$.contains()‎ القيمة true إن كان العنصر contained المعطى هو عنصر سليل من العنصر container المعطى أيضًا سواءً كان ذلك العنصر ابنًا ...

يُنشئُ التّابع 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" دعم ...

jQuery.uniqueSort( array )‎ القيم المعادة يعيد مصفوفة (Array). الوصف يرتِّب هذا التابع مصفوفةً من عناصر DOM، في مكانها، مع حذف العناصر المتكرِّرة. انتبه إلى أنَّ هذا التابع لا يصلح للعمل إلا مع المصفوفات التي تحوي عناصر DOM فقط. jQuery.uniqueSort( array )‎ أُضيفت مع الإصدار: 1.12/2.2. array مصفوفةٌ من عناصر DOM. يرتِّب التابع ‎$.uniqueSort()‎ مصفوفةً من الكائنات ويحذف أيَّة عقدٍ متكرِّرة. تُعدُّ العقدة متكرِّرة إن كان لها الاسم نفسه الذي تملكه عقدة أخرى موجودة قبلها في المصفوفة. أمَّا كان هنالك عقدتين ...

jQuery.uniqueSort( array )‎ القيم المعادة يعيد مصفوفة (Array). الوصف يرتِّب هذا التابع مصفوفةً من عناصر DOM، في مكانها، مع حذف العناصر المتكرِّرة. انتبه إلى أنَّ هذا التابع لا يصلح للعمل إلا مع المصفوفات التي تحوي عناصر DOM فقط. jQuery.uniqueSort( array )‎ أُضيفت مع الإصدار: 1.12/2.2. array مصفوفةٌ من عناصر DOM. يرتِّب التابع ‎$.uniqueSort()‎ مصفوفةً من الكائنات ويحذف أيَّة عقدٍ متكرِّرة. تُعدُّ العقدة متكرِّرة إن كان لها الاسم نفسه الذي تملكه عقدة أخرى موجودة قبلها في المصفوفة. أمَّا كان هنالك عقدتين ...

jQuery.unique( array )‎ أهمل مع الإصدار: 3.0. القيم المعادة يعيد مصفوفة (Array). الوصف يرتِّب هذا التابع مصفوفةً من عناصر DOM، في مكانها، مع حذف العناصر المتكرِّرة. انتبه إلى أنَّ هذا التابع لا يصلح للعمل إلا مع المصفوفات التي تحوي عناصر DOM فقط. jQuery.unique( array )‎ أُضيف مع الإصدار: 1.1.3. array مصفوفةٌ من عناصر DOM. بدءًا من الإصدار jQuery 3.0، أهمل هذا التابع وأصبح اسمًا بديلًا للتابع jQuery.uniqueSort()‎. استَعمِل رجاءً التابع الأخير عوضًا عن هذا التابع. يرتِّب التابع ‎$.unique()‎ مصفوفةً من ...

jQuery.unique( array )‎ أهمل مع الإصدار: 3.0. القيم المعادة يعيد مصفوفة (Array). الوصف يرتِّب هذا التابع مصفوفةً من عناصر DOM، في مكانها، مع حذف العناصر المتكرِّرة. انتبه إلى أنَّ هذا التابع لا يصلح للعمل إلا مع المصفوفات التي تحوي عناصر DOM فقط. jQuery.unique( array )‎ أُضيف مع الإصدار: 1.1.3. array مصفوفةٌ من عناصر DOM. بدءًا من الإصدار jQuery 3.0، أهمل هذا التابع وأصبح اسمًا بديلًا للتابع jQuery.uniqueSort()‎. استَعمِل رجاءً التابع الأخير عوضًا عن هذا التابع. يرتِّب التابع ‎$.unique()‎ مصفوفةً من ...

‎.closest( selector )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع ‎.closest()‎ بالنسبة لكل عنصر في المجموعة للحصول على العنصر الأول الذي يُطابِق المُحدِّد عن طريق اختبار العنصر ذاته والانتقال إلى العناصر الأسلاف له في شجرة DOM. ‎.closest( selector )‎ أضيفت في الإصدار: 1.3. selector مُحدِّد، ويُمثِّل سلسلة نصيّة تحتوي على تعبير المُحدِّد المطلوب مُطابقة العناصر معه. ‎.closest( selector [, context ] )‎ أضيفت في الإصدار: 1.4. selector مُحدِّد، ويُمثِّل سلسلة نصيّة تحتوي على تعبير المُحدِّد المطلوب مُطابقة العناصر معه. context ...

تُعيد تعريف نوع المُستند (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.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( 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 ...

‎.remove( [selector ] )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع مجموعة العناصر المطابقة من DOM. ‎.remove( [selector ] )‎ أُضيف مع الإصدار: 1.0. selector سلسلة نصية تمثِّل تعبير المحدد الذي يرشِّح مجموعة العناصر المطابقة لإزالتها. يطرح التابع ‎.remove()‎ عناصر محدَّدة خارج DOM بطريقة مماثلة لما يفعله التابع ‎.empty()‎. استعمل التابع ‎.remove()‎ لحذف عنصر معين بذاته بالإضافة إلى حذف كل شيء بداخله. أضف إلى ذلك أيضًا أنه يحذف جميع الأحداث وبيانات jQuery المرتبطة والمتعلقة بالعنصر. إن ...

‎.ready( handler )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف ينفِّذ هذا التابع دالةً عندما تكون شجرة DOM جاهزة. ‎.ready( handler )‎ أُضيف مع الإصدار: 1.0. handler الدالة المراد تنفيذها بعد أن تصبح DOM جاهزة. يوفر التابع ‎.ready()‎ طريقة لتشغيل شيفرة JavaScript حالما يصبح بالإمكان تعديل DOM بشكل آمن. يُعدُّ هذا الوقت غالبًا أفضل الأوقات لإنجاز مهامٍ ضرورية قبل أن يشاهد المستخدم الصفحة أو يتفاعل معها مثل إضافة معالجات أحداث أو تهيئة إضافات معيَّنة. عندما تُضاف دوال متعدِّدة عبر ...

تُعيد الخاصيّة documentURI الخاصّة بالواجهة Document مكان المستند على شكل سلسلة نصية. هذه الخاصّية قابلة للقراءة فقط في معيار DOM المُعاصر. البنية العامّة var string = document.documentURI; ملاحظات مستندات HTML تمتلك خاصيّة document.URL التي تُعيد نفس القيمة. الفرق بينهما هو أنّ documentURI مُتاحة على جميع أنواع المستندات. دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari قابليّة القراءة والكتابة نعم نعم نعم ؟ نعم قابلية القراءة فقط 43 نعم لا ؟ لا مصادر ومواصفات مواصفة DOM. مواصفة Document Object Model ...

‎.before( content [, content ] )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع ‎‎.before()‎‎ لإدخال المحتوى المُحدَّد عن طريق المُعامِل قبل كل عنصر من مجموعة العناصر المُطابقة. ‎.before( content [, content ] )‎ أضيفت في الإصدار: 1.0. content سلسلة نصيّة من الكائن htmlString، أو عنصر، أو نص، أو مصفوفة، أو jQuery، وتُمثِّل سلسلة HTML، أو عنصر DOM، أو عقدة نصيّة (text node)، أو مصفوفة من العناصر والعقد النصيّة، أو كائن jQuery المطلوب إدخالها قبل كل عنصر من مجموعة العناصر المُطابقة. ...

يُنشئ التّابع Document.importNode()‎ نسخةً جديدةً من العقدة Node أو قطعة المُستند DocumentFragment المُحدّدة من مستندٍ آخر ليُمكِنَ إدخالها إلى المستند الحاليّ. لكنّها لا تُدخل إلى شجرة المُستند، لفعل ذلك، عليك استدعاء تابع مثل Node.appendChild()‎ أو Node.insertBefore()‎. البنية العامة var node = document.importNode(externalNode, deep); externalNode‎ الكائن الجديد من النّوع Node أو DocumentFragment المرغوب استيراده إلى المستند الحالي. قيمة الخاصيّة parentNode الخاصّة بالعقدة الجديدة تكون null لأنّ العقدة لم تُدخَل بعدُ إلى شجرة المستند. deep‎ قيمةٌ منطقيّة من النّوع Boolean تُشير إلى ...

‎.detach( [selector ] )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع مجموعة العناصر المتطابقة من DOM. ‎.detach( [selector ] )‎ أُضيف مع الإصدار: 1.4. selector تعبير مُحدِّد يُرشِح مجموعة العناصر المتطابقة المراد حذفها وهو من النوع Selector. يعمل التابع ‎.detach()‎ مثل التابع  ‎.remove()‎ ، باستثناء أن ‎.detach()‎ يحتفظ بكل بيانات jQuery المرتبطة بالعناصر المحذوفة. يُفيد هذا التابع عند إعادة إدراج العناصر التي تمت إزالتها إلى DOM في وقت لاحق. أمثلة حذف جميع الفقرات من DOM: <!doctype ...

تعيد هذه الدالة مجموعةً من العناصر المطابقة التي إمَّا وُجدَت في شجرة DOM بناءً على الوسائط المُمرَّرة، أو أنشئت بتمرير سلسلة نصية تحتوي على محتوى HTML. ‎jQuery( selector [, context ] )‎ القيم المعادة تعيد كائنًا من النوع jQuery. الوصف تقبل هذه الدالة سلسلة نصية تحتوي على محدِّد CSS يُستعمَل لمطابقة مجموعة من العناصر. ‎jQuery( selector [, context ] )‎ أُضيفت مع الإصدار: 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد. context عنصر DOM، أو كائن Document، أو كائن jQuery ...

after( content [, content ] )‎. القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع ‎.after()‎ لإدخال المحتوى المُحدَّد عن طريق المُعامِل بعد كل عنصر من مجموعة العناصر المُطابقة. ‎.after( content [, content ] )‎ أضيفت في الإصدار: 1.0. content سلسلة نصيّة من الكائن htmlString، أو عنصر، أو نص، أو مصفوفة، أو jQuery، وتُمثِّل سلسلة html، أو عنصر DOM، أو عقدة نصيّة (text node)، أو مصفوفة من العناصر والعقد النصيّة، أو كائن jQuery المطلوب إدخالها بعد كل عنصر من مجموعة العناصر المُطابقة. ...

يُعيد التّابع Document.getElementById()‎ كائنًا من النّوع Element يُمثّل العنصر ذو المُعرّف (id) الذي يُوافق السلسلة النّصيّة المُحدّدة. ولأنّ مُعرّفات العناصر لا بدّ لها أن تكون فريدة عند إنشائها، فهي مُفيدة للوصول إلى عنصرٍ مُعيّنٍ بسرعة. إن أردت الوصول إلى عنصر لا يملك مُعرّفًا، يُمكنك استعمال التّابع querySelector()‎ للوصول إلى العنصر بأيّ مُحدِّدٍ كيفما كان. البنية العامة var element = document.getElementById(id); element‎ كائنٌ من النّوع Element يُمثّل عنصر DOM الذي يوافق مُعرّفه المُعرّف المُعطى، أو القيمة null‎ في حالة لم يوجد ...

‎.nextUntil( [selector ] [, filter ] )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يجلب هذا التابع جميع العناصر الأخوة التالية لكل عنصر والموجودة ضمن مجال محدَّد بدءًا من العنصر الأخ الذي يليه وحتى العنصر المطابق بوساطة المحدِّد أو عقدة DOM أو كائن jQuery (دون أن يدخل هذا العنصر ضمن المجال). ‎.nextUntil( [selector ] [, filter ] )‎ أُضيف مع الإصدار: 1.4. selector سلسلة نصية تحتوي على تعبير محدِّد يشير إلى مكان توقف مطابقة العناصر الأخوة التالية. filter سلسلة ...

‎.removeProp( propertyName )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع خاصِّيَّة كائنيِّة محدَّدة لكل عنصر في مجموعة العناصر المطابقة. ‎.removeProp( propertyName )‎ أُضيف مع الإصدار: 1.6. propertyName سلسلة نصية تمثِّل اسم الخاصِّيَّة الكائنية المراد حذفها. يحذف التابع ‎.removeProp()‎ الخاصِّيَّات التي ضُبطَت باستعمال التابع ‎.prop()‎. قد تولِّد المتصفحات خطأً عند محاولة حذف بعض الخاصِّيَّات المضمَّنة لعنصر DOM أو الكائن window. تسند الخاصِّيَّة jQuery آنذاك القيمة undefined للخاصِّيَّة وتتجاهل أي خطأ ولَّده المتصفح. من المهم عمومًا حذف الخاصِّيَّات ...

نُفضِّل في معظم الحالات استخدام المُكوّنات المضبوطة من أجل حقول الإدخال، ففي المُكوّنات المضبوطة يتعامل مُكوّن React مع بيانات الحقول. البديل لها هو المُكوّنات غير المضبوطة والتي يتعامل فيها DOM مع بيانات الحقول. لكتابة مُكوّن غير مضبوط بدلًا من كتابة معالج أحداث لكل تحديث للحالة، فبإمكانك استخدام المراجع للحصول على قيم الحقول من DOM. مثلًا تقبل هذه الشيفرة اسمًا واحدًا في المُكوّن غير المضبوط: class NameForm extends React.Component { constructor(props) { super(props); this.handleSubmit ...

توفر التوابع الموجودة في هذا القسم بعض عدة خدمات ووظائف متنوعة. يصعب حصرها في تصنيف أو قسم واحد. ‎jQuery.dequeue()‎ ينفَّذ هذا التابع الدالة التالية الموجودة في طابور الانتظار للعناصر المتطابقة. ‎jQuery.each()‎ هذه الدالة هي دالة تكرار عامة تستعمل لتكرار تنفيذ دالة بسلاسة تامة عبر الكائنات والمصفوفات. عدد مرات تكرار تنفيذ الدالة على المصفوفات والكائنات الشبيهة بالمصفوفات التي لها الخاصِّيَّة length (مثل الكائن الذي يحوي وسائط دالةٍ) تنحصر بالمجال من 0 إلى length-1، إذ length هو عدد العناصر. أمَّا عدد مرات ...

‎.prevUntil( [selector ] [, filter ] )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يجلب هذا التابع جميع العناصر الأخوة السابقة لكل عنصر من مجموعة العناصر المطابقة والموجودة ضمن مجال محدَّد بدءًا من العنصر الأخ الذي يسبقه مباشرةً وحتى العنصر المطابق بوساطة المحدِّد أو عقدة DOM أو كائن jQuery (دون أن يدخل هذا العنصر ضمن المجال). ‎.prevUntil( [selector ] [, filter ] )‎ أُضيف مع الإصدار: 1.4. selector سلسلة نصية تحتوي على تعبير محدِّد يشير إلى مكان توقف مطابقة ...

‎.parentsUntil( [selector ] [, filter ] )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يجلب هذا التابع العناصر الآباء (العنصر الأب [parent] والأجداد [ancestors]) الواقعة بين العنصر الأب الأقرب وحتى العنصر المتطابق باستعمال محدِّد، أو عقدة DOM، أو كائن jQuery (لا يدخل هذا العنصر ضمن المجال) وذلك لكل عنصر في مجموعة العناصر المطابقة، مع إمكانية ترشيحها بشكل اختياري عن طريق محدِّد. ‎.parentsUntil( [selector ] [, filter ] )‎ أضيف مع الإصدار 1.4. selector سلسلة نصية تحتوي على تعبير محدِّد ...

‎.parents([selector ])‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يجلب هذا التابع جميع العناصر الآباء (العنصر الأب [parent] والأجداد [ancestors]) لكل عنصر في مجموعة العناصر المطابقة، ويمكن أن يرشِّح أيضًا تلك العناصر التي أعادها اختياريًا باستعمال محدِّد. ‎.parents( [selector ] )‎ أضيف مع الإصدار 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد لمطابقة العناصر التي يجلبها التابع عند إعطاء التابع ‎.parents()‎ كائن jQuery يمثل مجموعة من عناصر DOM، فسيبحث عن جميع العناصر الآباء لكل عنصر من هذه العناصر في ...

يُعيد التّابع Document.getElementsByTagName()‎ كائنًا من النّوع HTMLCollection‎ يحتوي على جميع العناصر ذات اسم الوسم (tag name) المُعطى. عند استدعائه على كائن المُستند، فسيُبحَثُ في كامل المُستند، ما يشمل العقدة الجذر. القيمة المُعادة حيّة، أي أنّها تُحدّث نفسها تلقائيّا للبقاء مُتزامنةً مع شجرة DOM دون الحاجة إلى استدعاء التّابع Document.getElementsByTagName()‎ مرّة أخرى. البنية العامة var elements = document.getElementsByTagName(name); elements‎ كائنٌ حيّ من النّوع HTMLCollection‎ (لكن انظر الملاحظات أدناه) يُمثّل مجموعة العناصِر التي وُجدت مرتّبةً حسب طريقة عرضها في شجرة DOM. name‎ ...

تُعيد الخاصيّة document.styleSheets القابلة للقراءة فقط قائمةً من النّوع StyleSheetList التي تُعدّ عناصرُها كائناتٍ من النّوع CSSStyleSheet، وهذه الكائنات تُمثّل صفحات الأنماط المربوطة صراحةً أو المُضمّنة في المُستند. البنية العامة var styleSheetList = document.styleSheets; القيمة المُعادة قائمةٌ من النّوع StyleSheetList عناصِرها كائناتٌ من النّوع CSSStyleSheet. مثال function getStyleSheet(unique_title) { for(var i=0; i<document.styleSheets.length; i++) { var sheet = document.styleSheets[i]; if(sheet.title == unique_title) { return sheet; } ...

‎.prepend( content [, content ] )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يُستخدَم هذا التابع ‎في إدخال لمحتوى المُحدَّد عن طريق المُعامِل إلى بداية كل عنصر من مجموعة العناصر المُطابِقة. ‎.prepend( content [, content ] )‎ أضيف مع الإصدار 1.0. content سلسلة نصيّة من الكائن htmlString، أو عنصر، أو نص، أو مصفوفة، أو كائن jQuery، وتُمثِّل سلسلة HTML، أو عنصر DOM، أو عقدة نصيّة (text node)، أو مصفوفة من العناصر والعقد النصيّة، أو كائن jQuery المطلوب إدخالها في ...

‎.append( content [, content ] )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع ‎.append()‎ في إدخال المحتوى المُحدَّد عن طريق المُعامِل إلى آخر كل عنصر من مجموعة العناصر المُطابِقة. ‎.append( content [, content ] )‎ أضيفت في الإصدار: 1.0. content سلسلة نصيّة من الكائن htmlString، أو عنصر، أو نص، أو مصفوفة، أو jQuery، وتُمثِّل سلسلة HTML، أو عنصر DOM، أو عقدة نصيّة (text node)، أو مصفوفة من العناصر والعقد النصيّة، أو كائن jQuery المطلوب إدخالها بعد كل عنصر من مجموعة ...

‎.replaceWith( newContent )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يبدِّل هذا التابع المحتوى الجديد المعطى مكان كل عنصر في مجموعة العناصر المطابقة، ويعيد مجموعة العناصر التي استُبدلت. ‎.replaceWith( newContent )‎ أُضيف مع الإصدار: 1.2. newContent المحتوى الجديد الذي سيحل محل عناصر محدَّدة، وقد يكون سلسلة نصيَّة من الكائن htmlString أو عنصر DOM أو مصفوفة من عناصر DOM أو كائن jQuery. ‎.replaceWith( function )‎ أُضيف مع الإصدار: 1.4. function دالة من الشكل Function()‎، وتعيد المحتوى الذي سيُستبدل بمجموعة العناصر ...

تشكل التوابع والدوال الموجودة في هذا القسم أساس مكتبة jQuery. ‎.length تعيد هذه الخاصِّيَّة عدد العناصر الموجودة في كائن jQuery. ‎.jquery يُسند إلى هذه الخاصِّية سلسلة نصية تحتوي على رقم إصدار jQuery. ‎jQuery()‎ تعيد هذه الدالة مجموعةً من العناصر المطابقة التي إمَّا وُجدَت في شجرة DOM بناءً على الوسائط المُمرَّرة، أو أنشئت بتمرير سلسلة نصية تحتوي على محتوى HTML. ‎jQuery.contains()‎ يتحقَّق هذا التابع إن كان عنصر DOM معيَّن هو عنصر سليل (ancestor) من عنصر DOM آخر. ‎jQuery.cssHooks()‎ يتعلَّق هذا التابع ...

يُنشئ التّابع Document.createNSResolver()‎ كائنًا من النّوع XPathNSResolver الذي يستبين مجالات الأسماء مع احترام التعريفات في النّطاق (scope) لعقدة مُحدَّدة. البنية العامة nsResolver = document.createNSResolver(node); node‎ العقدة المراد استعمالها كسياقٍ لحلّ مجال الأسماء. nsResolver‎ القيمة المعادة، وهي كائنٌ من النّوع XPathNSResolver. ملاحظات يتبنّى التّابع أي عقدة DOM لحلّ مجالات الأسماء لكي يتمّ تقدير (evaluate) تعبير XPath بسهولة حسب سياق العقدة ومكان ظهورها في المستند. هذا المتبنِّي يعمل كالتّابع lookupNamespaceURI‎ المعرّف في مواصفة DOM Level 3 على العقد في حلّ رابط URI ...

‎.each( function )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يكرر هذا التابع، عبر كائن jQuery، تنفيذ دالة لكل عنصر متطابق. ‎.each( function )‎ أُضيف مع الإصدار: 1.0. function دالة تُنفَّذ لكل عنصر متطابق، وهي على الشكل Function( Integer index, Element element )‎. صُمِم التابع ‎.each()‎ لجعل بنية حلقات المرور على عناصر DOM موجزة وأقل عُرضةً للخطأ. عند استدعائه فإنه سيمر على جميع عناصر DOM التي تشكل جزءًا من كائن jQuery. في كل مرة تُشغل فيها دالة رد نداء، ...

محدد العناصر الوصف يُحدد جميع العناصر التي تحمل اسم الوسم المُعطى. jQuery( "element" )‎ أُضيف مع الإصدار: 1.0.  element العنصر المراد البحث عنه. ويشير إلى tagName في عُقَد DOM ‏(DOM nodes). تستدعى الدالة getElementsByTagName()‎ من JavaScript لإعادة العناصر المناسبة عند استخدام هذا التعبير. أمثلة العثور على جميع عناصر <div>: <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>element مثال على محدد العناصر</title> <style> div, span { width: 60px; height: 60px; ...

event.stopPropagation()‎ القيمة المعادة تُعيد هذه الخاصية القيمة undefined. الوصف تمنع هذه الخاصية الحدث من الانتقال عبر شجرة DOM إلى العناصر الأب (event bubbling)، مما يمنع إبلاغ أي من المعالجات الأب عن الحدث. event.stopPropagation()‎ أُضيف مع الإصدار: 1.0. لا تقبل هذه الخاصية أي وسائط. تستخدم الخاصية event.isPropagationStopped()‎ للحقق من استدعاء هذا التابع (على كائن الحدث هذا). تعمل هذه الخاصية مع الأحداث المخصصة المُطلَقة بواسطة التابع trigger()‎ أيضًا. لاحظ أن هذه الخاصية لن تمنع المعالجات الأخرى من العمل على نفس العنصر. ملاحظات ...

event.stopPropagation()‎ القيمة المعادة تُعيد هذه الخاصية القيمة undefined. الوصف تمنع هذه الخاصية الحدث من الانتقال عبر شجرة DOM إلى العناصر الأب (event bubbling)، مما يمنع إبلاغ أي من المعالجات الأب عن الحدث. event.stopPropagation()‎ أُضيف مع الإصدار: 1.0. لا تقبل هذه الخاصية أي وسائط. تستخدم الخاصية event.isPropagationStopped()‎ للحقق من استدعاء هذا التابع (على كائن الحدث هذا). تعمل هذه الخاصية مع الأحداث المخصصة المُطلَقة بواسطة التابع trigger()‎ أيضًا. لاحظ أن هذه الخاصية لن تمنع المعالجات الأخرى من العمل على نفس العنصر. ملاحظات ...

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎.empty()‎‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يُزيل هذا التابع كافة العُقَد السليلة لمجموعة العناصر المتطابقة من DOM. ‎.empty()‎ أُضيف مع الإصدار: 1.0. لا يقبل هذا التابع أي وسائط. لا يزيل هذا التابع العناصر الأبناء (والعناصر السليلة الأخرى) فقط، بل يزيل أيضًا أي نص ضمن مجموعة العناصر المتطابقة. ويرجع ذلك إلى أنه وفقًا لمواصفات DOM، تعدّ أي سلسلة نصية داخل عنصر ما عقدة ابن لهذا العنصر. إليك شيفرة HTML التالية: <div class="container"> <div class="hello">مرحبًا</div> <div class="goodbye">مع ...

الخاصيّة document.referrer هي خاصيةٌ قابلة للقراءة فقط تُعيد رابط URI الصّفحة التي أحيلت منها الصّفحة الحاليّة. البنية العامة string = document.referrer; ملاحظات ستكون القيمةُ سلسلة نصيّةً فارغةً في حالة وصل المُستخدم إلى الصّفحة مُباشرة دون المجيء من رابط مُعيّن، وذلك عبر الوصول إلى الصّفحة من شريط المُفضّلة مثلًا. ولأنّ هذه الخاصيّة تُعيد سلسلة نصيّة فقط، فلن تتمكن من الوصول إلى DOM الصّفحة المُحيلة. مصادر ومواصفات مواصفة DOM Level 2

مُلاحظة: لقد أُهمِلت الكثير من التوابع التي تُستعمل مع التّابع createEvent، هذه التّوابع تشمل التّابع initCustomEvent وتوابع أخرى. استعمل دوال بناء الأحداث عوضًا عنها. يُنشئُ التّابع Document.createEvent()‎ حدثًا من النّوع المُحدّد. يجب تهيئة الكائن المُعاد قبل أن يُمكنَ تمريره إلى التّابع dispatchEvent. البنية العامة var event = document.createEvent(type); event الكائن الجديد من النّوع Event. type سلسلةٌ نصيّةٌ تُمثّل نوع الحدث المرغوب إنشاؤه. القيم المُمكنة تشمل "UIEvents" و"MouseEvents" و"MutationEvents" و"HTMLEvents". انظر قسم المُلاحظات أدناه للمزيد من التّفاصيل. أمثلة // أنشئ الحدث var ...

event.stopImmediatePropagation()‎ القيمة المعادة تُعيد هذه الخاصية القيمة undefined. الوصف تمنع هذه الخاصية تنفيذ بقية معالجات الأحداث ومنع الحدث من الانتقال عبر شجرة DOM إلى العناصر الأب (event bubbling). event.stopImmediatePropagation()‎ أُضيف مع الإصدار: 1.3. لا تقبل هذه الخاصية أي وسائط. بالإضافة إلى منع تنفيذ أي معالجات إضافية على عنصر ما، فإن هذه الخاصية أيضًا تمنع الانتقال عبر شجرة DOM إلى العناصر الأب عن طريق استدعاء event.stopPropagation()‎ ضمنيًا. لمنع الحدث من الانتقال إلى العناصر الأب ببساطة مع السماح الأحداث الأخرى بالتنفيذ على ...

event.stopImmediatePropagation()‎ القيمة المعادة تُعيد هذه الخاصية القيمة undefined. الوصف تمنع هذه الخاصية تنفيذ بقية معالجات الأحداث ومنع الحدث من الانتقال عبر شجرة DOM إلى العناصر الأب (event bubbling). event.stopImmediatePropagation()‎ أُضيف مع الإصدار: 1.3. لا تقبل هذه الخاصية أي وسائط. بالإضافة إلى منع تنفيذ أي معالجات إضافية على عنصر ما، فإن هذه الخاصية أيضًا تمنع الانتقال عبر شجرة DOM إلى العناصر الأب عن طريق استدعاء event.stopPropagation()‎ ضمنيًا. لمنع الحدث من الانتقال إلى العناصر الأب ببساطة مع السماح الأحداث الأخرى بالتنفيذ على ...

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎.filter( selector )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يقلص هذا التابع مجموعة العناصر المُطابقة إلى تلك التي تطابق المُحدد أو اجتازت اختبار الدالة. ‎.filter( selector )‎ أُضيف مع الإصدار: 1.0. selector سلسلة نصية من النوع Selector تحتوي على تعبير مُحدد لمطابقة المجموعة الحالية من العناصر. ‎.filter( function )‎ أُضيف مع الإصدار: 1.0. function دالة على الشكل Function( Integer index, Element element ) => Boolean تُستخدم كاختبار لكل عنصر في المجموعة. ويُعد المعامل this هو عنصر DOM الحالي. ...

تُزوّدنا React بواجهة برمجة تطبيقات (API) صريحة بحيث لا نقلق بشأن التغييرات التي تطرأ في كل تحديث. يجعل هذا من كتابة التطبيقات أمرًا أسهل بكثير، ولكن قد لا يكون من الواضح كثيرًا كيفيّة تطبيق هذا في React. تشرح هذه الصفحة الخيارات التي وضعناها في خوارزمية المقارنة (diffing) بحيث تكون تحديثات المُكوّنات متوقعة وفي نفس الوقت سريعة كفاية لأجل التطبيقات عالية الأداء. البداية عندما تستخدم React في نقطة زمنية محدّدة بإمكانك التفكير في التابع render()‎ كأنّه يُنشِئ شجرة من عناصر React، ...

‎.has(selector)‎ القيم المعادة يُعيد كائنًا من النوع jQuery. الوصف يختار هذا التابع من العناصر التي حُدِّدَت مسبقًا العناصرَ السليلة منها التي تحقق الشروط المطلوبة في المحددات أو تطابق عنصر DOM. ‎.has( selector )‎ أضيف مع الإصدار: 1.4. selector سلسلة نصية من الكائن String، وتحتوي على تعبير المحدد لمطابقة عناصر معينة. ‎.has( contained )‎ أضيف مع الإصدار: 1.4. contained عنصر، وهو عنصر من شجرة DOM لاختيار الأب الذي يضمه. لنفترض أنه لدينا كائن jQuery والذي يمثل مجموعة من عناصر DOM، فسينشئ ...