نتائج البحث

اذهب إلى التنقل اذهب إلى البحث

DOM الافتراضي والكائنات الداخلية في React

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

Document.implementation

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

تصيير العناصر (Rendering Elements) في React

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

Document.createDocumentFragment()‎

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

التابع jQuery.contains()‎‎ في jQuery

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()‎‎ في jQuery

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()‎

يُنشئُ التّابع 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()‎‎ في jQuery

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

التابع ‎‎jQuery.uniqueSort()‎‎ في jQuery

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

التابع ‎‎jQuery.unique()‎‎ في jQuery

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

التابع ‎‎jQuery.unique()‎‎ في jQuery

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

التابع ‎.closest()‎‎ في jQuery

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

Document.doctype

تُعيد تعريف نوع المُستند (DTD) المُرتبط بالمُستند الحاليّ. الكائن المُعاد يُطبّق الواجهة DocumentType. استعمل DOMImplementation.createDocumentType()‎ لإنشاء الواجهة DocumentType. البنية العامّة doctype = document.doctype; doctype خاصيّة قابلة للقراءة فقط. مثال var doctypeObj = document.doctype; console.log( "doctypeObj.name: " + doctypeObj.name + "\n" + "doctypeObj.internalSubset: " + doctypeObj.internalSubset + "\n" + "doctypeObj.publicId: " ...

التابع ‎‎jQuery.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 ...

التابع ‎‎.remove()‎‎ في jQuery

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

التابع ‎‎.ready()‎‎ في jQuery

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

Document.documentURI

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

التابع ‎.before()‎‎‎ في jQuery

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

Document.importNode()‎

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

التابع ‎.detach()‎‎‎ في jQuery

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

الدالة jQuery()‎‎ في jQuery

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

التابع ‎.after()‎‎‎ في jQuery

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

Document.getElementById()‎

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

التابع ‎‎.nextUntil()‎‎ في jQuery

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

التابع ‎‎.removeProp()‎‎ في jQuery

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

المكونات غير المضبوطة في React

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

خدمات jQuery

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

التابع ‎‎.prevUntil()‎‎ في jQuery

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

التابع ‎‎.parentsUntil()‎‎ في jQuery

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

التابع ‎‎.parents()‎‎ في jQuery

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

Document.getElementsByTagName()‎

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

Document.styleSheets

تُعيد الخاصيّة 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()‎‎ في jQuery

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

التابع ‎.append()‎‎‎ في jQuery

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

التابع ‎‎.replaceWith()‎‎ في jQuery

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

أساس jQuery

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

Document.createNSResolver()‎

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

التابع ‎.each()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

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

محدد العناصر "element" في 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()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

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

الخاصية ‎event.stopPropagation()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

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

التابع ‎.empty()‎‎‎ في jQuery

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

Document.referrer

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

Document.createEvent()‎

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

الخاصية ‎event.stopImmediatePropagation()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

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

الخاصية ‎event.stopImmediatePropagation()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

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

التابع ‎.filter()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

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

المطابقة (Reconciliation) في React

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

التابع ‎‎.has()‎‎ في jQuery

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

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 الدعم ...

التابع ‎‎.not()‎‎ في jQuery

‎.not( [selector ] )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع عناصر محدَّدة من مجموعة من العناصر المطابقة. ‎.not( selector )‎ أُضيف مع الإصدار: 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد، أو عنصر DOM، أو مصفوفة من العناصر لمطابقة مجموعة معينة من العناصر. ‎.not( function )‎ أُضيف مع الإصدار: 1.4. function دالة من الشكل Function( Number index, Element element )‎ تعيد قيمة منطقيَّة Boolean، وتُستعمَل للتحقُّق من كلِّ عنصر من عناصر المجموعة. تقبل هذه الدالة ...

التابع ‎.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 لتغليف محتوى العناصر ...

التابع ‎‎.toArray()‎‎ في jQuery

‎.toArray()‎ القيم المعادة يعيد مصفوفة من النوع Array. الوصف يضع هذا التابع جميع العناصر الموجودة في مجموعة jQuery في مصفوفة ثمَّ يعيدها. ‎.toArray()‎ أُضيف مع الإصدار: 1.4. ولا يقبل هذا التابع أية وسائط. يضع هذا التابع جميع العناصر الموجودة في مجموعة jQuery في مصفوفة ثم يعيدها: alert( $( "li" ).toArray() ); ستُعاد جميع عقد DOM المطابقة عند استدعاء هذا السطر في مصفوفة قياسية: [<li id="foo">, <li id="bar">] أمثلة تحديد جميع العناصر <div> في الصفحة ثمَّ إعادة العناصر DOM في مصفوفة ثمَّ ...

التابع ‎.unwrap()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎.unwrap()‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف إزالة آباء مجموعة العناصر المُطابقة من شجرة DOM، مع ترك العناصر المُطابقة في مكانها. ‎.unwrap()‎ أُضيف مع الإصدار: 1.4. لا يقبل هذا الشكل أي وسائط. ‎.unwrap( [selector ] )‎ أُضيف مع الإصدار: 3.0. selector محدد للتحقق من العنصر الأب من النوع String. إذا لم يتطابق العنصر الأب لأحد العناصر مع المحدد، فلن يُحذف. يُزيل التابع ‎.unwrap()‎ العنصر الأب ويُعيد محتواه بدونه. وهو بالضبط معكوس التابع ‎.wrap()‎. وتحل العناصر المطابقة (ومثيلاتها، إن ...

التابع ‎‎.index()‎‎ في jQuery

‎.index()‎ القيم المعادة يعيد عددًا صحيحًا من النوع Number. الوصف يبحث هذا التابع عن عنصر معين من بين العناصر المطابقة. ‎.index()‎ أضيف مع الإصدار: 1.4، ولا يقبل هذا الشكل للتابع أي معاملات. ‎.index( selector )‎ أضيف مع الإصدار: 1.4. selector محدد يمثل مجموعة jQuery التي نبحث فيها عن عنصر معين. ‎.index ( element )‎ أضيف مع الإصدار: 1.0. element عنصر DOM أو أول عنصر في كائن jQuery و الذي سنبحث عنه في مجموعة العناصر المطابقة. القيم المعادة إذا لم يُمرر ...

التصيير السطحي (Shallow Rendering) في React

الاستيراد import ShallowRenderer from 'react-test-renderer/shallow'; // ES6 var ShallowRenderer = require('react-test-renderer/shallow'); // ES5 with npm لمحة عامة عند كتابة وحدات اختبار لمكتبة React يكون التصيير السطحي مفيدًا لك. يُتيح لك التصيير السطحي تصيير مكوّن على عمق مستوى واحد وتوضيح الحقائق حول ما يُعيده تابع التصيير، بدون القلق حول سلوك المكوّنات الأبناء والتي لم تُصيَّر أو ينشأ عنها نسخة. لا يحتاج ذلك إلى DOM. على سبيل المثال إن كان لديك المكوّن التالي: function MyComponent() { return ( <div> ...

Document.title

تُعيد أو تضبِط عنوان المُستند. البنية العامة var docTitle = document.title المُتغيّر docTitle سلسلةٌ نصيّةٌ تحتوي على عنوان المُستند. إن كان عنوان المُستند قد ضُبِط بالخاصيّة document.title، فسيُعيد القيمة المضبوطة، أو يُعيد العنوان المضبوط في اللغة الهيكليّة (مثل HTML أو SVG، انظر المُلاحظات أسفله). document.title = newTitle; المُتغيّر newTitle هو العنوان الجديد للمُستند. هذا التّعيين يُؤثّر على القيمة المُعادة للخاصيّة document.title، ويؤثّر كذلك على العنوان المعروض للمُستند (كعنوان نافذة المُتصفّح مثلًا)، ويُؤثّر كذلك على مُكوّنات DOM في المُستند (أي مُحتوى ...

Document.getElementsByTagNameNS()‎

يُعيد التّابع Document.getElementsByTagNameNS()‎ قائمةً تحتوي على جميع العناصر ذات اسم الوسم (tag name) التّابع لمجال الأسماء (namespace) المعطيين. عند استدعائه على كائن المُستند، فسيُبحَثُ في كامل المُستند، ما يشمل العقدة الجذر. البنية العامة elements = document.getElementsByTagNameNS(namespace, name) القيم elements‎ كائنٌ حيّ من النّوع NodeList‎ (لكن انظر الملاحظة أدناه) يُمثّل مجموعة العناصِر التي وُجدت مرتّبةً حسب طريقة عرضها في شجرة DOM. namespace‎ عنوان URI مجال الأسماء المبحوث عنه (انظر ‎element.namespaceURI). name‎ سلسلةٌ نصيّةٌ تُمثّل أسماء العناصِر المبحوث عنها. السلسلة النّصيّة الخاصّة ...

التابع ‎‎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 ...

تعديل العناصر في jQuery

جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل عنصر (أو مجموعة من العناصر) بأكمله وبذاته مثل الإضافة، أو النسخ، أو الحذف، أو الإزالة ...إلخ. (إن كنت تبحث عن توابع تعدل خاصية عنصر، فانتقل إلى قسم «تعديل الخاصيات»). ‎.after()‎ يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل بعد كل عنصر من مجموعة العناصر المُطابقة. ‎.append()‎ يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل إلى آخر كل عنصر من مجموعة العناصر المُطابِقة. ‎.appendTo()‎ يُدخِل هذا التّابع كل عنصر من ...

المحدد ‎:first‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

المحدد ‎:first الوصف يحدد أول عنصر DOM متطابق. jQuery( ":first" )‎ أُ‎ضيف مع الإصدار: 1.0. يعادل مُحدد الصنف الزائف ‎:first المحدد ‎:eq( 0 )‎. ويمكن أيضًا أن يُكتب على النحو ‎:lt( 1 )‎. في حين أن هذا لا يتطابق إلا مع عنصر واحد فقط : يمكن أن يتطابق المُحدد :first-child مع أكثر من عنصر بواقع عنصر واحد لكل أب. ملاحظات إضافية لأن ‎:first هو ملحق jQuery وليس جزءًا من مواصفات CSS، فلا يمكن استفادة الاستعلامات التي تستخدم ‎‎:first من تحسين الأداء ...

التابع ‎‎.parent()‎‎ في jQuery

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

التنقل بين العناصر في jQuery

تتيح التوابع في هذا القسم بتحديد عناصر موجودة في موضع محدد والتنقل بينها. ‎.add()‎ إنشاء كائن jQuery جديد من العناصر المضافة إلى مجموعة من العناصر المطابقة. ‎.addBack()‎ يُضيف هذا التّابع مجموعة العناصر الموجودة سابقًا في المَكْدَس (stack) إلى المجموعة الحاليّة، مع إمكانيّة ترشيحها بشكل اختياري عن طريق مُحدِّد (selector). ‎.andSelf()‎ يُضيف هذا التّابع مجموعة العناصر الموجودة سابقًا في المَكدَس (stack) إلى المجموعة الحاليّة. ‎.children()‎ يحصل هذا التّابع على العناصر الأبناء لكل عنصر من مجموعة العناصر المُطابِقة. ‎.closest()‎ يحصل هذا التّابع ...

التابع ‎‎.get()‎‎ في jQuery

يجلب عناصر DOM المطابقة والمخزنة في كائن jQuery. ‎.get( index )‎ الوصف يعيد هذا التابع عنصرًا واحدًا من العناصر الموجودة في كائن jQuery. ‎.get( index )‎ index فهرس صفري من النوع Number (عدد صحيح) يشير إلى العنصر المراد إعادته. يوفر التابع ‎.get()‎ إمكانية الوصول إلى كل عناصر DOM الموجودة في كل كائن jQuery. إذا كانت قيمة الفهرس index خارج المجال (أي أصغر من عدد العناصر الموجودة ضمن الكائن – أي قيمة سالبة – أو أكبر أو تساوي عدد هذه العناصر)، ...

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> الخارجي. ورغم أنّك تستطيع تعيين قيمة ...

التابع jQuery.data()‎‎ في jQuery

يخزِّن هذا التابع بيانات اعتباطيَّة متعلقة بعنصر محدَّد أو يعيد القيمة التي خُزِّنت لهذا العنصر. jQuery.data( element, key, value )‎ القيم المعادة يعيد كائنًا من النوع Object. الوصف يخزِّن هذا التابع بيانات اعتباطيَّة ويقرنها بعنصر محدَّد، ويعيد القيمة التي ضُبِطَت. jQuery.data( element, key, value )‎ أُضيف مع الإصدار: 1.2.3. element العنصر DOM الذي يراد ربط البيانات به. key سلسلة نصية تمثِّل الاسم الذي ستسمى البيانات المخزَّنة به. value أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيَّة استعمال ...

التابع jQuery.data()‎‎ في jQuery

يخزِّن هذا التابع بيانات اعتباطيَّة متعلقة بعنصر محدَّد أو يعيد القيمة التي خُزِّنت لهذا العنصر. jQuery.data( element, key, value )‎ القيم المعادة يعيد كائنًا من النوع Object. الوصف يخزِّن هذا التابع بيانات اعتباطيَّة ويقرنها بعنصر محدَّد، ويعيد القيمة التي ضُبِطَت. jQuery.data( element, key, value )‎ أُضيف مع الإصدار: 1.2.3. element العنصر DOM الذي يراد ربط البيانات به. key سلسلة نصية تمثِّل الاسم الذي ستسمى البيانات المخزَّنة به. value أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيَّة استعمال ...

التابع ‎‎.siblings()‎‎ في jQuery

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

تعديل الخاصيات في jQuery

جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل خاصية محددة لعنصر (أو مجموعة من العناصر). توصف أغلبية هذه التوابع على أنها «توابع ضابطة» (setters)، إذ تضبط وتغير قيمة خاصية محددة. هنالك قلة من هذه التوابع توصف على أنها «توابع جالبة» (getters) مثل ‎.attr()‎ و ‎.html()‎ و ‎.val()‎ لأنها تجلب معلومات من عناصر DOM لاستخدامها لاحقًا. (إن كنت تود إجراء تعديل على العنصر نفسه، فارجع إلى قسم «تعديل العناصر»). ‎.addClass()‎ يُضيف هذا التّابع الصّنف أو الأصناف المُحدَّدة لكل ...

التابع ‎‎.offsetParent()‎‎ في jQuery

‎.offsetParent()‎ القيم المعادة يعيد كائنًا من النوع Object. الوصف يعيد أقرب عنصر جد (ancestor) متموضع (positioned) للعنصر المطابق. ‎.offsetParent()‎ أُضيف مع الإصدار: 1.2.6. ولا يقبل هذا الشكل أي وسائط. إن كان لدينا كائن jQuery يمثِّل مجموعة عناصر DOM، فسيسمح لنا التابع ‎.offsetParent()‎ بالبحث في العناصر الأجداد (ancestors) لهذه العناصر في شجرة DOM ثمَّ ينشئ كائن jQuery جديد ويضع فيه أقرب عنصر جد متموضع عثر عليه. يكون العنصر متموضعًا (positioned) إذا كانت قيمة الخاصِّيَّة position له هي إمَّا relative أو absolute ...

التابع ‎‎.replaceAll()‎‎ في jQuery

‎.replaceAll( target )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يبدِّل هذا التابع مجموعة العناصر المطابقة مكان كل عنصر من العناصر المحدَّدة. ‎.replaceAll( target )‎ أُضيف مع الإصدار: 1.2. target سلسلة نصيِّة تحتوي على محدِّد، أو كائن jQuery، أو عناصر DOM، أو مصفوفة من العناصر تشير جميعها إلى العنصر أو العناصر المراد استبدالها. يشبه التابع ‎.replaceAll()‎ التابع ‎.replaceWith()‎ ولكنهما متعاكسان بالنسبة للمُستبدل والمُستبدل به. بفرض أنَّ لدينا البنية DOM التالية: <div class="container"> <div class="inner first">مرحبًا</div> <div class="inner ...

التابع ‎‎.contents()‎‎‎ في jQuery

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

العنصر

العنصر <span> هو حاوية سطرية (inline container) عامة، والتي لا تُمثِّل نوعًا معيّنًا من المحتوى، ويمكن أن تستعمل تجميع العناصر من أجل التنسيق (إما باستخدام الخاصية id أو class) أو لأن تلك العناصر تتشارك في خاصيةٍ ما مثل الخاصية lang. لا يجب أن يستعمل هذا العنصر إلا إذا لم يكن أيُّ عنصرٍ آخر مناسبًا؛ إذ إنَّ العنصر <span> يشبه العنصر <div> كثيرًا، لكن العنصر <div> هو عنصر كتلي (block-level element) بينما العنصر <span> هو عنصر سطري (inline element). مثال عن ...

التابع ‎‎.prop()‎‎ في jQuery

يجلب هذا التابع قيمة خاصِّيَّة كائن محدَّدةٍ للعنصر الأول من مجموعة العناصر المطابقة، أو يضبط قيمة خاصِّيَّة كائن واحدة أو أكثر لجميع العناصر المطابقة. ‎.prop( propertyName )‎ القيم المعادة يعيد أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيَّة إعادة أي نوع). الوصف يجلب هذا التابع قيمة خاصِّيَّة كائن محدَّدةٍ للعنصر الأول من مجموعة العناصر المطابقة. ‎.prop( propertyName )‎ أُضيف مع الإصدار: 1.6. propertyName سلسلة نصية تمثِّل اسم الخاصِّيَّة المراد إعادة قيمتها. يجلب التابع ‎.prop()‎ قيمة خاصِّيَّة معينة ...

الأحداث في jQuery

تُستخدَم التوابع الموجودة في هذا القسم لتسجيل سلوكيات محدَّدة تحدث عندما وقع حدث معين ناتج عن تفاعل المستخدم مع المتصفح. أضف إلى ذلك وجود توابع تساعد على التعديل والتلاعب بتلك السلوكيات المسجلة مسبقًا. ‎.bind()‎ يُرفِق هذا التّابع مُعالِج أحداث (Event handler) لحدثٍ ما للعناصر. ‎.blur()‎ يربط هذا التّابع مُعالِج أحداث (event handler) إلى حدث الضّبابيّة ‎(blur)‎ في JavaScript، أو يُطلِق هذا الحدث على عنصر ما. ‎.change()‎ يربط هذا التّابع مُعالِج الأحداث (event handler) لتغيير حدث JavaScript أو يُطلِق هذا الحدث ...

التابع ‎.children()‎‎ في jQuery

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

التابع ‎‎jQuery.queue()‎‎ في jQuery

يعرض هذا التابع أو يعدِّل طابور الدوال المراد تنفيذها على العنصر المطابق. jQuery.queue( element [, queueName ] )‎ القيم المعادة يعيد مصفوفةً (Array). الوصف يعرض هذا التابع طابور الدوال المراد تنفيذها على العنصر المطابق. jQuery.queue( element [, queueName ] )‎ أُضيف مع الإصدار: 1.3. element عنصر DOM الذي سيُبحث عن طابور الانتظار المرتبط به. queueName سلسلة نصية تحتوي على اسم الطابور. القيمة الافتراضيَّة هي fx وهو اسم طابور التأثيرات القياسي. ملاحظة: هذا التابع ذو مستوًى منخفض، لذا يجب عليك استعمال ...

استخدام لغة Kotlin في نطاق JavaScript

تتيح لغة Kotlin إمكانيّة استهداف لغة JavaScript من خلال تحويل (transpiling) شيفرات Kotlin إلى ما يماثلها في JavaScript ؛ إذ تستهدف بالوقت الحاليّ معيارECMAScript 5.1، ومن المُخطَّط له أيضًا التوافق مع معيار ECMAScript 2015 لاحقًا. عند استخدام لغة Kotlin بهدف كتابة شيفرات JavaScript فستُحوَّل الشيفرات المكتوبة بلغة Kotlin (بعدِّها جزءًا من المشروع والمكتبة القياسيّة في Kotlin) إلى شيفرة JavaScript، ولكنّ هذا لا يشمل أيًّا ممّا يتعلَّق ببيئة JDK أو JVM أو Java أو أيّ من منصّاتها أو مكتباتها المُستخدَمة، ويُستبعَد ...

مكونات الويب في React

إنّ مكوّنات React ومكوّنات الويب مبنية لحل مشاكل مختلفة. حيث تُزوِّدنا مكوّنات الويب بتغليف قوي لمكوّنات قابلة لإعادة الاستخدام، بينما تُزوِّدنا مكوّنات React بمكتبة تصريحات تُبقي DOM على تزامن مع بياناتنا. يكون هذا الهدفان متكاملين، وكمُطوّر لك حرية استخدام React في مكوّنات الويب لديك، أو استخدام مكوّنات الويب في React أو كليهما معًا. معظم من يستخدم React لا يستخدم مكوّنات الويب، ولكن قد ترغب في ذلك خاصة إذا كنت تستخدم مكوّنات لواجهة المستخدم من طرف ثالث والتي تكون مكتوبة باستخدام ...

التابع ‎‎jQuery.queue()‎‎ في jQuery

يعرض هذا التابع أو يعدِّل طابور الدوال المراد تنفيذها على العنصر المطابق. jQuery.queue( element [, queueName ] )‎ القيم المعادة يعيد مصفوفةً (Array). الوصف يعرض هذا التابع طابور الدوال المراد تنفيذها على العنصر المطابق. jQuery.queue( element [, queueName ] )‎ أُضيف مع الإصدار: 1.3. element عنصر DOM الذي سيُبحث عن طابور الانتظار المرتبط به. queueName سلسلة نصية تحتوي على اسم الطابور. القيمة الافتراضيَّة هي fx وهو اسم طابور التأثيرات القياسي. ملاحظة: هذا التابع ذو مستوًى منخفض، لذا يجب عليك استعمال ...

التابع ‎.wrap()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎.wrap( wrappingElement )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف تغليف شيفرة HTML حول كل عنصر في مجموعة العناصر المُطابقة. ‎.wrap( wrappingElement )‎ أُضيف مع الإصدار: 1.0. wrappingElement مُحدد أو عنصر أو سلسلة HTML أو كائن jQuery يحدد الشيفرة المراد تغليفها حول العناصر المُطابقة. عند تمرير مجموعة jQuery تحتوي على أكثر من عنصر واحد، أو محدد يتطابق مع أكثر من عنصر واحد، فسيُستخدم العنصر الأول. وهو من النوع Selector أو htmlString أو Element أو jQuery. ‎.wrap( function )‎ أُضيف ...

Document.adoptNode()‎

يتبنّى التّابع Document.adoptNode()‎ عقدة خارجيّة، وتُحذف العقدة وشجرتها الفرعيّة من المُستند الأصلي (إن كان موجودًا)، وتتغيّر قيمة المُستند المالِك ownerDocument إلى المُستند الحاليّ. ويُمكن بعد ذلك إدخال العقدة إلى المُستند الحاليّ. البنية العامة node = document.adoptNode(externalNode); node يُمثّل العقدة المُتبنّاة والتي مالِكها هو المُستند الحالي وعقدتها الأب parentNode ذات قيمةٍ null، وذلك لأنّها لم تُدخَل بعدُ إلى شجرة المُستند. لاحِظ أنّ كلّا من node وexternalNode سيُصبحان نفس الكائن بعد الاستدعاء. externalNode هي العقدة التي ستُتبنّى من مُستند آخر. مثال var ...

المصطلحات في React

التطبيق وحيد الصفحة التطبيق وحيد الصفحة (Single-page Application) هو التطبيق الذي يُحمِّل صفحة HTML واحدة وكل ملحقاتها الضرورية (مثل CSS و JavaScript) المطلوبة لكي يعمل التطبيق. لا تتطلّب أيّة تفاعلات مع الصفحة أو الصفحات اللاحقة أي عودة للخادم مرّة أخرى، ممّا يعني عدم إعادة تحميل الصفحة. بالرغم من قدرتك على بناء تطبيق وحيد الصفحة في React فهو ليس أمرًا ضروريًّا. يُمكِن أيضًا استخدام React لتحسين أجزاء صغيرة من الموقع مع الحصول على تفاعليّة أكبر. يُمكِن للشيفرة المكتوبة باستخدام React أن ...

التابع ‎‎.prevAll()‎‎ في jQuery

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

jQuery/Topics a-z

‎.add()‎ إنشاء كائن jQuery جديد من العناصر المضافة إلى مجموعة من العناصر المطابقة. ‎.addBack()‎ يُضيف هذا التّابع مجموعة العناصر الموجودة سابقًا في المَكْدَس (stack) إلى المجموعة الحاليّة، مع إمكانيّة ترشيحها بشكل اختياري عن طريق مُحدِّد (selector). ‎.addClass()‎ يُضيف هذا التّابع الصّنف أو الأصناف المُحدَّدة لكل عنصر من مجموعة العناصر المُطابقة. ‎.after()‎ يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل بعد كل عنصر من مجموعة العناصر المُطابقة. ‎.ajaxComplete()‎ يُسجِّل هذا التّابع مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال طلبات Ajax. ‎.ajaxError()‎ ...

Document.close()‎

يُنهِي التّابع Document.close()‎ الكتابة إلى مستندٍ فُتح بالتّابع Document.open()‎. البنية العامة document.close(); مثال // فتح مستند للكتابة // ثمّ كتابة محتوى على المستند // ثمّ إغلاقه document.open(); document.write("<p>هنا محتوى</p>"); document.close(); مصادر ومواصفات مواصفة DOM Level 2 HTML: ‏close‎(‎)‎ Method.

Document.readyState

تصِفُ الخاصيّة Document.readyState حالة تحميل المُستند. البنية العامة var string = document.readyState; القيم يُمكن للخاصيّة أن تحمِل القيم التّاليّة: "loading" المُستند لا يزال قيد التّحميل "interactive" تحميل المُستند قد انتهى، لكنّ الموارد الفرعيّة كالصّور وصفحات الأنماط والإطارات لا تزال قيد التّحميل "complete" انتهى تحميل المُستندِ وجميع موارِده الفرعيّة. هذه الحالة تُشير إلى أنّ الحدث load سيُطلَق فورًا. يُطلَق الحدث readystatechange على كائن المُستند document عند كلّ تغيّر لقيمة هذه الخاصيّة. أمثلة الحالات المُختلفة لجاهزيّة المُستند: switch (document.readyState) { case ...

Document.children

تُعيد الخاصيّة children القابلة للقراءة فقط والمُعرّفة على الواجهة ParentNode كائنا من النّوع HTMLCollection الذي يحتوي على جميع العناصِرِ الأولاد الخاصّة بالعقدة التي استُدعَت عليها. البنية العامة var children = node.children; القيمة القيمة المُعادة عبارة عن كائن من النّوع HTMLCollection والذي هو مجموعة حيّة ومُرتّبة من عناصر DOM الذين هم أولاد العقدة. يُمكنك الوصول إلى العقد الأولاد كل على حدة في المجموعة عبر استعمال إمّا التّابع item()‎ على المجموعة أو باستعمال طريقة الوصول إلى المصفوفات في JavaScript. إن لم يكن ...

المحدد ‎‎‎("#id")‎ ID في jQuery

المحدد ID الوصف يختار هذا المحدد العنصر الذي يمتلك المعرف id المعطى. jQuery( "#id" )‎ أضيف مع الإصدار: 1.0. id المعرف المراد البحث عنه، والذي يُمنح للعنصر عبر الخاصية id. تستعمل محددات المعرف (ID selectors) في مكتبة jQuery الدالة document.getElementById()‎ في JavaScript. عندما يضاف محدد آخر لمحدد المعرف، مثل h2#pageTitle، فستتحقق jQuery مجددًا من العناصر بناءًا على المحدد المضاف قبل أن تختار العنصر المطابق. عند استدعاء jQuery()‎ (أو ()$) بتمرير المحدد id كمعامل، فستعيد كائنًا من النوع jQuery يحتوي على ...

التابع ‎.find()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎.find( selector )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يعيد العناصر السليلة لكل عنصر في المجموعة الحالية من العناصر المُطابقة، والتي تكون مرشحة بواسطة مُحدد، أو كائن jQuery، أو عنصر. ‎.find( selector )‎ أُضيف مع الإصدار: 1.0. selector سلسلة نصية من النوع Selector تحتوي على تعبير مُحدد لمطابقة العناصر معه. ‎.find( element )‎ أُضيف مع الإصدار: 1.60. element عنصر من النوع Element أو كائن من النوع jQuery لمطابقة العناصر معه. إذا أُدخل كائن jQuery يمثل مجموعة من عناصر ...

الخاصية ‎event.isImmediatePropagationStopped()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

event.isImmediatePropagationStopped()‎ القيمة المعادة تُعيد كائنًا من النوع Boolean. الوصف تتحقق هذه الخاصية من استدعاء الحدث event.stopImmediatePropagation()‎‎ على كائن الحدث هذا. event.isImmediatePropagationStopped()‎ أُضيف مع الإصدار: 1.3. لا تقبل هذه الخاصية أي وسائط. أُضيفت هذه الخاصية في المستوى الثالث من DOM. أمثلة التحقق من استدعاء event.stopImmediatePropagation()‎‎. <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>event.isImmediatePropagationStopped مثال على الخاصية</title> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <button>أنقر هنا</button> <div id="stop-log"></div> <script> function immediatePropStopped( event ) { var msg = ""; if ( event.isImmediatePropagationStopped() ) { ...

الخاصية ‎event.isImmediatePropagationStopped()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

event.isImmediatePropagationStopped()‎ القيمة المعادة تُعيد كائنًا من النوع Boolean. الوصف تتحقق هذه الخاصية من استدعاء الحدث event.stopImmediatePropagation()‎‎ على كائن الحدث هذا. event.isImmediatePropagationStopped()‎ أُضيف مع الإصدار: 1.3. لا تقبل هذه الخاصية أي وسائط. أُضيفت هذه الخاصية في المستوى الثالث من DOM. أمثلة التحقق من استدعاء event.stopImmediatePropagation()‎‎. <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>event.isImmediatePropagationStopped مثال على الخاصية</title> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <button>أنقر هنا</button> <div id="stop-log"></div> <script> function immediatePropStopped( event ) { var msg = ""; if ( event.isImmediatePropagationStopped() ) { ...

التابع ‎.eq()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎.eq( index )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف تقليص مجموعة العناصر المتطابقة إلى تلك الموجودة في الفهرس المُحدَد. ‎.eq( index )‎ أُضيف مع الإصدار: 1.1.2. index عدد صحيح يشير إلى الموضع الصفري للعنصر، وهو من النوع Number. ‎.eq( indexFromEnd )‎ أُضيف مع الإصدار: 1.4. indexFromEnd عدد صحيح يشير إلى موضع العنصر، مع العد تنازليا من العنصر الأخير في المجموعة، وهو من النوع Number. إذا كان لدينا كائن jQuery يمثل مجموعة من عناصر DOM، فسينشئ التابع ‎.eq()‎ كائن jQuery ...

Document.caretPositionFromPoint()‎

تنبيه: هذه تقنيّة تجريبيّة، انظر جدول دعم المتصفّحات قبل استخدام هذا التّابع في شيفرة إنتاجيّة. يعيد التّابع Document.caretPositionFromPoint‎()‎ كائنًا من النّوع CaretPosition يحتوي على عقدة DOM ومكان علامة الإقحام (caret) وحدود محارف (character offset) العلامة داخل هذه العقدة. البنية العامة var caretPosition = document.caretPositionFromPoint(float x, float y); المعاملات x الإحداثيّ الأفقيّ لنقطة ما. y الإحداثيّ العمودي لنقطة ما. القيمة المعادة كائن من النّوع CaretPosition. مثال يقوم المثال التّالي بإدخال فراغ سطريً (line break) أينما ضغطت. جزء HTML: <p>Lorem ipsum dolor ...

التابع ‎‎.next()‎‎ في jQuery

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

التابع ‎‎.nextAll()‎‎ في jQuery

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

Document.compatMode

تدلّ على ما إذا كان المُستند قد قُدِّم في نمط التجاوزات (Quirks Mode) أو نمط المعايير (Standards Mode). البنية العامّة mode = document.compatMode القيم "BackCompat" في حالة كان المُستند في نمط التجاوزات (Quirks Mode). "CSS1Compat" في حالة كان المُستند في نمط المعايير (Standards Mode). مثال if (document.compatMode == "BackCompat") { // نمط // Quirks } مصادر ومواصفات مواصفة DOM: Document.compatMode. مواصفة MSDN: compatMode property.

الخاصية ‎event.isPropagationStopped()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في jQuery

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎event.isPropagationStopped()‎ القيمة المعادة تُعيد كائنًا من النوع Boolean. الوصف نتحقق هذه الخاصية من استدعاء الحدث event.stopPropagation()‎‎ على كائن الحدث هذا. event.isPropagationStopped()‎ أُضيف مع الإصدار: 1.3. لا تقبل هذه الخاصية أي وسائط. هذه الخاصية موصوفة في مواصفات W3C DOM Level 3 . أمثلة التحقق من استدعاء event.stopPropagation()‎‎. <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>event.isPropagationStopped مثال على الخاصية</title> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <button>أنقر هنا</button> <div id="stop-log"></div> <script> function propStopped( event ) { var msg = ""; if ( event.isPropagationStopped() ) { ...

عرض (100 السابقة | 100 التالية) (20 | 50 | 100 | 250 | 500).