Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/blackjacx/shsearchbar
The search bar that doesn't suck.
https://github.com/blackjacx/shsearchbar
apple carthage carthage-support cocoapods hacktoberfest ios search spm swiftpackagemanager uisearchbar xcode
Last synced: 3 days ago
JSON representation
The search bar that doesn't suck.
- Host: GitHub
- URL: https://github.com/blackjacx/shsearchbar
- Owner: Blackjacx
- License: mit
- Created: 2016-08-01T21:19:42.000Z (over 8 years ago)
- Default Branch: develop
- Last Pushed: 2023-10-04T13:47:20.000Z (over 1 year ago)
- Last Synced: 2025-01-14T05:09:27.008Z (10 days ago)
- Topics: apple, carthage, carthage-support, cocoapods, hacktoberfest, ios, search, spm, swiftpackagemanager, uisearchbar, xcode
- Language: Swift
- Homepage:
- Size: 2.06 MB
- Stars: 254
- Watchers: 7
- Forks: 34
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
[](https://twitter.com/intent/follow?original_referer=https%3A%2F%2Fgithub.com%2Fblackjacx&screen_name=Blackjacxxx)
[](https://twitter.com/intent/follow?original_referer=https%3A%2F%2Fgithub.com%2Fblackjacx&screen_name=Blackjacxxx)
[](https://github.com/Blackjacx/shsearchbar/releases)
[](https://swiftpackageindex.com/Blackjacx/SHSearchBar)
[](https://swiftpackageindex.com/Blackjacx/SHSearchBar)
[](https://codebeat.co/projects/github-com-blackjacx-shsearchbar)
[](https://github.com/blackjacx/shsearchbar/blob/develop/LICENSE)
[](https://www.paypal.me/STHEROLD)
# SHSearchBar
The clean and shiny search bar that does what UISearchBar does only with dirty
hacks. This view is designed to tackle the customization limits of UISearchBar.
The difference here is that this class does not inherit UISearchBar but
composes a new UIView object by using a UITextField that is much easier to use.
These are the limits of the UISearchBar:
- no clean way to left align the placeholder
- the cancel button is hard to tailor to your needs
- generally the appearance is not customizable (e.g. the font of the text)
- there are some strange behaviors when you set a custom background image
Since I use a UITextField these restrictions do not apply.
## Installation
### [Swift Package Manager](https://swift.org/package-manager/)
In Xcode open your target list and select your project. Click the tab `Swift
Packages` and there the small `+` icon. Enter the URL of this repository,
select the version you want to install - usually the preset is okay - and
confirm.
### [CocoaPods](http://cocoapods.org)
Since SHSearchBar uses localized resources I dropped CocoaPods support in favor of SPM from version `2.0.0`.
Please integrate the package via SPM (see above).
### Carthage
Since SHSearchBar uses localized resources I dropped Carthage support in favor of SPM from version `2.0.0`.
Please integrate the package via SPM (see above).
## Examples
The repo includes an example project. It shows shows different use cases of
the search bar. To run it, just open and run `./Example/SHSearchBarExample.xcodeproj`. The following images show some
use cases:
You can show a custom placeholder like for normal text fields:
And you can even type text into that searchbar:
Wow there are customizable accessory views too:
Easily customize text and cancel button as you want:
You can customize each corner radius of the text field so that layouts like this become an ease:
The inner text field supports the new iOS 10 'textContentMode':
(Re-uses the address searched in Apple Maps before)
You can use the search bar inside a UINavigationBar:
## Code Documentation
The [code documentation](https://swiftpackageindex.com/Blackjacx/SHSearchBar/develop/documentation/shsearchbar) is generated and hosted by [Swift Package Index](https://swiftpackageindex.com/) (powered by [DocC](https://developer.apple.com/documentation/docc))
## Release
To release this Swift package the following steps have to be taken:
- Create a new branch `release-x.y.z`
- Run `bash <(curl -H -s https://raw.githubusercontent.com/Blackjacx/Scripts/master/frameworks/bootstrap.sh)` to update to the latest shared development files
- Run `bundle update` to update all Ruby gems
- Commit all changes, make a PR and merge it to develop
- Run `bundle exec fastlane release framework:"SHSearchBar" version:"x.y.z"` to release the new version
- Post the following on 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
- If you found a **bug**, please open an **issue**.
- If you have a **feature request**, please open an **issue**.
- If you want to **contribute**, please submit a **pull request**.
## Author
[Stefan Herold](mailto:[email protected]) • 🐦 [@Blackjacxxx](https://twitter.com/Blackjacxxx)
## Contributors
Thanks to all of you who are part of this:
## License
SHSearchBar is available under the MIT license. See the [LICENSE](LICENSE) file for more info.