نتائج البحث

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

‎.addClass( className )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع ‎.addClass()‎ لإضافة الصّنف أو الأصناف المُحدَّدة لكل عنصر من مجموعة العناصر المُطابقة. ‎.addClass( className )‎ أضيفت في الإصدار: 1.0. className سلسلة نصيّة من الكائن String، وتُمثِّل صنف أو عدة أصناف مفصولة بمسافة بينها لإضافتها إلى الخاصيّة class لكل عنصر مُطابق. ‎.addClass( function )‎ أضيفت في الإصدار: 1.4. Function دالة على الشكل Function( Integer index, String currentClassName )‎ وتُعيد سلسلة نصيّة. دالة تُعيد اسم أو عدة أسماء لأصناف مفصولةً بمسافة بينها ...

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

إعادة القيمة الحالية للعنصر الأول في مجموعة العناصر المُطابقة أو تعيين قيمة (value) كل عنصر مُطابق. ‎.val()‎ القيمة المعادة يُعيد كائنًا من النوع String أو Number أو Array. الوصف إعادة القيمة الحالية للعنصر الأول في مجموعة العناصر المُطابقة. ‎.val()‎ أُضيف مع الإصدار: 1.0. لا يقبل هذا الشكل أي وسائط. يستخدم التابع ‎.val()‎ في المقام الأول للحصول على قيم عناصر النماذج مثل <input> و <select> و <textarea>. عند استدعائها على مجموعة فارغة، فإنها تُعيد undefined. عندما يكون العنصر الأول في المجموعة ...

jQuery.cssNumber القيم المعادة يعيد كائنًا من النوع Object. الوصف يعيد هذا التابع كائنًا يحتوي على جميع خاصِّيَّات CSS التي يمكن استعمالها دون واحدة. يستعمل التابع ‎.css()‎ هذا الكائن ليتحقَّق إن كان بإمكانه إضافة الواحدة px إلى القيم المعطاة دون واحدة. jQuery.cssNumber أُضيف مع الإصدار: 1.4.3. يمكنك أن تتخيل أنَّ jQuery.cssNumber ليس إلا قائمةً بجميع خاصِّيَّات CSS التي يمكنك استعمالها دون واحدة. يستعمل التابع ‎.css()‎ هذه القائمة ليحدِّد إن كان هنالك حاجة لإضافة الواحدة px إلى القيم عديمة الواحدة. تكون مفاتيح ...

يجلب هذا التابع المحتوى النصي المرتبط بكل عنصر في مجموعة العناصر المطابقة بالإضافة إلى العناصر الأحفاد لهم، أو يغيِّر المحتوى النصي للعناصر المطابقة. ‎.text()‎ القيم المعادة يعيد سلسلة نصية من النوع String. الوصف يجلب هذا التابع المحتوى النصي المرتبط بكل عنصر في مجموعة العناصر المطابقة بالإضافة إلى المحتوى النصي للعناصر الأحفاد أيضًا. ‎‎.text()‎‎ أُضيف مع الإصدار: 1.0. ولا يقبل هذا التابع أية وسائط. يمكن استعمال التابع ‎.text()‎ في مستندات XML ومستندات HTML كلاهما خلافًا للتابع ‎.html()‎. يعيد التابع سلسلة نصية ...

‎.appendTo( target )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع ‎.appendTo()‎ في إدخال كل عنصر من مجموعة العناصر المُطابِقة إلى نهاية العنصر الهدف. ‎.appendTo( target )‎ أضيفت في الإصدار: 1.0. target مُحدِّد (Selector) أو سلسلة نصيّة من الكائن htmlString أو عنصر أو مصفوفة أو كائن jQuery، وتُمثِّل مجموعة العناصر المُطابِقة التي ستُدخَل إلى نهاية العنصر أو العناصر المُحدَّدة عن طريق هذا المُعامِل. ينجز التّابعان ‎.append()‎ و ‎.appendTo()‎ نفس المهمة ويكمن الفرق الأساسي بينهما في الصّياغة، أي في مكان تحديد المحتوى ...

‎.insertBefore( target )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف إدخال كل عنصر من مجموعة العناصر المُطابقة بعد الهدف. ‎.insertBefore( target )‎ أُضيف مع الإصدار: 1.0. target كائن قد يكون من النوع Selector أو htmlString أو Element أو Array أو jQuery، وهو يمثل محدد أو عنصر أو مصفوفة عناصر أو سلسلة HTML أو كائن jQuery؛ ستدرج مجموعة العناصر المطابقة قبل العنصر (العناصر) المحدد بواسطة هذا المعامل. يُنفذ التابع ‎.before()‎ والتابع ‎.insertBefore()‎ نفس المهمة. الاختلاف الرئيسي هو في بناء الجملة، على ...

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

‎.position()‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يجلب هذا التابع الإحداثيات الحالية للعنصر الأول في المجموعة المطابقة نسبةً إلى أقرب عنصر أب متموضع (offset parent) لذلك العنصر. ‎.position()‎ أضيف مع الإصدار 1.2. لا يقبل هذا التابع أية وسائط. يجلب التابع ‎.position()‎ الإحداثيات الحالية لعنصرٍ (لإطار حوافه الخارجية [margin box] تحديدًا) نسبةً إلى أقرب عنصر أب له (إطار حواشيه [padding box] تحديدًا، أي باستثناء الهوامش والإطار). يختلف هذا التابع عن التابع ‎.offset()‎ الذي يعيد الإحداثيات الحالية للعنصر نسبةً إلى ...

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

يعيد هذا التابع قيمة الطول الحالي (تتضمن قيمة الحواشي فقط دون الإطار) لأول عنصر في مجموعة العناصر المطابقة أو يغير الطول الداخلي لكل العناصر المطابقة. ‎.innerHeight()‎ القيم المعادة يعيد عدد من النوع Number. الوصف يعيد هذا التابع قيمة الطوال الحالي (من ضمنها قيمة الحواشي فقط دون إطار) لأول عنصر في مجموعة العناصر المطابقة. ‎.innerHeight()‎ أضيف مع الإصدار: 1.2.6، ولا يقبل هذا التابع أي معاملات. يعيد هذا التابع قيمة طول العنصر، وتدخل قيمة الحواشي العليا والسفلى ضمن تلك القيمة، بواحدة البكسل. ...

يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة أو يغير الطول لكل العناصر المتطابقة. ‎.height()‎ القيم المعادة عدد من النوع Number. الوصف يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة سابقًا. ‎.height()‎ أضيف مع الإصدار 1.0، ولا يقبل هذا التابع أي معاملات. الفرق بين التابع ‎.css( "height" )‎ والتابع ‎.height()‎ هو أن الأخير يعيد قيمة الطول بدون واحدة (يعيد 400 مثلًا)، بينما يعيد التابع الأول قيمة الطول مع واحدة (يعيد 400px مثلًا). يفضل استعمال ...

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

يجلب هذا التابع موضع شريط التمرير الشاقولي الحالي للعنصر الأول من مجموعة العناصر المطابقة، أو يضبط موضع شريط التمرير الشاقولي لجميع العناصر المطابقة. ‎.scrollTop()‎ القيم المعادة يعيد عددًا من النوع Number. الوصف يجلب هذا التابع موضع شريط التمرير الشاقولي الحالي للعنصر الأول من مجموعة العناصر المطابقة. ‎.scrollTop()‎ أُضيف مع الإصدار: 1.2.6، ولا يقبل هذا التابع أية وسائط. موضع شريط التمرير الشاقولي هو نفسه عدد البكسلات المخفية من النافذة المعروضة القابلة للتمرير وحتى أعلاها (الجزء المخفي من المنطقة العلوية القابلة للتمرير). ...

‎.clone( [withDataAndEvents ] )‎ القيمة المعادة كائن jQuery. الوصف يُستخدَم التابع ‎.clone()‎ في إنشاء نسخة عميقة (deep copy) من مجموعة العناصر المُطابِقة. ‎.clone( [withDataAndEvents ] )‎ أضيفت في الإصدار: 1.0. withDataAndEvents (القيمة الافتراضة: false) قيمة منطقيّة (Boolean)، وتُشير ما إذا كان يجب نسخ مُعالِجات الأحداث مع العناصر. بدءًا من إصدار jQuery 1.4 أصبحت بيانات العنصر تُنسَخ أيضًا. ‎.clone( [withDataAndEvents ] [, deepWithDataAndEvents ] )‎ أضيفت في الإصدار: 1.5. withDataAndEvents (القيمة الافتراضية: false) قيمة منطقيّة (Boolean)، وتُشير ما إذا كان يجب ...

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

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

‎.insertAfter( target )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف إدخال كل عنصر من مجموعة العناصر المُطابقة بعد الهدف. ‎.insertAfter( target )‎ أُضيف مع الإصدار: 1.0. target كائن قد يكون من النوع Selector أو htmlString أو Element أو Array أو jQuery، وهو يمثل محدد أو عنصر أو مصفوفة عناصر أو سلسلة HTML أو كائن jQuery؛ ستدرج مجموعة العناصر المطابقة بعد العنصر (العناصر) المحدد بواسطة هذا المعامل. ينفذ كلٌ من التابع ‎.after()‎ والتابع ‎.insertAfter()‎ نفس المهمة. الاختلاف الرئيسي هو في ...

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

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

يجلب هذا التابع موضع شريط التمرير الأفقي الحالي للعنصر الأول من مجموعة العناصر المطابقة، أو يضبط موضع شريط التمرير الأفقي لجميع العناصر المطابقة. ‎.scrollLeft()‎ القيم المعادة يعيد عددًا من النوع Number. الوصف يجلب هذا التابع موضع شريط التمرير الأفقي الحالي للعنصر الأول من مجموعة العناصر المطابقة. ‎.scrollLeft()‎ أُضيف مع الإصدار: 1.2.6، ولا يقبل هذا التابع أية وسائط. موضع التمرير الأفقي هو نفسه عدد البكسلات المخفية من النافذة المعروضة وإلى يسار المنطقة القابلة للتمرير. إن كان شريط التمرير مزاحًا كليًّا إلى ...

jQuery.cssNumber القيم المعادة يعيد كائنًا من النوع Object. الوصف يعيد هذا التابع كائنًا يحتوي على جميع خاصِّيَّات CSS التي يمكن استعمالها دون واحدة. يستعمل التابع ‎.css()‎ هذا الكائن ليتحقَّق إن كان بإمكانه إضافة الواحدة px إلى القيم المعطاة دون واحدة. jQuery.cssNumber أُضيف مع الإصدار: 1.4.3. يمكنك أن تتخيل أنَّ jQuery.cssNumber ليس إلا قائمةً بجميع خاصِّيَّات CSS التي يمكنك استعمالها دون واحدة. يستعمل التابع ‎.css()‎ هذه القائمة ليحدِّد إن كان هنالك حاجة لإضافة الواحدة px إلى القيم عديمة الواحدة. تكون مفاتيح ...

‎.wrapAll( wrappingElement )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف تغليف شيفرة HTML حول جميع العناصر في مجموعة من العناصر المُطابقة. ‎.wrapAll( wrappingElement )‎ أُضيف مع الإصدار: 1.2. wrappingElement مُحدد أو عنصر أو سلسلة HTML أو كائن jQuery يحدد الهيكل المراد التفافه حول العناصر المُطابقة. وهو من النوع Selector أو htmlString أو Element أو jQuery. ‎.wrapAll( function )‎ أُضيف مع الإصدار: 1.4. function دالة على الشكل Function( Integer index ) => String or jQuery. وهي دالة رد نداء تُعيد محتوى HTML أو كائن jQuery المراد التفافها حول العناصر المطابقة. داخل ...

‎.toggleClass( className )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف إضافة أو إزالة صنف واحد أو أكثر من كل عنصر من مجموعة العناصر المُطابقة، اعتمادًا على وجود الصنف أو قيمة وسيط الحالة. ‎.toggleClass( className )‎ أُضيف مع الإصدار: 1.0. className اسم أو أكثر من أسماء الأصناف (مفصولة بمسافات) والمراد تبديلها لكل عنصر في المجموعة المطابقة، وهو من النوع String. ‎.toggleClass( className, state )‎ أُضيف مع الإصدار: 1.3. className اسم أو أكثر من أسماء الأصناف (مفصولة بمسافات) والمراد تبديلها لكل ...

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

يُستخدَم التابع ‎.css()‎ في الحصول على القيمة المحسوبة لخاصية من خاصيات التنسيق (computed style property) للعنصر الأول من مجموعة العناصر المُطابِقة أو تعيين واحدة أو أكثر من خاصيّات CSS لكل عنصر مُطابِق. ‎.css( propertyName )‎ القيمة المعادة سلسلة نصيّة من الكائن String. الوصف الحصول على خاصيّات التنسيق المحسوبة للعنصر الأول من مجموعة العناصر المُطابِقة. ‎.css( propertyName )‎ أضيفت في الإصدار: 1.0. propertyName سلسلة نصيّة String، وتُمثِّل اسم خاصيّة CSS. ‎.css( propertyNames )‎ أضيفت في الإصدار: 1.9. propertyNames مصفوفة Array، وتُمثِّل ...

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

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

يجلب هذا التابع قيمة الارتفاع الخارجي (outer height، تتضمن الحواشي padding، والإطار border، والهامش margin اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة، أو يغير قيمة الارتفاع الخارجي لكل العناصر المطابقة. ‎.outerHeight( [includeMargin ] )‎ القيم المعادة يعيد عددًا من النوع Number. الوصف يجلب هذا التابع قيمة الارتفاع الخارجي (outer height، تتضمن الحواشي [padding]، والإطار [border]، والهامش [margin] اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة. ‎.outerHeight( [includeMargin ] )‎ أضيف مع الإصدار 1.2.6. includeMargin قيمة منطقيَّة (boolean) تحدِّد إن ...

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

‎.prependTo( target )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يُستخدَم هذا التابع في إدخال كل عنصر من مجموعة العناصر المُطابِقة إلى بداية العنصر الهدف. ‎.prependTo( target )‎ أضيف مع الإصدار 1.0. target مُحدِّد (Selector) أو سلسلة نصيّة من الكائن htmlString أو عنصر أو مصفوفة أو كائن jQuery، وتُمثِّل مجموعة العناصر المُطابِقة التي ستُدخَل إلى بداية العنصر أو العناصر المُحدَّدة عن طريق هذا المُعامِل. ينجز التابعان ‎.prepend()‎ و ‎.prependTo()‎ نفس المهمة ويكمن الفرق الأساسي بينهما في الصياغة، أي في ...

يجلب هذا التابع قيمة العرض الخارجي (outer width، تتضمن الحواشي padding، والإطار border، والهامش margin اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة، أو يغير قيمة العرض الخارجي لكل العناصر المطابقة. ‎.outerWidth( [includeMargin ] )‎ القيم المعادة يعيد عددًا من النوع Number. الوصف يجلب هذا التابع قيمة العرض الخارجي (outer height، تتضمن الحواشي [padding]، والإطار [border]، والهامش [margin] اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة. ‎.outerWidth( [includeMargin ] )‎ أضيف مع الإصدار 1.2.6. includeMargin قيمة منطقيَّة (boolean) تحدِّد إن ...

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

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

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

يجب أن يوفر لك هذا الدليل كل ما تحتاج إليه للبدء في استخدام أصناف Model. يسمح Active Model لمساعدي Action Pack بالتفاعل مع كائنات روبي الصرفة. يساعد Active Model أيضًا على إنشاء قواعد بيانات ORM مخصصة للاستخدام خارج إطار ريلز. بعد قراءة هذا الدليل، ستتعلم: كيف يعمل نموذج Active Record. كيف تعمل ردود النداء وعمليات التحقق. كيف تعمل المُسَلسِلات (serializers). كيف يتكامل Active Model مع إطار تدويل ريلز (i18n). مقدمة Active Model هو مكتبة تحتوي على وحدات مختلفة تستخدم في ...

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

تحذف الدّالة delattr()‎ الخاصيّة المُعطاة من الكائن (إن سمَح الكائن بحذف الخاصيّة). البنية العامة delattr(object, name) المعاملات object الكائن المرغوب حذف خاصيّةٍ من خاصيّاته. name سلسلة نصيّة تُمثّل اسم الخاصيّة المرغوب حذفها. القيمة المعادة القيمة None كبقيّة الدّوال التي لا تُعيد أي قيمة صراحةً في بايثون. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّها مُشابهة للكلمة المفتاحيّة del التي تحذف الكائنات: >>> class A: ... def __init__(self, a=1, b=2): ... ...

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

‎.on( events [, selector ] [, data ], handler )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر  بالعناصر المحدَّدة. ‎.on( events [, selector ] [, data ], handler )‎ أُضيف مع الإصدار: 1.7. events سلسلة نصية تحتوي على نوع حدث واحد، أو عدَّة أنواع أحداث مفصولة بمسافة فارغة بالإضافة إلى مجالات أسماء (namespaces) (اختياريَّا) مثل "click"، أو "keydown.myPlugin". selector سلسلة نصية تمثِّل اسم المحدِّد الذي يرشِّح أحفاد (descedants) العناصر ...

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

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

توفر مكتبة jQuery مجموعة قوية من الأدوات لمطابقة العناصر وتحديدها في الصفحة، إذ استفادت المكتبة من CSS بجميع إصداراتها. من أجل استعمال المحارف الخاصة (مثل !"#$%&'()*+,./:;<=>?@[\]^`{|}~) كجزء صرف من الاسم المراد تحديده، يجب أن تهرب تلك المحارف عبر \\. على سبيل المثال، إن كان اسم العنصر المراد تحديده هو id="foo.bar"، يمكنك تحديده عبر المُحدِّد $("#foo\\.bar"). تحوي مواصفات CSS القياسية (أي W3C CSS specification) مجموعة كاملة من القواعد المتعلقة بالمحددات الصالحة. هنالك أيضًا مقالة مفيدة لصاحبها Mathias Bynens تتحدث عن تهريب ...

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

أساس jQuery تشكل التوابع والدوال الموجودة في هذا القسم أساس مكتبة jQuery. المحددات توفر مكتبة jQuery مجموعة قوية من الأدوات لمطابقة العناصر وتحديدها في الصفحة، إذ استفادت المكتبة من CSS بجميع إصداراتها. التنقل بين العناصر تتيح التوابع في هذا القسم بتحديد عناصر موجودة في موضع محدد والتنقل بينها. تعديل العناصر جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل عنصر (أو مجموعة من العناصر) بأكمله وبذاته مثل الإضافة، أو النسخ، أو الحذف، أو الإزالة ...إلخ. (إن كنت تبحث ...

المحدد ‎:not()‎ الوصف يختار هذا المحدِّد جميع العناصر التي لا تطابق المحدِّد المعطى. jQuery( ":not(selector)" )‎ أُضيف مع الإصدار: 1.0. selector المحدِّد المراد منه ترشيح العناصر. يقبل هذا التابع أن يُمرَّر إليه جميع المحدِّدات مثل ‎:not(div a)‎ و ‎:not(div,a)‎. ملاحظات إضافية سينتهي المطاف بالتابع ‎.not()‎ إلى تزويدك بنتائج أكثر قابلية للقراءة عوضًا عن تمرير محدِّدات أو متغيرات معقَّدة إلى مرشِّح المحدِّد ‎:not()‎، ويكون التابع في أغلب الأحيان هو الخيار الأفضل. أمثلة إيجاد جميع مربعات الاختيار (checkbox) التي لم تُختار، وتمييز ...

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

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

الشكل الأول للتابع attr (انظر فقرة البنية العامة) مكافئ للتابع attr_reader. أما الشكل الثاني فيكافئ attr_accessor(name)‎، ولكنه أصبح مهملًا الآن. الشكل الأخير يكافئ attr_reader(name)‎، لكنه أصبح مهملًا أيضًا. البنية العامة attr(name, ...) → nil attr(name, true) → nil attr(name, false) → nil‎ المعاملات name‎ اسم الميزة. القيمة المعادة تعاد القيمة nil. انظر أيضا التابع attr_accessor: يحدد خاصية مسماة (named attribute) لهذه الوحدة. التابع attr_writer: ينشئ تابع وصول (accessor method) للسماح بتعيين قيمة للخاصية symbol.id2name. مصادر قسم التابع attr‎ في الصنف Module‎ في توثيق روبي ...