CocoaPods trunk is moving to be read-only. Read more on the blog, there are 13 months to go.
| TestsTested | ✓ |
| LangLanguage | Obj-CObjective C |
| License | MIT |
| ReleasedLast Release | Apr 2017 |
Maintained by glaszig.
A drop-in UITextView replacement which gives you: a placeholder.
Technically it differs from other solutions in that it tries to work like UITextField's private _placeholderLabel so you should not suffer ugly glitches like jumping text views or loads of custom drawing code.
Your iOS project. (Tested on iOS versions 7.x, 8.0. Should also work on 5.x and 6.x)
Note: This is ARC-enabled code. You'll need Xcode 4.2 and OS X 10.6, at least.
Note: To run the tests you'll need Xcode 5 with XCTest.
Either clone this repo and add the project to your Xcode workspace, use CocoaPods or Carthage.
SZTextView *textView = [SZTextView new];
textView.placeholder = @"Enter lorem ipsum here";
textView.placeholderTextColor = [UIColor lightGrayColor];
textView.font = [UIFont fontWithName:@"HelveticaNeue-Light" size:18.0];Analogously you can use the attributedPlaceholder property to set a fancy NSAttributedString as the placeholder:
NSMutableAttributedString *placeholder = [[NSMutableAttributedString alloc] initWithString:@"Enter lorem ipsum here"];
[placeholder addAttribute:NSForegroundColorAttributeName value:[UIColor redColor] range:NSMakeRange(0,2)];
[placeholder addAttribute:NSForegroundColorAttributeName value:[UIColor greenColor] range:NSMakeRange(2,4)];
[placeholder addAttribute:NSForegroundColorAttributeName value:[UIColor blueColor] range:NSMakeRange(6,4)];
textView.attributedPlaceholder = placeholder;Both properties placeholder and attributedPlaceholder are made to stay in sync.
If you set an attributedPlaceholder and afterwards set placeholder to something else, the set text gets copied to the attributedPlaceholder while trying to keep the original text attributes.
Also, placeholder will be set to attributedPlaceholder.string when using the attributedPlaceholder setter.
A simple demo and a few unit tests are included.
The placeholder is animatable. Just configure the double property fadeTime
to the seconds you'd like the animation to take.
If you prefer using Interface Builder to configure your UI, you can use UDRA's to set values for placeholder and placeholderTextColor.
git checkout -b my-new-feature)git commit -am 'Added some feature')git push origin my-new-feature)Published under the MIT license.
Note
I've developed this component for Cocktailicious. You should check it out *shamelessplug*.
Please let me now if and how you use this component. I'm curious.