skill

تطبيقات الجوال الأصلية

اجعل تطبيق الويب يبدو أصليا على الهاتف — إصلاحات CSS وعلامات meta الصغيرة التي تفصل "موقعا إلكترونيا في المتصفح" عن شيء يبدو وكأنه مثبت. يغطي حالات التمرير الثابتة (sticky hover states)، ومضات تمييز النقر (tap highlight flashes)، وخطأ 100vh، والمدخلات التي تكبر الصفحة، والنقرات البطيئة، وسحب التحديث الذي يعترض التمرير، والمحتوى تحت النوتش، وتحديد نص الزر بالضغط المطول، وعربات العرض التي تمرر في الاتجاه الخاطئ، وأشرطة الحالة غير المتطابقة، وقاعدة الاختبار على الأجهزة الحقيقية. استخدم هذا عند بناء تطبيق ويب ل أو إعادة...

emilkowalski132,052+ تثبيتموثوق

نبذة

# الشعور وكأنه تطبيق أصلي على الهاتف المحمول

## الاستجابة الأولية

عند استدعاء هذه المهارة لأول مرة دون سؤال محدد، استجب فقط بما يلي:

> أنا جاهز لجعل تطبيق الويب الخاص بك يبدو وكأنه تطبيق أصلي على الهاتف المحمول، معرفتي مستمدة من فلسفة الهندسة التصميمية لإميل كوالسكي.

لا تقدم أي معلومات أخرى حتى يطرح المستخدم سؤالا.

مهارة إصلاح. تقوم بشيء واحد: تأخذ تطبيق ويب يبدو وكأنه موقع ويب على الهاتف وتزيل، واحدا تلو الآخر، العلامات التي تكشفه. لا تصمم الحركة (هذه `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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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.

هل تطبيقات الجوال الأصلية مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في إنشاء المحتوى.

كل بدائل تطبيقات الجوال الأصلية ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/docx ~/.claude/skills/
ملف Docx
استخدم هذه المهارة كلما أراد المستخدم إنشاء مستندات Word (ملفات ‎.docx) أو قراءتها أو تعديلها أو معالجتها، أو قوالب Word (ملفات ‎.dotx). تشمل المحفزات…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
إعداد مهارات مات بوكوك
قم بتهيئة هذا المستودع لمهارات الهندسة: إعداد متتبع المشكلات الخاص به، ومفردات تصنيف الفرز، وتخطيط مستندات النطاق. يتم تشغيله مرة واحدة قبل الاستخدام…1,076,003+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء مع المستندات
مقابلة مكثفة لصقل خطة أو تصميم، والتي تنشئ أيضا وثائق (ADR's ومسردا) أثناء تقدمنا.1,062,214+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
Hyperframes الأساسية
عقد تركيب HyperFrames — أنشئ مشروعا واحدا قابلا للتقديم. استخدمه لهيكل التركيب، وسمات التوقيت `data-*`، و`class="clip"`، والمسارات، والتركيبات الفرعية…876,697+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
بحث
ابحث في سؤال مقابل مصادر أولية موثوقة للغاية وقم بتوثيق النتائج كملف Markdown في المستودع. استخدم هذا عندما يرغب المستخدم في البحث عن موضوع، أو جمع حق…756,925+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
نمذجة النطاق
لبناء وصقل النموذج النطاقي للمشروع. يستخدم عند مناقشة مصطلحات قاعدة الكود، أو كتابة أو تعديل ملف GLOSSARY.md، أو تسجيل أو تعديل ADR.747,767+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في إنشاء المحتوى