SHSearchBar

SHSearchBar

Чистая и блестящая панель поиска, которая делает то, что UISearchBar делает только с грязными хаками. Это представление предназначено для устранения ограничений настройки UISearchBar. Разница здесь в том, что этот класс не наследует UISearchBar, а создает новый объект UIView, используя UITextField, который гораздо проще в использовании. Это ограничения UISearchBar:

• нет чистого способа выровнять заполнитель по левому краю
• кнопку отмены сложно адаптировать под ваши нужды
• как правило, внешний вид не настраивается (например, шрифт текста)
• наблюдается странное поведение при установке собственного фонового изображения

Поскольку я использую UITextField, эти ограничения не применяются.

Установка

Менеджер пакетов Swift

В Xcode откройте целевой список и выберите свой проект. Перейдите на вкладку Swift Packages и там появится маленький значок + . Введите URL-адрес этого репозитория, выберите версию, которую хотите установить (обычно с предустановкой все в порядке), и подтвердите.

Какао-стручки

Поскольку SHSearchBar использует локализованные ресурсы, я отказался от поддержки CocoaPods в пользу SPM с версии 2.0.0 . Пожалуйста, интегрируйте пакет через SPM (см. выше).

Карфаген

Поскольку SHSearchBar использует локализованные ресурсы, я отказался от поддержки Carthage в пользу SPM с версии 2.0.0 . Пожалуйста, интегрируйте пакет через SPM (см. выше).

Примеры

Репозиторий включает пример проекта. Он показывает различные варианты использования панели поиска. Чтобы запустить его, просто откройте и запустите ./Example/SHSearchBarExample.xcodeproj . На следующих изображениях показаны некоторые варианты использования:

Вы можете отобразить пользовательский заполнитель, как для обычных текстовых полей:

И вы даже можете ввести текст в эту панель поиска:

Ого, есть еще и настраиваемые виды аксессуаров:

Легко настраивайте текст и кнопку отмены по своему усмотрению:

Вы можете настроить радиус каждого угла текстового поля, чтобы такие макеты были простыми:

Внутреннее текстовое поле поддерживает новый textContentMode iOS 10:
(Повторно использует адрес, найденный ранее в Apple Maps)

Вы можете использовать панель поиска внутри UINavigationBar:

Кодовая документация

Документация по коду создается и размещается в Swift Package Index (на базе DocC).

Выпускать

Чтобы выпустить этот пакет Swift, необходимо предпринять следующие шаги:

• Создайте новую ветку release-xyz
• Запустите bash <(curl -H -s https://raw.githubusercontent.com/Blackjacx/Scripts/master/frameworks/bootstrap.sh) чтобы обновить до последних общих файлов разработки.
• Запустите bundle update , чтобы обновить все драгоценные камни Ruby.
• Зафиксируйте все изменения, сделайте PR и объедините его для развития
• Запустите 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. Дополнительную информацию смотрите в файле ЛИЦЕНЗИИ.