عرض مصدر jQuery/jQuery/ready

<noinclude>{{DISPLAYTITLE:الخاصية <code>‎‎jQuery.ready‎</code>‎ في jQuery}}</noinclude>
= <code>jQuery.ready</code> =

=== القيم المعادة ===
قيمة هذا الخاصية هي من النوع Thenable.

=== الوصف ===
هذه الخاصية هي كائنٌ شبيه بالكائن [[jQuery/promise|Pormise]] (يدعى Thenable) التي تستبين عن اللحظة الزمنيَّة التي يصبح فيها المستند جاهزًا.

=== <code>jQuery.ready</code> ===
أُضيف مع الإصدار: 1.8.

بدءًا من الإصدار jQuery 3.0، أصبح بالإمكان استعمال الكائن الذي يعيده هذا التابع مع التابع <code>[[jQuery/jQuery/when|jQuery.when()‎]]</code> والتابع <code>[[jQuery/jQuery/resolve|jQuery.resolve()‎]]</code> الأساسي. لا يجب أن تبني الشيفرة أيَّة افتراضات تتعلق فيما إذا كان هذا الكائن هو jQuery.Deferred، أو Promise، أو أي نوع آخر من أنواع الكائن Promise.

انظر أيضًا توثيق التابع <code>[[jQuery/ready|ready()‎.]]</code> فهو مفيد.

=== أمثلة ===
مراقبة جهوزية الصفحة عبر استعمال <code>[[jQeruy/jQuery/when|jQuery.when()‎]]</code>:<syntaxhighlight lang="javascript">
$.when( $.ready ).then(function() {
 // أصبحت الصفحة جاهزة
});

</syntaxhighlight>استعمال اعتيادي آخر للتابع <code>jQuery.when()</code>‎:<syntaxhighlight lang="javascript">
$.when(
  $.getJSON( "ajax/test.json" ),
  $.ready
).done(function( data ) {
  // أصبح المستند جاهزًا
  // `data` كبيانات test.json تمرَّر قيمة
});
مصادر

</syntaxhighlight>

== مصادر ==
* [http://api.jquery.com/jQuery.ready/ صفحة الخاصية jQuery.ready في توثيق jQuery الرسمي.]
[[تصنيف:jQuery]]
[[تصنيف:jQuery Core]]
[[تصنيف:jQuery Events]]
[[تصنيف:jQuery Properties]]