SHSearchBar

SHBúsquedaBar

La barra de búsqueda limpia y brillante que hace lo que hace UISearchBar solo con trucos sucios. Esta vista está diseñada para abordar los límites de personalización de UISearchBar. La diferencia aquí es que esta clase no hereda UISearchBar sino que compone un nuevo objeto UIView utilizando un UITextField que es mucho más fácil de usar. Estos son los límites de UISearchBar:

• no hay una forma limpia de alinear a la izquierda el marcador de posición
• el botón cancelar es difícil de adaptar a sus necesidades
• generalmente la apariencia no es personalizable (por ejemplo, la fuente del texto)
• hay algunos comportamientos extraños cuando configuras una imagen de fondo personalizada

Como uso UITextField, estas restricciones no se aplican.

Instalación

Administrador de paquetes rápido

En Xcode abra su lista de objetivos y seleccione su proyecto. Haga clic en la pestaña Swift Packages y allí el pequeño ícono + . Ingrese la URL de este repositorio, seleccione la versión que desea instalar (generalmente la preestablecida está bien) y confirme.

CacaoPods

Dado que SHSearchBar utiliza recursos localizados, abandoné el soporte de CocoaPods en favor de SPM desde la versión 2.0.0 . Integre el paquete a través de SPM (ver arriba).

Cartago

Dado que SHSearchBar utiliza recursos localizados, abandoné el soporte de Carthage en favor de SPM desde la versión 2.0.0 . Integre el paquete a través de SPM (ver arriba).

Ejemplos

El repositorio incluye un proyecto de ejemplo. Muestra diferentes casos de uso de la barra de búsqueda. Para ejecutarlo, simplemente abra y ejecute ./Example/SHSearchBarExample.xcodeproj . Las siguientes imágenes muestran algunos casos de uso:

Puede mostrar un marcador de posición personalizado como para los campos de texto normales:

E incluso puedes escribir texto en esa barra de búsqueda:

Vaya, también hay vistas de accesorios personalizables:

Personalice fácilmente el texto y el botón cancelar como desee:

Puede personalizar el radio de cada esquina del campo de texto para que diseños como este sean sencillos:

El campo de texto interno es compatible con el nuevo 'textContentMode' de iOS 10:
(Reutiliza la dirección buscada anteriormente en Apple Maps)

Puedes usar la barra de búsqueda dentro de UINavigationBar:

Documentación del código

La documentación del código es generada y alojada por Swift Package Index (con tecnología DocC)

Liberar

Para lanzar este paquete Swift, se deben seguir los siguientes pasos:

• Crear una nueva rama release-xyz
• Ejecute bash <(curl -H -s https://raw.githubusercontent.com/Blackjacx/Scripts/master/frameworks/bootstrap.sh) para actualizar a los últimos archivos de desarrollo compartidos
• Ejecute bundle update para actualizar todas las gemas de Ruby
• Confirme todos los cambios, cree un PR y combínelo para desarrollarlo.
• Ejecute bundle exec fastlane release framework:"SHSearchBar" version:"xyz" para lanzar la nueva versión.
• Publica lo siguiente en Twitter

 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

Contribución

• Si encontró un error , abra un problema .
• Si tiene una solicitud de función , abra una incidencia .
• Si desea contribuir , envíe una solicitud de extracción .

Autor

Stefan Herold • ? @blackjacxxx

Colaboradores

Gracias a todos los que sois parte de esto:

Licencia

SHSearchBar está disponible bajo la licencia MIT. Consulte el archivo de LICENCIA para obtener más información.