Implementing Placeholder in UITextView: Comparative Analysis of Custom Controls and Delegate Methods

Overview of UITextView Placeholder Functionality

In iOS application development, UITextView is widely used as a multi-line text input control, but the native version lacks the placeholder functionality available in UITextField. Placeholder text displays prompt information when no user input is present, enhancing user experience. Based on community best practices, this article analyzes the technical details of two mainstream implementation approaches.

Custom UIPlaceHolderTextView Control Implementation

Creating a custom control by subclassing UITextView provides the most feature-complete solution. This approach supports Interface Builder configuration, animated transitions, and flexible appearance customization.

Interface Definition and Property Declaration

The custom control header file defines two key properties:

@interface UIPlaceHolderTextView : UITextView
@property (nonatomic, retain) IBInspectable NSString *placeholder;
@property (nonatomic, retain) IBInspectable UIColor *placeholderColor;
@end

The IBInspectable and IB_DESIGNABLE macros enable property configuration directly in Interface Builder, improving development efficiency.

Initialization and Notification Registration

The control completes basic setup in initWithFrame: and awakeFromNib methods:

- (void)awakeFromNib {
    [super awakeFromNib];
    if (!self.placeholder) {
        [self setPlaceholder:@""];
    }
    if (!self.placeholderColor) {
        [self setPlaceholderColor:[UIColor lightGrayColor]];
    }
    [[NSNotificationCenter defaultCenter] addObserver:self 
                                             selector:@selector(textChanged:) 
                                                 name:UITextViewTextDidChangeNotification 
                                               object:nil];
}

By observing UITextViewTextDidChangeNotification, the control responds to text changes in real-time.

Placeholder Label Drawing and Management

The drawRect: method handles placeholder label creation and layout:

- (void)drawRect:(CGRect)rect {
    if ([[self placeholder] length] > 0) {
        if (_placeHolderLabel == nil) {
            _placeHolderLabel = [[UILabel alloc] initWithFrame:CGRectMake(8, 8, self.bounds.size.width - 16, 0)];
            _placeHolderLabel.lineBreakMode = NSLineBreakByWordWrapping;
            _placeHolderLabel.numberOfLines = 0;
            _placeHolderLabel.font = self.font;
            _placeHolderLabel.backgroundColor = [UIColor clearColor];
            _placeHolderLabel.textColor = self.placeholderColor;
            _placeHolderLabel.alpha = 0;
            _placeHolderLabel.tag = 999;
            [self addSubview:_placeHolderLabel];
        }
        _placeHolderLabel.text = self.placeholder;
        [_placeHolderLabel sizeToFit];
        [self sendSubviewToBack:_placeHolderLabel];
    }
    [super drawRect:rect];
}

The label uses automatic size adjustment, supports multi-line text display, and ensures it doesn't interfere with user input through sendSubviewToBack.

Text Change Response and Animation Effects

The textChanged: method manages placeholder visibility:

- (void)textChanged:(NSNotification *)notification {
    if ([[self placeholder] length] == 0) return;
    
    [UIView animateWithDuration:UI_PLACEHOLDER_TEXT_CHANGED_ANIMATION_DURATION animations:^{
        if ([[self text] length] == 0) {
            [[self viewWithTag:999] setAlpha:1];
        } else {
            [[self viewWithTag:999] setAlpha:0];
        }
    }];
}

Using UIView animation provides smooth opacity transitions with a duration of 0.25 seconds, enhancing visual experience.

Memory Management and Resource Cleanup

The dealloc method properly handles notification observers and object release:

- (void)dealloc {
    [[NSNotificationCenter defaultCenter] removeObserver:self];
#if __has_feature(objc_arc)
#else
    [_placeHolderLabel release]; _placeHolderLabel = nil;
    [_placeholderColor release]; _placeholderColor = nil;
    [_placeholder release]; _placeholder = nil;
    [super dealloc];
#endif
}

The code is compatible with both ARC and non-ARC environments, ensuring memory safety.

Lightweight Solution Based on UITextViewDelegate

For simple scenarios, placeholder functionality can be quickly added by implementing the UITextViewDelegate protocol.

Delegate Method Implementation

Handle placeholder logic in textViewDidBeginEditing and textViewDidEndEditing:

- (void)textViewDidBeginEditing:(UITextView *)textView {
    if ([textView.text isEqualToString:@"placeholder text here..."]) {
        textView.text = @"";
        textView.textColor = [UIColor blackColor];
    }
}

- (void)textViewDidEndEditing:(UITextView *)textView {
    if ([textView.text isEqualToString:@""]) {
        textView.text = @"placeholder text here...";
        textView.textColor = [UIColor lightGrayColor];
    }
}

This approach directly modifies the UITextView's text property, distinguishing placeholder from user input through color changes.

Swift Implementation

The Swift version is more concise:

func textViewDidBeginEditing(_ textView: UITextView) {
    if textView.text == "placeholder text here..." && textView.textColor == .lightGray {
        textView.text = ""
        textView.textColor = .black
    }
}

func textViewDidEndEditing(_ textView: UITextView) {
    if textView.text == "" {
        textView.text = "placeholder text here..."
        textView.textColor = .lightGray
    }
}

Third-Party Library UITextView+Placeholder

The UITextView+Placeholder library on GitHub offers another implementation option. Integrate via CocoaPods:

pod 'UITextView+Placeholder'

Usage is extremely simple:

UITextView *textView = [[UITextView alloc] init];
textView.placeholder = @"How are you?";
textView.placeholderColor = [UIColor lightGrayColor];

The library supports NSAttributedString formatted placeholders, providing more styling options.

Solution Comparison and Selection Recommendations

The custom control solution offers complete functionality with animation and Interface Builder support, suitable for complex projects. The delegate approach provides concise code ideal for rapid prototyping. Third-party libraries balance ease of use and functionality, making them optimal for team projects.

Implementation Detail Optimization Suggestions

In practical development, consider these optimizations: match placeholder font with input font, support rich text placeholders, handle layout adjustments during keyboard interactions, and add accessibility labels for improved accessibility.

Conclusion

Adding placeholder functionality to UITextView is crucial for enhancing iOS application user experience. Developers can choose appropriate technical solutions based on project requirements: custom controls offer maximum flexibility, delegate methods suit simple scenarios, and third-party libraries provide out-of-the-box solutions.