//
|
// IQTextView.swift
|
// https://github.com/hackiftekhar/IQKeyboardManager
|
// Copyright (c) 2013-24 Iftekhar Qurashi.
|
//
|
// Permission is hereby granted, free of charge, to any person obtaining a copy
|
// of this software and associated documentation files (the "Software"), to deal
|
// in the Software without restriction, including without limitation the rights
|
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
// copies of the Software, and to permit persons to whom the Software is
|
// furnished to do so, subject to the following conditions:
|
//
|
// The above copyright notice and this permission notice shall be included in
|
// all copies or substantial portions of the Software.
|
//
|
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
// THE SOFTWARE.
|
|
import UIKit
|
|
/** @abstract UITextView with placeholder support */
|
@available(iOSApplicationExtension, unavailable)
|
@MainActor
|
@objc open class IQTextView: UITextView {
|
|
@objc required public init?(coder aDecoder: NSCoder) {
|
super.init(coder: aDecoder)
|
NotificationCenter.default.addObserver(self, selector: #selector(self.refreshPlaceholder),
|
name: UITextView.textDidChangeNotification, object: self)
|
}
|
|
@objc override public init(frame: CGRect, textContainer: NSTextContainer?) {
|
super.init(frame: frame, textContainer: textContainer)
|
NotificationCenter.default.addObserver(self, selector: #selector(self.refreshPlaceholder),
|
name: UITextView.textDidChangeNotification, object: self)
|
}
|
|
@objc override open func awakeFromNib() {
|
super.awakeFromNib()
|
NotificationCenter.default.addObserver(self, selector: #selector(self.refreshPlaceholder),
|
name: UITextView.textDidChangeNotification, object: self)
|
}
|
|
private var placeholderInsets: UIEdgeInsets {
|
let top: CGFloat = self.textContainerInset.top
|
let left: CGFloat = self.textContainerInset.left + self.textContainer.lineFragmentPadding
|
let bottom: CGFloat = self.textContainerInset.bottom
|
let right: CGFloat = self.textContainerInset.right + self.textContainer.lineFragmentPadding
|
return UIEdgeInsets(top: top, left: left, bottom: bottom, right: right)
|
}
|
|
private var placeholderExpectedFrame: CGRect {
|
let insets: UIEdgeInsets = self.placeholderInsets
|
let maxWidth: CGFloat = self.frame.width-insets.left-insets.right
|
let size: CGSize = CGSize(width: maxWidth, height: self.frame.height-insets.top-insets.bottom)
|
let expectedSize: CGSize = placeholderLabel.sizeThatFits(size)
|
|
return CGRect(x: insets.left, y: insets.top, width: maxWidth, height: expectedSize.height)
|
}
|
|
lazy var placeholderLabel: UILabel = {
|
let label = UILabel()
|
|
label.autoresizingMask = [.flexibleWidth, .flexibleHeight]
|
label.lineBreakMode = .byWordWrapping
|
label.numberOfLines = 0
|
label.font = self.font
|
label.textAlignment = self.textAlignment
|
label.backgroundColor = UIColor.clear
|
label.isAccessibilityElement = false
|
label.textColor = UIColor.placeholderText
|
label.alpha = 0
|
self.addSubview(label)
|
|
return label
|
}()
|
|
/** @abstract To set textView's placeholder text color. */
|
@IBInspectable open var placeholderTextColor: UIColor? {
|
|
get {
|
return placeholderLabel.textColor
|
}
|
|
set {
|
placeholderLabel.textColor = newValue
|
}
|
}
|
|
/** @abstract To set textView's placeholder text. Default is nil. */
|
@IBInspectable open var placeholder: String? {
|
|
get {
|
return placeholderLabel.text
|
}
|
|
set {
|
placeholderLabel.text = newValue
|
refreshPlaceholder()
|
}
|
}
|
|
/** @abstract To set textView's placeholder attributed text. Default is nil. */
|
open var attributedPlaceholder: NSAttributedString? {
|
get {
|
return placeholderLabel.attributedText
|
}
|
|
set {
|
placeholderLabel.attributedText = newValue
|
refreshPlaceholder()
|
}
|
}
|
|
@objc override open func layoutSubviews() {
|
super.layoutSubviews()
|
|
placeholderLabel.frame = placeholderExpectedFrame
|
}
|
|
@objc private func refreshPlaceholder() {
|
|
let text: String = text ?? attributedText?.string ?? ""
|
if text.isEmpty {
|
placeholderLabel.alpha = 1
|
} else {
|
placeholderLabel.alpha = 0
|
}
|
}
|
|
@objc override open var text: String! {
|
|
didSet {
|
refreshPlaceholder()
|
}
|
}
|
|
open override var attributedText: NSAttributedString! {
|
|
didSet {
|
refreshPlaceholder()
|
}
|
}
|
|
@objc override open var font: UIFont? {
|
|
didSet {
|
|
if let unwrappedFont: UIFont = font {
|
placeholderLabel.font = unwrappedFont
|
} else {
|
placeholderLabel.font = UIFont.systemFont(ofSize: 12)
|
}
|
}
|
}
|
|
@objc override open var textAlignment: NSTextAlignment {
|
didSet {
|
placeholderLabel.textAlignment = textAlignment
|
}
|
}
|
|
@objc override weak open var delegate: (any UITextViewDelegate)? {
|
|
get {
|
refreshPlaceholder()
|
return super.delegate
|
}
|
|
set {
|
super.delegate = newValue
|
}
|
}
|
|
@objc override open var intrinsicContentSize: CGSize {
|
guard !hasText else {
|
return super.intrinsicContentSize
|
}
|
|
var newSize: CGSize = super.intrinsicContentSize
|
let placeholderInsets: UIEdgeInsets = self.placeholderInsets
|
newSize.height = placeholderExpectedFrame.height + placeholderInsets.top + placeholderInsets.bottom
|
|
return newSize
|
}
|
|
@objc override open func caretRect(for position: UITextPosition) -> CGRect {
|
var originalRect = super.caretRect(for: position)
|
|
// When placeholder is visible and text alignment is centered
|
if placeholderLabel.alpha == 1 && self.textAlignment == .center {
|
// Calculate the width of the placeholder text
|
let font = placeholderLabel.font ?? UIFont.systemFont(ofSize: UIFont.systemFontSize)
|
let textSize = placeholderLabel.text?.size(withAttributes: [.font: font]) ?? .zero
|
// Calculate the starting x position of the centered placeholder text
|
let centeredTextX = (self.bounds.size.width - textSize.width) / 2
|
// Update the caret position to match the starting x position of the centered text
|
originalRect.origin.x = centeredTextX
|
}
|
|
return originalRect
|
}
|
}
|
