SHSearchBar

SHSearchBar

La barre de recherche propre et brillante qui fait ce que UISearchBar fait uniquement avec des hacks sales. Cette vue est conçue pour résoudre les limites de personnalisation de UISearchBar. La différence ici est que cette classe n'hérite pas de UISearchBar mais compose un nouvel objet UIView en utilisant un UITextField beaucoup plus simple à utiliser. Voici les limites de UISearchBar :

• pas de moyen propre d'aligner à gauche l'espace réservé
• le bouton d'annulation est difficile à adapter à vos besoins
• généralement l'apparence n'est pas personnalisable (par exemple la police du texte)
• il y a des comportements étranges lorsque vous définissez une image d'arrière-plan personnalisée

Puisque j'utilise un UITextField, ces restrictions ne s'appliquent pas.

Installation

Gestionnaire de paquets Swift

Dans Xcode, ouvrez votre liste de cibles et sélectionnez votre projet. Cliquez sur l'onglet Swift Packages et là sur la petite icône + . Entrez l'URL de ce référentiel, sélectionnez la version que vous souhaitez installer - généralement le préréglage est correct - et confirmez.

Cosses de cacao

Étant donné que SHSearchBar utilise des ressources localisées, j'ai abandonné le support de CocoaPods au profit de SPM à partir de la version 2.0.0 . Veuillez intégrer le package via SPM (voir ci-dessus).

Carthage

Étant donné que SHSearchBar utilise des ressources localisées, j'ai abandonné le support de Carthage au profit de SPM à partir de la version 2.0.0 . Veuillez intégrer le package via SPM (voir ci-dessus).

Exemples

Le dépôt comprend un exemple de projet. Il montre différents cas d'utilisation de la barre de recherche. Pour l'exécuter, ouvrez et exécutez simplement ./Example/SHSearchBarExample.xcodeproj . Les images suivantes montrent quelques cas d'utilisation :

Vous pouvez afficher un espace réservé personnalisé comme pour les champs de texte normaux :

Et vous pouvez même saisir du texte dans cette barre de recherche :

Wow, il existe également des vues d'accessoires personnalisables :

Personnalisez facilement le texte et le bouton Annuler comme vous le souhaitez :

Vous pouvez personnaliser chaque rayon de coin du champ de texte afin que des mises en page comme celle-ci deviennent faciles :

Le champ de texte interne prend en charge le nouveau « textContentMode » d'iOS 10 :
(Réutilise l'adresse recherchée dans Apple Maps auparavant)

Vous pouvez utiliser la barre de recherche dans une UINavigationBar :

Documentation des codes

La documentation du code est générée et hébergée par Swift Package Index (propulsé par DocC)

Libérer

Pour publier ce package Swift, les étapes suivantes doivent être suivies :

• Créer une nouvelle branche release-xyz
• Exécutez bash <(curl -H -s https://raw.githubusercontent.com/Blackjacx/Scripts/master/frameworks/bootstrap.sh) pour mettre à jour vers les derniers fichiers de développement partagés
• Exécutez bundle update pour mettre à jour toutes les gemmes Ruby
• Validez toutes les modifications, créez un PR et fusionnez-le pour développer
• Exécutez bundle exec fastlane release framework:"SHSearchBar" version:"xyz" pour publier la nouvelle version
• Postez ce qui suit sur 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

Contribution

• Si vous avez trouvé un bug , veuillez ouvrir un ticket .
• Si vous avez une demande de fonctionnalité , veuillez ouvrir un problème .
• Si vous souhaitez contribuer , veuillez soumettre une pull request .

Auteur

Stéphane Hérold • ? @Blackjacxxx

Contributeurs

Merci à vous tous qui en faites partie :

Licence

SHSearchBar est disponible sous la licence MIT. Voir le fichier LICENSE pour plus d'informations.