نتائج البحث
اذهب إلى التنقل
اذهب إلى البحث
التابع jQuery.htmlPrefilter() في jQuery
jQuery.htmlPrefilter( html ) القيم المعادة يعيد سلسلةً نصيةً (String). الوصف يعدِّل ويرشِّح هذا التابع سلاسل HTML النصية الممرَّرة عبر توابع التعديل (manipulation) في jQuery. jQuery.htmlPrefilter( html ) أُضيف مع الإصدار: 1.12/2.2. html سلسلة نصية تحتوي على شيفرة HTML التي يراد تطبيق العمليَّة عليها. إنَّ الحاجة إلى استدعاء هذا التابع بشكل مباشر أمرٌ نادر الحدوث، إذ يستعمل بدلًا من ذلك كنقطة دخول لتعديل توابع التعديل الموجودة. إن أردنا مثلًا إزالة الوسم <del> من محتوى HTML الوارد، فاستعمل هذا التابع مثلما موضح ...
التابع jQuery.htmlPrefilter() في jQuery
jQuery.htmlPrefilter( html ) القيم المعادة يعيد سلسلةً نصيةً (String). الوصف يعدِّل ويرشِّح هذا التابع سلاسل HTML النصية الممرَّرة عبر توابع التعديل (manipulation) في jQuery. jQuery.htmlPrefilter( html ) أُضيف مع الإصدار: 1.12/2.2. html سلسلة نصية تحتوي على شيفرة HTML التي يراد تطبيق العمليَّة عليها. إنَّ الحاجة إلى استدعاء هذا التابع بشكل مباشر أمرٌ نادر الحدوث، إذ يستعمل بدلًا من ذلك كنقطة دخول لتعديل توابع التعديل الموجودة. إن أردنا مثلًا إزالة الوسم <del> من محتوى HTML الوارد، فاستعمل هذا التابع مثلما موضح ...
التابع .attr() في jQuery
يُستَخدَم التّابع .attr() للحصول على قيمة خاصيّة HTML لأوّل عنصر من مجموعة العناصر المُطابِقة، أو تعيين خاصيّة HTML أو عدة خاصيّات لكل عنصر مُطابِق. attr( attributeName ). القيمة المعادة سلسلة نصيّة على شكل الكائن String. الوصف الحصول على قيمة خاصيّة HTML لأوّل عنصر من مجموعة العناصر المُطابِقة. attr( attributeName ). أضيفت في الإصدار: 1.0. attributeName سلسلة نصيّة من الكائن String، تُمثِّل اسم خاصيّة HTML المطلوب الحصول على قيمتها. يحصل التّابع .attr() على قيمة خاصيّة HTML لأول عنصر فقط من المجموعة ...
محدد العناصر التي لها الخاصية [name] في jQuery
محدد العناصر التي لها الخاصية [name] الوصف يختار هذا المحدد العناصر التي تمتلك خاصية معينة مهما كانت قيمتها. jQuery( "[attribute]" ) أضيف مع الإصدار: 1.0. attribute اسم الخاصية المراد البحث عنها. أمثلة إضافة قيمة الخاصية id إلى المحتوى النصي للعنصر الذي يمتلك الخاصية id : <!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>attributeHas demo</title>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<div>no id</div>
<div id="hey">with id</div>
<div id="there">has an id</div>
<div>nope</div>
<script>
// .one() نستعمل التابع
// لكي يُنفَّذ معالج الأحداث مرةً واحدةً على الأكثر لكل عنصر ولكل حدث
$( "div[id]" ).one( "click", ...
الدالة jQuery() في jQuery
تعيد هذه الدالة مجموعةً من العناصر المطابقة التي إمَّا وُجدَت في شجرة DOM بناءً على الوسائط المُمرَّرة، أو أنشئت بتمرير سلسلة نصية تحتوي على محتوى HTML. jQuery( selector [, context ] ) القيم المعادة تعيد كائنًا من النوع jQuery. الوصف تقبل هذه الدالة سلسلة نصية تحتوي على محدِّد CSS يُستعمَل لمطابقة مجموعة من العناصر. jQuery( selector [, context ] ) أُضيفت مع الإصدار: 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد. context عنصر DOM، أو كائن Document، أو كائن jQuery ...
محدد الخاصيات التي فيها [name*="value"] في jQuery
محدد الخاصيات التي فيها [name*="value"] الوصف تحديد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تحتوي على السلسلة النصيّة الفرعيّة المُعطاة. jQuery( "[attribute*='value']" ) أضيفت في الإصدار: 1.0. attribute اسم خاصيّة HTML. value قيمة خاصيّة HTML. يُمكِن أن تكون مُعرِّفًا صالحًا (valid identifier) أو سلسلةً نصيّةً موضوعةً بين علامتي اقتباس. يُعَد هذا المُحدِّد الأكثر تطابقًا تجاه القيمة من بين مُحدِّدات الخاصيّات في jQuery، حيث يختار العنصر إن ظهرت السلسلة النصيّة للمُحدِّد في أي مكان من قيمة خاصيّة العنصر. قارن هذا ...
تعديل العناصر في jQuery
جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل عنصر (أو مجموعة من العناصر) بأكمله وبذاته مثل الإضافة، أو النسخ، أو الحذف، أو الإزالة ...إلخ. (إن كنت تبحث عن توابع تعدل خاصية عنصر، فانتقل إلى قسم «تعديل الخاصيات»). .after() يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل بعد كل عنصر من مجموعة العناصر المُطابقة. .append() يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل إلى آخر كل عنصر من مجموعة العناصر المُطابِقة. .appendTo() يُدخِل هذا التّابع كل عنصر من ...
محدد الخاصيات التي تنتهي بـ [name$="value"] في jQuery
محدد الخاصيات التي تنتهي بـ [name$="value"] الوصف تحديد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تنتهي بالضّبط بالسلسلة النصيّة المُعطاة، تكون المقارنة حسّاسة لحالة الأحرف. jQuery( "[attribute$='value']" ) أضيفت في الإصدار: 1.0. attribute اسم خاصيّة HTML. value قيمة خاصيّة HTML. يُمكِن أن تكون مُعرِّفًا صالحًا (valid identifier) أو سلسلةً نصيّةً موضوعةً بين علامتي اقتباس. أمثلة إيجاد كافّة حقول الإدخال والتي خاصيّة الاسم لها تنتهي بالقيمة letter، ووضع نص فيها: <!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>مثال عن محدد ...
محدد الخاصيات التي تساوي [name="value"] في jQuery
محدد الخاصيات التي تساوي [name="value"] الوصف تحديد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تُساوي تمامًا قيمة مُعيَّنة. jQuery( "[attribute='value']" ) أضيفت في الإصدار: 1.0. attribute اسم خاصيّة HTML. value قيمة خاصيّة HTML. يُمكِن أن تكون مُعرِّفًا صالحًا (valid identifier) أو سلسلةً نصيّةً موضوعةً بين علامتي اقتباس. أمثلة إيجاد كافّة حقول الإدخال التي تملك القيمة أحمر وتبديل نص عنصر <span> المُجاور لها: <!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>مثال عن محدد الخاصيات التي تساوي [name="value"]</title>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
...
التابع .removeClass() في jQuery
.removeClass( [className ] ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع صنفًا واحدًا، أو عدَّة أصناف، أو جميع الأصناف من كل عنصر في مجموعة العناصر المطابقة. .removeClass( [className ] ) أُضيف مع الإصدار: 1.0. className سلسلة نصيَّة تمثِّل اسم صنفٍ واحدٍ أو عدَّة أصناف مفصولة بمسافة يراد حذفها من الخاصِّيَّة class لكل عنصر مطابق. .removeClass( function ) أُضيف مع الإصدار: 1.4. function دالة من الشكل Function( Integer index, String className ) والتي تعيد سلسلة نصية تمثِّل ...
محدد الخاصيات ذات السابقة [name|="value"] في jQuery
محدد الخاصيات ذات السابقة [name|="value"] الوصف تحديد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تساوي السلسلة النصيّة المُعطاة أو تبدأ بتلك السلسلة النصيّة متبوعةً بشرطة (-). jQuery( "[attribute|='value']" ) أضيفت في الإصدار: 1.0. attribute اسم خاصيّة HTML. value قيمة خاصيّة HTML، يُمكِن أن تكون مُعرِّفًا صالحًا (valid identifier) أو سلسلةً نصيّةً موضوعةً بين علامتي اقتباس. أُضيف هذا المُحدِّد إلى مواصفات CSS للتعامل مع خاصيّات HTML في تلك اللغة. أمثلة إيجاد كافّة الرّوابط التي تمتلك الخاصيّة hreflang ذات اللغة الإنجليزيّة، ...
محدد الخاصيات التي لا تساوي [name!="value"] في jQuery
محدد الخاصيات التي لا تساوي [name!="value"] الوصف تحديد العناصر التي إمّا لا تمتلك خاصيّة HTML المُحدَّدة أو تمتلكها ولكن قيمتها لا تُساوي القيمة المُعيَّنة. jQuery( "[attribute!='value']" ) أضيفت في الإصدار: 1.0. attribute اسم خاصيّة HTML. value قيمة خاصيّة HTML. يُمكِن أن تكون مُعرِّفًا صالحًا (valid identifier) أو سلسلةً نصيّةً موضوعةً بين علامتي اقتباس. يُكافِئ هذا المُحدِّد :not([attr='value']) ملاحظات إضافيّة لمّا كانت [name!="value"] عبارة عن امتداد jQuery وليست جزءًا من مواصفات CSS، فلن تستفيد الاستعلامات التي تستخدم [name!="value"] من زيادة الأداء ...
محدد الخاصيات التي فيها كلمة [name~="value"] في jQuery
محدد الخاصيات التي فيها كلمة [name~="value"] الوصف تحديد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تحتوي على الكلمة المُعطاة محدودةً بينها بمسافات فارغة. jQuery( "[attribute~='value']" ) أضيفت في الإصدار: 1.0. attribute اسم خاصيّة HTML. value قيمة خاصيّة HTML. يُمكِن أن تكون مُعرِّفًا صالحًا (valid identifier) أو سلسلةً نصيّةً موضوعةً بين علامتي اقتباس. يُطابِق هذا المُحدِّد السلسلة النصيّة المُختَبَرَة مع كل كلمة من قيمة خاصيّة HTML، حيث تُعرَّف الكلمة كسلسلة نصيّة مفصولة بينها بمسافات فارغة. يُطابِق المُحدِّد إن كانت السلسلة ...
محدد الخاصيات التي تبدأ بـ [name^="value"] في jQuery
محدد الخاصيات التي تبدأ بـ [name^="value"] الوصف تحديد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تبدأ بالضّبط بالسلسلة النصيّة المُعطاة. jQuery( "[attribute^='value']" ) أضيفت في الإصدار: 1.0. attribute اسم خاصيّة HTML. value قيمة خاصيّة HTML. يُمكِن أن تكون مُعرِّفًا صالحًا (valid identifier) أو سلسلةً نصيّةً موضوعةً بين علامتي اقتباس. يُفيد هذا المُحدِّد في تحديد العناصر في صفحات مُنتَجَة من قبل أُطُر عمل من جهة الخادم (server-side frameworks) والتي تُنتِج HTML مع وضع مُعرِّفات مُمنهجة للعناصر، ولكن على الرغم من ...
التابع .prop() في jQuery
يجلب هذا التابع قيمة خاصِّيَّة كائن محدَّدةٍ للعنصر الأول من مجموعة العناصر المطابقة، أو يضبط قيمة خاصِّيَّة كائن واحدة أو أكثر لجميع العناصر المطابقة. .prop( propertyName ) القيم المعادة يعيد أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيَّة إعادة أي نوع). الوصف يجلب هذا التابع قيمة خاصِّيَّة كائن محدَّدةٍ للعنصر الأول من مجموعة العناصر المطابقة. .prop( propertyName ) أُضيف مع الإصدار: 1.6. propertyName سلسلة نصية تمثِّل اسم الخاصِّيَّة المراد إعادة قيمتها. يجلب التابع .prop() قيمة خاصِّيَّة معينة ...
محدد أكثر من خاصية [name="value"] في jQuery
محدد أكثر من خاصية Multiple Attribute Selector الوصف يختار هذا المحدِّد العناصر التي تطابق جميع مرشِّحات خاصِّيَّة معينة. jQuery( "[attributeFilter1][attributeFilter2][attributeFilterN]" ) أُضيف مع الإصدار: 1.0. attributeFilter1 مرشِّح خاصِّيَّة. attributeFilter2 مرشِّح خاصِّيَّة آخر والذي يقلص العناصر المراد تحديدها. attributeFilter3 مرشِّح خاصِّيَّة آخر، ويمكن استعمال عددٍ من المرشِّحات بحسب الحاجة. أمثلة إيجاد جميع المدخلات التي تملك الخاصِّيَّة id وتنتهي قيمة الخاصِّيَّة name لها بالقيمة man ثمَّ ضبط قيمتها: <!doctype html>
<html lang="ar">
<head>
<meta charset="utf-8">
<title>attributeMultiple مثالٌ عن محدد الخاصيات المتعددة</title>
...
التابع .removeData() في jQuery
.removeData( [name ] ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع جزءًا من البيانات المخزَّنة مسبقًا. .removeData( [name ] ) أُضيف مع الإصدار: 1.2.3. name سلسلة نصيِّة تمثِّل اسم جزء البيانات المراد حذفها. .removeData( [list ] ) أُضيف مع الإصدار: 1.7. list مصفوفة أو سلسلة نصية تحتوي على أسماء أجزاء البيانات المراد حذفها، وتفصل الأسماء في السلسلة النصية بفراغ. يسمح لنا التابع .removeData() بحذف القيم التي ضُبطت مسبقًا باستعمال التابع .data(). إن مرِّر إلى التابع اسم ...
التابع .html() في jQuery
يجلب هذا التابع محتوى HTML لأول عنصر في مجموعة العناصر المطابقة أو يغير محتوى HTML لكل العناصر المطابقة. ()html. القيم المعادة يعيد سلسلة نصية من النوع String. الوصف يجلب هذا التابع محتوى HTML لأول عنصر في مجموعة العناصر المطابقة. .html() أضيفت مع الإصدار: 1.0، ولا يقبل هذا التابع أي معاملات. هذا التابع غير متوافر في صفحات XML. في صفحة HTML، يمكن استعمال التابع ()html. لجلب محتوى أي عنصر. إذا طابق تعبير المحدد أكثر من عنصر، فسيُعاد محتوى HTML للعنصر الأول ...
التابع .hasClass() في jQuery
.hasClass( className ) القيم المعادة يعيد قيمة منطقية Boolean. الوصف حدد إن كانت العناصر التي اختيرت سابقًا تمتلك صنفًا معينًا أم لا. .hasClass( className ) أُضيف مع الإصدار: 1.2. className سلسلة نصية تمثل اسم الصنف المراد البحث عنه. يمكن إسناد أكثر من صنف إلى العناصر. نعبر عن هذا في HTML بفصل أسماء الأصناف بمسافة فارغة: <div id="mydiv" class="foo bar"></div>
سيعيد التابع .hasClass() القيمة true إذا كان الصنف المبحوث عنه مسندًا إلى العنصر المحدد حتى إن كان هذا العنصر يمتلك أصنافًا أخرى. ...
التابع .removeAttr() في jQuery
.removeAttr( attributeName ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع خاصِّيَّة HTML محدَّدة لكل عنصر في مجموعة العناصر المطابقة. .removeAttr( attributeName ) أُضيف مع الإصدار: 1.0. attributeName سلسلة نصِّيَّة تمثِّل اسم خاصِّيَّة HTML المراد حذفها. ابتداءً من الإصدار 1.7، يمكن أن تحتوي السلسلة النصِّيَّة على قائمة من الخاصِّيَّات المفصولة بفراغ. يستخدم التابع .removeAttr() الدالة removeAttribute() الموجودة في JavaScript، ولكنَّه يتميز عنها بأنَّه يمكن أن يُستدعَى مع الكائن jQuery مباشرةً ويأخذ بالحسبان التسمية المختلفة للخاصِّيَّات عبر المتصفحات. ...
تعديل الخاصيات في jQuery
جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل خاصية محددة لعنصر (أو مجموعة من العناصر). توصف أغلبية هذه التوابع على أنها «توابع ضابطة» (setters)، إذ تضبط وتغير قيمة خاصية محددة. هنالك قلة من هذه التوابع توصف على أنها «توابع جالبة» (getters) مثل .attr() و .html() و .val() لأنها تجلب معلومات من عناصر DOM لاستخدامها لاحقًا. (إن كنت تود إجراء تعديل على العنصر نفسه، فارجع إلى قسم «تعديل العناصر»). .addClass() يُضيف هذا التّابع الصّنف أو الأصناف المُحدَّدة لكل ...
التابع .addClass() في jQuery
.addClass( className ) القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع .addClass() لإضافة الصّنف أو الأصناف المُحدَّدة لكل عنصر من مجموعة العناصر المُطابقة. .addClass( className ) أضيفت في الإصدار: 1.0. className سلسلة نصيّة من الكائن String، وتُمثِّل صنف أو عدة أصناف مفصولة بمسافة بينها لإضافتها إلى الخاصيّة class لكل عنصر مُطابق. .addClass( function ) أضيفت في الإصدار: 1.4. Function دالة على الشكل Function( Integer index, String currentClassName ) وتُعيد سلسلة نصيّة. دالة تُعيد اسم أو عدة أسماء لأصناف مفصولةً بمسافة بينها ...
التابع .removeProp() في jQuery
.removeProp( propertyName ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع خاصِّيَّة كائنيِّة محدَّدة لكل عنصر في مجموعة العناصر المطابقة. .removeProp( propertyName ) أُضيف مع الإصدار: 1.6. propertyName سلسلة نصية تمثِّل اسم الخاصِّيَّة الكائنية المراد حذفها. يحذف التابع .removeProp() الخاصِّيَّات التي ضُبطَت باستعمال التابع .prop(). قد تولِّد المتصفحات خطأً عند محاولة حذف بعض الخاصِّيَّات المضمَّنة لعنصر DOM أو الكائن window. تسند الخاصِّيَّة jQuery آنذاك القيمة undefined للخاصِّيَّة وتتجاهل أي خطأ ولَّده المتصفح. من المهم عمومًا حذف الخاصِّيَّات ...
التابع .val() في jQuery
إعادة القيمة الحالية للعنصر الأول في مجموعة العناصر المُطابقة أو تعيين قيمة (value) كل عنصر مُطابق. .val() القيمة المعادة يُعيد كائنًا من النوع String أو Number أو Array. الوصف إعادة القيمة الحالية للعنصر الأول في مجموعة العناصر المُطابقة. .val() أُضيف مع الإصدار: 1.0. لا يقبل هذا الشكل أي وسائط. يستخدم التابع .val() في المقام الأول للحصول على قيم عناصر النماذج مثل <input> و <select> و <textarea>. عند استدعائها على مجموعة فارغة، فإنها تُعيد undefined. عندما يكون العنصر الأول في المجموعة ...
التابع jQuery.cssNumber() في jQuery
jQuery.cssNumber القيم المعادة يعيد كائنًا من النوع Object. الوصف يعيد هذا التابع كائنًا يحتوي على جميع خاصِّيَّات CSS التي يمكن استعمالها دون واحدة. يستعمل التابع .css() هذا الكائن ليتحقَّق إن كان بإمكانه إضافة الواحدة px إلى القيم المعطاة دون واحدة. jQuery.cssNumber أُضيف مع الإصدار: 1.4.3. يمكنك أن تتخيل أنَّ jQuery.cssNumber ليس إلا قائمةً بجميع خاصِّيَّات CSS التي يمكنك استعمالها دون واحدة. يستعمل التابع .css() هذه القائمة ليحدِّد إن كان هنالك حاجة لإضافة الواحدة px إلى القيم عديمة الواحدة. تكون مفاتيح ...
التابع .text() في jQuery
يجلب هذا التابع المحتوى النصي المرتبط بكل عنصر في مجموعة العناصر المطابقة بالإضافة إلى العناصر الأحفاد لهم، أو يغيِّر المحتوى النصي للعناصر المطابقة. .text() القيم المعادة يعيد سلسلة نصية من النوع String. الوصف يجلب هذا التابع المحتوى النصي المرتبط بكل عنصر في مجموعة العناصر المطابقة بالإضافة إلى المحتوى النصي للعناصر الأحفاد أيضًا. .text() أُضيف مع الإصدار: 1.0. ولا يقبل هذا التابع أية وسائط. يمكن استعمال التابع .text() في مستندات XML ومستندات HTML كلاهما خلافًا للتابع .html(). يعيد التابع سلسلة نصية ...
التابع .appendTo() في jQuery
.appendTo( target ) القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع .appendTo() في إدخال كل عنصر من مجموعة العناصر المُطابِقة إلى نهاية العنصر الهدف. .appendTo( target ) أضيفت في الإصدار: 1.0. target مُحدِّد (Selector) أو سلسلة نصيّة من الكائن htmlString أو عنصر أو مصفوفة أو كائن jQuery، وتُمثِّل مجموعة العناصر المُطابِقة التي ستُدخَل إلى نهاية العنصر أو العناصر المُحدَّدة عن طريق هذا المُعامِل. ينجز التّابعان .append() و .appendTo() نفس المهمة ويكمن الفرق الأساسي بينهما في الصّياغة، أي في مكان تحديد المحتوى ...
التابع .insertBefore() في jQuery
.insertBefore( target ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف إدخال كل عنصر من مجموعة العناصر المُطابقة بعد الهدف. .insertBefore( target ) أُضيف مع الإصدار: 1.0. target كائن قد يكون من النوع Selector أو htmlString أو Element أو Array أو jQuery، وهو يمثل محدد أو عنصر أو مصفوفة عناصر أو سلسلة HTML أو كائن jQuery؛ ستدرج مجموعة العناصر المطابقة قبل العنصر (العناصر) المحدد بواسطة هذا المعامل. يُنفذ التابع .before() والتابع .insertBefore() نفس المهمة. الاختلاف الرئيسي هو في بناء الجملة، على ...
التابع .after() في jQuery
after( content [, content ] ). القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع .after() لإدخال المحتوى المُحدَّد عن طريق المُعامِل بعد كل عنصر من مجموعة العناصر المُطابقة. .after( content [, content ] ) أضيفت في الإصدار: 1.0. content سلسلة نصيّة من الكائن htmlString، أو عنصر، أو نص، أو مصفوفة، أو jQuery، وتُمثِّل سلسلة html، أو عنصر DOM، أو عقدة نصيّة (text node)، أو مصفوفة من العناصر والعقد النصيّة، أو كائن jQuery المطلوب إدخالها بعد كل عنصر من مجموعة العناصر المُطابقة. ...
التابع .position() في jQuery
.position() القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يجلب هذا التابع الإحداثيات الحالية للعنصر الأول في المجموعة المطابقة نسبةً إلى أقرب عنصر أب متموضع (offset parent) لذلك العنصر. .position() أضيف مع الإصدار 1.2. لا يقبل هذا التابع أية وسائط. يجلب التابع .position() الإحداثيات الحالية لعنصرٍ (لإطار حوافه الخارجية [margin box] تحديدًا) نسبةً إلى أقرب عنصر أب له (إطار حواشيه [padding box] تحديدًا، أي باستثناء الهوامش والإطار). يختلف هذا التابع عن التابع .offset() الذي يعيد الإحداثيات الحالية للعنصر نسبةً إلى ...
التابع .offset() في jQuery
يجلب الإحداثيات الحاليَّة للعنصر الأول أو يضبط إحداثيات كل عنصر في مجموعة العناصر المطابقة نسبةً إلى الصفحة. .offset() القيم المعادة يعيد كائنًا من النوع Object. الوصف يجلب الإحداثيات الحاليَّة للعنصر الأول في مجموعة العناصر المطابقة نسبةً إلى الصفحة. .offset() أُضيف مع الإصدار: 1.2. لا يقبل هذا الشكل أي وسائط. يسمح لنا التابع .offset() بمعرفة الموقع الحالي لعنصر محدَّد (خصوصًا معرفة حدوده ويُستثنى منها الهوامش) نسبةً إلى الصفحة. من جهة أخرى، نجد أنَّ التابع .position() يعيد الموقع الحالي للعنصر نسبة إلى ...
التابع .innerHeight() في jQuery
يعيد هذا التابع قيمة الطول الحالي (تتضمن قيمة الحواشي فقط دون الإطار) لأول عنصر في مجموعة العناصر المطابقة أو يغير الطول الداخلي لكل العناصر المطابقة. .innerHeight() القيم المعادة يعيد عدد من النوع Number. الوصف يعيد هذا التابع قيمة الطوال الحالي (من ضمنها قيمة الحواشي فقط دون إطار) لأول عنصر في مجموعة العناصر المطابقة. .innerHeight() أضيف مع الإصدار: 1.2.6، ولا يقبل هذا التابع أي معاملات. يعيد هذا التابع قيمة طول العنصر، وتدخل قيمة الحواشي العليا والسفلى ضمن تلك القيمة، بواحدة البكسل. ...
التابع .height() في jQuery
يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة أو يغير الطول لكل العناصر المتطابقة. .height() القيم المعادة عدد من النوع Number. الوصف يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة سابقًا. .height() أضيف مع الإصدار 1.0، ولا يقبل هذا التابع أي معاملات. الفرق بين التابع .css( "height" ) والتابع .height() هو أن الأخير يعيد قيمة الطول بدون واحدة (يعيد 400 مثلًا)، بينما يعيد التابع الأول قيمة الطول مع واحدة (يعيد 400px مثلًا). يفضل استعمال ...
التابع .remove() في jQuery
.remove( [selector ] ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع مجموعة العناصر المطابقة من DOM. .remove( [selector ] ) أُضيف مع الإصدار: 1.0. selector سلسلة نصية تمثِّل تعبير المحدد الذي يرشِّح مجموعة العناصر المطابقة لإزالتها. يطرح التابع .remove() عناصر محدَّدة خارج DOM بطريقة مماثلة لما يفعله التابع .empty(). استعمل التابع .remove() لحذف عنصر معين بذاته بالإضافة إلى حذف كل شيء بداخله. أضف إلى ذلك أيضًا أنه يحذف جميع الأحداث وبيانات jQuery المرتبطة والمتعلقة بالعنصر. إن ...
التابع .scrollTop() في jQuery
يجلب هذا التابع موضع شريط التمرير الشاقولي الحالي للعنصر الأول من مجموعة العناصر المطابقة، أو يضبط موضع شريط التمرير الشاقولي لجميع العناصر المطابقة. .scrollTop() القيم المعادة يعيد عددًا من النوع Number. الوصف يجلب هذا التابع موضع شريط التمرير الشاقولي الحالي للعنصر الأول من مجموعة العناصر المطابقة. .scrollTop() أُضيف مع الإصدار: 1.2.6، ولا يقبل هذا التابع أية وسائط. موضع شريط التمرير الشاقولي هو نفسه عدد البكسلات المخفية من النافذة المعروضة القابلة للتمرير وحتى أعلاها (الجزء المخفي من المنطقة العلوية القابلة للتمرير). ...
التابع .clone() في jQuery
.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() في jQuery
يعيد هذا التابع قيمة العرض الحالي (تدخل قيمة الحواشي ضمنها فقط) لأول عنصر من مجموعة العناصر المطابقة أو يغير العرض الداخلي لكل العناصر المطابقة. .innerWidth() القيم المعادة يعيد عدد من النوع Number. الوصف يعيد هذا التابع قيمة العرض الحالي (من ضمنها قيمة الحواشي ودون قيمة الإطار) لأول عنصر من مجموعة العناصر المطابقة. .innerWidth() أضيف مع الإصدار: 1.2.6، ولا يقبل هذا التابع أي معاملات. يعيد هذا التابع عرض العنصر، من ضمنها الحواشي اليمنى واليسرى، بواحدة البكسل. إن كان كائن jQuery فارغًا ...
التابع .empty() في jQuery
.empty() القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يُزيل هذا التابع كافة العُقَد السليلة لمجموعة العناصر المتطابقة من DOM. .empty() أُضيف مع الإصدار: 1.0. لا يقبل هذا التابع أي وسائط. لا يزيل هذا التابع العناصر الأبناء (والعناصر السليلة الأخرى) فقط، بل يزيل أيضًا أي نص ضمن مجموعة العناصر المتطابقة. ويرجع ذلك إلى أنه وفقًا لمواصفات DOM، تعدّ أي سلسلة نصية داخل عنصر ما عقدة ابن لهذا العنصر. إليك شيفرة HTML التالية: <div class="container">
<div class="hello">مرحبًا</div>
<div class="goodbye">مع ...
التابع .insertAfter() في jQuery
.insertAfter( target ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف إدخال كل عنصر من مجموعة العناصر المُطابقة بعد الهدف. .insertAfter( target ) أُضيف مع الإصدار: 1.0. target كائن قد يكون من النوع Selector أو htmlString أو Element أو Array أو jQuery، وهو يمثل محدد أو عنصر أو مصفوفة عناصر أو سلسلة HTML أو كائن jQuery؛ ستدرج مجموعة العناصر المطابقة بعد العنصر (العناصر) المحدد بواسطة هذا المعامل. ينفذ كلٌ من التابع .after() والتابع .insertAfter() نفس المهمة. الاختلاف الرئيسي هو في ...
التابع .wrap() في jQuery
.wrap( wrappingElement ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف تغليف شيفرة HTML حول كل عنصر في مجموعة العناصر المُطابقة. .wrap( wrappingElement ) أُضيف مع الإصدار: 1.0. wrappingElement مُحدد أو عنصر أو سلسلة HTML أو كائن jQuery يحدد الشيفرة المراد تغليفها حول العناصر المُطابقة. عند تمرير مجموعة jQuery تحتوي على أكثر من عنصر واحد، أو محدد يتطابق مع أكثر من عنصر واحد، فسيُستخدم العنصر الأول. وهو من النوع Selector أو htmlString أو Element أو jQuery. .wrap( function ) أُضيف ...
التابع .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 ...
التابع .scrollLeft() في jQuery
يجلب هذا التابع موضع شريط التمرير الأفقي الحالي للعنصر الأول من مجموعة العناصر المطابقة، أو يضبط موضع شريط التمرير الأفقي لجميع العناصر المطابقة. .scrollLeft() القيم المعادة يعيد عددًا من النوع Number. الوصف يجلب هذا التابع موضع شريط التمرير الأفقي الحالي للعنصر الأول من مجموعة العناصر المطابقة. .scrollLeft() أُضيف مع الإصدار: 1.2.6، ولا يقبل هذا التابع أية وسائط. موضع التمرير الأفقي هو نفسه عدد البكسلات المخفية من النافذة المعروضة وإلى يسار المنطقة القابلة للتمرير. إن كان شريط التمرير مزاحًا كليًّا إلى ...
التابع jQuery.cssNumber() في jQuery
jQuery.cssNumber القيم المعادة يعيد كائنًا من النوع Object. الوصف يعيد هذا التابع كائنًا يحتوي على جميع خاصِّيَّات CSS التي يمكن استعمالها دون واحدة. يستعمل التابع .css() هذا الكائن ليتحقَّق إن كان بإمكانه إضافة الواحدة px إلى القيم المعطاة دون واحدة. jQuery.cssNumber أُضيف مع الإصدار: 1.4.3. يمكنك أن تتخيل أنَّ jQuery.cssNumber ليس إلا قائمةً بجميع خاصِّيَّات CSS التي يمكنك استعمالها دون واحدة. يستعمل التابع .css() هذه القائمة ليحدِّد إن كان هنالك حاجة لإضافة الواحدة px إلى القيم عديمة الواحدة. تكون مفاتيح ...
التابع .wrapAll() في jQuery
.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() في jQuery
.toggleClass( className ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف إضافة أو إزالة صنف واحد أو أكثر من كل عنصر من مجموعة العناصر المُطابقة، اعتمادًا على وجود الصنف أو قيمة وسيط الحالة. .toggleClass( className ) أُضيف مع الإصدار: 1.0. className اسم أو أكثر من أسماء الأصناف (مفصولة بمسافات) والمراد تبديلها لكل عنصر في المجموعة المطابقة، وهو من النوع String. .toggleClass( className, state ) أُضيف مع الإصدار: 1.3. className اسم أو أكثر من أسماء الأصناف (مفصولة بمسافات) والمراد تبديلها لكل ...
التابع .before() في jQuery
.before( content [, content ] ) القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع .before() لإدخال المحتوى المُحدَّد عن طريق المُعامِل قبل كل عنصر من مجموعة العناصر المُطابقة. .before( content [, content ] ) أضيفت في الإصدار: 1.0. content سلسلة نصيّة من الكائن htmlString، أو عنصر، أو نص، أو مصفوفة، أو jQuery، وتُمثِّل سلسلة HTML، أو عنصر DOM، أو عقدة نصيّة (text node)، أو مصفوفة من العناصر والعقد النصيّة، أو كائن jQuery المطلوب إدخالها قبل كل عنصر من مجموعة العناصر المُطابقة. ...
التابع .css() في jQuery
يُستخدَم التابع .css() في الحصول على القيمة المحسوبة لخاصية من خاصيات التنسيق (computed style property) للعنصر الأول من مجموعة العناصر المُطابِقة أو تعيين واحدة أو أكثر من خاصيّات CSS لكل عنصر مُطابِق. .css( propertyName ) القيمة المعادة سلسلة نصيّة من الكائن String. الوصف الحصول على خاصيّات التنسيق المحسوبة للعنصر الأول من مجموعة العناصر المُطابِقة. .css( propertyName ) أضيفت في الإصدار: 1.0. propertyName سلسلة نصيّة String، وتُمثِّل اسم خاصيّة CSS. .css( propertyNames ) أضيفت في الإصدار: 1.9. propertyNames مصفوفة Array، وتُمثِّل ...
التابع .replaceWith() في jQuery
.replaceWith( newContent ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يبدِّل هذا التابع المحتوى الجديد المعطى مكان كل عنصر في مجموعة العناصر المطابقة، ويعيد مجموعة العناصر التي استُبدلت. .replaceWith( newContent ) أُضيف مع الإصدار: 1.2. newContent المحتوى الجديد الذي سيحل محل عناصر محدَّدة، وقد يكون سلسلة نصيَّة من الكائن htmlString أو عنصر DOM أو مصفوفة من عناصر DOM أو كائن jQuery. .replaceWith( function ) أُضيف مع الإصدار: 1.4. function دالة من الشكل Function()، وتعيد المحتوى الذي سيُستبدل بمجموعة العناصر ...
التابع .unwrap() في jQuery
.unwrap() القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف إزالة آباء مجموعة العناصر المُطابقة من شجرة DOM، مع ترك العناصر المُطابقة في مكانها. .unwrap() أُضيف مع الإصدار: 1.4. لا يقبل هذا الشكل أي وسائط. .unwrap( [selector ] ) أُضيف مع الإصدار: 3.0. selector محدد للتحقق من العنصر الأب من النوع String. إذا لم يتطابق العنصر الأب لأحد العناصر مع المحدد، فلن يُحذف. يُزيل التابع .unwrap() العنصر الأب ويُعيد محتواه بدونه. وهو بالضبط معكوس التابع .wrap(). وتحل العناصر المطابقة (ومثيلاتها، إن ...
التابع .outerHeight() في jQuery
يجلب هذا التابع قيمة الارتفاع الخارجي (outer height، تتضمن الحواشي padding، والإطار border، والهامش margin اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة، أو يغير قيمة الارتفاع الخارجي لكل العناصر المطابقة. .outerHeight( [includeMargin ] ) القيم المعادة يعيد عددًا من النوع Number. الوصف يجلب هذا التابع قيمة الارتفاع الخارجي (outer height، تتضمن الحواشي [padding]، والإطار [border]، والهامش [margin] اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة. .outerHeight( [includeMargin ] ) أضيف مع الإصدار 1.2.6. includeMargin قيمة منطقيَّة (boolean) تحدِّد إن ...
التابع .prepend() في jQuery
.prepend( content [, content ] ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يُستخدَم هذا التابع في إدخال لمحتوى المُحدَّد عن طريق المُعامِل إلى بداية كل عنصر من مجموعة العناصر المُطابِقة. .prepend( content [, content ] ) أضيف مع الإصدار 1.0. content سلسلة نصيّة من الكائن htmlString، أو عنصر، أو نص، أو مصفوفة، أو كائن jQuery، وتُمثِّل سلسلة HTML، أو عنصر DOM، أو عقدة نصيّة (text node)، أو مصفوفة من العناصر والعقد النصيّة، أو كائن jQuery المطلوب إدخالها في ...
التابع .prependTo() في jQuery
.prependTo( target ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يُستخدَم هذا التابع في إدخال كل عنصر من مجموعة العناصر المُطابِقة إلى بداية العنصر الهدف. .prependTo( target ) أضيف مع الإصدار 1.0. target مُحدِّد (Selector) أو سلسلة نصيّة من الكائن htmlString أو عنصر أو مصفوفة أو كائن jQuery، وتُمثِّل مجموعة العناصر المُطابِقة التي ستُدخَل إلى بداية العنصر أو العناصر المُحدَّدة عن طريق هذا المُعامِل. ينجز التابعان .prepend() و .prependTo() نفس المهمة ويكمن الفرق الأساسي بينهما في الصياغة، أي في ...
التابع .outerWidth() في jQuery
يجلب هذا التابع قيمة العرض الخارجي (outer width، تتضمن الحواشي padding، والإطار border، والهامش margin اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة، أو يغير قيمة العرض الخارجي لكل العناصر المطابقة. .outerWidth( [includeMargin ] ) القيم المعادة يعيد عددًا من النوع Number. الوصف يجلب هذا التابع قيمة العرض الخارجي (outer height، تتضمن الحواشي [padding]، والإطار [border]، والهامش [margin] اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة. .outerWidth( [includeMargin ] ) أضيف مع الإصدار 1.2.6. includeMargin قيمة منطقيَّة (boolean) تحدِّد إن ...
التابع .detach() في jQuery
.detach( [selector ] ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع مجموعة العناصر المتطابقة من DOM. .detach( [selector ] ) أُضيف مع الإصدار: 1.4. selector تعبير مُحدِّد يُرشِح مجموعة العناصر المتطابقة المراد حذفها وهو من النوع Selector. يعمل التابع .detach() مثل التابع .remove() ، باستثناء أن .detach() يحتفظ بكل بيانات jQuery المرتبطة بالعناصر المحذوفة. يُفيد هذا التابع عند إعادة إدراج العناصر التي تمت إزالتها إلى DOM في وقت لاحق. أمثلة حذف جميع الفقرات من DOM: <!doctype ...
التابع .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 لتغليف محتوى العناصر ...
التابع .append() في jQuery
.append( content [, content ] ) القيمة المعادة كائن jQuery. الوصف يُستخدَم التّابع .append() في إدخال المحتوى المُحدَّد عن طريق المُعامِل إلى آخر كل عنصر من مجموعة العناصر المُطابِقة. .append( content [, content ] ) أضيفت في الإصدار: 1.0. content سلسلة نصيّة من الكائن htmlString، أو عنصر، أو نص، أو مصفوفة، أو jQuery، وتُمثِّل سلسلة HTML، أو عنصر DOM، أو عقدة نصيّة (text node)، أو مصفوفة من العناصر والعقد النصيّة، أو كائن jQuery المطلوب إدخالها بعد كل عنصر من مجموعة ...
أساسيات Active Model في ريلز
يجب أن يوفر لك هذا الدليل كل ما تحتاج إليه للبدء في استخدام أصناف Model. يسمح Active Model لمساعدي Action Pack بالتفاعل مع كائنات روبي الصرفة. يساعد Active Model أيضًا على إنشاء قواعد بيانات ORM مخصصة للاستخدام خارج إطار ريلز. بعد قراءة هذا الدليل، ستتعلم: كيف يعمل نموذج Active Record. كيف تعمل ردود النداء وعمليات التحقق. كيف تعمل المُسَلسِلات (serializers). كيف يتكامل Active Model مع إطار تدويل ريلز (i18n). مقدمة Active Model هو مكتبة تحتوي على وحدات مختلفة تستخدم في ...
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"
دعم ...
الدالة delattr() في بايثون
تحذف الدّالة delattr() الخاصيّة المُعطاة من الكائن (إن سمَح الكائن بحذف الخاصيّة). البنية العامة delattr(object, name)
المعاملات object الكائن المرغوب حذف خاصيّةٍ من خاصيّاته. name سلسلة نصيّة تُمثّل اسم الخاصيّة المرغوب حذفها. القيمة المعادة القيمة None كبقيّة الدّوال التي لا تُعيد أي قيمة صراحةً في بايثون. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّها مُشابهة للكلمة المفتاحيّة del التي تحذف الكائنات: >>> class A:
... def __init__(self, a=1, b=2):
... ...
jQuery/Topics a-z
.add() إنشاء كائن jQuery جديد من العناصر المضافة إلى مجموعة من العناصر المطابقة. .addBack() يُضيف هذا التّابع مجموعة العناصر الموجودة سابقًا في المَكْدَس (stack) إلى المجموعة الحاليّة، مع إمكانيّة ترشيحها بشكل اختياري عن طريق مُحدِّد (selector). .addClass() يُضيف هذا التّابع الصّنف أو الأصناف المُحدَّدة لكل عنصر من مجموعة العناصر المُطابقة. .after() يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل بعد كل عنصر من مجموعة العناصر المُطابقة. .ajaxComplete() يُسجِّل هذا التّابع مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال طلبات Ajax. .ajaxError() ...
التابع .on() في jQuery
.on( events [, selector ] [, data ], handler ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر بالعناصر المحدَّدة. .on( events [, selector ] [, data ], handler ) أُضيف مع الإصدار: 1.7. events سلسلة نصية تحتوي على نوع حدث واحد، أو عدَّة أنواع أحداث مفصولة بمسافة فارغة بالإضافة إلى مجالات أسماء (namespaces) (اختياريَّا) مثل "click"، أو "keydown.myPlugin". selector سلسلة نصية تمثِّل اسم المحدِّد الذي يرشِّح أحفاد (descedants) العناصر ...
التابع .not() في jQuery
.not( [selector ] ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع عناصر محدَّدة من مجموعة من العناصر المطابقة. .not( selector ) أُضيف مع الإصدار: 1.0. selector سلسلة نصية تحتوي على تعبير محدِّد، أو عنصر DOM، أو مصفوفة من العناصر لمطابقة مجموعة معينة من العناصر. .not( function ) أُضيف مع الإصدار: 1.4. function دالة من الشكل Function( Number index, Element element ) تعيد قيمة منطقيَّة Boolean، وتُستعمَل للتحقُّق من كلِّ عنصر من عناصر المجموعة. تقبل هذه الدالة ...
التابع .is() في jQuery
.is( selector ) القيمة المعادة يُعيد كائنًا من النوع Boolean. الوصف التحقق من مجموعة العناصر المطابقة الحالية مقابل مُحدَّد أو عنصر أو كائن jQuery وإعادة القيمة true إذا تطابق أحد هذه العناصر على الأقل مع الوسائط المُدخلَة. .is( selector ) أُضيف مع الإصدار: 1.0. selector سلسلة من النوع Selector تحتوي على تعبير مُحدِّد لمطابقة العناصر. .is( function ) أُضيف مع الإصدار: 1.6. function دالة على الشكل Function( Integer index, Element element ) => Boolean، وهي تستخدم كاختبار لكل عنصر في ...
المحددات في jQuery
توفر مكتبة jQuery مجموعة قوية من الأدوات لمطابقة العناصر وتحديدها في الصفحة، إذ استفادت المكتبة من CSS بجميع إصداراتها. من أجل استعمال المحارف الخاصة (مثل !"#$%&'()*+,./:;<=>?@[\]^`{|}~) كجزء صرف من الاسم المراد تحديده، يجب أن تهرب تلك المحارف عبر \\. على سبيل المثال، إن كان اسم العنصر المراد تحديده هو id="foo.bar"، يمكنك تحديده عبر المُحدِّد $("#foo\\.bar"). تحوي مواصفات CSS القياسية (أي W3C CSS specification) مجموعة كاملة من القواعد المتعلقة بالمحددات الصالحة. هنالك أيضًا مقالة مفيدة لصاحبها Mathias Bynens تتحدث عن تهريب ...
أساس jQuery
تشكل التوابع والدوال الموجودة في هذا القسم أساس مكتبة jQuery. .length تعيد هذه الخاصِّيَّة عدد العناصر الموجودة في كائن jQuery. .jquery يُسند إلى هذه الخاصِّية سلسلة نصية تحتوي على رقم إصدار jQuery. jQuery() تعيد هذه الدالة مجموعةً من العناصر المطابقة التي إمَّا وُجدَت في شجرة DOM بناءً على الوسائط المُمرَّرة، أو أنشئت بتمرير سلسلة نصية تحتوي على محتوى HTML. jQuery.contains() يتحقَّق هذا التابع إن كان عنصر DOM معيَّن هو عنصر سليل (ancestor) من عنصر DOM آخر. jQuery.cssHooks() يتعلَّق هذا التابع ...
jQuery/Topics
أساس jQuery تشكل التوابع والدوال الموجودة في هذا القسم أساس مكتبة jQuery. المحددات توفر مكتبة jQuery مجموعة قوية من الأدوات لمطابقة العناصر وتحديدها في الصفحة، إذ استفادت المكتبة من CSS بجميع إصداراتها. التنقل بين العناصر تتيح التوابع في هذا القسم بتحديد عناصر موجودة في موضع محدد والتنقل بينها. تعديل العناصر جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل عنصر (أو مجموعة من العناصر) بأكمله وبذاته مثل الإضافة، أو النسخ، أو الحذف، أو الإزالة ...إلخ. (إن كنت تبحث ...
المحدد :not() في jQuery
المحدد :not() الوصف يختار هذا المحدِّد جميع العناصر التي لا تطابق المحدِّد المعطى. jQuery( ":not(selector)" ) أُضيف مع الإصدار: 1.0. selector المحدِّد المراد منه ترشيح العناصر. يقبل هذا التابع أن يُمرَّر إليه جميع المحدِّدات مثل :not(div a) و :not(div,a). ملاحظات إضافية سينتهي المطاف بالتابع .not() إلى تزويدك بنتائج أكثر قابلية للقراءة عوضًا عن تمرير محدِّدات أو متغيرات معقَّدة إلى مرشِّح المحدِّد :not()، ويكون التابع في أغلب الأحيان هو الخيار الأفضل. أمثلة إيجاد جميع مربعات الاختيار (checkbox) التي لم تُختار، وتمييز ...
خدمات jQuery
توفر التوابع الموجودة في هذا القسم بعض عدة خدمات ووظائف متنوعة. يصعب حصرها في تصنيف أو قسم واحد. jQuery.dequeue() ينفَّذ هذا التابع الدالة التالية الموجودة في طابور الانتظار للعناصر المتطابقة. jQuery.each() هذه الدالة هي دالة تكرار عامة تستعمل لتكرار تنفيذ دالة بسلاسة تامة عبر الكائنات والمصفوفات. عدد مرات تكرار تنفيذ الدالة على المصفوفات والكائنات الشبيهة بالمصفوفات التي لها الخاصِّيَّة length (مثل الكائن الذي يحوي وسائط دالةٍ) تنحصر بالمجال من 0 إلى length-1، إذ length هو عدد العناصر. أمَّا عدد مرات ...
الأحداث في jQuery
تُستخدَم التوابع الموجودة في هذا القسم لتسجيل سلوكيات محدَّدة تحدث عندما وقع حدث معين ناتج عن تفاعل المستخدم مع المتصفح. أضف إلى ذلك وجود توابع تساعد على التعديل والتلاعب بتلك السلوكيات المسجلة مسبقًا. .bind() يُرفِق هذا التّابع مُعالِج أحداث (Event handler) لحدثٍ ما للعناصر. .blur() يربط هذا التّابع مُعالِج أحداث (event handler) إلى حدث الضّبابيّة (blur) في JavaScript، أو يُطلِق هذا الحدث على عنصر ما. .change() يربط هذا التّابع مُعالِج الأحداث (event handler) لتغيير حدث JavaScript أو يُطلِق هذا الحدث ...
التابع Module.attr في روبي
الشكل الأول للتابع 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 في توثيق روبي ...
المكتبة Active Model في ريلز
يوفر Active Model مجموعة معروفة من الواجهات لاستعمالها في أصناف النماذج (model classes). إنها تسمح لمساعدي Action Pack بالتفاعل مع النماذج التي ليست من Active Record مثلًا. يساعد Active Model في بناء روابط ORM مخصصة (تقنية ربط الكائنات بالعلاقات) للاستعمال خارج إطار ريلز. يمكنك قراءة المزيد حول Active Model في دليل أساسيات Active Model. قبل الإصدار 3.0 من ريلز، إن رغبت جوهرة أو رغب مطور بامتلاك كائن يتفاعل مع مساعدي Action Pack، فإنه يتطلب إمَّا نسخ أجزاء من شيفرة ريلز، ...
التابع Module.attr_writer في روبي
ينشئ التابع attr_writer تابع وصول (accessor method) للسماح بتعيين قيمة للخاصية symbol.id2name. تحول الوسائط النصية إلى رموز. البنية العامة attr_writer(symbol, ...) → nil
attr_writer(string, ...) → nil
المعاملات symbol رمز لتحديد الخاصية. string سلسلة نصية لتحديد الخاصية. القيمة المعادة تعاد القيمة nil. انظر أيضا التابع attr: الشكل الأول لهذا التابع مكافئ للتابع attr_reader. أما الشكل الثاني فيكافئ التابع attr_accessor(name). التابع attr_accessor: يحدد خاصية مسماة (named attribute) لهذه الوحدة. التابع attr_reader: ينشئ متغيرات نسخ (instance variables) والتوابع المقابلة التي تعيد قيمة متغيرات النسخ هذه. مصادر قسم التابع ...
التابع Module.attr_reader في روبي
ينشئ التابع attr_reader متغيرات نسخ (instance variables) والتوابع المقابلة التي تعيد قيمة متغيرات النسخ هذه. وهو مكافئ لاستدعاء "attr:name" على كل اسم name بالتتابع. تحول الوسائط النصية إلى رموز. البنية العامة attr_reader(symbol, ...) → nil
attr(symbol, ...)→ nil
attr_reader(string, ...) → nil
attr(string, ...)→ nil
المعاملات symbol رمز يمثل الخاصية. string سلسلة نصية تمثل الخاصية. القيمة المعادة تعاد القيمة nil. انظر أيضا التابع attr: الشكل الأول لهذا التابع مكافئ للتابع attr_reader. أما الشكل الثاني فيكافئ التابع attr_accessor. التابع attr_accessor: يحدد خاصية مسماة (named attribute) لهذه ...
السلسلة في رابط الكائنات بالعلاقات Eloquent
مقدمة عند بناء واجهات JSON APIs، تحتاج معظم الأوقات إلى تحويل نماذجك وعلاقاتها إلى مصفوفات أو كائنات JSON. يزود Eloquent بمجموعة من التوابع المساعدة لهذه التحويلات، إضافةً إلى التحكم بالحقول التي يجب تضمينها في التحويلات. سلسلة النماذج والمجموعات السلسلة لمصفوفات لتحويل نموذج وعلاقاته المحمّلة لمصفوفة، يمكنك استخدام التابع toArray. إن هذا التابع تعاودي، لذلك ستُحوّل كل الحقول وكل العلاقات (وعلاقات العلاقات) إلى مصفوفات: $user = App\User::with('roles')->first();
return $user->toArray();
يمكنك أيضًا تحويل مجموعة كاملة من النماذج إلى مصفوفة: $users = App\User::all();
return $users->toArray();
السلسلة ...
التابع Module.attr_accessor في روبي
يحدد التابع attr_accessor خاصية مسماة (named attribute) لهذه الوحدة، إذ يكون الاسم هو نتيجة التعبير symbol.id2name، وينشئ متغير نسخة (@name) وتابع وصول مقابل له (access method) لقراءته. ينشئ أيضًا تابعًا يُسمى name= لتعيين الخاصية. تحول الوسائط النصية إلى رموز. البنية العامة attr_accessor(symbol, ...) → nil
attr_accessor(string, ...) → nil
المعاملات symbol رمز لتحديد الخاصية. string سلسلة نصية لتحديد الخاصية. القيمة المعادة تعاد القيمة nil. أمثلة مثال على استخدام التابع attr_accessor: module Mod
attr_accessor(:one, :two)
end
Mod.instance_methods.sort #=> [:one, :one=, :two, :two=]
...
الدالة setattr() في بايثون
تُنشئ الدّالة setattr() قيمة لخاصيّة كائن مُعيّن. البنية العامة setattr(object, name, value)
المعاملات object الكائن المُراد تعديل خاصيّة من خاصيّاته أو إضافة خاصّية جديدة إليه إن لم تكن موجودة مُسبقًا. name سلسلة نصيّة تُمثّل اسم الخاصيّة، يُمكن أن تكون الخاصيّة موجودة مُسبقًا (ستُغيّر قيمتها) أو غير موجودة (ما يعني أنّها ستُنشأ). value القيمة المرغوب إسنادها للخاصيّة. القيمة المعادة القيمة None. ملاحظات يجب على الكائن أن يسمح بتعديل خاصيّاته. الاستدعاء setattr(x, 'foobar', 123) مُكافئ للجملة x.foobar = 123. أمثلة المثال التّالي ...
تنقيح تطبيقات ريلز
يقدّم هذا الدليل التقنيات اللازمة لتنقيح تطبيقات ريلز. بعد قراءة هذا الدليل، ستتعلّم: الغرض من التنقيح. كيفة تتبّع العلل والأخطاء التي لا تتعرّف عليها الاختبارات في تطبيقك. طرقًا مختلفة للتنقيح. كيفيّة تحليل أثر المكدس. مساعدي العرض للتنقيح احدى المهام الشائعة في التنقيح هي فحص محتويات متغيّر معيّن، لذا يوفر ريلز ثلاثة طرائق لفعل ذلك: Debug To_yaml Inspect debug سيعيد المساعد debug الوسم <pre> الذي يصدّر الكائن باستخدام تنسيق YAML، وسيؤدي هذا إلى توليد بيانات يمكن للإنسان قراءتها من أي كائن. ...
ارتباطات Active Record في ريلز
يغطي هذا الدليل مزايا الارتباطات Active Record. بعد قراءة هذا الدليل، ستتعلم: كيفية التصريح عن الارتباطات بين نماذج Active Record. الأنواع المختلفة للارتباطات في Active Record. كيفية استعمال التوابع المضافة إلى نماذجك عبر إنشاء الارتباطات. لمَ نستخدم الارتباطات؟ في ريلز، يعدّ الارتباط اتصالًا بين نموذجين من Active Record. لمَ نحتاج إلى الارتباطات بين النماذج؟ لأنها تجعل العمليات الشائعة سهلة وبسيطة في تطبيقك. مثلًا، لنفرض أن لدينا تطبيق ريلز بسيط يحوي نموذجًا للكتّاب ونموذجًا للكتب؛ كل كاتب يملك العديد من الكتب. ...
الدالة frozenset() في بايثون
تعيد الدّالة frozenset() كائنًا جديدًا من النّوع frozenset مع عناصر مأخوذة من الكائن القابل للتكرار الذي يُمرّر إليها اختياريًّا. انظر الصّنف frozenset للمزيد من المعلومات حول كيفيّة استعماله. القيمة المُعادة تكون مجموعة جامدةً غير قابلة للتّغيير، أي عكس المجموعات في بايثون، فالمجموعات الجامدة لا تقبل تعديل مُحتوياتها إمّا إضافةً أو حذفًا أو غير ذلك. البنية العامة frozenset([iterable])
المعاملات iterable مُعامل اختياريّ. وهو كائن قابل للتّكرار لإنشاء مجموعة جامدة من عناصره. القيمة المعادة مجموعة جامدة تحتوي على العناصر الفريدة الموجودة في ...
JSX في TypeScript
مقدمة JSX بنيةٌ (syntax) مشابهةٌ للغة XML يُمكن تضمينها وتحويلها إلى شيفرة JavaScript صالحة، لكن آلية عملية التحويل تختلف من تطبيق (implementation) إلى آخر. اشتهرت JSX باستخدامها مع مكتبة React، لكنها تملك تطبيقات أخرى غير React. تدعم لغة TypeScript تضمين JSX، وتدقيق الأنواع فيها، وكذا ترجمة JSX إلى JavaScript مباشرةً. ملاحظة حول المصطلحات: نستخدم في هذه الصّفحة كلمة "صِفَة" للإشارة إلى الكلمة الإنجليزيّة "attribute" وكلمة "خاصيّة" للإشارة إلى كلمة "property"، كلاهما يُترجَم إلى كلمة "خاصيّة" ولهما نفس المعنى في معظم ...
التابع jQuery.noConflict() في jQuery
jQuery.noConflict( [removeAll ] ) القيم المعادة يعيد كائنًا من النوع Object. الوصف يجبر هذا التابع jQuery على التنازل عن التحكم بالمتغيِّر $. jQuery.noConflict( [removeAll ] ) أُضيف مع الإصدار: 1.0. removeAll قيمةٌ منطقيَّةٌ تحدِّد إن كان يراد إزالة جميع متغيرات jQuery من النطاق العام (global scope) بما فيها jQuery نفسها. تستعمل أغلب مكتبات JavaScript المعامل $ بوصفه دالةً أو اسم متغيِّر مثلما تفعل jQuery تمامًا. ففي حالة مكتبة jQuery، يُعدُّ $ اسمًا بديلًا للعبارة jQuery، لذا تكون جميع الوظائف متاحة ...
التابع jQuery.noConflict() في jQuery
jQuery.noConflict( [removeAll ] ) القيم المعادة يعيد كائنًا من النوع Object. الوصف يجبر هذا التابع jQuery على التنازل عن التحكم بالمتغيِّر $. jQuery.noConflict( [removeAll ] ) أُضيف مع الإصدار: 1.0. removeAll قيمةٌ منطقيَّةٌ تحدِّد إن كان يراد إزالة جميع متغيرات jQuery من النطاق العام (global scope) بما فيها jQuery نفسها. تستعمل أغلب مكتبات JavaScript المعامل $ بوصفه دالةً أو اسم متغيِّر مثلما تفعل jQuery تمامًا. ففي حالة مكتبة jQuery، يُعدُّ $ اسمًا بديلًا للعبارة jQuery، لذا تكون جميع الوظائف متاحة ...
الخاصية .jquery في jQuery
الخاصية .jquery القيم المعادة تعيد سلسلة نصية من النوع String. الوصف يُسند إلى هذه الخاصِّية سلسلة نصية تحتوي على رقم إصدار jQuery. jquery أُضيف مع الإصدار: 1.0. الخاصِّيَّة .jquery هي سلسلة نصية تحتوي على رقم إصدار jQuery مثل "1.5.0" أو "1.4.4"، وتُسند إلى نموذج jQuery الأولي، ويشار إليها عادةً عبر الاسم البديل $.fn. أمثلة تحديد إن كان كائنٌ ما هو كائن jQuery: $(function() {
// أصبحت الصفحة جاهزة
});
استعمال اختصار للشكل $(document).ready() ووسيط لكتابة شيفرة الفشل الآمن (failsafe) في jQuery ...
التابع jQuery.sub() في jQuery
jQuery.sub( ) أهمل مع الإصدار: 1.7. حذف مع الإصدار: 1.9. القيم المعادة يعيد كائنًا من النوع jQuery. الوصف ينشئ هذا التابع نسخةً جديدةً من jQuery للتمكن من تعديل خاصِّيَّاتها وتوابعها دون المساس بالمكتبة الأصليَّة. jQuery.sub( ) أُضيفت مع الإصدار: 1.5. لا يقبل هذا التابع أية وسائط. أهمل هذا التابع بدءًا من الإصدار jQuery 1.7 وسيُنقل إلى إضافةٍ في الإصدار jQuery 1.8. هنالك حالتان خاصَّتان أنشئ التابع jQuery.sub() من أجلهما. الحالة الأولى هي من أجل توفير طريقة للتحكم بتوابع jQuery دون ...
التابع jQuery.sub() في jQuery
jQuery.sub( ) أهمل مع الإصدار: 1.7. حذف مع الإصدار: 1.9. القيم المعادة يعيد كائنًا من النوع jQuery. الوصف ينشئ هذا التابع نسخةً جديدةً من jQuery للتمكن من تعديل خاصِّيَّاتها وتوابعها دون المساس بالمكتبة الأصليَّة. jQuery.sub( ) أُضيفت مع الإصدار: 1.5. لا يقبل هذا التابع أية وسائط. أهمل هذا التابع بدءًا من الإصدار jQuery 1.7 وسيُنقل إلى إضافةٍ في الإصدار jQuery 1.8. هنالك حالتان خاصَّتان أنشئ التابع jQuery.sub() من أجلهما. الحالة الأولى هي من أجل توفير طريقة للتحكم بتوابع jQuery دون ...
التابع $.ajaxPrefilter() في jQuery
jQuery.ajaxPrefilter( [dataTypes ], handler ) القيم المعادة يعيد قيمةً غير مُعرَّفة (undefined). الوصف يعالج هذا التابع إعدادات Ajax المخصَّصة أو يعدِّل إعدادات موجودة قبل أن يرسل كل طلب وقبل أن يعالج باستعمال الدالة $.ajax(). jQuery.ajaxPrefilter( [dataTypes ], handler ) أُضيف مع الإصدار: 1.5. dataTypes سلسلة نصية اختياريَّة تحتوي على نوع بيانات (dataType) واحد أو عدَّة أنواع مفصولة بفراغ. handler دالة من الشكل Function( Object options, Object originalOptions, jqXHR jqXHR ) وتستعمل لتعيين قيم افتراضيَّة لطلبات Ajax المستقبليَّة. تبدو عملية الترشيح ...
الخاصية event.stopPropagation() في jQuery
event.stopPropagation() القيمة المعادة تُعيد هذه الخاصية القيمة undefined. الوصف تمنع هذه الخاصية الحدث من الانتقال عبر شجرة DOM إلى العناصر الأب (event bubbling)، مما يمنع إبلاغ أي من المعالجات الأب عن الحدث. event.stopPropagation() أُضيف مع الإصدار: 1.0. لا تقبل هذه الخاصية أي وسائط. تستخدم الخاصية event.isPropagationStopped() للحقق من استدعاء هذا التابع (على كائن الحدث هذا). تعمل هذه الخاصية مع الأحداث المخصصة المُطلَقة بواسطة التابع trigger() أيضًا. لاحظ أن هذه الخاصية لن تمنع المعالجات الأخرى من العمل على نفس العنصر. ملاحظات ...
المحدد :submit في jQuery
المحدد submit: الوصف يحدِّد جميع عناصر الإدخال ذات النوع submit. jQuery( ":submit" ) أضيف مع الإصدار 1.0. يُستعمَل المحدِّد :submit عادةً مع العناصر <input> أو <button>. انتبه إلى أنَّ بعض المتصفحات تعامل العنصر <button> على أنَّها من النوع submit ضمنيًّا بينما لا تفعل متصفحات أخرى ذلك (مثل المتصفح Internet Explorer). إن أردت التأكد من عمل الشيفرة عبر جميع المتصفحات، وضمان تحديد العناصر <button> التي سترسل النموذج بشكل صحيح، فاستعمل الخاصِّيَّة type دومًا وحدِّد قيمتها. ملاحظات إضافية لمَّا كان المحدِّد :submit ...
الخاصية event.result في jQuery
event.result القيمة المعادة تُعيد كائنًا من النوع Object. الوصف تعيد هذه الخاصية القيمة الأخيرة المُعادة بواسطة معالج الأحداث الذي أطلقه هذا الحدث، ما لم تكن هذه القيمة غير معرفة undefined. event.result أُضيف مع الإصدار: 1.3. يمكن أن تكون هذه الخاصية مفيدة للحصول على القيم المُعادة السابقة للأحداث المخصصة. أمثلة عرض قيمة معالج الحدث المُعادة السابقة: <!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>event.result مثال على الخاصية</title>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<button>عرض event.result</button>
<p></p>
<script>
$( "button" ).click(function( event ) {
return "مرحبًا";
});
$( ...
الدالة jQuery.getJSON() في jQuery
jQuery.getJSON( url [, data ] [, success ] ) القيم المعادة تعيد كائنًا من النوع jqXHR. الوصف تجلب هذه الدالة بياناتٍ مرمَّزة بصيغة JSON من الخادم باستعمال طلب HTTP عبر الطريقة GET. jQuery.get( url [, data ] [, success ] ) أُضيفت مع الإصدار: 1.0. url سلسلة نصية تحتوي على الرابط URL الذي سيُرسَل الطلب إليه. data كائنٌ مجرَّد أو سلسلة نصية تُرسَل إلى الخادم مع الطلب. success دالةٌ من الشكل Function( Object data, String textStatus, jqXHR jqXHR ) يراد ...
التابع deferred.done() في jQuery
deferred.done( doneCallbacks [, doneCallbacks ] ) القيمة المعادة تُعيد كائنًا من النوع Deferred. الوصف يُضيف هذا التابع مُعالجات تستدعى عند قبول الكائن المؤجل Deferred. deferred.done( doneCallbacks [, doneCallbacks ] ) أُضيف مع الإصدار: 1.5. doneCallbacks هو دالة، أو مصفوفة دوال، تُستدعى عند قبول الكائن المؤجل Deferred، وهو دالة Function(). doneCallbacks هو دالة اختيارية إضافية، أو مصفوفة دوال، تُستدعى عند قبول الكائن المؤجل Deferred، وهو دالة Function(). يقبل التابع deferred.done() وسيطًا واحدًا أو أكثر، وكلها يمكن أن تكون إما دالة مفردة ...
التابع .eq() في jQuery
.eq( index ) القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف تقليص مجموعة العناصر المتطابقة إلى تلك الموجودة في الفهرس المُحدَد. .eq( index ) أُضيف مع الإصدار: 1.1.2. index عدد صحيح يشير إلى الموضع الصفري للعنصر، وهو من النوع Number. .eq( indexFromEnd ) أُضيف مع الإصدار: 1.4. indexFromEnd عدد صحيح يشير إلى موضع العنصر، مع العد تنازليا من العنصر الأخير في المجموعة، وهو من النوع Number. إذا كان لدينا كائن jQuery يمثل مجموعة من عناصر DOM، فسينشئ التابع .eq() كائن jQuery ...
التابع .last() في jQuery
.last() القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يزيل هذا التابع جميع العناصر المتطابقة من المجموعة باستثناء العنصر الأخير. .last() أُضيف مع الإصدار: 1.4. لا يقبل هذا التابع أي معاملات. إن أعطي للتابع .last() كائن jQuery يمثل مجموعةً من عناصر DOM، فسيبني كائن jQuery جديد من العنصر الأخير في تلك المجموعة. افترض أنه لدينا صفحة تحتوي على قائمة بسيطة مثل: <ul>
<li>عنصر القائمة الأول</li>
<li>عنصر القائمة الثاني</li>
<li>عنصر القائمة الثالث</li>
<li>عنصر القائمة الرابع</li>
<li>عنصر ...
التعامل مع CSS في jQuery
تعمل التوابع الموجودة في هذا القسم على جلب وضبط قيم خاصيات CSS لعنصر محدَّد (أو مجموعة عناصر محدَّدة). .height() يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة أو يغير الطول لكل العناصر المتطابقة. .innerHeight() يعيد هذا التابع قيمة الطول الحالي (تتضمن قيمة الحواشي فقط دون الإطار) لأول عنصر في مجموعة العناصر المطابقة أو يغير الطول الداخلي لكل العناصر المطابقة. .innerWidth() يعيد هذا التابع قيمة العرض الحالي (تدخل قيمة الحواشي ضمنها فقط) لأول عنصر من مجموعة العناصر المطابقة ...
التابع 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.fx.off() في jQuery
jQuery.fx.off القيم المعادة قيمتهما هي قيمة منطقية (Boolean). الوصف تعمل هذه الخاصِّيَّة على تعطيل جميع الحركات على الصعيد العام. jQuery.fx.off أُضيفت مع الإصدار: 1.3. عند تغيير قيمة هذه الخاصِّيَّة إلى القيمة true، ستَنقل جميع التوابع الحركيَّة العناصر إلى حالتها النهائية مباشرةً عند استدعائها دون إظهار أي تأثيرات أو تطبيق أية حركات على العنصر. يُرغب باستعمال هذه الخاصِّيَّة لسببين هما: تعمل jQuery على جهازٍ ذي مواصفات منخفضة. يواجه المستخدمون مشكلاتٍ في إمكانيَّة الوصول مع الحركات. يمكن إيقاف هذا السلوك وتشغيل الحركات ...
التابع .one() في jQuery
.one( events [, data ], handler ) القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر بالعناصر المحدَّدة. يُنفَّذ معالج الحدث مرةً واحدةً لكل عنصر ولكل نوع من الأحداث المرتبطة. .one( events [, data ], handler ) أُضيف مع الإصدار: 1.1. events سلسلة نصية تحتوي على نوع حدث واحد أو عدَّة أنواع من أحداث JavaScript مثل "click" أو "submit,". data كائن مجرَّد (Object) يحتوي على البيانات التي ستُمرَّر إلى مُعالِج الحدث ...
التابع deferred.promise() في jQuery
deferred.promise( [target ] ) القيمة المعادة يُعيد كائنًا من النوع Promise. الوصف يُعيد هذا التابع كائن Promise للكائن المؤجل Deferred. deferred.promise( [target ] ) أُضيف مع الإصدار: 1.5. target الكائن الذي يجب إرفاق تابع promise به وهو من النوع Object. يسمح التابع deferred.promise() لدالة غير متزامنة بمنع الشيفرات البرمجية الأخرى من التدخل في تقدم أو حالة الطلب الداخلي الخاص به. ويعرض التابع promise فقط التوابع المؤجلة اللازمة لإرفاق معالجات إضافية أو تحديد الحالة (then و done و fail و always ...
التابع jQuery.error() في jQuery
jQuery.error( message ) الوصف يأخذ هذا التابع قيمةً ثمَّ يرمي استثناءً يحتوي على هذه القيمة. jQuery.error( message ) أُضيف مع الإصدار: 1.4.1. message رسالة الخطأ المراد إرسالها. أكثر من يستعمل هذا التابع هم المطورون في إضافاتهم (plugin) الذين يريدون توفير وإظهار معلومات أوسع حول رسائل الخطأ. أمثلة تجاهل الخطأ jQuery.error وإظهاره في سجل المتصفح: jQuery.error = console.error;
مصادر صفحة التابع ()jQuery.error في توثيق jQuery الرسمي.
التابع deferred.resolve() في jQuery
deferred.resolve( [args ] ) القيمة المعادة يُعيد كائنًا من النوع Deferred. الوصف قبول كائن مؤجل واستدعاء أي doneCallbacks مع الوسائط args المُحدَدة. deferred.resolve( [args ] ) أُضيف مع الإصدار: 1.5. args الوسائط الاختيارية التي تُمرر إلى دوال doneCallbacks، ويمكن أن يكون من أي نوع من أنواع JavaScript. عادة، يجب أن يستدعي هذا التابع فقط منشئ الكائن المؤجل Deferred؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير حالة الكائن المؤجل بإعادة كائن Promise كسلسلة (chain) من خلال التابع deferred.promise(). عند قبول الكائن ...