نتائج البحث

مقدمة يقدم Laravel Cashier واجهة قويّة لاشتراكات خدمات الفواتير Stripe و Braintree، وهي تعالج تقريبًا كل شيفرات boilerplate الخاصة باشتراك الفواتير التي تخشى من كتابتها، وبالإضافة إلى إدارة الاشتراكات الأساسية، يستطيع Cashier التعامل مع القسائم (coupons)، ومبادلة الاشتراكات وكميّات الاشتراكات وفترات السماح بالإلغاء وحتى إنشاء ملفات PDF للفواتير. تنبيه: إذا كنت تضع رسوم لمرة واحدةً فقط ولا توفّر الاشتراكات، فيجب عليك أن لا تستخدم Cashier، وبدلًا من ذلك، يجب عليك استخدام حزمة برمجيات التطوير (SDK) الخاصة بـ Braintree و Stripe ...

مقدمة يقدم Laravel Cashier واجهة قويّة لاشتراكات خدمات الفواتير Stripe و Braintree، وهي تعالج تقريبًا كل شيفرات boilerplate الخاصة باشتراك الفواتير التي تخشى من كتابتها، وبالإضافة إلى إدارة الاشتراكات الأساسية، يستطيع Cashier التعامل مع القسائم (coupons)، ومبادلة الاشتراكات وكميّات الاشتراكات وفترات السماح بالإلغاء وحتى إنشاء ملفات PDF للفواتير. تنبيه: إذا كنت تضع رسوم لمرة واحدةً فقط ولا توفّر الاشتراكات، فيجب عليك أن لا تستخدم Cashier، وبدلًا من ذلك، يجب عليك استخدام حزمة برمجيات التطوير (SDK) الخاصة بـ Braintree و Stripe ...

مؤشر الاستقرار: 1 - تجريبي يوفر تتبع الأحداث آلية لتركيز معلومات التتبع التي  تولدت بواسطة V8، ونواه Node.js، وبرمجية مساحة المستخدم (userspace code). يمكن تفعيل التتبع بواسطة راية سطر الأوامر ‎--trace-event-categories أو باستخدام وحدة trace_events. وتقبل راية ‎‎--‎trace-event-categories قائمة بأسماء الفئات المفصولة بفاصلات. والفئات المتاحة هي:     • node - عنصر نائب (placeholder) فارغ.     • node.async_hooks - يتيح التقاط بيانات التتبع async_hooks المُفصَّلة. أحداث async_hooks لها asyncId فريد وخاصيتا triggerId و triggerAsyncId الخاصة.     • node.bootstrap ...

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

تعرض الوحدة v8 واجهات برمجة التطبيقات (API) الخاصة بإصدار V8 المضمنة في برمجية Node.js. ويمكن الوصول إليها باستخدام: const v8 = require('v8'); وقد يتعرض كلٌ من واجهات برمجة التطبيقات والتنفيذ للتغيير في أي وقت. v8.cachedDataVersionTag()‎ أُضيف مع الإصدار: v8.0.0.     • القيمة المُعادة: من النوع <integer>. يُعيد عدد صحيح يمثل "وسم الإصدار" مشتق من الإصدار V8، ورايات سطر الأوامر وميزات المعالج CPU المكتشفة. وهو يفيد في تحديد ما إذا كان المخزن المؤقت لـ cacheddata الخاص بـ vm.Script متوافق مع مثيل ...

مقدمة تهدف هيكلية تطبيق Laravel الافتراضية إلى توفير نقطة بداية رائعة لكل من التطبيقات الكبيرة والصغيرة. بالطبع، أنت حر في تنظيم تطبيقك كما تشاء. لا يفرض Laravel أي قيود تقريبًا على مكان وجود أي صنف من أصناف مشروعك، طالما أن Composer يمكنه تحميل الصنف تلقائيًا. أين هو مجلّد النماذج؟ عند عملية البدء مع Laravel، يشوشّ العديد من المطورين بسبب عدم وجود المجلّد models. ومع ذلك، فإن عدم وجود مثل هذا المجلّد هو متعمد. نجد كلمة "نماذج" غامضة لأنها تعني الكثير ...

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

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

مُلاحظة: هذه الخاصيّة تجريبيّة، انظر جدول دعم المتصفحات قبل استعمالها في شيفرةٍ إنتاجيّة. يُعيد التّابع Document.getAnimations()‎ مصفوفةً بجميع الكائنات من النّوع Animation التي تعمل حاليًا، والتي عناصرها الهدَفُ هي من أولاد (عناصر سليلة) المُستند. هذه المصفوفة تشمل تحريكات CSS و تأثيرات الانتقال في CSS وتحريكات الويب. البنية العامة var allAnimations = Document.getAnimations(); المعاملات لا توجد معاملات. القيمة المعادة مصفوفةٌ عناصِرها كائناتٌ من النّوع Animation، كل منها يُمثّل تحريكًا واحدًا مرتبطًا بالعناصر الأولاد للمُستند الذي استُدعَى عليه التّابع. أمثلة سيُبطئ المثال ...

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

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

التصريح عن دالة غير متزامنة (asynchronous function declaration) يُعيد كائنًا من النوع AsyncFunction، يمكن أيضًا إنشاء الدوال غير المتزامنة عبر تعابير تعريف الدوال غير المتزامنة (async function expression). البنية العامة async function name([param[, param[, ... param]]]) { statements } name اسم الدالة param اسم الوسيط المُرَّر إلى الدالة. statements التعابير البرمجية التي تُشكِّل جسم الدالة. القيمة المعادة كائن AsyncFunction الذي يُمثِّل الدالة غير المتزامنة ويُنفِّذ الشيفرة الموجودة ضمنها. الوصف عندما تُستدعى دالة غير متزامنة، فستعيد كائن Promise، وعندما تُعيد ...

يغطي هذا الدليل دمج ريلز مع Rack والتفاعل مع مكونات Rack الأخرى. بعد قراءة هذا الدليل، ستتعلم: كيفية استخدام برمجيات Rack الوسيطة في تطبيقات ريلز الخاصة بك. حزمة البرمجيات الوسيطة الداخلية لـ Action Pack. كيفية تعريف مكدس برنامج وسيط مخصص (custom Middleware stack). تحذير: يفترض هذا الدليل معرفة عملية ببروتوكول Rack وبمفاهيم Rack مثل البرمجيات الوسيطة (middlewares) وخرائط url و Rack::Builder. مقدمة إلى Rack يوفر Rack واجهة دنيا، ومركبة من وحدات، وقابلة للتهيئة لتطوير تطبيقات الويب في روبي. من خلال ...

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

تُمثّل الواجهة Document أي صفحة ويب مُحمّلة في المُتصفح وتعمل كنُقطة بداية للوصول إلى مُحتوى الصّفحة، أي شجرة DOM التي تشمل عناصر مثل <body> و <table>، إضافة إلى العديد من العناصر الأخرى. وتُوفِّر إمكانيّة التّعامل بشكل عمومي للمُستند، مثل كيفيّة الحصول على عنوان URL الخاصّ بالصّفحة وكيفيّة إنشاء عناصر جديدة في المُستند. تصِفُ الواجهة Document الخصائص (properties) والتّوابع (methods) الشّائعة لأي نوع كان من المُستندات. واعتمادًا على نوع المُستند (مثل HTML، و XML، و SVG وغيرها)، يُمكن أن تتوفّر واجهة ...

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

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

الخاصيّة Document.onfullscreenerror مُعالِج أحداثٍ للحدث fullscreenerror ويُطلَق عندما يلِج مُستند غير قابل لذلك إلى وضع ملء الشّاشة. البنية العامة targetDocument.onfullscreenerror = fullscreenErrorHandler; مثال document.onfullscreenerror = function ( event ) { console.log("لا يُمكن الولوج إلى وضع ملء الشّاشة") }; // سيفشَل استدعاء التّابع // requestFullscreen() // لأنّه خارج مُعالجِ أحداث document.documentElement.requestFullscreen(); دعم المتصفحات الميزة Chrome Internet Explorer Firefox Opera Safari الدعم الأساسي 45 47 وراء full-screen-api.unprefix.enabled ؟ ؟ ؟ انظر أيضًا fullscreenerror Document.onfullscreenchange مصادر ومواصفات مواصفة Fullscreen API

التوجيه الأساسي تقبل أغلب مسارات Laravel الأساسيّة مُتغّيرين: رابط URI  و نطاق مغلق Closure مما يُوفّر طريقة بسيطة ومعبّرة جدّا لتعريف المسارات (routes): Route::get('foo', function () { return 'Hello World'; }); ملفات المسار الإفتراضيّة كل مسارات Laravel مُعرّفة في ملفات مساراتك الموجودة في المجلّد routes. يُحمّل إطار العمل كل هذه الملفّات تلقائيًا. يعرّف الملف routes/web.php كل المسارات المُخصّصة لواجهة الويب. مجموعة البرمجيّات الوسيطة web معيّنة على كل المسارات وتوفّر خاصيّات مثل حالة الجلسة (session state) والحماية CSRF. المسارات ...

الخاصيّة Document.onfullscreenchange مُعالِج أحداثٍ للحدث fullscreenchange الذي يُطلَق عندما يلِج أو يخرج مُستندٌ من وضع ملء الشّاشة. البنية العامة targetDocument.onfullscreenchange = fullscreenChangeHandler; مثال document.onfullscreenchange = function ( event ) { console.log("هناك تغيّر في وضع ملء الشّاشة") }; document.documentElement.onclick = function () { // يجب استدعاء التّابع // requestFullscreen() // داخل مُعالج أحداث لكي لا يفشَل استدعاؤه document.documentElement.requestFullscreen(); } دعم المتصفحات الميزة Chrome Internet Explorer Firefox Opera Safari الدعم الأساسي 45 47 وراء full-screen-api.unprefix.enabled ؟ ؟ ؟ ...

تنبيه: هذه الميّزة غير قياسية وليست متواجدة على مسار قياسيات. لا تستعملها في المواقع الإنتاجية: إذ لن تعمل لجميع المُستخدمين. وقد تكون هناك عدّة حالات من عدم التوافقيّة بين المتصفحات وقد تتغيّر طريقة تصرّف الميّزة في المُستقبل. الدالة البانية Document تُنشئ كائنًا جديدًا من النوع Document، وهو صفحة ويب مُحمّلة في المُتصفّح، ويَعمل كنقطة بداية للوصول إلى مُحتوى الصّفحة. البنية العامة var document = new Document() المعاملات لا توجد معاملات. دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم ...

توفر الوحدة url مجموعة من الأدوات لمعالجة وتحليل عناوين الويب (URL). يمكن استيراد الوحدة والبدء باستخدامها عبر تنفيذ: ‎‎const url = require('url'); سلاسل العناوين والكائِن URL سلسلة العنوان (URL String) هي سلسلة نصيّة مُنظمة مؤلَّفة من عدِّة مكوِّنات. يُعاد الكائِن URL، عند تحليل سلسلة العنوان، مقرونًا بخاصيّات تُمثِّل مكوِّنات سلسلة العنوان المُختلفة. توفر الوحدة url واجهتين برمجيّتين للتعامل مع عناوين الويب: واجهة قديمة خاصّة ببيئة Node.js، وأخرى جديدة تُطبِّق معيار WHATWG المُستخدَم في مُتصفحات الويب (سنستخدم عبارة "الواجهة الحديثة" للإشارة ...

مُلاحظة: هذه الخاصيّة تجريبيّة، انظر جدول دعم المتصفحات قبل استعمالها في شيفرةٍ إنتاجيّة. الخاصيّة Document.onselectionchange مُعالِج أحداثٍ للحدث selectionchange الذي يُطلَق عندما يتغيّر تظليل الكائن. البنية العامة obj.onselectionchange = function; المُتغيّر function هي دالّة عرّفها المُستخدم user-defined، دون اللاحقة () أو أية مُعاملات، أو تعريفٌ لدالّةٍ مجهولة (anonymous function). مثال document.onselectionchange = function() { console.log("لقد تغيّر التّظليل"); }; دعم المتصفحات الميزة Chrome Internet Explorer Edge Firefox Opera Safari الدعم الأساسي 49 ؟ نعم 45 ؟ ؟ انظر أيضًا selectionchange selectstart ...

في مُستندات HTML، يُنشئُ التّابع Document.createElement()‎ عنصرَ HTML المُحدّد عبر المُعامل tagName الذي يُمثّل اسم الوسم، أو يُنشئ كائنا من النّوع HTMLUnknownElement إن لم يُتعرَّف على اسم الوسم tagName. البنية العامة var element = document.createElement(tagName[, options]); المعاملات tagName سلسلةٌ نصيّةٌ تُحدّد نوع العنصر المرغوب إنشاؤه. قيمة nodeName الخاصّة بالعنصر المُنشأ تُحدَّد من قيمة tagName. لا تَستعمِل الأسماء الموصوفة (مثل "html:a") مع هذا التّابع. عندما يُستدعى التّابع على مُستند HTML، فستُحوَّل قيمة tagName إلى أحرف صغيرة (lower case) قبل إنشاء العنصر. ...

يشير التّابع Document.queryCommandSupported‎()‎ إلى ما إذا كان أمر التّحرير المعطى مدعومًا من طرف المتصفّح أم لا. البنية العامة isSupported = document.queryCommandSupported(command); command الأمر المرغوب التّعرّف على ما إذا كان مدعومًا أم لا. القيمة المعادة قيمة منطقيّة من النّوع Boolean تكون true إن كان الأمر مدعومًا وتكون false إن لم يكن كذلك. مثال var flg = document.queryCommandSupported("SelectAll"); if(flg) { // نفّذ عمليّةً ما } ملاحظات يعيد الأمر 'paste' القيمة false في حالة لم يكن الأمر متاحًا إضافةً إلى حالة كون السكربت المستدعي ...

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

ستتعرف في هذا الدليل على كيفية عمل Action Cable وكيفية استخدام WebSockets لدمج ميزات الوقت الفعلي في تطبيق ريلز. بعد قراءة هذا الدليل، ستتلعم: ماهية Action Cable وكيفية دمج الواجهة الخلفية والأمامية الخاصة به. كيفية إعداد Action Cable. كيفية إعداد القنوات. النشر وإعداد المعمارية لتشغيل Action Cable. المقدمة يدمج Action Cable مقابس الويب WebSockets مع باقي تطبيق ريلز بسلاسة. يسمح ذلك بكتابة الميزات في الوقت الحقيقي في روبي بنفس الأسلوب والشكل كبقية تطبيقات ريلز، مع الاستمرار في الأداء وقابلية التطوير. ...

يُعيد التّابع Document.querySelector()‎ أول كائنٍ من النّوع Element الذي يُمثّل العنصر المُوافِق للمُحدِّد أو المحدّدات المعطاة. ويُعيد القيمة null في حالة لم يجِد أيّ عنصر. مُلاحظة: يتمّ البحث باستعمال المرور على العمق أولًا قبل التّرتيب (depth-first pre-order traversal) حول عقد المستند بدايةً من أول عنصر في هيكل المستند ويُكرّر (iterating) حول العقد في القائمة مرتّبةً حسب عدد العقد الأبناء. البنية العامة element = document.querySelector(selectors); selectors‎ سلسلة نصيّة من النّوع DOMString تحتوي على مُحدّد واحدٍ أو أكثر لمُوافقته مع عناصر المستند ...

يُستعمَل العنصر <audio> لتضمين المحتوى الصوتي في المستندات، وقد يحتوي على ملف مصدري واحد أو أكثر التي تُمثَّل باستخدام الخاصية src أو عبر العنصر <source>، وسيختار المتصفح أنسب الملفات الصوتية لتشغيلها. المثال الآتي يستخدم العنصر <audio> مع الخاصية autoplay لتشغيل الصوت تلقائيًا مع تحديد رابط URL للملف المصدري عبر الخاصية src: <audio src="khamsat.mp3" autoplay> لا يدعم متصفحك العنصر <code>audio</code>. </audio> أما المثال الآتي ففيه العنصر <audio> مع استخدام خاصية controls لإضافة أزرار للتحكم بالمقطع، وسيُحدَّد رابط URL للمقطع عبر العنصر <source>: ...

تُعيد الخاصية Document.fullscreenElement القابلة للقراءة فقط العنصر Element الذي في وضع ملء الشاشة حاليًا ضمن عناصر المستند الحالي، أو تُعيد القيمة null في حالة لم يكن وضع ملء الشاشة مُفعلًا. ورغم أن هذه الخاصية قابلة للقراءة فقط، إلا أنّها لن ترمي استثناءً عند تغيير قيمتها (حتى في نمط strict)، وستُتجاهل أية عمليّة ضبط قيمة لها. البنية العامة var element = document.fullscreenElement; ستكون قيمة المتغيّر element هي إشارةٌ إلى العنصر الموجود في وضع ملء الشاشة حاليًا، أو القيمة null في حالة ...

يشير التّابع Document.queryCommandEnabled‎()‎ إلى ما إذا كان أمر التّحرير المعطى مفعّلًا من طرف المتصفّح أم لا. البنية العامة isEnabled = document.queryCommandEnabled(command); command الأمر المرغوب التّعرّف على ما إذا كان مدعومًا أو لا. القيمة المعادة قيمة منطقيّة من النّوع Boolean تكون true إن كان الأمر مُفعّلًا وتكون false إن لم يكن كذلك. مثال var flg = document.queryCommandEnabled("SelectAll"); if(flg) { document.execCommand("SelectAll", false, null); // الأمر مُفعّل، لذا نفّذه } ملاحظات بالنّسبة للأمران 'cut' و'copy' فإنّ التّابع يعيد القيمة true فقط إن استدعيَ في ...

(PHP 4, PHP 5, PHP 7) تحمي الدالة flock()‎ ملفًا محدَّدًا أثناء إجراء عمليَّة عليه (مثل القراءة منه أو الكتابة عليه) إشارةً إلى أنَّ هذا الملف يُستعمل الآن. الوصف bool flock ( resource $handle , int $operation [, int &$wouldblock ] ) تُتيح لك هذه الدالة قفل أيَّ ملف ومنع الآخرين من القراءة منه أو الكتابة عليه وذلك أثناء إجراء عمليَّة ما على هذا الملف. يمكن استعمال هذه الدالة نظريًا على جميع الأنظمة (من ضمنها أغلب توزيعات لينكس وحتى ويندوز). كان ...

مقدمة الهدف من هذا الدليل هو تعليمك كيفيّة كتابة ملف تعريف عالي الجودة. هذا الدليل يريك أولًا توثيق واجهة برمجية (API) معيّنة مع طريقة استعمالها، ثم يشرح كيفية كتابة التصريح الملائم. هذه الأمثلة مرتبة تصاعديا حسب التعقيد، من الأبسط إلى الأعقد: المتغيرات العامة (Global Variables). الدوال العامة (Global Functions). الكائنات ذات الخاصيات. الدوال ذات الأحمال الزائدة (Overloaded Functions). الأنواع القابلة لإعادة الاستخدام (الواجهات). الأنواع القابلة لإعادة الاستخدام (أسماء الأنواع البديلة [Type Aliases]). تنظيم الأنواع. الأصناف. الأمثلة المتغيرات العامة التوثيق: يحتوي ...

مقدمة يوفّر Laravel Envoy صياغة نظيفة ومختزلة لتعريف المهام الشائعة وتشغيلها على الخوادم البعيدة (remote servers)، ويمكنك إعداد المهام بسهولة باستخدام صياغة نمط Blade للنشر، أوامر Artisan وغيرها. ويدعم Envoy في الوقت الحالي أنظمة تشغيل لينكس و ماك فقط. التثبيت ثبّت أولًا Envoy باستخدام أمر global require الخاص بالأمر Composer: composer global require laravel/envoy قد تتسبب مكتبات Composer العامة (global) في بعض الأحيان في حدوث تعارضات في الحزم، يمكنك في هذه الحالة استخدام مكتبة cgr والذي يعد بديلًا للأمر composer global ...

مقدمة يوفّر Laravel Envoy صياغة نظيفة ومختزلة لتعريف المهام الشائعة وتشغيلها على الخوادم البعيدة (remote servers)، ويمكنك إعداد المهام بسهولة باستخدام صياغة نمط Blade للنشر، أوامر Artisan وغيرها. ويدعم Envoy في الوقت الحالي أنظمة تشغيل لينكس و ماك فقط. التثبيت ثبّت أولًا Envoy باستخدام أمر global require الخاص بالأمر Composer: composer global require laravel/envoy قد تتسبب مكتبات Composer العامة (global) في بعض الأحيان في حدوث تعارضات في الحزم، يمكنك في هذه الحالة استخدام مكتبة cgr والذي يعد بديلًا للأمر composer global ...

تُعيد الخاصية Document.fullscreenEnabled القابلة للقراءة فقط كائنًا من النوع Boolean يُشير إلى ما إذا كان وضع ملء الشاشة مُتاحًا أم لا. وضع ملء الشاشة مُتاح للصفحات التي لا تحتوي على إضافات ذات نوافِذَ في أي من مُستنداتها فقط، وفي حالة كانت جميع عناصر <iframe> التي تحوي المُستند ذات خاصيّة allowfullscreen مضبوطة. ورغم أن هذه الخاصية قابلة للقراءة فقط، إلا أنّها لن ترمي استثناءً عند تغيير قيمتها (حتى في نمط strict)، وستُتجاهل أية عمليّة ضبط قيمة لها. البنية العامة var isFullscreenAvailable ...

الدالة then()‎ تعيد وعدًا Promise، وتأخذ وسيطين على الأكثر، وهما دالتا رد النداء (callback) لنجاح أو فشل الوعد. var promise1 = new Promise(function(resolve, reject) { resolve('Success!'); }); promise1.then(function(value) { console.log(value); // "Success!" }); ملاحظة: إذا كان أحد أو كلا المعاملين غير موجود، أو كان موجودًا لكنه ليس دالةً، فلن تضع الدالة then()‎ معالجًا له، لكنها لن تولِّد أي أخطاء. إذا أصبحت هنالك حالة للوعد Promise الذي استدعيت الدالة ()then عليه، ولم يكن للدالة ()then وسائط مناسبة، فسيُنشَأ وعدٌ Promise جديد دون ...

تنبيه: هذه تقنيّة تجريبيّة، انظر جدول دعم المُتصفحات قبل استعمال هذه الخاصيّة في شيفرة إنتاجيّة. تُعيد الخاصيّة القابلة للقراءة فقط timeline المُعرَّفة على الواجهة Document الخطَّ الزمني الافتراضي للمُستند الحالي. هذا الخط الزّمني كائن خاص من النوع DocumentTimeline الذي يُنشأ تلقائيا عند تحميل الصّفحة. الخطّ الزمني فريد لكل مستند ويبقى طيلة مُدّة بقاء المُستند حيًّا، ما يشمل استدعاءات التّابع document.open()‎. تُحسب القيم الزمنية لهذا الخط الزمني حسب حدّ ثابت (fixed offset) من السّاعة العموميّة بحيث يُكافئ وقتُ الصّفر (zero time) ...

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

تعدّ واجهة بوابة مخدّم الويب Web Server Gateway Interface وتختصر إلى (WSGI) واجهة معيارية بين برنامج مخدّم الويب وتطبيقات الويب المكتوبة بلغة بايثون. إن وجود واجهة معيارية يسهّل من استخدام التطبيقات التي تدعم WSGI مع العديد من مخدّمات الويب المختلفة. إن كنت ترغب في إنشاء مخدّم ويب أو إطار عمل برمجي فيتحتّم عليك حينئذ أن تحيط بكلّ تفاصيل WSGI، ولكن إن كنت ترغب في تثبيت أحد التطبيقات التي تدعم WSGI أو كتابة تطبيق ويب باستخدام إحدى أطر العمل المتوفّرة فلن ...

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

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

مقدمة حاوي خدمات 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 ...

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

توفِّر HTML عددًا من العناصر التي يمكن أن تتكامل مع بعضها لإنشاء نماذج يمكن للمستخدمين ملأها وإرسالها إلى خادوم الويب لمعالجها. العنصر الوصف <button> يُمثِّل العنصر <button> زرًا قابلًا للضغط. <datalist> يحتوي العنصر <datalist> على عناصر <option> التي تُمثِّل القيم المتوافرة لعناصر النماذج الأخرى. <fieldset> تجميع عدِّة عناصر ولافتات (<label>) ضمن نموذج في مستند HTML؛ مما يجعل نماذجك أسهل استخدامًا وأوضح. <form> تمثيل قسم في المستند الذي يحتوي على عناصر يستطيع المستخدم التفاعل معها لإرسال بيانات إلى خادوم الويب. <input> يُستخدَم العنصر <input> لإنشاء عناصر تفاعلية للنماذج في ...

تُنشئ هذه الدالة البانية معالج HTTP للطلب المعطى. لا حاجة لإنشاء نسخ من هذا الصنف بصورة مباشرة إذ أنّها تنشأ تلقائيًا حسب حاجة كائنات WSGIServer. ولكن يمكن إنشاء أصناف فرعية من هذا الصنف وتزويدها على هيئة أصناف معالجة handler_class إلى الدالة make_server()‎. البنية العامة wsgiref.simple_server.WSGIRequestHandler(request, client_address, server) ‎المعاملات request الطلب المراد إنشاء معالج HTTP له. client_address عنوان العميل، وهو عبارة عن صفّ بالصيغة (host, port). server نسخة من الصنف WSGIServer. توابع لإعادة تعريف القيم في الأصناف الفرعية get_environ()‎ يعيد التابع ...

ستتعرف في هذا الدليل على كيفية عمل وحدات التحكم (Controller) وكيفية ملاءمتها مع دورة الطلب (request cycle) في التطبيق الخاص بك. بعد قراءة هذا الدليل، ستتعلم: كيفية اتباع تدفق الطلب من خلال وحدة تحكم. كيفية تقييد المعاملات التي مُرّرت إلى وحدة التحكم الخاصة بك. كيف ولماذا تخزَّن البيانات في الجلسة (session) أو ملفات تعريف الارتباط (cookies). كيفية العمل مع المرشحات (filters) لتنفيذ التعليمات البرمجية أثناء معالجة الطلب. كيفية استخدام استيثاق HTTP المضمن في وحدة التحكم. كيفية تدفق البيانات مباشرة إلى ...

تقدم وحدة cgitb أداة خاصة للتعامل مع الاستثناءات في سكربتات بايثون. (قد يكون اسم الوحدة مضلّلًا. صمّمت هذه الوحدة في المقام الأوّل لعرض معلومات الأخطاء الخاصّة بسكربتات CGI بصيغة HTML، ولكنّها أصبحت تعرض المعلومات كنصوص صرفة في وقت لاحق). في حال حدوث استثناء لم تلتقطه بايثون، تعرض الوحدة تقريرًا مفصّلًا ومنسّقًا، ويتضمّن هذا التقرير الجزء المسؤول عن حدوث الخطأ في الشيفرة المصدرية، إضافة إلى قيم الوسائط والمتغيرات المحلية الخاصّة بالدالة الحالية. يمكن الاستفادة من هذا التقرير في تنقيح الشيفرة المصدرية ...

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

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة umask()‎ قيمة القناع umask الحاليَّة. الوصف int umask ([ int $mask ] ) تضبط هذه الدالة قيمة القناع umask في PHP إلى القيمة mask & 0777 ثمَّ تعيد قيمة umask السابقة. عندما تُستعمل PHP كوحدة من وحدات الخادم، فستُستعاد قيمة umask عند انتهاء كلِّ طلب. المعاملات mask قيمة umask الجديدة. القيم المعادة تُعاد قيمة umask الحاليَّة إن لم يُمرَّر أيُّ معامل، أو ستُعاد قيمة umask السابقة خلافًا لذلك. أمثلة المثال 1: استعمال الدالة ...