SHSearchBar

SHsearchBar

شريط البحث النظيف واللامع الذي يفعل ما يفعله UISearchBar فقط مع الاختراقات القذرة. تم تصميم طريقة العرض هذه لمعالجة حدود التخصيص الخاصة بـ UISearchBar. الفرق هنا هو أن هذه الفئة لا ترث UISearchBar ولكنها تقوم بتكوين كائن UIView جديد باستخدام UITextField وهو أسهل بكثير في الاستخدام. هذه هي حدود UISearchBar:

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

نظرًا لأنني أستخدم UITextField، فإن هذه القيود لا تنطبق.

تثبيت

مدير الحزم سويفت

في Xcode، افتح قائمة الأهداف وحدد مشروعك. انقر فوق علامة التبويب Swift Packages وهناك أيقونة + الصغيرة. أدخل عنوان URL لهذا المستودع، وحدد الإصدار الذي تريد تثبيته - عادةً ما يكون الإعداد المسبق جيدًا - وقم بالتأكيد.

كاكاوبودس

نظرًا لأن SHSearchBar يستخدم موارد محلية، فقد قمت بإسقاط دعم CocoaPods لصالح SPM من الإصدار 2.0.0 . الرجاء دمج الحزمة عبر SPM (انظر أعلاه).

قرطاج

نظرًا لأن SHSearchBar يستخدم موارد محلية، فقد أسقطت دعم Carthage لصالح SPM من الإصدار 2.0.0 . الرجاء دمج الحزمة عبر SPM (انظر أعلاه).

أمثلة

يتضمن الريبو مشروع مثال. يعرض حالات الاستخدام المختلفة لشريط البحث. لتشغيله، فقط قم بفتح وتشغيل ./Example/SHSearchBarExample.xcodeproj . الصور التالية توضح بعض حالات الاستخدام:

يمكنك إظهار عنصر نائب مخصص مثل حقول النص العادية:

ويمكنك أيضًا كتابة نص في شريط البحث هذا:

واو، هناك طرق عرض ملحقة قابلة للتخصيص أيضًا:

قم بتخصيص النص وزر الإلغاء بسهولة كما تريد:

يمكنك تخصيص نصف قطر كل زاوية من حقل النص بحيث تصبح التخطيطات مثل هذه سهلة:

يدعم حقل النص الداخلي نظام التشغيل iOS 10 الجديد "textContentMode":
(إعادة استخدام العنوان الذي تم البحث عنه في خرائط Apple من قبل)

يمكنك استخدام شريط البحث داخل UINavigationBar:

توثيق الكود

يتم إنشاء وثائق الكود واستضافتها بواسطة Swift Package Index (المدعوم من DocC)

يطلق

لإصدار حزمة Swift هذه، يجب اتخاذ الخطوات التالية:

• قم بإنشاء فرع جديد release-xyz
• قم بتشغيل bash <(curl -H -s https://raw.githubusercontent.com/Blackjacx/Scripts/master/frameworks/bootstrap.sh) للتحديث إلى أحدث ملفات التطوير المشتركة
• قم بتشغيل bundle update لتحديث جميع جواهر روبي
• قم بإجراء جميع التغييرات، وقم بإجراء العلاقات العامة ودمجها للتطوير
• قم بتشغيل bundle exec fastlane release framework:"SHSearchBar" version:"xyz" لإصدار الإصدار الجديد
• قم بنشر ما يلي على تويتر

 SHSearchBar release x.y.z ?

▸   SHSearchBar (x.y.z) successfully published
▸ ?  September 2nd
▸ ?  https://swiftpackageindex.com/Blackjacx/SHSearchBar
▸ ?  https://github.com/Blackjacx/SHSearchBar/releases/latest
▸ ?  Tell your friends!

#spm #search #ios #apple #xcode #uisearchbar #swiftpackagemanager

مساهمة

• إذا وجدت خطأ ، يرجى فتح قضية .
• إذا كان لديك طلب ميزة ، يرجى فتح قضية .
• إذا كنت ترغب في المساهمة ، يرجى تقديم طلب سحب .

مؤلف

ستيفان هيرولد • ? @بلاك جاككسكس

المساهمين

شكرا لكم جميعا الذين هم جزء من هذا:

رخصة

SHSearchBar متاح بموجب ترخيص MIT. راجع ملف الترخيص لمزيد من المعلومات.