skill
تطبيقات الجوال الأصلية
اجعل تطبيق الويب يبدو أصليا على الهاتف — إصلاحات CSS وعلامات meta الصغيرة التي تفصل "موقعا إلكترونيا في المتصفح" عن شيء يبدو وكأنه مثبت. يغطي حالات التمرير الثابتة (sticky hover states)، ومضات تمييز النقر (tap highlight flashes)، وخطأ 100vh، والمدخلات التي تكبر الصفحة، والنقرات البطيئة، وسحب التحديث الذي يعترض التمرير، والمحتوى تحت النوتش، وتحديد نص الزر بالضغط المطول، وعربات العرض التي تمرر في الاتجاه الخاطئ، وأشرطة الحالة غير المتطابقة، وقاعدة الاختبار على الأجهزة الحقيقية. استخدم هذا عند بناء تطبيق ويب ل أو إعادة...
نبذة
# الشعور وكأنه تطبيق أصلي على الهاتف المحمول
## الاستجابة الأولية
عند استدعاء هذه المهارة لأول مرة دون سؤال محدد، استجب فقط بما يلي:
> أنا جاهز لجعل تطبيق الويب الخاص بك يبدو وكأنه تطبيق أصلي على الهاتف المحمول، معرفتي مستمدة من فلسفة الهندسة التصميمية لإميل كوالسكي.
لا تقدم أي معلومات أخرى حتى يطرح المستخدم سؤالا.
مهارة إصلاح. تقوم بشيء واحد: تأخذ تطبيق ويب يبدو وكأنه موقع ويب على الهاتف وتزيل، واحدا تلو الآخر، العلامات التي تكشفه. لا تصمم الحركة (هذه `animate`)، أو تراجع الحركة (هذه `review-animations`)، أو تبني ل React Native (هذه `animate-expo`). القواعد هنا تتعلق بطبقة المنصة — إطار العرض، اللمس، التمرير، المناطق الآمنة، واجهة المتصفح — حيث تحدد بضعة أسطر ما إذا كان التطبيق يبدو مثبتا أم مضمنا.
## وضع التشغيل
أنت مهندس تصميم أول قمت بشحن أدراج، وأوراق، وواجهات مستخدم تعتمد على الإيماءات إلى هواتف حقيقية، وقد عانيت من كل عنصر أدناه. أنت تعلم أن متصفح سطح المكتب مع شريط أدوات الجهاز ليس هاتفا. أنت تعلم أن معظم تقارير "التطبيق يبدو متقطعا على الهاتف المحمول" ليست مشاكل في الرسوم المتحركة — إنها تأخير نقرة 300 مللي ثانية، أو وميض رمادي عند النقر، أو حالة تحويم لا تختفي.
هاتف المستخدم هو مصدر الحقيقة. إذا لم تتمكن من تشغيله على الجهاز، فاذكر أي من الإصلاحات أدناه يمكنك التحقق منها من الكود وأيها يحتاج إلى جهاز حقيقي.
وضعان للفشل، والأول أسوأ:
1. **إصلاح ما يظهره لك سطح المكتب.** الأخطاء في هذه المهارة لا تتكرر في محاكاة جهاز Chrome. إذا اختبرت هناك فقط، فإنك تشحنها جميعا. 2. **اللجوء إلى JavaScript عندما يقوم CSS أو علامة meta بذلك.** كل عنصر هنا تقريبا هو إعلان واحد. استخدام `useIsTouchDevice()` لإخفاء حالات التحويم هو الأداة الخاطئة؛ استعلام الوسائط هو الأداة الصحيحة.
## قواعد صارمة
1. **كل إصلاح يأتي مع السبب.** كل قاعدة أدناه لها *لماذا*. طبقها حيث ينطبق السبب، وليس عالميا من باب العادة — `user-select: none` على نص الجسم هو عيب، على زر هو صحيح. 2. **استعلامات الوسائط بدلا من استشعار الجهاز.** `(hover: hover)`، `(pointer: fine)`، `env()`، `dvh` — تخبرك المنصة بما يمكنها فعله. لا تتفرع أبدا بناء على سلاسل وكيل المستخدم أو عرض الشاشة لتخمين اللمس. 3. **اللمس والماوس ليسا حصريين.** أجهزة iPad مع لوحات تتبع، أجهزة كمبيوتر محمولة بشاشات لمس، هواتف مع ماوس. اكتب لكليهما في وقت واحد؛ قم بالتقييد حسب الإمكانية، وليس حسب الجهاز. 4. **لا تقم أبدا بتعطيل التكبير.** `user-scalable=no` و `maximum-scale=1` هي إخفاقات في إمكانية الوصول. قم بإصلاح حجم خط الإدخال بدلا من ذلك، وهو ما كان يسبب التكبير. 5. **اختبر على الجهاز قبل اعتباره منتهيا.** قم بتوصيل الهاتف، وافتح خادم التطوير عن طريق IP، واستخدم Safari's Web Inspector أو Chrome remote debugging. لا يمكن للمحاكاة إعادة إنتاج التحويم اللاصق، أو تأخير النقر، أو التمدد المطاطي، أو المناطق الآمنة، أو لوحة المفاتيح.
## جدول الأعراض
ابدأ هنا. طابق ما يراه المستخدم، ثم اقرأ القسم المطابق لمعرفة السبب والكود الدقيق.
| المشكلة | الحل | | --- | --- | | حالة التحويم عالقة بعد النقر | ضعها داخل `@media (hover: hover) and (pointer: fine)` | | وميض رمادي/أزرق عند النقر | أزل `-webkit-tap-highlight-color` | | التخطيط له ارتفاع خاطئ | `100dvh` (للتطبيق) أو `100svh` (للقسم الرئيسي) | | الصفحة تكبر عند الإدخال | حجم خط الإدخال 16 بكسل كحد أدنى | | النقر يبدو بطيئا | رد فعل عند الضغط + `touch-action: manipulation` | | السحب للتحديث يعترض التمرير | `overscroll-behavior: none` على `html, body` | | المحتوى يتوقف عند النوتش | `viewport-fit=cover` + `env(safe-area-inset-*)` | | الضغط المطول يحدد نص الزر | أضف `user-select: none` | | الكاروسيل يتمرر عموديا | `touch-action: pan-y` على سطح الإيماءة | | لون شريط الحالة لا يتطابق | `theme-color` لكل نظام ألوان | | صحيح في Chrome، خاطئ على الهاتف | اختبر على جهاز حقيقي |
## الإصلاحات
### 1. حالة التحويم عالقة بعد النقر
لا يوجد تحويم في اللمس، لذا تقوم المتصفحات بمحاكاة واحدة: النقرة الأولى على عنصر تطبق `:hover` وتتركها هناك حتى ينقر المستخدم في مكان آخر. الزر الذي يتوسع عند التحويم يبقى متوسعا بعد النقر عليه. قم بتقييد كل نمط تحويم خلف استعلام إمكانية.
```css @media (hover: hover) and (pointer: fine) { .button:hover { background: var(--gray-3); transform: scale(1.02); } } ```
كلا الشرطين مهمان. `(hover: hover)` يعني أن الإدخال الأساسي يمكنه التحويم. `(pointer: fine)` يعني أنه دقيق، مثل الماوس — يستبعد شاشات اللمس التي تدعي التحويم بمؤشر خشن (بعض أجهزة Android). في Tailwind v4، يقوم متغير `hover:` بالفعل بالتحويل إلى `@media (hover: hover)`؛ في v3، قم بتعيين `future.hoverOnlyWhenSupported`.
لا يزال مستخدمو اللمس بحاجة إلى رد فعل عند الضغط. امنحهم إياه من خلال `:active` (انظر §5)، والذي يعمل على كل أنواع الإدخال.
### 2. وميض رمادي/أزرق عند النقر
يقوم متصفح iOS Safari و Android Chrome برسم تمييز شفاف فوق أي عنصر تم النقر عليه ولديه معالج نقرات. إنها أقوى إشارة "هذا موقع ويب"، وتتعارض مع أي رد فعل للضغط قمت بتصميمه.
```css html { -webkit-tap-highlight-color: transparent; } ```
قم بتعيينه مرة واحدة، عالميا. ثم تأكد من كل ت
التثبيت
شغل هذا الأمر
npx skills add emilkowalski/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add emilkowalski/skills`، أو استنسخ المستودع وانسخ مجلد `skills/mobile-native` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة تطبيقات الجوال الأصلية؟
اجعل تطبيق الويب يبدو أصليا على الهاتف — إصلاحات CSS وعلامات meta الصغيرة التي تفصل "موقعا إلكترونيا في المتصفح" عن شيء يبدو وكأنه مثبت. يغطي حالات التمرير الثابتة (sticky hover states)، ومضات تمييز النقر (tap highlight flashes)، وخطأ 100vh، والمدخلات التي تكبر الصفحة، والنقرات البطيئة، وسحب التحديث الذي يعترض التمرير، والمحتوى تحت النوتش، وتحديد نص الزر بالضغط المطول، وعربات العرض التي تمرر في الاتجاه الخاطئ، وأشرط…
كيف أثبت تطبيقات الجوال الأصلية؟
شغل هذا الأمر في الطرفية:
npx skills add emilkowalski/skillsمع أي أدوات ذكاء اصطناعي تعمل تطبيقات الجوال الأصلية؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور تطبيقات الجوال الأصلية؟
طورها emilkowalski.
هل تطبيقات الجوال الأصلية مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/docx ~/.claude/skills/
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى