GrowingTextView
  • October 23, 2023

Requirements


iOS 8.0 or above

Installation


CocoaPods

GrowingTextView is available through CocoaPods. To install it, simply add the following line to your Podfile:

Swift 5.0

pod ‘GrowingTextView’, ‘0.7.2’

Swift 4.2

pod ‘GrowingTextView’, ‘0.6.1’

Swift 4.1

pod ‘GrowingTextView’, ‘~> 0.5’

Swift 3

pod ‘GrowingTextView’, ‘~> 0.4’

Swift 2.3 (Stopped update since Sep 2016)

pod ‘GrowingTextView’, :git => ‘https://github.com/KennethTsang/GrowingTextView.git’, :branch => ‘swift2’

Carthage

GrowingTextView is also available through Carthage. To install it, add the following line to your Cartfile:

Swift 5.0

github “KennethTsang/GrowingTextView” ~> 0.7

Swift 4.2

github “KennethTsang/GrowingTextView” ~> 0.6

Swift 4.1

github “KennethTsang/GrowingTextView” ~> 0.5

Swift 3

github “KennethTsang/GrowingTextView” ~> 0.4

Swift 2.3 (Stopped update since Sep 2016)

github “KennethTsang/GrowingTextView” “swift2”

Manually

Copy GrowingTextView.swift into your project.

Usage


Example

GrowingTextview is just a textview, download the example to see how to use it as a input toolbar like other instant messaging apps.

Using GrowingTextview programmatically

let textView = GrowingTextView()
textView.delegate = self
addSubview(textView)

Using GrowingTextview in Storyboard

  1. Drag a TextView into Storyboard.
  2. Set class to “GrowingTextView”.
  3. Set delegate to it’s view controller.
automaticallyAdjustsScrollViewInsets

Sometime the view controller may incorrectly adjust the inset of textview automatically. To avoid this, set automaticallyAdjustsScrollViewInsets to false

override func viewDidLoad() {
super.viewDidLoad()
automaticallyAdjustsScrollViewInsets = false
}

Customization


Parameter Type Description Default
maxLength Int Maximum text length. Exceeded text will be trimmed. 0 means no limit. 0
trimWhiteSpaceWhenEndEditing Bool Trim white space and new line characters when textview did end editing. true
placeholder String? Placeholder text. nil
placeholderColor UIColor Placeholder text color. UIColor(white: 0.8, alpha: 1.0)
attributedPlaceholder NSAttributedString? Attributed Placeholder text. nil
minHeight CGFloat Minimum height of textview. 0.0
maxHeight CGFloat Maximum height of textview. 0.0
Examples

 

textView.maxLength = 140
textView.trimWhiteSpaceWhenEndEditing = false
textView.placeholder = “Say something…”
textView.placeholderColor = UIColor(white: 0.8, alpha: 1.0)
textView.minHeight = 25.0
textView.maxHeight = 70.0
textView.backgroundColor = UIColor.whiteColor()
textView.layer.cornerRadius = 4.0

Animation


  1. Adopt GrowingTextViewDelegate instead of UITextViewDelegate.
  2. Implement textViewDidChangeHeight.
  3. Call layoutIfNeeded() on superview inside the animation.

class ViewController: UIViewController, GrowingTextViewDelegate {
func textViewDidChangeHeight(_ textView: GrowingTextView, height: CGFloat) {
UIView.animate(withDuration: 0.2) {
self.view.layoutIfNeeded()
}
}
}

Delegate


GrowingTextViewDelegate is inherited from UITextViewDelegate. You may use it’s delegate function as a normal UITextView.

class ViewController: UIViewController, GrowingTextViewDelegate {
func textViewDidChange(_ textView: UITextView) {

}
func textViewDidEndEditing(_ textView: UITextView) {

}
}

Check out UITextViewDelegate here: https://developer.apple.com/reference/uikit/uitextviewdelegate

GitHub


View Github

#animation #awesemetextfield #carthage #chat #cocoapods #currencytextfield #customtextfield #customwidgets #facetedsearch #geosearch #growing #growingtextview #instantsearch #interfacebuilder #ios #ioslibrary #iosswift #opensource #passwordtextfield #placeholder #placeholdertextview #realmswift #search #searchengine #searchinterface #searchsynonyms #styledtext #swift #swiftframework #swiftlibrary #swiftpackagemanager #swiftui #swiftuicomponents #text #textexpansion #textfield #texture #textview #tjtextfield #ui #uikit #uitextfield #uitextfieldnavigation #uitextview #uitextviewalgolia #widgets
YOU MIGHT ALSO LIKE...
🧭 NavigationKit

NavigationKit is a lightweight library which makes SwiftUI navigation super easy to use. 💻 Installation 📦 Swift Package Manager Using Swift Package Manager, add ...

swiftui-navigation-stack

An alternative SwiftUI NavigationView implementing classic stack-based navigation giving also some more control on animations and programmatic navigation. NavigationStack Installation ...

Stinsen

Simple, powerful and elegant implementation of the Coordinator pattern in SwiftUI. Stinsen is written using 100% SwiftUI which makes it ...

SwiftUI Router

With SwiftUI Router you can power your SwiftUI app with path-based routing. By utilizing a path-based system, navigation in your app becomes ...

FlowStacks

This package takes SwiftUI's familiar and powerful NavigationStack API and gives it superpowers, allowing you to use the same API not just ...