SHSearchBar

SHSearchBar

Die saubere und glänzende Suchleiste, die das tut, was UISearchBar nur mit schmutzigen Hacks macht. Diese Ansicht wurde entwickelt, um die Anpassungsbeschränkungen von UISearchBar zu überwinden. Der Unterschied besteht darin, dass diese Klasse UISearchBar nicht erbt, sondern ein neues UIView-Objekt erstellt, indem sie ein UITextField verwendet, das viel einfacher zu verwenden ist. Dies sind die Grenzen der UISearchBar:

• Keine saubere Möglichkeit, den Platzhalter linksbündig auszurichten
• Die Schaltfläche „Abbrechen“ lässt sich nur schwer an Ihre Bedürfnisse anpassen
• Im Allgemeinen ist das Erscheinungsbild nicht anpassbar (z. B. die Schriftart des Textes).
• Es gibt einige seltsame Verhaltensweisen, wenn Sie ein benutzerdefiniertes Hintergrundbild festlegen

Da ich ein UITextField verwende, gelten diese Einschränkungen nicht.

Installation

Swift-Paketmanager

Öffnen Sie in Xcode Ihre Zielliste und wählen Sie Ihr Projekt aus. Klicken Sie auf den Reiter Swift Packages und dort auf das kleine + -Symbol. Geben Sie die URL dieses Repositorys ein, wählen Sie die Version aus, die Sie installieren möchten – normalerweise ist die Voreinstellung in Ordnung – und bestätigen Sie.

Kakaokapseln

Da SHSearchBar lokalisierte Ressourcen verwendet, habe ich die CocoaPods-Unterstützung zugunsten von SPM ab Version 2.0.0 eingestellt. Bitte integrieren Sie das Paket über SPM (siehe oben).

Karthago

Da SHSearchBar lokalisierte Ressourcen verwendet, habe ich die Carthage-Unterstützung zugunsten von SPM ab Version 2.0.0 eingestellt. Bitte integrieren Sie das Paket über SPM (siehe oben).

Beispiele

Das Repo enthält ein Beispielprojekt. Es zeigt verschiedene Anwendungsfälle der Suchleiste. Um es auszuführen, öffnen Sie einfach ./Example/SHSearchBarExample.xcodeproj und führen Sie es aus. Die folgenden Bilder zeigen einige Anwendungsfälle:

Sie können einen benutzerdefinierten Platzhalter wie für normale Textfelder anzeigen:

Und Sie können sogar Text in diese Suchleiste eingeben:

Wow, es gibt auch anpassbare Zubehöransichten:

Passen Sie den Text und die Schaltfläche „Abbrechen“ ganz einfach nach Ihren Wünschen an:

Sie können jeden Eckradius des Textfelds anpassen, sodass Layouts wie dieses einfacher werden:

Das innere Textfeld unterstützt den neuen iOS 10 „textContentMode“:
(Verwendet die zuvor in Apple Maps gesuchte Adresse erneut)

Sie können die Suchleiste in einer UINavigationBar verwenden:

Code-Dokumentation

Die Codedokumentation wird von Swift Package Index (unterstützt von DocC) generiert und gehostet.

Freigeben

Um dieses Swift-Paket freizugeben, müssen die folgenden Schritte ausgeführt werden:

• Erstellen Sie einen neuen Zweig release-xyz
• Führen Sie bash <(curl -H -s https://raw.githubusercontent.com/Blackjacx/Scripts/master/frameworks/bootstrap.sh) aus, um auf die neuesten freigegebenen Entwicklungsdateien zu aktualisieren
• Führen Sie bundle update aus, um alle Ruby-Gems zu aktualisieren
• Übernehmen Sie alle Änderungen, erstellen Sie eine PR und führen Sie sie zur Entwicklung zusammen
• Führen Sie bundle exec fastlane release framework:"SHSearchBar" version:"xyz" aus, um die neue Version zu veröffentlichen
• Posten Sie Folgendes auf 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

Beitrag

• Wenn Sie einen Fehler gefunden haben, öffnen Sie bitte ein Problem .
• Wenn Sie eine Funktionsanfrage haben, öffnen Sie bitte ein Problem .
• Wenn Sie einen Beitrag leisten möchten, senden Sie bitte eine Pull-Anfrage .

Autor

Stefan Herold • ? @Blackjacxxx

Mitwirkende

Vielen Dank an alle, die dabei sind:

Lizenz

SHSearchBar ist unter der MIT-Lizenz verfügbar. Weitere Informationen finden Sie in der LICENSE-Datei.