نتائج البحث

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

الصنف ‎:disabled

الصنف الزائف ‎:disabled في CSS (أي pseudo-class) يُمثِّل أي عنصر مُعطَّل، ولا يمكن اختيار أو النقر على العنصر المعطَّل ولا الكتابة فيه، ولا يقبل التركيز (focus)، ويمكن أن يكون العنصر مُفعَّلًا (enabled) أي يمكن اختياره أو النقر عليه أو الكتابة فيه. input:disabled { background: #ccc; } الشكل العام لهذا المحدد: :disabled أمثلة هذا المثال يستعرض نموذجًا بسيطًا لشحن المشتريات، ويستخدم الحدث change في JavaScript للسماح للمستخدم بتفعيل أو تعطيل بعض حقول النموذج: <form action="#"> <fieldset id="shipping"> <legend>عنوان ...

Number.isNaN()‎

الدالة Number.isNaN()‎ تُحدِّد إذا كانت القيمة المُمرَّرة إليها هي NaN ومن النوع Number. وهذه الدالة هي نسخة أفضل من الدالة الأصلية العامة isNaN()‎. البنية العامة Number.isNaN(value) value القيمة التي ستُختبَر إن كانت NaN. القيمة المعادة قيمة منطقية Boolean تُشير إذا كانت القيمة هي NaN ومن النوع Number (وهي true) أم لا (وهي false). الوصف لمّا كانت نتيجة استخدام معاملي المقارنة == و === هي false عند مقارنة قيم NaN مع NaN، فأصبح من الضروري وجود الدالة Number.isNaN()‎، فحالة المقارنة السابقة ...

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

jQuery.inArray( value, array [, fromIndex ] )‎ القيم المعادة يعيد عددًا (Number). الوصف يبحث هذا التابع عن قيمة محدَّدة ضمن مصفوفةٍ ثمَّ يعيد قيمة فهرس موضعها (أو القيمة ‎-1 إن لم يجدها). jQuery.inArray( value, array [, fromIndex ] )‎ أُضيف مع الإصدار: 1.2. value أي شيء، ويمثل القيمة المراد البحث عنها. array المصفوفة المراد البحث ضمن عناصرها. fromIndex عددٌ (Number) يمثل قيمة فهرس أحد عناصر المصفوفة الذي يراد بدء عملية البحث عنده. القيمة الافتراضيَّة هي 0 أي البحث ضمن جميع ...

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

jQuery.inArray( value, array [, fromIndex ] )‎ القيم المعادة يعيد عددًا (Number). الوصف يبحث هذا التابع عن قيمة محدَّدة ضمن مصفوفةٍ ثمَّ يعيد قيمة فهرس موضعها (أو القيمة ‎-1 إن لم يجدها). jQuery.inArray( value, array [, fromIndex ] )‎ أُضيف مع الإصدار: 1.2. value أي شيء، ويمثل القيمة المراد البحث عنها. array المصفوفة المراد البحث ضمن عناصرها. fromIndex عددٌ (Number) يمثل قيمة فهرس أحد عناصر المصفوفة الذي يراد بدء عملية البحث عنده. القيمة الافتراضيَّة هي 0 أي البحث ضمن جميع ...

HTML/Topics/Scripting

لإنشاء محتوى تفاعلي في تطبيقات الويب، فتدعم HTML استخدام لغات السكربتات، وخصوصًا JavaScript، وهنالك عدِّة عناصر متوافرة لدعم هذه الإمكانية. العنصر الوصف <canvas> استخدم العنصر <canvas> مع الواجهة البرمجية الخاصة به لترسم الرسومات وتحركها. <noscript> يُعرِّف العنصر <noscript> قسمًا من شيفرات HTML التي ستُضاف إلى الصفحة إذا لم يكن العنصر <script> مدعومًا في المتصفح أو كان استخدام شيفرات JavaScript معطلًا من قِبل المستخدم. <script> تضمين أو الإشارة إلى سكربت قابل للتنفيذ.

العنصر

استخدم العنصر <canvas> مع الواجهة البرمجية الخاصة به لترسم الرسومات وتحركها. المثال الآتي سيُضيف عنصر <canvas> إلى مستند HTML، مع تحديد ارتفاعه عبر الخاصية height وعرضه عبر الخاصية width، وسنوفِّر نصًا بديلًا إن لم يكن المتصفح قادرًا على عرض العنصر، فمن المفيد توفير محتوى بديل لزيادة قابلية الوصول لمحتوى العنصر. <canvas id="canvas" width="300" height="300"> نص بديل يصف ماذا يظهر العنصر <code>canvas</code>. </canvas> وبفرض أننا سنرسم مستطيلًا بأبعاد 80×80 باللون الأحمر، فستكون شيفرة JavaScript كالآتي: <script> var canvas = document.getElementById("canvas"); ...

Document.getSelection()‎

تنبيه: هذه تقنيّة تجريبيّة، انظر جدول دعم المتصفّحات قبل استخدام هذا التّابع في شيفرة إنتاجيّة. يعيد التّابع Document.getSelection‎()‎ كائنًا من النّوع Selection يمثّل مجال النّص المظلَّل من طرف المستخدم، أو موقع علامة الإقحام (caret) حاليًّا. البنية العامة var selection = documentOrShadowRootInstance.getSelection() المعاملات لا توجد مُعاملات. القيمة المعادة كائن من النّوع Selection. مثال function foo() { var selObj = document.getSelection(); alert(selObj); var selRange = selObj.getRangeAt(0); // نفّذ عمليّة ...

وحدة الخيوط العاملة (Worker Threads) في Node.js

مؤشر الاستقرار: 1 - تجريبي توفر وحدة worker طريقة لإنشاء بيئات متعددة تعمل علي خيوط مستقلة، ولإنشاء قنوات رسائل بينها. ويمكن الوصول إليها باستخدام الراية ‎--experimental-worker flag بالإضافة إلى: const worker = require('worker_threads'); وتفيد الخيوط العاملة (Workers) في أداء عمليات JavaScript كثيفة الاستخدام لوحدة المعالجة المركزية؛ ويجب ألَّا تستخدم في عمليات الإدخال والإخراج I/O، إذ تتعامل آلياتُ Node.js المدمجة لتنفيذ العمليات بشكل غير متزامن معها بشكل أكثر كفاءة من خيوط Worker. علي عكس العمليات التابعة أو عند استخدام وحدة cluster، يمكن ...

Rails/Topics

ابدأ من هنا البدء مع ريلز يغطي هذا الدليل بدء وتشغيل ريلز. بعد قراءة هذا الدليل، ستتعلم: كيف تثبّت ريلز وتُنشئ تطبيق ريلز جديد وتربط تطبيق ريلز بقاعدة بيانات، وما هو التخطيط العام لتطبيق ريلز، والمبادئ الأساسية للنمط MVC والتصميم RESTful، وكيف تولد سريعًا أجزاء البداية لتطبيق ريلز. المكتبات الأساسية Action Cable تعمل المكتبة Action Cable على دمج WebSockets مع بقية تطبيق ريلز الخاص بك بسهولة، إذ تسمح بكتابة الميزات ذات الوقت الحقيقي (real-time features) المنشودة في روبي وفي نفس ...

محدد العناصر "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; ...

JSON.stringify()‎

الدالة JSON.stringify()‎ تحوِّل قيمةً في JavaScript إلى سلسلة نصية بصيغة JSON، وتستطيع -اختياريًّا- استبدال القيم إذا حُدِّدَت دالة استبدال (replacer)، أو تضمين خاصيات مُعيّنة إذا حُدِّدة مصفوفة استبدال (replacer). البنية العامة JSON.stringify(value[, replacer[, space]]) value القيمة التي نريد تحويلها إلى صيغة JSON. replacer الدالة التي ستُغيّر من سلوك عملية التحويل، أو مصفوفة من كائنات String و Number التي تعمل كقائمة بالخاصيات المسموحُ تضمينها في الكائن؛ إذا كانت هذه القيمة null أو لم تضبَط فستضمَّن جميع الخاصيات. space كائن من النوع ...

Object.setPrototypeOf()‎

الدالة Object.setPrototypeOf()‎ تضبط كائن prototype (أي الخاصية [[Prototype]] الداخلية) للكائن المُحدَّد إلى كائنٍ آخر أو إلى القيمة null. تحذير: تغيير خاصية [[Prototype]] لأحد الكائنات هي عمليةٌ بطيئةٌ جدًا بسبب طبيعة تحسين محركات JavaScript الأداء للوصول إلى الخاصيات، وهي بطيئةٌ في جميع المتصفحات ومحركات JavaScript، وتأثيرها على الأداء بسبب تعديل طريقة وراثة الكائنات كبيرٌ وذو مدى بعيد، وليس مقتصرًا على الوقت اللازم لتنفيذ الدالة Object.setPrototypeOf()‎ فقط، لكنه سيمتد لأيّة شيفرات ستصل إلى أيّة كائنات تغيّرت فيها قيمة الخاصية [[Prototype]]؛ لذا إذا ...

التخزين المؤقت (Cache) في Laravel

الضبط يوفر Laravel واجهة برمجيّة معبّرة وموحّدة لكل التخزين المؤقت. يوجد ملف ضبط التخزين في config/cache.php. في هذا الملف، يمكن تحديد مشغّل التخزين الذي سيُستعمل تلقائيًّا في كامل التطبيق. يدعم Laravel العديد من الواجهات الخلفيّة الشائعة مثل Memcached و Redis من البداية. يحتوي ملف ضبط التخزين أيضًا على خيارات متعدّدة مفصّلة في الملف ذاته لذا تأكد من قراءته جيدا. تلقائيًّا، يستعمل Laravel برنامج التشغيل file للتخزبن المؤقت، يسجل هذا المشغل الكائنات المخزّنة بطريقة متسلسلة في نظام الملفات. بالنسبة للتطبيقات الكبيرة، ...

اختبارات التوكيد‎ في Node.js

الاستقرار: 2-مستقر توفِّر الوحدة assert مجموعةً من اختبارات التوكيد البسيطة التي يمكن استعمالها للتأكد من الثوابت (invariants). يوجد وضعي توكيد هما: الوضع الصارم (strict mode)، والوضع الإرثي (legacy mode)؛ وينصح باستعمال الوضع الصارم فقط. للمزيد من المعلومات حول موازنات التساوي المستعملة، ارجع إلى دليل MDN حول موازنات التساوي والتشابه. الصنف assert.AssertionError أضيف في الإصدار v0.1.21. يتفرَّع هذا الصنف الفرعي من الصنف Error الذي يشير إلى فشل عمليَّة التوكيد. جميع الأخطاء التي ترميها الوحدة assert هي نسخةٌ من الصنف AssertError. new ...

Python/stat

يُعرّف الصنف stat ثوابت وتوابع لمعالجة نتيجة استدعاء التوابع os.stat()‎وos.fstat‎‎()‎  وos.lstat()‎ وكذلك بطبيعة الحال فهو يعالج نتائج التابع Path.stat‎()‎، ولا يتم إنشاء كائنات منه، فجميع التوابع والثوابت يمكن الوصول إليها مباشرة من الصنف. توابع الصنف stat لكشف نوع الملفات التابع stat.S_ISDIR للكشف عن كون النمط مشيرًا إلى مجلد. التابع stat.S_ISCHR للكشف عن كون النمط مشيرًا إلى ملف character special device. التابع stat.S_ISBLK للكشف عن كون النمط مشيرًا إلى ملف block special device. التابع stat.S_ISREG للكشف عن كون النمط مشيرًا إلى ...

دمج التصريحات في TypeScript

مقدمة تصِف بعض المبادئ الفريدة الموجودة في لغة TypeScript شكل كائنات JavaScript على مستوى الأنواع. مبدأ دمج التصريحات (declaration merging) من المزايا التي تنفرد بها TypeScript. سيُساعد فهم هذا المبدأ على العمل مع شيفرة JavaScript الموجودة مسبقًا. إضافة إلى أنّها توفّر قدرة على إعمال مبادئ تجريد (abstraction concepts) أكثر تقدّمًا. نعني بدمج التصريحات في هذه الصفحة بأنّ المترجم يدمج تصريحين مختلفين لهما نفس الاسم في تعريف واحد. يمتلك هذا التعريف المندمج مزايا التصريحين الأصليّين. يُمكن دمج أي عدد من التصريحات، ...

Document.querySelectorAll()‎

يُعيد التّابع Document.querySelectorAll()‎ كائنًا ثابتًا (غير حيّ) من النّوع NodeList الذي يُمثّل قائمة عناصر المستند التي تُوافق المُحدّدات المعطاة. مُلاحظة: هذا التّابع مبني على التّابع ParentNode.querySelectorAll()‎. البنية العامة elementList = parentNode.querySelectorAll(selectors); selectors‎ سلسلة نصيّة من النّوع DOMString تحتوي على مُحدّد واحدٍ أو أكثر لمُوافقته مع عناصر المستند والبحث عن العنصر المرغوب. يجب على هذه السّلسلة النّصيّة أن تكون مُحدّد CSS صالح، إن لم يكن كذلك، فسيُرمى استثناء SyntaxError، انظر هذه الصّفحة للمزيد حول المُحدّدات وكيفيّة إدارتها. يُمكن تحديد عدّة محدّدات ...

Document.URL

خاصيّة document.URL قابلة للقراءة فقط تُعيد مكان المُستند (أي عنوان URL) في سلسلةٍ نصيّة. البنية العامة var string = document.URL مثال في الجزء الخاصّ بلغة JavaScript، نضع: document.getElementById("url").textContent = document.URL; جزء HTML: <p id="urlText"> URL:<br/> <span id="url">مكان المُستند سيظهرُ هنا</span> </p> دعم المتصفحات الميزة Chrome Internet Explorer Firefox Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مواصفة HTML Living Standard حدّدت هذه المُواصفة أنّ الخاصيّة سلسلة نصيّة من النّوع USVString عوضا عن DOMString. مواصفة Document Object ...

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

jQuery.holdReady( hold )‎ القيم المعادة يعيد القيمة undefined. الوصف يعلِّق هذا التابع تنفيذ الحدث ready في jQuery أو يحرِّره إن كان معلَّقًا. jQuery.holdReady( hold )‎ أُضيفت مع الإصدار: 1.6. hold قيمةٌ منطقيَّةٌ (Boolean) تحدِّد إن كان يراد تعليق تنفيذ الحدث ready أم إطلاقه للعمل بعد أن كان معلقًا. يعمل التابع ‎$.holdReady()‎ على تأجيل تنفيذ استدعاء الحدث ready. سيستخدم هذه الميِّزة المتطورة عادةً محمِّلات السكربت الديناميكيَّة (dynamic script loaders) التي تريد تحميل شيفرة JavaScript إضافيَّة -مثل إضافات jQuery- قبل السماح للحدث ...

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

jQuery.holdReady( hold )‎ القيم المعادة يعيد القيمة undefined. الوصف يعلِّق هذا التابع تنفيذ الحدث ready في jQuery أو يحرِّره إن كان معلَّقًا. jQuery.holdReady( hold )‎ أُضيفت مع الإصدار: 1.6. hold قيمةٌ منطقيَّةٌ (Boolean) تحدِّد إن كان يراد تعليق تنفيذ الحدث ready أم إطلاقه للعمل بعد أن كان معلقًا. يعمل التابع ‎$.holdReady()‎ على تأجيل تنفيذ استدعاء الحدث ready. سيستخدم هذه الميِّزة المتطورة عادةً محمِّلات السكربت الديناميكيَّة (dynamic script loaders) التي تريد تحميل شيفرة JavaScript إضافيَّة -مثل إضافات jQuery- قبل السماح للحدث ...

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

jQuery.ajaxTransport( dataType, handler )‎ القيم المعادة يعيد قيمةً من النوع undefined. الوصف ينشئ هذا التابع كائنًا يعالج عملية الإرسال الفعلي لبيانات Ajax. jQuery.ajaxTransport( dataType, handler )‎ أُضيف مع الإصدار: 1.5. dataTypes سلسلة نصية تحدِّد نوع البيانات المراد استعمال هذا التابع معها. handler دالةٌ من الشكل Function( Object options, Object originalOptions, jqXHR jqXHR )‎ تعيد الكائن transport الجديد لاستعماله مع نوع البيانات المحدَّد في الوسيط الأول. الكائن transport هو كائنٌ يوفر تابعين اثنين هما: التابع send، والتابع abort اللذان تستعملهما الدالة ...

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

jQuery.ajaxTransport( dataType, handler )‎ القيم المعادة يعيد قيمةً من النوع undefined. الوصف ينشئ هذا التابع كائنًا يعالج عملية الإرسال الفعلي لبيانات Ajax. jQuery.ajaxTransport( dataType, handler )‎ أُضيف مع الإصدار: 1.5. dataTypes سلسلة نصية تحدِّد نوع البيانات المراد استعمال هذا التابع معها. handler دالةٌ من الشكل Function( Object options, Object originalOptions, jqXHR jqXHR )‎ تعيد الكائن transport الجديد لاستعماله مع نوع البيانات المحدَّد في الوسيط الأول. الكائن transport هو كائنٌ يوفر تابعين اثنين هما: التابع send، والتابع abort اللذان تستعملهما الدالة ...

Object.prototype

الخاصية Object.prototype تُمثِّل القيمة الكائن prototype التابعة للكائن Object. سمات الخاصية Object.prototype قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف جميع الكائنات في JavaScript تقريبًا تنحدر من الكائن Object، والكائنات الاعتيادية ترث الخاصيات (بما في ذلك الدوال) من الكائن Object.prototype، على الرغم أنَّه يمكن إعادة الكتابة فوق تلك الخاصيات. قد تُنشَأ كائنات من النوع Object لا ينطبق فيها ما سبق (مثلًا عبر استخدام الدالة Object.create(null)‎) أو يمكن تعديل كائن prototype مما لا يجعل ما سبق صحيحًا (مثلًا عبر ...

Object.getOwnPropertyDescriptors()‎

الدالة Object.getOwnPropertyDescriptors()‎ تُعيد واصفات جميع الخاصيات التابعة لكائنٍ ما مباشرةً (أي أنها معرَّفة في الكائن نفسه، وليس في سلسلة prototype). البنية العامة Object.getOwnPropertyDescriptors(obj) obj الكائن الذي نريد الحصول على واصفات جميع خاصياته. القيمة المعادة كائن يحتوي على واصفات جميع الخاصيات التابعة للكائن، وقد يكون هذا الكائن فارغًا لم لم يملك الكائن المعني أيّة خاصيات. الوصف تسمح لنا هذه الدالة بالحصول على الوصف الدقيق لجميع خاصيات الكائن؛ وتتألف الخاصيات في JavaScript من سلسلة نصية تُشكِّل اسم الخاصية وواصف لتلك الخاصية؛ لمزيدٍ ...

دوال التعامل مع صيغة JSON في PHP

يتيح الامتداد JSON معالجة صيغة تبادل البيانات JavaScript Object Notation (اختصارًا JSON) في لغة PHP. يُعالَج فك تّرميز JSON في الإصدار الخامس من PHP بواسطة مُحلِّل اعتمادًا على الأداة JSON_checker التي أنشأها Douglas Crockford، بينما يأتي الإصدار السّابع من PHP مع مُحلِّل مُحسَّن وجديد تمامًا مكتوب خصّيصًا لأجل PHP ومُرخَّص بموجب رخصة PHP. مُلاحظة: تعتمد PHP مجموعة عُليا من JSON كما هو مُحدَّد في المعيار الأصلي RFC 7159. json_decode()‎ تفك ترميز سلسلة نصية بصيغة JSON. json_encode()‎ تُعيد قيمة ما على ...

Document.cookie

تُستعمل هذه الخاصيّة للحصول على ملفّات الارتباط (cookies) المُرتبطة بالمُستند الحالي وضبطها، للتعامل مع ملفّات الارتباط ببساطة أكثر، انظر إطار العمل البسيط هذا. البنية العامة الحصول على جميع ملفّات تعريف الارتباط المتاحة allCookies = document.cookie; المُتغيّر allCookies أعلاه عبارة عن سلسلة نصيّة تحتوي على قائمة بجميع ملفات الارتباط مفصولة بفاصلة منقوطة (;)، وهي على شكل مفتاح=قيمة. ضبط ملفّ ارتباط جديد document.cookie = newCookie; في الشيفرة أعلاه، المُتغيّر newCookie عبارة عن سلسلة نصيّة على شكل مفتاح=قيمة. لاحظ أنّك تستطيع أن تضبط أو تُحدّث ...

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

الواجهات الساكنة (Facades) في Laravel

مقدمة تُوفِّر الواجهات الساكنة واجهة "ساكنة" (static) للأصناف المتوافرة في حاوي خدمات تطبيقك. يأتي Laravel مع عدة واجهات تمكنك من استخدام كل خاصيات Laravel تقريبًا. تمثل واجهات Laravel الساكنة "وسطاء ساكنات" (static proxies) للأصناف الأساسية بحاوي الخدمات مما يوفر كل فوائد الصِّيغ (syntax) المقتضبة والمُعبِّرة مع الحفاظ على قابلية الاختبار ومرونة أكبر من الدالات الساكنة التقليدية. كل واجهات Laravel الساكنة مُعرَّفةٌ في مجال الأسماء Illuminate\Support\Facades. يمكننا الوصول لواجهة ساكنة بهذه الطريقة: use Illuminate\Support\Facades\Cache; Route::get('/cache', function () { return ...

أدوات Active Support في ريلز

Active Support هو جزء من نواة ريلز التي توفر ملحقات للغة روبي والأدوات المساعدة وغيرها من الأشياء. أحد الأشياء التي يتضمنها هو واجهة برمجية لأدوات قياس (instrumentation API) يمكن استخدامها داخل تطبيق لقياس إجراءات معينة تحدث داخل شيفرة روبي، مثل تلك الموجودة داخل تطبيق ريلز أو إطار العمل نفسه، إذ لا يقتصر ذلك على ريلز فقط. يمكن استخدامها بشكل مستقل في شيفرات روبي البرمجية الأخرى إذا كان ذلك مطلوبًا. في هذا الدليل، ستتعلم كيفية استخدام الواجهة البرمجية لأدوات القياس (instrumentation API) ...

المكتبة Action Cable في ريلز

تعمل المكتبة Action Cable على دمج WebSockets مع بقية تطبيق ريلز الخاص بك بسهولة. تسمح بكتابة الميزات ذات الوقت الحقيقي (real-time features) المنشودة في روبي وفي نفس الصياغة والشكل كسائر تطبيق ريلز الخاص بك مع الحفاظ على سرعة الأداء وقابلية التطور. تُعدُّ هذه المكتبة حزمةً كاملةً توفر إطار JavaScript من طرف المستخدم، وإطار روبي من طرف الخادم كلاهما. أنت تملك الوصول إلى كامل نموذج النطاق (full domain model) المكتوب مع Active Record أو مع أي تقنية ORM التي اخترتها. يمكنك ...

Boolean.prototype.valueOf()‎

الدالة Boolean.prototype.valueOf()‎ تُعيد قيمةً أوليّةً للكائن المعطي. البنية العامة bool.valueOf() القيمة المعادة القيمة الأوليّة لكائن Boolean المعطي. الوصف الدالة valueOf التابعة لكائنات Boolean تُعيد القيمة الأوليّة للكائن Boolean. يجدر بالذكر أنَّ هذه الدالة تُستدعى داخليًا (وتلقائيًا) من لغة JavaScript ونادرًا ما تُستخدَم مباشرةً في الشيفرات. أمثلة هذا مثال عن استخدام الدالة valueOf لإسناد القيمة الأولية للكائن x إلى المتغير myVar، لاحظ أنَّ القيمة الأوليّة لهذا الكائن هي false: x = new Boolean(); myVar = x.valueOf(); // false دعم المتصفحات الميزة Chrome ...

Document.hasFocus()‎

يُعيد التّابع Document.hasFocus‎()‎ قيمة منطقيّة من النّوع Boolean تدلّ على ما إذا كان المستند أو أي عنصرٍ داخل المستند مُركَّزًا عليه أو لا. يُستعمل هذا التّابع لتحديد ما إذا كان العنصر المفعّل في مستند مُركَّزًا عليه أو لا. ملاحظة: عند عرض مستندٍ ما، فالعنصر المُركّز عليه هو دائمًا العنصر المفعّل في المستند، لكنّ العنصر المفعّل لا يكون دائمًا مُركَّزًا عليه بالضّرورة. على سبيل المثال، عنصر مُفعّل داخل نافذة منبثقة في الخلفيّة لا يكون مركّزًا عليه. البنية العامة focused = document.hasFocus(); ...

Array.prototype.toString()‎

الدالة Array.prototype.toString()‎ تعيد تمثيلًا نصيًّا للمصفوفة المعنية وجميع عناصرها. var months = ['Jan', 'Feb', 'Mar', 'Apr']; months.toString(); // "Jan,Feb,Mar,Apr" البنية العامة arr.toString() القيمة المعادة سلسلة نصية تُمثِّل المصفوفة وعناصرها. الوصف الكائن Array يُعيد تعريف الدالة toString الموجودة في الكائنObject؛ فهو لا يرث الدالة Object.prototype.toString()‎. فلكائنات Array ستُعيد الدالة toString تمثيلًا نصيًا للمصفوفة بفصل عناصرها بفاصلة. تستدعي JavaScript الدالة toString تلقائيًا عند محاولة تمثيل المصفوفة كقيمة نصية. دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم نعم نعم نعم نعم مصادر ومواصفات مسودة المعيار ECMAScript Latest Draft. معيار ...

محدد الأصناف ‎"‎.class"‎‎ في jQuery

محدد الأصناف الوصف يُستخدَم مُحدِّد الأصناف في تحديد كافّة العناصر التي تمتلك الصّنف المُعطَى. ‎jQuery( ".class" )‎ أضيفت في الإصدار: 1.0. class الصّنف المطلوب البحث عنه. يُمكِن للعنصر أن يمتلك عدّة أصناف، يجب أن يتطابق واحد منها فقط مع هذه القيمة. تستخدم jQuery لأجل مُحدِّدات الأصناف الدالة ‎getElementsByClassName()‎ الأصليّة في JavaScript إن كان المتصفّح يدعمها. أمثلة إيجاد العنصر الذي يمتلك الصّنف myClass: <!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>class مثال عن المحدد</title> <style> div, span { ...

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

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

Object.prototype.toString()‎

الدالة Object.prototype.toString()‎ تُعيد سلسلةً نصيةً تُمثِّل الكائن. البنية العامة obj.toString() القيمة المعادة سلسلة نصيّة تُمثِّل الكائن. الوصف يملك كل كائن الدالة toString()‎ التي ستستدعى تلقائيًا عندما يراد تمثيل الكائن كقيمة نصية أو عند الإشارة إلى الكائن في مكانٍ تتوقع JavaScript توفير سلسلة نصية فيه؛ وافتراضيًا توجد الدالة toString()‎ في جميع الكائنات التي تنحدر من الكائن Object؛ وإذا لم يُعاد تعريف هذه الدالة في الكائن المُخصَّص فستُعيد القيمة "[object type]"، إذ إنَّ type هو نوع الكائن، والشيفرة الآتية توضِّح ذلك: var ...

المكتبة Active Storage في ريلز

يجعل Active Storage عملية رفع الملفات وإنشاء مرجع لها في أي خدمة سحابية - مثل Amazon S3، أو Google Cloud Storage، أو Microsoft Azure Storage - وربطها بنماذج Active Record عمليةً بسيطةً وسهلةً. يدعم أيضًا امتلاك خدمة تخزين أساسية في خدمة سحابية، وخدمة تخزين انعكاسية (mirror) في خدمات سحابية أخرى وذلك من أجل تحقيق التوافر الدائم. أضف إلى ذلك أنه يوفر خدمة التخزين على قرص صلب (disk service) للفحص أو النشر المحلي ولكن التركيز الأساسي ينصب على التخزين السحابي. يمكن ...

الحقل checkbox

عناصر <input> ذات النوع checkbox تُعرَض افتراضيًا كصناديق مربعة يمكن التأشير عليها لتفعيله، كالتي قد تراها في بعض الأوراق الحكومية. فهي تسمح لك باختيار قيم لإرسالها مع النموذج. أزرار الانتقاء (radio buttons) تشبه صناديق التأشير (checkboxes) لكن هنالك فرق مهم بينهما، فأزرار الانتقاء تستخدم لاختيار قيمة من مجموعة قيم، بينما صناديق التأشير تسمح لك بتفعيل أو تعطيل القيم. فلو كانت هنالك عدِّة خيارات، فتسمح أزرار الانتقاء باختيار قيمة منها، بينما صناديق التأشير تسمح بتحديد عدِّة قيم. <label for="checkbox">صندوق تأشير</label> <input type="checkbox" ...

Document.elementsFromPoint()‎

تنبيه: هذه تقنيّة تجريبيّة، انظر جدول دعم المتصفّحات قبل استخدام هذا التّابع في شيفرة إنتاجيّة. يعيد التّابع Document.elementsFromPoint‎()‎ مصفوفة بجميع العناصر الموجودة في نقطة الإحداثيّات المعطاة (حسب إطار العرض [viewport]). البنية العامة var elements = document.elementsFromPoint(x, y); x الإحداثيّات الأفقيّة لنقطة ما. y الإحداثيّات الرأسية لنقطة ما. القيمة المعادة مصفوفة كائنات من النّوع Element. مثال جزء HTML: <div> <p>محتوى نصيّ</p> </div> <p>العناصر في الإحداثيّات 30 و 20</p> <div id="output"></div> جزء JavaScript: var output = document.getElementById("output"); if (document.elementsFromPoint) { var elements = document.elementsFromPoint(30, ...

Number.MAX_VALUE

الخاصية Number.MAX_VALUE تُمثِّل أكبر قيمة عددية قابلة للتمثيل في JavaScript. سمات الخاصية Number.MAX_VALUE قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف الخاصية MAX_VALUE تملك القيمة 1.79E+308 تقريبًا، والقيم العددية الأكبر من الخاصية MAX_VALUE ستُمثَّل على أنها Infinity. لمّا كانت الخاصية MAX_VALUE ساكنةً (static)، فيجب استخدامها بالصيغة Number.MAX_VALUE دون الحاجة إلى إنشاء كائن Number جديد؛ لاحظ أنَّ استخدامها على كائنٍ أنشَأتَه (بدلًا من الكائن Number) سيؤدي إلى إعادة القيمة undefined. أمثلة الشيفرة الآتية تضرب قيمتين عدديتين، وإذا كانت النتيجة ...

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

deferred.resolve( [args ] )‎ القيمة المعادة يُعيد كائنًا من النوع Deferred. الوصف قبول كائن مؤجل واستدعاء أي doneCallbacks مع الوسائط args المُحدَدة. deferred.resolve( [args ] )‎ أُضيف مع الإصدار: 1.5. args الوسائط الاختيارية التي تُمرر إلى دوال doneCallbacks، ويمكن أن يكون من أي نوع من أنواع JavaScript. عادة، يجب أن يستدعي هذا التابع فقط منشئ الكائن المؤجل Deferred؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير حالة الكائن المؤجل بإعادة كائن Promise كسلسلة (chain) من خلال التابع deferred.promise()‎‎‎. عند قبول الكائن ...

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

deferred.resolve( [args ] )‎ القيمة المعادة يُعيد كائنًا من النوع Deferred. الوصف قبول كائن مؤجل واستدعاء أي doneCallbacks مع الوسائط args المُحدَدة. deferred.resolve( [args ] )‎ أُضيف مع الإصدار: 1.5. args الوسائط الاختيارية التي تُمرر إلى دوال doneCallbacks، ويمكن أن يكون من أي نوع من أنواع JavaScript. عادة، يجب أن يستدعي هذا التابع فقط منشئ الكائن المؤجل Deferred؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير حالة الكائن المؤجل بإعادة كائن Promise كسلسلة (chain) من خلال التابع deferred.promise()‎‎‎. عند قبول الكائن ...

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

deferred.reject( [args ] )‎ القيمة المعادة تُعيد كائنًا من النوع Deferred. الوصف يرفُض هذا التابع كائنًا مؤجلًا ويستدعي أي failCallbacks مع الوسيط args المُعطى. deferred.reject( [args ] )‎ أُضيف مع الإصدار: 1.5. args يمكن أن يكون من أي نوع من أنواع JavaScript. وسائط اختيارية تُمرر إلى failCallbacks. عادة يجب أن يستدعي هذا التابع فقط منشئ الكائن المؤجل Deferred؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير حالة الكائن المؤجل بإعادة الكائن Promise كسلسلة (chain) من خلال التابع deferred.promise()‎. عندما يتم رفض الكائن المؤجل ...

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

deferred.reject( [args ] )‎ القيمة المعادة تُعيد كائنًا من النوع Deferred. الوصف يرفُض هذا التابع كائنًا مؤجلًا ويستدعي أي failCallbacks مع الوسيط args المُعطى. deferred.reject( [args ] )‎ أُضيف مع الإصدار: 1.5. args يمكن أن يكون من أي نوع من أنواع JavaScript. وسائط اختيارية تُمرر إلى failCallbacks. عادة يجب أن يستدعي هذا التابع فقط منشئ الكائن المؤجل Deferred؛ يمكنك منع الشيفرات البرمجية الأخرى من تغيير حالة الكائن المؤجل بإعادة الكائن Promise كسلسلة (chain) من خلال التابع deferred.promise()‎. عندما يتم رفض الكائن المؤجل ...

isNaN()‎

الدالة isNaN()‎ تُحدِّد فيما إذا كانت القيمة المُمرَّرة إليها هي NaN أم لا. لاحظ أنَّ تحويل القيم داخل الدالة isNaN()‎ له قواعد مثيرة للاهتمام؛ لذا يمكنك استخدام الدالة Number.isNaN()‎ التي عُرِّفَت في ECMAScript 2015 بدلًا من هذه الدالة. البنية العامة isNaN(value) value القيمة التي ستُختبَر إن كانت NaN. القيمة المعادة القيمة true إذا كانت القيمة المُعطاة هي NaN، والقيمة false فيما عدا ذلك. الوصف ضرورة وجود الدالة isNaN على النقيض من بقية القيم في JavaScript، لا يمكن الاعتماد على معاملات ...

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

jQuery.noConflict( [removeAll ] )‎ القيم المعادة يعيد كائنًا من النوع Object. الوصف يجبر هذا التابع jQuery على التنازل عن التحكم بالمتغيِّر $. jQuery.noConflict( [removeAll ] )‎ أُضيف مع الإصدار: 1.0. removeAll قيمةٌ منطقيَّةٌ تحدِّد إن كان يراد إزالة جميع متغيرات jQuery من النطاق العام (global scope) بما فيها jQuery نفسها. تستعمل أغلب مكتبات JavaScript المعامل $ بوصفه دالةً أو اسم متغيِّر مثلما تفعل jQuery تمامًا. ففي حالة مكتبة jQuery، يُعدُّ $ اسمًا بديلًا للعبارة jQuery، لذا تكون جميع الوظائف متاحة ...

الدالة get_browser()‎ في PHP

(PHP 4, PHP 5, PHP 7) تعيد الدالة get_browser()‎ الميزات التي يدعمها متصفح المستخدم. الوصف mixed get_browser ([ string $user_agent [, bool $return_array = FALSE ]] ) تحاول هذه الدالة تحديد الميزات التي يدعمها متصفح المستخدم من خلال البحث عن معلومات المتصفح في ملف browscap.ini. المعاملات user_agent متصفح المستخدم المراد تحليله. افتراضيًا، تستخدم قيمة ترويسة User-Agent في HTTP لكن يمكنك تمرير قيمة إلى هذا المعامل للبحث عن معلومات متصفحٍ آخر على سبيل المثال. يمكنك تجاوز هذا المعامل بضبط قيمته إلى القيمة ...

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

jQuery.noConflict( [removeAll ] )‎ القيم المعادة يعيد كائنًا من النوع Object. الوصف يجبر هذا التابع jQuery على التنازل عن التحكم بالمتغيِّر $. jQuery.noConflict( [removeAll ] )‎ أُضيف مع الإصدار: 1.0. removeAll قيمةٌ منطقيَّةٌ تحدِّد إن كان يراد إزالة جميع متغيرات jQuery من النطاق العام (global scope) بما فيها jQuery نفسها. تستعمل أغلب مكتبات JavaScript المعامل $ بوصفه دالةً أو اسم متغيِّر مثلما تفعل jQuery تمامًا. ففي حالة مكتبة jQuery، يُعدُّ $ اسمًا بديلًا للعبارة jQuery، لذا تكون جميع الوظائف متاحة ...

export

التعبير البرمجي export يمكن أن يُستخدَم عند إنشاء وحدات JavaScript (أي JavaScript modules) لتصدير الدوال أو الكائنات أو القيم الأوليّة (primitive values) من وحدة (module) لكي يمكن استخدامها من برنامج آخر باستخدام التعبير البرمجي import. لاحظ أنَّ دعم هذه الميزة ما يزال محدودًا، لذا انظر إلى قسم «دعم المتصفحات» قبل استخدامها. البنية العامة export { name1, name2, …, nameN }; export { variable1 as name1, variable2 as name2, …, nameN }; export let name1, name2, …, nameN; // also var, function export let ...

التابع 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 المعطى أيضًا سواءً كان ذلك العنصر ابنًا ...

مجالات الأسماء في TypeScript

مقدمة تشرح هذه الصفحة كيفيّة تنظيم شيفرتك باستخدام مجالات الأسماء (namespaces) في لغة TypeScript. كانت مجالات الأسماء تُسمّى قديمًا بمصطلح "الوحدات الداخليّة (internal modules)"، وما كان يُسمّى بالوحدات الخارجيّة (External modules) أصبح الآن يُسمّى ببساطة بمصطلح "الوحدات (modules)". ويجب استخدام الكلمة المفتاحية ‎namespace‎ في الأماكن التي كانت تُستخدَم فيها الكلمة المفتاحية ‎module‎ للتصريح سابقًا عن وحدة داخليّة في النسخ التي سبقت TypeScript 1.5، أي أنّ عليك استخدام ‎namespace X {‎ عوضًا عن ‎module X {‎، وذلك تجنّبًا لإرباك المستخدمين الجدد. ...

التابع ‎‎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()‎ مصفوفةً من الكائنات ويحذف أيَّة عقدٍ متكرِّرة. تُعدُّ العقدة متكرِّرة إن كان لها الاسم نفسه الذي تملكه عقدة أخرى موجودة قبلها في المصفوفة. أمَّا كان هنالك عقدتين ...

التصريح عن المتغيّرات في TypeScript

التصريح عن المتغيّرات (Variable Declarations) الكلمتان المفتاحيتان ‎let‎ و‎const‎ نوعان جديدان من طرق التصريح عن المتغيرات في لغة JavaScript. الكلمة المفتاحية let مُشابهة للكلمة المفتاحية var من عدّة نواحي، لكنّ let تسمح للمُطورين بتجنب بعض المشاكل التي تحدث عادةً في لغة JavaScript. أمّا const فهي طريقة لمنع إعادة تعيين القيم للمتغيرات. ولأنّ TypeScript مجموعة عليا من JavaScript، فاللغة تدعم ‎let‎ و‎const‎. وسنشرح طرق التصريح عن المتغيرات هذه ولمَ يُفضّل استعمالها عوضًا عن ‎var‎. إن كانت لديك خبرة قليلة في لغة ...

Object.getOwnPropertyDescriptor()‎

الدالة Object.getOwnPropertyDescriptor()‎ تُعيد واصف إحدى الخاصيات التابعة لكائنٍ ما مباشرةً (أي أنها معرَّفة في الكائن نفسه، وليس في سلسلة prototype). البنية العامة Object.getOwnPropertyDescriptor(obj, prop) obj الكائن الذي نريد الحصول على واصف إحدى خاصياته. prop اسم الخاصية التي نريد الحصول على واصفها. القيمة المعادة واصف الخاصية (property descriptor) المعطاة إن كانت موجودةً في الكائن، أو القيمة undefined فيما عدا ذلك. الوصف تسمح لنا هذه الدالة بالحصول على الوصف الدقيق لإحدى خاصيات الكائن؛ وتتألف الخاصيات في JavaScript من سلسلة نصية تُشكِّل اسم ...

التابع ‎‎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()‎ مصفوفةً من ...

Document.location

تُعيد الخاصيّة Document.location القابلة للقِراءة فقط كائنًا من النّوع Location، والذي يحتوي على معلومات حول عنوان URL الخاصّ بالمُستند ويُتيح توابع لتعديل عنوان URL هذا وتحميل عنوان URL آخر. ورغم أنّ الخاصيّة Document.location للقِراءة فقط، إلا أنّك تستطيع تعيين سلسلة نصيّة من النّوع DOMString لها كذلك. ما يعني بأنّك تستطيع التّعامل مع هذه الخاصيّة بصفتها سلسلة نصيّة عاديّة في مُعظم الحالات. والسّطران التّاليّان مُتكافئان: document.location = 'http://www.example.com' document.location.href = 'http://www.example.com' للحصول على عنوان URL المُستندِ وحده، يُمكنك استعمال الخاصيّة document.URL كذلك. ...

Boolean.prototype.toString()‎

الدالة Boolean.prototype.toString()‎ تُعيد سلسلةً نصيّةً تُمثَّل كائن Boolean المعطي. البنية العامة bool.toString() القيمة المعادة سلسلة نصية تُمثَّل كائن Boolean المعطي. الوصف يُعيد الكائن Boolean تعريف الدالة toString الموروثة من الكائن Object؛ وستُعيد هذه الدالة سلسلةً نصيةً تُمثِّل الكائن Boolean. ستستدعي JavaScript هذه الدالة تلقائيًا عند محاولة استخدام كائن Boolean كقيمة نصية، مثلًا: عند إضافة سلسلة نصية إلى كائن Boolean.  ستُعيد الدالة toString في كائنات Boolean السلسلة النصية "true" أو "false" اعتمادًا على قيمة كائن Boolean. أمثلة هذا مثال عن استخدام ...

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

‎.removeAttr( attributeName )‎ القيم المعادة يعيد كائنًا من النوع jQuery. الوصف يحذف هذا التابع خاصِّيَّة HTML محدَّدة لكل عنصر في مجموعة العناصر المطابقة. ‎.removeAttr( attributeName )‎ أُضيف مع الإصدار: 1.0. attributeName سلسلة نصِّيَّة تمثِّل اسم خاصِّيَّة HTML المراد حذفها. ابتداءً من الإصدار 1.7، يمكن أن تحتوي السلسلة النصِّيَّة على قائمة من الخاصِّيَّات المفصولة بفراغ. يستخدم التابع ‎.removeAttr()‎ الدالة removeAttribute()‎ الموجودة في JavaScript، ولكنَّه يتميز عنها بأنَّه يمكن أن يُستدعَى مع الكائن jQuery مباشرةً ويأخذ بالحسبان التسمية المختلفة للخاصِّيَّات عبر المتصفحات. ...

التابع ‎‎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()‎ مصفوفةً من ...

التابع Thread.handle_interrupt‎ في روبي

يغير التابع handle_interrupt توقيت المقاطعة غير المتزامنة (asynchronous interrupt timing). المقاطعة (interrupt) يعني الحدث غير المتزامن (asynchronous event) والإجراء المقابل raise و kill وإشارة المسك (signal trap، غير مدعومة حاليًا) وعملية إنهاء المهمة الفرعية الرئيسية (عند إنهاء المهمة الفرعية الرئيسية، فسيتم إنهاء كل المهام الفرعية الأخرى). البنية العامة handle_interrupt(hash) { ... } → result of the block‎ يحتوي المعامل hash المعطى على أزواج على شاكلة ExceptionClass => :TimingSymbol إذ ExceptionClass هو مقاطعة (interrupt) المٌعالج من قبل الكتلة المعطاة. أما TimingSymbol فيمكن أن يكون ...

Document.createDocumentFragment()‎

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

Date.prototype.setSeconds()‎

الدالة Date.prototype.setSeconds()‎ تضبط الثواني للتاريخ المُحدَّد وفقًا للتوقيت المحلي. البنية العامة dateObj.setSeconds(secondsValue[, msValue]) في الإصدارات التي تسبق JavaScript 1.3: dateObj.setSeconds(secondsValue) secondsValue عددٌ صحيحٌ يُمثِّل عدد الثواني من الوقت بين 0 و 59. msValue قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الملي ثانية من الوقت بين 0 و 999. القيمة المعادة كم ملي ثانية قد مضت بدءًا من ‎1 January 1970 00:00:00 UTC للتاريخ المعطى (وستُغيّر قيمة الكائن Date أيضًا). الوصف إذا لم تُحدَّد قيمة للمعامل msValue فستُستخدَم القيمة المُعادة من الدالة  getMilliseconds()‎. إذا ...

Function.prototype.call()‎

الدالة Function.prototype.call()‎ تستدعي دالةً وتضبط قيمة this فيها إلى القيمة المعطية، وستُوفَّر الوسائط التي ستُمرَّر إليها كقائمة. ملاحظة: صحيحٌ أنَّ البنية العامة لهذه الدالة تكاد تماثل بينة الدالة apply()‎، لكن الفرق الرئيسي بينهما هو أنَّ الدالة apply()‎ تقبل مصفوفةً واحدةً تحتوي على الوسائط، بينما call()‎ تقبل قائمةً بالوسائط التي تُمرَّر إلى الدالة. البنية العامة function.call([thisArg, arg1, arg2, ...]) thisArg وسيطٌ اختياري، وهو يُمثِّل قيمة المعامل this التي ستُستعمل في الدالة function، لاحظ أنَّ قيمة this المُمرَّرة لا تعني بالضرورة أنَّها ...

الصنف ‎:first

الصنف الزائف ‎:first في CSS (أي pseudo-class) يُستعمَل مع القاعدة ‎@page، ويُمثِّل أوّل صفحة من المستند عند طباعته. @page :first { margin-left: 50%; margin-top: 50%; } ملاحظة: لا يمكن تغيير قيم جميع خاصيات CSS عند استخدام هذا الصنف الزائف، وإنما يمكن تغيير قيم الهوامش margin واليتامى orphans والأرامل widows وطريقة الانتقال إلى صفحة جديدة؛ وسيتم تجاهل جميع الخاصيات الأخرى. الشكل العام لهذا المحدد: :first أمثلة لاحظ كيف ستتغير الهوامش في الصفحة الأولى عند طباعتها: <p>الصفحة الأولى</p> <p>الصفحة الثانية</p> <button>طباعة!</button> شيفرة CSS: @page :first ...

حاوي الخدمات (Service Container) في Laravel

مقدمة حاوي خدمات Laravel (أي Laravel service container) هو أداةٌ قوية لإدارة اعتِماديَّات (dependencies) الصِّنف والقيام بإضافة اعتِماديَّات (dependency injection)." إضافة الاعتِماديَّات" هو مصطلح تقني يعني في مُجمله "إضافة" اعتماديات الصنف باستخدام التابع الباني (constructor) أو في بعض الحالات توابع ضبط القيم (setter). لنلقِ نظرة على هذا المثال البسيط: <?php namespace App\Http\Controllers; use App\User; use App\Repositories\UserRepository; use App\Http\Controllers\Controller; class UserController extends Controller { /** * مستودع المُستخدِم تطبيق * * @var ...

Function.prototype.bind()‎

الدالة Function.prototype.bind()‎ تُنشِئ دالةً جديدةً التي عند استدعائها ستُضبَط قيمة المعامل this إلى القيمة المعطية، وستُوفَّر إليها قائمة المعاملات التي تلي قيمة المعامل this. البنية العامة fun.bind(thisArg[, arg1[, arg2[, ...]]]) thisArg وسيطٌ يُمثِّل قيمة المعامل this التي ستُستعمل في الدالة func عند استدعائها، لاحظ أنَّ JavaScript ستتجاهل هذه القيمة إذا استدعيت الدالة كدالة بانية باستخدام المعامل new. arg1, arg2, ...‎ الوسائط التي ستُرفَق مع الوسائط المُمرَّرة إلى الدالة عند استدعائها. القيمة المعادة نسخة من الدالة المعطية مع قيمة this المُخصَّصة ...

العنصر

يُنشِئ العنصر <a> (اسمه اختصار للكلمة anchor) رابطًا فائقًا (hyperlink) لصفحات الويب الأخرى أو للملفات أو لأقسم الصفحة الحالية أو لعناوين البريد الإلكتروني. المثال الآتي فيه رابط إلى موقع خارجي: <a href="http://www.hsoub.com/"> شركة حسوب </a> بطاقة العنصر تصنيفات المحتوى عنصر تنظيمي أو عنصر عادي. المحتوى المسموح محتوى تنظيمي أو عادي. الوسم المختصر لا يمكن حذف أيّ من وسمَي البداية أو النهاية. العناصر الأب أي عنصر باستنثاء عنصر <a> آخر. واجهة DOM HTMLAnchorElement دعم المتصفحات Chrome Firefox Edge Safari Opera مدعوم مدعوم مدعوم ...

Date.prototype.toDateString()‎

الدالة Date.prototype.toDateString()‎ تعيد قسم التاريخ من كائن Date كسلسلة نصية سهلة القراءة من البشر. البنية العامة dateObj.toDateString() القيمة المعادة سلسلة نصية تُمثِّل قسم التاريخ من كائن Date. الوصف كائنات Date تُشير إلى لحظة زمنية معيّنة، واستدعاء الدالة toString()‎ سيُعيد التاريخ كسلسلة نصية سهلة القراءة من البشر، وهو يتألف من قسم التاريخ (اليوم والشهر والسنة) متبوعًا بقسم الوقت (الساعات والدقائق والثواني والمنطقة الزمنية)؛ لكن في بعض الأحيان من الأفضل الحصول على قسم التاريخ فقط دونًا عن الوقت، وذلك باستخدام الدالة toDateString()‎. ...

Function.caller

الخاصية Function.caller تُعيد الدالة التي استدعت الدالة التي تُنفَّذ حاليًا. لا يجوز استخدام هذه الخاصية في نمط strict. الوصف إذا لم تُستدعَ الدالة f ضمن دالة أخرى (أي أنها استدعيت في أعلى مستوى top level)، فقيمة الخاصية f.caller هي null. هذه الخاصيةُ هي بديلٌ عن الخاصية المحذوفة arguments.caller التابعة للكائن arguments. لاحظ أنَّه في حالة الاستدعاء التعاودي (recursion)، فلا يمكننا إعادة بناء مكدس الاستدعاءات (call stack) باستخدام هذه الخاصية. فلتكن لدينا الشيفرة: function f(n) { g(n - 1); } function g(n) ...

String.prototype.length

الخاصية length التابعة لكائنات String تُشير إلى طول السلسلة النصية، وذلك بعدّ عدد رموز UTF-16. البنية العامة str.length الوصف هذه الخاصية تُعيد عدد رموز المحارف (code points) الموجودة في السلسلة النصية. لاحظ أنَّ ترميز UTF-16 هو الصيغة المستخدم في JavaScript، وهو يستخدم 16-بت لتمثيل المحارف الشائعة، لكنه يحتاج إلى أكثر من بايت لتمثيل المحارف الأقل شيوعًا، لذا من الممكن ألّا تساوي القيمة المُعادة من الخاصية length عدد المحارف الفعلية الموجودة في السلسلة النصية. حدَّد معيار ECMAScript 2016 (أي ES7) طولًا ...

Number.NEGATIVE_INFINITY

الخاصية Number.NEGATIVE_INFINITY تُمثِّل أصغر قيمة عددية قابلة للتمثيل في JavaScript. سمات الخاصية Number.NEGATIVE_INFINITY قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف قيمة الخاصية Number.NEGATIVE_INFINITY هي نفسها القيمة السالبة لخاصية الكائن العام Infinity. لكن سلوك هذه القيمة يختلف اختلافًا بسيطًا عن اللانهاية الرياضية: أيّة قيمة موجبة، بما في ذلك POSITIVE_INFINITY، مضروبة بالقيمة NEGATIVE_INFINITY هي NEGATIVE_INFINITY. أيّة قيمة سالبة، بما في ذلك NEGATIVE_INFINITY، مضروبة بالقيمة NEGATIVE_INFINITY  هي POSITIVE_INFINITY. أيّة قيمة موجبة مقسومة على NEGATIVE_INFINITY هي صفر سالب. أيّة قيمة سالبة مقسومة ...

Date.prototype.setMinutes()‎

الدالة Date.prototype.setMinutes()‎ تضبط الدقائق (0-59) للتاريخ المُحدَّد وفقًا للتوقيت المحلي. البنية العامة dateObj.setMinutes(minutesValue[, secondsValue[, msValue]]) في الإصدارات التي تسبق JavaScript 1.3: dateObj.setMinutes(minutesValue) minutesValue عددٌ صحيحٌ يُمثِّل عدد الدقائق من الوقت بين 0 و 59. secondsValue قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الثواني من الوقت بين 0 و 59. msValue قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الملي ثانية من الوقت بين 0 و 999. إذا حدّدت قيمةً للمعامل msValue فيجب أن تضبط قيمة secondsValue أيضًا. القيمة المعادة كم ملي ثانية ...

Number.POSITIVE_INFINITY

الخاصية Number.POSITIVE_INFINITY تُمثِّل أصغر قيمة عددية قابلة للتمثيل في JavaScript. سمات الخاصية Number.POSITIVE_INFINITY قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف قيمة الخاصية Number.POSITIVE_INFINITY هي نفسها قيمة خاصية الكائن العام Infinity. لكن سلوك هذه القيمة يختلف اختلافًا بسيطًا عن اللانهاية الرياضية: أيّة قيمة موجبة، بما في ذلك POSITIVE_INFINITY، مضروبة بالقيمة POSITIVE_INFINITY هي POSITIVE_INFINITY. أيّة قيمة سالبة، بما في ذلك NEGATIVE_INFINITY، مضروبة بالقيمة POSITIVE_INFINITY  هي NEGATIVE_INFINITY. أيّة قيمة موجبة مقسومة على POSITIVE_INFINITY هي صفر موجب. أيّة قيمة سالبة مقسومة على ...

Date.prototype.toTimeString()‎

الدالة Date.prototype.toTimeString()‎ تعيد قسم الوقت من كائن Date كسلسلة نصية سهلة القراءة من البشر. البنية العامة dateObj.toTimeString() القيمة المعادة سلسلة نصية تُمثِّل قسم الوقت من كائن Date بصيغة American English. الوصف كائنات Date تُشير إلى لحظة زمنية معيّنة، واستدعاء الدالة toString()‎ سيُعيد التاريخ كسلسلة نصية سهلة القراءة من البشر، وهو يتألف من قسم التاريخ (اليوم والشهر والسنة) متبوعًا بقسم الوقت (الساعات والدقائق والثواني والمنطقة الزمنية)؛ لكن في بعض الأحيان من الأفضل الحصول على قسم الوقت فقط دونًا عن التاريخ، وذلك ...

العنصر

يُمثِّل العنصر <output> ناتج عملية حسابية أو أحد أفعال المستخدم. مثال تفاعلي (باستخدام شيفرة JavaScript) يُستخدَم فيه العنصر <output> لإظهار ناتج عملية حسابية يجريها المستخدم: <form oninput="result.value = parseInt(a.value) + parseInt(b.value)"> <input type="range" name="b" value="50"> + <input type="number" name="a" value="10"> = <output name="result">60</output> </form> بطاقة العنصر تصنيفات المحتوى عنصر تنظيمي، وعنصر عادي، وعنصر مرتبط بالنماذج. المحتوى المسموح المحتوى العادي. الوسم المختصر لا يمكن حذف أيّ من وسمَي البداية أو النهاية. العناصر الأب أي عنصر يقبل المحتوى العادي. واجهة ...

المحدد ‎‎‎:nth-of-type()‎‎ في jQuery

المحدد ()‎:nth-of-type الوصف يختار هذا المحدِّد عناصر ذات موقع محدد ضمن مجموعة من العناصر الأخوة (أي جميعها أبناء لعناصر أخرى) التي لها اسم العنصر ذاته. jQuery( ":nth-of-type(index/even/odd/equation)" )‎ أُضيف مع الإصدار: 1.9. index فهرس العنصر الابن المراد مطابقته، ويبدأ العد من القيمة 1 بدءًا من بداية المجموعة (أي فهرس أول عنصر في المجموعة هو 1). ويمكن استعمال الكلمة المحجوزة even التي تُمثِّل العناصر التي يكون ترتيبها بين إخوتها فرديًا، أو الكلمة المحجوزة odd التي تُمثِّل العناصر التي يكون ترتيبها بين ...

التابع 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 للإشارة إلى إمكانيَّة استعمال ...

الواجهات في TypeScript

مقدّمة تركيز التحقق من الأنواع (type-checking) على شكل (shape) القيم من مبادئ TypeScript الأساسية. يُصطلَح عليه أحيانًا بالتعبير duck typing أو التحقق من الأنواع الفرعيّة هيكليًّا (structural subtyping). تعمل الواجهات في TypeScript على تسمية هذه الأنواع، وهي طريقة قويّة لتعريف عقود (contracts) داخل شيفرتك أو عقود مع شيفرةٍ خارج مشروعك. واجهة بسيطة لنبدأ بمثال بسيط لنفهم كيفيّة عمل الواجهات: function printLabel(labelledObj: { label: string }) { console.log(labelledObj.label); } let myObj = {size: 10, label: "Size 10 Object"}; printLabel(myObj); سيتحقّق مدقّق ...

Document.domain

تُستعمل للحصول على نطاقِ أصلِ المُستند الحالي أو ضبطه. وذلك حسب سياسة الأصل الواحد (same origin policy). البنية العامة var domainString = document.domain; document.domain = string; مثال // للمُستند // www.example.xxx/good.html // يُغلق هذا البرنامج النّافذة var badDomain = "www.example.xxx"; if (document.domain == badDomain) { window.close(); // هذا مُجرّد مثال، إذ أنّ هذا السّطر لا يقوم بأي شيء في بعض الأحيان } // إن كان الرّابط مثلا // https://wiki.hsoub.com/JavaScript/Document // فستُضبط القيمة التّاليّة للمُتغيّر // "wiki.hsoub.com" var domain = document.domain; ملاحظات تُعيد هذه الخاصيّة القيمة null في حالة ...

Document.children

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

Function.prototype.toString()‎

الدالة Function.prototype.toString()‎ تعيد سلسلةً نصيةً لتمثيل الشيفرة المصدرية للدالة. البنية العامة function.toString() القيمة المعادة سلسلة نصية تُمثِّل الشيفرة المصدرية للدالة. الوصف يُعيد الكائن Function تعريف الدالة toString الموروثة من الكائن Object؛ وستُعيد هذه الدالة، عند استدعائها على الدوال التي عرَّفها المستخدم، سلسلةً نصيةً للشيفرة المصدرية التي تُستخدَم لتعريف الدوال. ستستدعي JavaScript هذه الدالة تلقائيًا عند محاولة استخدام الدالة كقيمة نصية، مثلًا: عند إضافة سلسلة نصية إلى الدالة. استدعاء الدالة toString على دوال الكائنات المُضمَّنة في اللغة أو على الدوال المُنشَأة ...

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

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

Document.lastModified

تُعيد الخاصية document.lastModified سلسلةً نصيةً تحتوي على تاريخ ووقتِ آخر تعديلٍ للمُستند الحاليّ. البنية العامة string = document.lastModified; مثال طريقة الاستعمال البسيطة: alert(document.lastModified); // يُعيد تاريخا مُشابها لما يلي // 03/22/2018 05:20:48 تحويل قيمة lastModified إلى كائن من النّوع Date: var oLastModif = new Date(document.lastModified); تحويل قيمة lastModified إلى عدد الأجزاء من ألف جزء من الثّانيّة التّي مرّت منذ 1 يناير 1970 على السّاعة 00:00:00: var nLastModif = Date.parse(document.lastModified); ملاحظات لاحظ بأنّه لا يُمكن استعمال السّلسة النّصيّة التي تُعيدها الخاصيّة lastModified ...

قوالب Blade في Laravel

مقدمة يقدم Laravel محرّك قولبةٍ بسيطاً لكن قويٌّ و فعّال هو Blade. على خلاف محرّكات PHP أخرى، لا يمنع Blade المستخدم من استعمال شيفرات PHP في الواجهة، بل إنّه يحوِِّل صفحات Blade إلى شيفرة PHP ويخزِّنها تخزينًا مؤقتًا إلى حين تغييرها. ممّا يعني أنّ Blade لا يتطلب أيّ جهد أو وقت إضافي من التطبيق. تنتهي صفحات Blade بالامتداد blade.php. وتوجد عادة في مجلد resources/views. توريث القوالب تعريف التخطيط إنّ من الفوائد الأساسية لاستخدام Blade هي توريث القوالب (template inheritance) واستخدام ...

قوالب Blade في Laravel

مقدمة يقدم Laravel محرّك قولبةٍ بسيطاً لكن قويٌّ و فعّال هو Blade. على خلاف محرّكات PHP أخرى، لا يمنع Blade المستخدم من استعمال شيفرات PHP في الواجهة، بل إنّه يحوِِّل صفحات Blade إلى شيفرة PHP ويخزِّنها تخزينًا مؤقتًا إلى حين تغييرها. ممّا يعني أنّ Blade لا يتطلب أيّ جهد أو وقت إضافي من التطبيق. تنتهي صفحات Blade بالامتداد blade.php. وتوجد عادة في مجلد resources/views. توريث القوالب تعريف التخطيط إنّ من الفوائد الأساسية لاستخدام Blade هي توريث القوالب (template inheritance) واستخدام ...

الحقل week

عناصر <input> ذات النوع week تُنشِئ حقل إدخال يسمح بانتقاء السنة ورقم الأسبوع في السنة (من الأسبوع 1 إلى 52). شكل هذا الحقل يختلف من متصفح إلى متصفح، فالدعم الحالي ليس مثاليًا، فالوضع الحالي لهذا الحقل في متصفحات Chrome و Opera و Edge ومتصفحات الهواتف المحمولة لا بأس به، وسيُعرَض كحقل نصي في المتصفحات التي لا تدعمه: <input type="week" name="week"> سيبدو هذا الحقل كما في الصورة الآتية في متصفحَي Chrome و Opera، الضغط على السهم سيؤدي إلى إظهار نافذة منتقي التاريخ: ...

الدالة json_decode()‎ في PHP

(PHP 5 >= 5.2.0, PHP 7, PECL json >= 1.2.0) تفك الدالة json_decode()‎ ترميز سلسلة نصية بصيغة JSON. الوصف mixed json_decode ( string $json [, bool $assoc = FALSE [, int $depth = 512 [, int $options = 0]]] ) تأخذ سلسلة مُرمَّزة بصيغة JSON وتحوِّلها إلى مُتغيِّر PHP. المعاملات json سلسلة نصية بصيغة JSON التي سيُفكُّ ترميزها. تعمل هذه الدّالّة مع سلاسل نصّيّة مُرمَّزة بترميز UTF-8 فقط. ملاحظة: تعتمد PHP مجموعة عُليا من JSON كما هو مُحدَّد في المعيار ...

معالجة الأحداث في React

تُشبه معالجة الأحداث لعناصر React معالجة الأحداث لعناصر DOM، ولكن هنالك فروق تتعلّق بالصياغة: تُسمَّى أحداث React باستخدام حالة الأحرف camelCase (أي عند وجود اسم مؤلف من عدة كلمات نجعل الحرف الأول من الكلمة الأولى بالشكل الصغير أمّا باقي الكلمات نجعل حرفها الأول بالشكل الكبير) بدلًا من استخدام الشكل الصغير للأحرف. نُمرِّر في JSX دالة كمُعالِج للأحداث، بدلًا من سلسلة نصيّة. على سبيل المثال لنأخذ شيفرة HTML التالية: <button onclick="activateLasers()"> تفعيل الليزر </button> تكون الشيفرة السابقة مختلفة قليلًا في React: <button ...

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 ...

الصنف ‎:fullscreen

الصنف الزائف ‎:fullscreen في CSS (أي pseudo-class) يُمثِّل العناصر التي تُعرَض عندما يكون المتصفح في وضع ملء الشاشة. div:-moz-full-screen { background-color: pink; } div:-webkit-full-screen { background-color: pink; } div:fullscreen { background-color: pink; } لاحظ أنَّ مواصفة W3C تستخدم الكلمة المحجوزة ‎:fullscreen دون شرطة بين الكلمتين، لكن متصفحات WebKit و Gecko تستخدم سابقة مع تلك الكلمة مع وضع شرطة بين full و screen كما في ‎:-webkit-full-screen و ‎:-moz-full-screen، أما متصفحَي Edge و IE فيستعملان ‎:fullscreen و ‎:-ms-fullscreen على التوالي وبالترتيب. الشكل العام لهذا المحدد: ...

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

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

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

‎.delay( duration [, queueName ] )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يضبط هذا التابع مؤقِّت لتأجيل تنفيذ العناصر التالية في طابور (queue) الانتظار. ‎.delay( duration [, queueName ] )‎ أُضيف مع الإصدار: 1.4. duration عدد صحيح يشير إلى مدة تأخير تنفيذ العنصر التالي في طابور (queue) الانتظار بالمللي ثانية. queueName سلسلة نصية تحتوي على اسم قائمة الانتظار التأثيرات القياسية. قيمتها الافتراضية fx. يسمح لنا التابع ‎.delay()‎ بتأخير تنفيذ الدوال التي تتبعه في طابور (queue) الانتظار. ويمكن استخدامه ...

Date.prototype.setHours()‎

الدالة Date.prototype.setHours()‎ تضبط الساعة (0-23) للتاريخ المُحدَّد وفقًا للتوقيت المحلي. وتُعيد كم ملي ثانية قد مضت بدءًا من ‎1 January 1970 00:00:00 UTC للتاريخ المعطى (وستُغيّر قيمة الكائن Date أيضًا). البنية العامة dateObj.setHours(hoursValue[, minutesValue[, secondsValue[, msValue]]]) في الإصدارات التي تسبق JavaScript 1.3: dateObj.setHours(hoursValue) hoursValue عددٌ صحيحٌ يُمثِّل الساعة من اليوم بين 0 و 23. minutesValue قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الدقائق من الوقت بين 0 و 59. secondsValue قيمةٌ اختياريةٌ، وهي عددٌ صحيحٌ يُمثِّل عدد الثواني من الوقت بين 0 و ...

نظرة سريعة على التخزين المؤقت في ريلز

هذا الدليل عبارة عن مدخل يطلعك على كيفية تسريع تطبيق ريلز عبر التخزين المؤقت. يعني التخزين المؤقت تخزين المحتوى الذي أُنشِئ أثناء دورة الاستجابة للطلب وإعادة استخدامه عند الاستجابة لطلبات مشابهة. غالبًا ما يكون التخزين المؤقت الطريقة الأكثر فاعلية لتعزيز أداء التطبيق. من خلال التخزين المؤقت، يمكن لمواقع الويب التي تعمل على خادم واحد مع قاعدة بيانات واحدة الحفاظ على تحميل الآلاف من المستخدمين المتزامنين. يوفر ريلز مجموعة مميزة من ميزات التخزين المؤقت. سوف يعلمك هذا الدليل نطاق وغرض كل ...

اختبارات المتصفح (Laravel Dusk) في Laravel

مقدمة يوفّر لك Laravel Dusk أتمتة للمتصفّح واختبار للواجهات البرمجيّة بطريقة سهلة الاستخدام. بشكلٍ افتراضي، لا يتطلّب Dusk تنصيب JDK أو Selenium على جهازك، حيث يستعمل تثبيت مستقل (standalone) لبرمجية ChromeDriver. بأي حال، يمكنك استخدام أي برنامج تشغيل متوافق مع Selenium إذا أردت. التثبيت للبدء، أضف الاعتمادية laravel/dusk إلى مشروعك: composer require --dev laravel/dusk بعد تثبيت Dusk، سجّل مزوّد الخدمة الذي يتبع إلى Dusk، وهو Laravel\Dusk\DuskServiceProvider. بشكل عام، يكون هذا تلقائيًّا باستخدام التسجيل التلقائي لمزوّدات خدمة Laravel. تنبيه: إذا قمت بتسجيل ...

الحقل month

عناصر <input> ذات النوع month تُنشِئ حقل إدخال يسمح بانتقاء السنة والشهر بسهولة. شكل هذا الحقل يختلف من متصفح إلى متصفح، فالدعم الحالي ليس مثاليًا (راجع قسم دعم المتصفحات لمزيدٍ من المعلومات)، لكن هذا الحقل سيُعرَض كحقل نصي في المتصفحات التي لا تدعمه: <input type="month" name="month"> سيبدو هذا الحقل كما في الصورة الآتية في متصفحَي Chrome و Opera: لقطة لكيفية عرض الحقل month في متصفحَي Chrome و Opera. أما في متصفح Edge فسيبدو الحقل كما يلي: لقطة لكيفية عرض الحقل month ...

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