Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tadejr/ResizingTokenField
A token field implementation for iOS
https://github.com/tadejr/ResizingTokenField
Last synced: about 1 month ago
JSON representation
A token field implementation for iOS
- Host: GitHub
- URL: https://github.com/tadejr/ResizingTokenField
- Owner: tadejr
- License: mit
- Created: 2019-06-19T13:46:44.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-01-28T13:03:53.000Z (almost 4 years ago)
- Last Synced: 2024-10-12T13:21:19.002Z (2 months ago)
- Language: Swift
- Size: 213 KB
- Stars: 106
- Watchers: 5
- Forks: 26
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-awesome-swift - ResizingTokenField - A UICollectionView-based token field which provides intrinsic content height. (Libs / UI)
- awesome-swift - ResizingTokenField - A UICollectionView-based token field which provides intrinsic content height. (Libs / UI)
- awesome-swift - ResizingTokenField - A token field implementation for iOS ` 📝 2 years ago ` (UI [🔝](#readme))
- awesome-swift - ResizingTokenField - A UICollectionView-based token field which provides intrinsic content height. (Libs / UI)
README
# ResizingTokenField
[](https://travis-ci.org/tadejr/ResizingTokenField)
[](https://cocoapods.org/pods/ResizingTokenField)
[](https://cocoapods.org/pods/ResizingTokenField)
[](https://cocoapods.org/pods/ResizingTokenField)
A token field implementation written in Swift 5.
## Features
- Can be used in Interface Builder or created programmatically
- Uses a `UICollectionView` to display tokens, allowing token changes to be animated
- Automatically updates intrinsic height as content is added and removed
- Supports collapsing tokens into a text description
- Allows providing a custom `UICollectionViewCell` for tokens
## Installation
### Cocoapods
ResizingTokenField is available through [CocoaPods](https://cocoapods.org). To install it, add the following to your `Podfile`:
```ruby
pod 'ResizingTokenField', '~> 0.1.1'
```
### Carthage
To install via [Carthage](https://github.com/Carthage/Carthage), add the following to your `Cartfile`:
```ogdl
github "tadejr/ResizingTokenField" "0.1.1"
```
## Usage
The token field can be used via Interface Builder - add an empty `UIView` to your layout and set its class to `ResizingTokenField`. It can also be initialized programmatically by using `init(frame:)`.
Meant to be used with auto layout; it provides intrinsic content height, meaning you only need to pin its position and width, height will change automatically as content is added and removed from the field. In Interface Builder, the Placeholder Intrinsic Size setting can be used for height.
### Configuration
Customization is possible by setting appropriate properties on a `ResizingTokenField` instance. Additionally, three different delegates can be set to handle specific behaviour. Check the example project for more info.
### Rotation support
The token field does not automatically invalidate layout when its bounds change. To handle device rotation you should manually invalidate layout.
```swift
override func viewWillTransition(to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator) {
super.viewWillTransition(to: size, with: coordinator)
tokenField.invalidateLayout()
}
```
### Height change animation
To animate changes to the token field's height you should call `layoutIfNeeded()` on an appropriate superview when token field intrinsic height changes.
```swift
func resizingTokenField(_ tokenField: ResizingTokenField, willChangeIntrinsicHeight newHeight: CGFloat) {
view.layoutIfNeeded()
}
func resizingTokenField(_ tokenField: ResizingTokenField, didChangeIntrinsicHeight newHeight: CGFloat) {
UIView.animate(withDuration: tokenField.animationDuration) {
self.view.layoutIfNeeded()
}
}
```
## Author
Tadej Razborsek, [email protected]
## License
ResizingTokenField is available under the MIT license. See the LICENSE file for more info.