Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/serralvo/TextFieldCounter
UITextField character counter with lovable UX 💖. No math skills required 🙃.
https://github.com/serralvo/TextFieldCounter
swift textfield uitextfield
Last synced: 4 days ago
JSON representation
UITextField character counter with lovable UX 💖. No math skills required 🙃.
- Host: GitHub
- URL: https://github.com/serralvo/TextFieldCounter
- Owner: serralvo
- License: mit
- Created: 2016-12-03T14:13:33.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-12-27T20:05:11.000Z (almost 5 years ago)
- Last Synced: 2024-11-10T12:04:49.205Z (about 1 month ago)
- Topics: swift, textfield, uitextfield
- Language: Swift
- Homepage:
- Size: 1.14 MB
- Stars: 439
- Watchers: 9
- Forks: 31
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-ios - TextFieldCounter - UITextField character counter with lovable UX. (UI / TextField & TextView)
- awesome-swift - TextFieldCounter - UITextField character counter with lovable UX. (Libs / UI)
- awesome-swift - TextFieldCounter - UITextField character counter with lovable UX. (Libs / UI)
- awesome-ios-star - TextFieldCounter - UITextField character counter with lovable UX. (UI / TextField & TextView)
- fucking-awesome-swift - TextFieldCounter - UITextField character counter with lovable UX. (Libs / UI)
- awesome-swift - TextFieldCounter - UITextField character counter with lovable UX . No math skills required . ` 📝 a year ago` (UI [🔝](#readme))
README
# TextFieldCounter
UITextField character counter with lovable UX 💖. No math skills required 🙃.
[![Swift Version][swift-image]][swift-url]
[![License][license-image]][license-url]
[![Build Status][build-status-image]][build-status-url]
[](https://codecov.io/gh/serralvo/TextFieldCounter)
![CocoaPods][pod-version-image]
## Features
- [x] Set max length of `UITextField`.
- [x] A beautiful and animated label about the limits. Show it by ascending or descending way.
- [x] Haptic Feedback.
- [x] Easy setup with `@IBInspectable`.
![TextFieldCounter][demo-image]
## Requirements
|TextFieldCounter Version| 1.1.0 | 1.0.4|
|---|---|---|
|iOS Version | 10.0+| 8.0+|
|Xcode Version | 11.2| 8|
## Installation
#### CocoaPods
You can use [CocoaPods](http://cocoapods.org/) to install `TextFieldCounter` by adding it to your `Podfile`:
```ruby
platform :ios, '10.0'
use_frameworks!
pod 'TextFieldCounter'
```
To get the full benefits import `TextFieldCounter` wherever you import UIKit
``` swift
import UIKit
import TextFieldCounter
```
#### Manually
1. Download and drop ```TextFieldCounter.swift``` in your project.
2. Congratulations 🚀
## Usage example
#### By Inspector
1. Set the class and configure the options.
![Inspector][inspector-image]
#### Programmatically
```swift
import TextFieldCounter
let frame = CGRect(x: 20, y: 80, width: 320, height: 30)
let textField = TextFieldCounter(frame: frame, limit: 20, animate: true, ascending: true, counterColor: .black, limitColor: .red)
view.addSubview(textField)
```
##### Use Delegate
Set `counterDelegate` and enjoy it 🚀:
```swift
override func viewDidLoad() {
super.viewDidLoad()
textField.counterDelegate = self
}
func didReachMaxLength(textField: TextFieldCounter) {
print("didReachMaxLength")
}
```
## Next Steps
- Add `UIAppearance` support
- Add More tests
- Add Carthage support
## Contribute
We would ❤️ to see your contribution! To contribute to **TextFieldCounter**, check the ``LICENSE`` file for more info.
## License
Distributed under the MIT license. See ``LICENSE`` for more information.
## About
Created by Fabricio Serralvo – [serralvo.co](https://serralvo.co)
Special thanks 👍 to [@ciceroduarte](https://github.com/ciceroduarte) and [@rogerluan](https://github.com/rogerluan)
[swift-image]:https://img.shields.io/badge/swift-5.0-orange.svg
[swift-url]: https://swift.org/
[license-image]: https://img.shields.io/badge/License-MIT-blue.svg
[license-url]: LICENSE
[build-status-image]: https://api.travis-ci.org/serralvo/TextFieldCounter.svg
[pod-version-image]: https://img.shields.io/cocoapods/v/TextFieldCounter.svg
[build-status-url]: https://travis-ci.org/serralvo/TextFieldCounter
[inspector-image]:https://github.com/serralvo/TextFieldCounter/blob/master/Images/inspector.png
[demo-image]:https://github.com/serralvo/TextFieldCounter/blob/master/Images/demo.gif