Alpine.js

انتقل إلى مستندات Alpine لمعظم الأشياء: مستندات Alpine

أنتم مدعوون لتقديم تحديثات للمستندات عن طريق إرسال العلاقات العامة إلى هذا الريبو. توجد المستندات في الدليل /packages/docs .

ابق هنا للحصول على المعلومات المتعلقة بالمساهمة.

هل تبحث عن مستندات V2؟ ها هم

أنماط مكونات جبال الألب

دليل المساهمة:

بداية سريعة

استنساخ هذا الريبو محليا
قم بتشغيل npm install و npm run build
قم بتضمين الملف /packages/alpinejs/dist/cdn.js من علامة <script> على صفحة ويب وستكون جاهزًا للبدء!

جولة قصيرة

يمكنك تثبيت كل شيء باستخدام: npm install في الدليل الجذر لهذا الريبو بعد استنساخه محليًا.

هذا الريبو هو "أحادي الريبو" باستخدام مساحات عمل npm لإدارة الحزم. تحتوي كل حزمة على مجلد خاص بها في الدليل /packages .

بدلاً من الاضطرار إلى تشغيل إصدارات منفصلة لكل حزمة، يتم التعامل مع جميع حزم الحزم بنفس الأمر: npm run build

فيما يلي نظرة سريعة على كل حزمة في هذا الريبو:

طَرد	وصف
com.alpinejs	الريبو الرئيسي لجبال الألب مع كل قلب جبال الألب
ينهار	مكون إضافي لتوسيع العناصر وطيها باستخدام الرسوم المتحركة السلسة
csp	الريبو لتوفير بناء "CSP آمن" لـ Alpine
مستندات	وثائق جبال الألب
ركز	مكون إضافي يسمح لك بإدارة التركيز داخل العنصر
تاريخ	مكون إضافي لربط البيانات للاستعلام عن معلمات السلسلة باستخدام واجهة برمجة تطبيقات السجل (من المرجح أن يتغير الاسم)
تتقاطع	مكون إضافي لتشغيل تعبيرات JS بناءً على العناصر المتقاطعة مع إطار العرض
قناع	مكون إضافي لتنسيق حقل إدخال النص تلقائيًا أثناء قيام المستخدم بالكتابة
يتحول	مكون إضافي لتحويل HTML (مثل morphdom) داخل الصفحة بذكاء
تستمر	مكون إضافي لاستمرار حالة جبال الألب عبر عمليات تحميل الصفحة

يتم تخزين ملفات JS المترجمة (نتيجة تشغيل npm run [build/watch] ) ليتم تضمينها كعلامة <script> على سبيل المثال في دليل packages/[package]/dist الخاص بكل حزمة.

يجب أن تحتوي كل حزمة على الأقل على: بنية "cdn" تتم تهيئتها ذاتيًا ويمكن تضمينها باستخدام سمة src في علامة <script defer> ، module.[esm/cjs].js يُستخدم للاستيراد كوحدة JS (cjs للعقدة، esm لكل شيء آخر).

يتم التعامل مع حزمة Alpine V3 حصريًا بواسطة ESBuild. يتم تخزين كافة التكوينات لهذه الإصدارات في ملف scripts/build.js .

اختبار

هناك أداتان اختبار مختلفتان مستخدمتان في هذا الريبو: Cypress (لاختبارات التكامل)، وJest (لاختبارات الوحدة).

يتم تخزين جميع الاختبارات داخل المجلد /tests ضمن /tests/cypress و /tests/jest .

يمكنك تشغيلهما من سطر الأوامر باستخدام: npm run test

إذا كنت ترغب فقط في تشغيل cypress وفتح واجهة المستخدم الخاصة به (موصى به أثناء التطوير)، فيمكنك تشغيل: npm run cypress

إذا كنت ترغب في تشغيل اختبارات Jest فقط، فيمكنك تشغيل npm run jest مثل الاختبارات العادية واستهداف اختبارات محددة. يمكنك تحديد خيارات تكوين سطر الأوامر لإعادة التوجيه إلى أمر jest باستخدام -- كما يلي: npm run jest -- --watch

يوسع

معلومات إضافية