المهارات Apple HIG: Navigation Components
📦

Apple HIG: Navigation Components

آمن

تنفيذ البحث والتنقل وفق معايير Apple

احصل على تنفيذات معتمدة من Apple لحقل البحث، وعناصر التحكم بالصفحات، وعناصر التحكم بالمسار وفق إرشادات واجهة المستخدم البشرية. تأكد من أن تنقل تطبيقك يبدو أصليًا وبديهيًا عبر iOS وmacOS ومنصات Apple الأخرى.

يدعم: Claude Codex Code(CC)
📊 71 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "Apple HIG: Navigation Components". Where should search go in an iOS app with a tab bar?

النتيجة المتوقعة:

بالنسبة لتطبيقات iOS التي تحتوي على شريط تبويب، لديك ثلاث خيارات رئيسية: 1) البحث كعلامة تبويب مميزة بصريًا على الجانب اللاحق من شريط التبويب (يبقي البحث ظاهرًا دائمًا)، 2) البحث في شريط أدوات سفلي (إما حقل موسّع أو زر يتحول بحركة إلى حقل)، أو 3) البحث ضمن المحتوى. توصي Apple بالموضع السفلي عندما يكون البحث أولوية ويوجد مساحة، لأنه أسهل للوصول. ضع في اعتبارك ما إذا كان حقل البحث يجب أن يبدأ مُركّزًا (ظهور لوحة المفاتيح مباشرة) أو غير مُركّز (يعزز الاكتشاف) بناءً على أهداف تطبيقك.

استخدام "Apple HIG: Navigation Components". What's the difference between page controls and path controls?

النتيجة المتوقعة:

تعرض عناصر التحكم بالصفحات صفًا من نقاط المؤشر تمثل صفحات في تسلسل خطي مسطح (مثل شاشات الإعداد الأولي أو معارض الصور). تساعد المستخدمين على التنقل بين عناصر متكافئة في قائمة مرتبة. تعرض عناصر التحكم بالمسار مسار نظام الملفات لعنصر محدد، مع إظهار التسلسل من قرص الجذر إلى المجلدات الأب ثم العنصر الحالي. عناصر التحكم بالمسار خاصة بـ macOS وتستخدم لتصفح الملفات (مثل شريط المسار في Finder)، بينما عناصر التحكم بالصفحات مخصصة لترقيم صفحات محتوى منفصل في iOS/iPadOS.

استخدام "Apple HIG: Navigation Components". How do I add search scope tokens like in Mail?

النتيجة المتوقعة:

الرموز هي تمثيلات مرئية لمصطلحات البحث يمكن للمستخدمين تحديدها وتعديلها كمرشحات. لتنفيذ الرموز في حقل البحث: 1) حدِّد مصطلحات أو عناصر بحث شائعة (مثل جهات اتصال محددة في Mail أو مرشحات الصور في Messages)، 2) طبّق معالجة مرئية تُغلف المصطلح كعنصر قابل للتحديد، 3) اسمح للرموز بتصفية مصطلحات بحث إضافية، 4) فكّر في إقران الرموز باقتراحات بحث ليتعرف المستخدمون على الرموز المتاحة، 5) استخدم searchable APIs في SwiftUI أو UISearchTextField لدعم الرموز. توضح الرموز عمليات البحث عبر تركيزها على سمات محددة.

التدقيق الأمني

آمن
v1 • 2/25/2026

All 200 static analysis findings are false positives from pattern matching on Markdown documentation content. This skill contains only Apple Human Interface Guidelines reference documentation with no executable code. The detected 'external_commands' patterns are inline code formatting (backticks in Markdown), 'network' patterns are legitimate documentation links to developer.apple.com, and 'blocker' patterns match words in UI component names and API references. This is safe documentation content.

3
الملفات التي تم فحصها
352
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

45
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
31
المجتمع
100
الأمان
74
الامتثال للمواصفات

ماذا يمكنك بناءه

تنفيذ البحث في تطبيق iOS

يحتاج مطور iOS إلى إضافة وظيفة البحث إلى تطبيقه. يستخدم هذه المهارة لفهم ما إذا كان ينبغي وضع البحث في شريط التبويب، أو شريط الأدوات، أو ضمن المحتوى، وكيفية تنفيذ عناصر التحكم بالنطاق لتصفية النتائج.

إضافة ترقيم صفحات لمعرض الصور

يحتاج مطور يبني تطبيق معرض صور إلى عناصر التحكم بالصفحات للتنقل. يستشير هذه المهارة لمعرفة موضع عناصر التحكم بالصفحات المناسب، وتخصيص المؤشرات، والسلوكيات الخاصة بالمنصة في iOS مقابل watchOS.

تصميم متصفح ملفات macOS

يبني مطور Mac متصفح ملفات ويحتاج إلى عناصر تحكم بالمسار لتصفح فتات الخبز. يرجع إلى هذه المهارة لفهم عناصر التحكم بالمسار القياسية مقابل المنبثقة والموضع الصحيح في جسم النافذة مقابل شريط الأدوات.

جرّب هذه الموجهات

إرشادات بحث أساسية 
أين يجب أن أضع حقل البحث في تطبيق iOS؟ يحتوي التطبيق على شريط تبويب في الأسفل.
عناصر التحكم بالصفحات الخاصة بالمنصة 
كيف تختلف عناصر التحكم بالصفحات بين iOS وwatchOS؟ أنا أبني تطبيق لياقة يستهدف كلا المنصتين.
عناصر التحكم بالنطاق والرموز 
أنا أبني تطبيقًا شبيهًا بـ Mail. كيف أنفذ عناصر التحكم بالنطاق والرموز لتصفية البحث؟
تنفيذ عناصر التحكم بالمسار 
أحتاج إلى عرض تنقل تسلسل الملفات في تطبيق مستندات على macOS. هل يجب أن أستخدم عناصر تحكم بالمسار القياسية أم المنبثقة، وأين أضعها؟

أفضل الممارسات

  • ابدأ البحث فورًا عندما يكتب المستخدمون لتوفير نتائج فورية تتكرر وتتطور باستمرار بدلًا من انتظار إرسال النموذج
  • ضع حقول البحث حيث يتوقعها المستخدمون - عادةً أعلى القائمة أو شريط الأدوات أو شريط التنقل - مع نص عنصر نائب مفيد يصف ما يمكن البحث عنه
  • افترِض نطاق بحث أوسع ودع المستخدمين يضيّقونه بعناصر التحكم بالنطاق، مع توفير سياق لمجموعة النتائج الكاملة قبل التنقيح

تجنب

  • تجنب استخدام نص عنصر نائب عام مثل 'Search' في حقول البحث - فهو لا يقدم سياقًا مفيدًا حول المحتوى القابل للبحث
  • لا تستخدم عناصر التحكم بالصفحات للتنقل الهرمي - فهي مصممة فقط لتسلسلات صفحات مسطحة وخطية تكون فيها جميع الصفحات متكافئة
  • لا تضع عناصر التحكم بالمسار أبدًا في أشرطة الأدوات أو أشرطة الحالة - مكانها في جسم النافذة، مثل شريط المسار في Finder أسفل النافذة

الأسئلة المتكررة

ما المنصات التي تغطيها هذه المهارة؟
تغطي هذه المهارة جميع منصات Apple: iOS وiPadOS وmacOS وtvOS وwatchOS وvisionOS. توثق اعتبارات وسلوكيات خاصة بكل منصة لحقول البحث وعناصر التحكم بالصفحات وعناصر التحكم بالمسار عند الاقتضاء.
هل توفر هذه المهارة أمثلة شيفرة؟
لا، هذه المهارة تقدم إرشادات تصميم وأفضل ممارسات من Apple Human Interface Guidelines. تشير إلى توثيق API الرسمي من Apple لتطبيقات SwiftUI وUIKit لكنها لا تولد الشيفرة بنفسها.
ما الفرق بين عناصر التحكم بالنطاق والرموز؟
عناصر التحكم بالنطاق هي عناصر تحكم مجزأة تتيح للمستخدمين اختيار فئة البحث قبل أو أثناء البحث (مثل All مقابل Current mailbox في Mail). الرموز هي تمثيلات مرئية لمصطلحات بحث محددة تعمل كمرشحات (مثل التصفية حسب جهة اتصال محددة). يمكنك استخدامهما معًا لتصفية بحث قوية.
متى يجب أن أستخدم البحث المُركّز مقابل غير المُركّز في شريط التبويب؟
استخدم البحث المُركّز (تظهر لوحة المفاتيح فورًا) عندما تريد تجارب بحث سريعة وعابرة. استخدم البحث غير المُركّز (يظهر الحقل لكن لوحة المفاتيح تنتظر) لتعزيز الاكتشاف والاستكشاف، خاصة في التطبيقات ذات مجموعات المحتوى الكبيرة مثل Music أو TV.
هل يمكنني استخدام عناصر التحكم بالمسار على iOS؟
لا، عناصر التحكم بالمسار خاصة بـ macOS وفقًا لـ HIG من Apple. لتنقل تسلسل الملفات في iOS، فكّر في استخدام navigation controllers أو tab bars أو sidebars بدلًا من ذلك لتمثيل العلاقات الهرمية.
كم عدد مؤشرات الصفحات التي يعد كثيرًا؟
توصي Apple بتجنب أكثر من نحو 10 مؤشرات صفحات لأنها تصبح صعبة العد بنظرة سريعة. إذا كان تطبيقك يحتاج إلى أكثر من 10 صفحات كعناصر متكافئة، ففكّر في ترتيب مختلف مثل شبكة تتيح للناس التنقل في المحتوى بأي ترتيب.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

المستودع

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/hig-components-search

مرجع

main

بنية الملفات

📁 references/

📄 page-controls.md

📄 path-controls.md

📄 search-fields.md

📄 SKILL.md