iOS自定义UITextField：设备及Storyboard中占位符文本不显示问题

我来帮你搞定这个自定义UITextField占位符不显示的问题！看了你的代码片段，我发现几个大概率导致问题的点，咱们一步步来解决：

1. 自定义Border层遮挡了占位符 #

你添加的border CALayer默认会放在TextField原生内容的上层，直接把占位符给挡住了。这是最常见的原因！

解决办法：在createBorder()方法里，把border层的层级调到最底层：

func createBorder() {
    // 先保留你原来的border样式设置
    border.frame = CGRect(x: 0, y: self.frame.size.height - 1, width: self.frame.size.width, height: 1)
    border.backgroundColor = UIColor.lightGray.cgColor
    
    // 关键：把border放到所有内容的下面
    border.zPosition = -1
    self.layer.addSublayer(border)
}

2. Storyboard预览异常：缺少@IBDesignable标记 #

要让自定义控件在Storyboard里正常显示预览，必须给类加上@IBDesignable标记，不然Storyboard没法正确渲染你的自定义逻辑。

修改类定义：

@IBDesignable
class UnderlineTextField : UITextField, UITextFieldDelegate {
    // ... 你的原有代码 ...
}

3. 未完成的init(frame:)方法 #

你的init(frame:)方法只写了半截super.ini...，这会导致编译错误，还会打乱控件的初始化流程，赶紧补全它：

required override init(frame: CGRect) {
    super.init(frame: frame)
    delegate = self
    createBorder()
    // 别忘了初始化你的numericKbdToolbar
    setupNumericKeyboardToolbar()
}

// 补充toolbar的初始化方法示例
private func setupNumericKeyboardToolbar() {
    numericKbdToolbar.sizeToFit()
    let doneButton = UIBarButtonItem(barButtonSystemItem: .done, target: self, action: #selector(resignFirstResponder))
    numericKbdToolbar.items = [UIBarButtonItem(barButtonSystemItem: .flexibleSpace, target: nil, action: nil), doneButton]
    self.inputAccessoryView = numericKbdToolbar
}

4. 占位符样式被意外隐藏 #

有时候自定义TextField时，可能不小心让占位符颜色和背景色一致，看起来像是没显示。可以显式设置占位符样式来排查：

// 在初始化方法里添加这行
if let placeholderText = self.placeholder {
    self.attributedPlaceholder = NSAttributedString(
        string: placeholderText,
        attributes: [NSAttributedString.Key.foregroundColor: UIColor.gray]
    )
}

额外优化：让Border自动适应布局 #

因为TextField的frame可能会在AutoLayout后变化，你的border层不会自动跟着调整，建议重写layoutSubviews来更新border的位置：

override func layoutSubviews() {
    super.layoutSubviews()
    // 用bounds而不是frame，适配AutoLayout
    border.frame = CGRect(x: 0, y: self.bounds.height - 1, width: self.bounds.width, height: 1)
}

按照上面的步骤调整后，不管是在设备上运行还是Storyboard预览里，占位符应该都能正常显示了！

内容的提问来源于stack exchange，提问作者aaa111