https://github.com/whitesmith/WSTagsField
An iOS text field that represents tags, hashtags, tokens in general.
https://github.com/whitesmith/WSTagsField
carthage carthage-installation cocoapods hashtag hashtags ios swift swift-package-manager tags ui-components uitextfield
Last synced: 4 months ago
JSON representation
An iOS text field that represents tags, hashtags, tokens in general.
- Host: GitHub
- URL: https://github.com/whitesmith/WSTagsField
- Owner: whitesmith
- License: mit
- Created: 2016-07-04T09:56:23.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2022-10-20T06:32:55.000Z (over 2 years ago)
- Last Synced: 2024-11-20T05:48:06.154Z (5 months ago)
- Topics: carthage, carthage-installation, cocoapods, hashtag, hashtags, ios, swift, swift-package-manager, tags, ui-components, uitextfield
- Language: Swift
- Homepage:
- Size: 263 KB
- Stars: 1,285
- Watchers: 19
- Forks: 227
- Open Issues: 29
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - WSTagsField - An iOS text field that represents different Tags. (UI / Tag)
- awesome-swift - WSTagsField - An iOS text field that represents different Tags. (Libs / UI)
- awesome-cocoa - WSTagsField
- awesome-swift - WSTagsField - An iOS text field that represents different Tags. (Libs / UI)
- awesome-ios-star - WSTagsField - An iOS text field that represents different Tags. (UI / Tag)
- fucking-awesome-swift - WSTagsField - An iOS text field that represents different Tags. (Libs / UI)
- awesome-swift - WSTagsField - An iOS text field that represents tags, hashtags, tokens in general. ` 📝 3 months ago ` (UI [🔝](#readme))
README
# WSTagsField
[](https://github.com/Carthage/Carthage)
[](https://swift.org/package-manager/)
[](https://cocoapods.org/pods/WSTagsField)
[](https://developer.apple.com/swift/)
[](http://www.apple.com/ios/)
[]()
[](https://opensource.org/licenses/MIT)An iOS text field that represents tags, hashtags, tokens in general.

## Usage
``` swift
let tagsField = WSTagsField()
tagsField.layoutMargins = UIEdgeInsets(top: 2, left: 6, bottom: 2, right: 6)
tagsField.contentInset = UIEdgeInsets(top: 10, left: 10, bottom: 10, right: 10)
tagsField.spaceBetweenLines = 5.0
tagsField.spaceBetweenTags = 10.0
tagsField.font = .systemFont(ofSize: 12.0)
tagsField.backgroundColor = .white
tagsField.tintColor = .green
tagsField.textColor = .black
tagsField.fieldTextColor = .blue
tagsField.selectedColor = .black
tagsField.selectedTextColor = .red
tagsField.delimiter = ","
tagsField.isDelimiterVisible = true
tagsField.placeholderColor = .green
tagsField.placeholderAlwaysVisible = true
tagsField.keyboardAppearance = .dark
tagsField.returnKeyType = .next
tagsField.acceptTagOption = .space
tagsField.shouldTokenizeAfterResigningFirstResponder = true// Events
tagsField.onDidAddTag = { field, tag in
print("DidAddTag", tag.text)
}tagsField.onDidRemoveTag = { field, tag in
print("DidRemoveTag", tag.text)
}tagsField.onDidChangeText = { _, text in
print("DidChangeText")
}tagsField.onDidChangeHeightTo = { _, height in
print("HeightTo", height)
}tagsField.onValidateTag = { tag, tags in
// custom validations, called before tag is added to tags list
return tag.text != "#" && !tags.contains(where: { $0.text.uppercased() == tag.text.uppercased() })
}print("List of Tags Strings:", tagsField.tags.map({$0.text}))
```## Installation
####
[Carthage]
[Carthage]: https://github.com/Carthage/Carthage
To install it, simply add the following line to your **Cartfile**:
```ruby
github "whitesmith/WSTagsField"
```Then run `carthage update`.
Follow the current instructions in [Carthage's README][carthage-installation]
for up to date installation instructions.[carthage-installation]: https://github.com/Carthage/Carthage#adding-frameworks-to-an-application
####
[CocoaPods]
[CocoaPods]: http://cocoapods.org
To install it, simply add the following line to your **Podfile**:
```ruby
pod "WSTagsField"
```Then run `pod install` with CocoaPods 1.8.0 or newer.
### Swift Package Manager
Using **Xcode 11**, just go to _"File" > "Swift Packages" > "Add Package Dependency..."_ and use this repository: `https://github.com/whitesmith/WSTagsField`.
### Manually
Download all the source files and drop them into your project.
## Requirements
* iOS 9.0+
* Xcode 11 (Swift 5.1)# Contributing
The best way to contribute is by submitting a pull request. We'll do our best to respond to your patch as soon as possible. You can also submit a [new GitHub issue](https://github.com/whitesmith/WSTagsField/issues/new) if you find bugs or have questions. :octocat:
# Credits
This project was inspired by [CLTokenInputView](https://github.com/clusterinc/CLTokenInputView).