UITextView: какво е, многоредов вход и принцип на работа

Какво е UITextView

UITextView е компонент на UIKit, предназначен за показване и редактиране на многоредов текст. За разлика от UILabel, UITextView поддържа избор на текст, редактиране, превъртане при превишаване на размерите и атрибутиран текст. Като наследник на UIScrollView, UITextView автоматично активира вертикално и хоризонтално превъртане при превишаване на съдържанието — това се конфигурира чрез isScrollEnabled. Класът поддържа редактиране чрез свойството isEditable: задайте false за режим само за четене. UITextView работи с NSLayoutManager чрез системата TextKit: NSTextStorage (съхранение на атрибутиран текст) → NSLayoutManager (оформление на редове) → NSTextContainer (геометрия на текстовата област). Тази архитектура позволява създаване на персонализирано оформление с обтичане на текст около изображения, многоколонен текст и сложни текстови оформления. UITextView се използва за показване на статии, описания, логове, коментари и всякакъв многоредов текст в iOS.

UITextView срещу UITextField: ключови разлики

Разликата между UITextView и UITextField далеч надхвърля броя на редовете. UITextField е едноредов UIControl с поддръжка на placeholder, left/right view и бутон за изчистване. UITextView е многоредов UIScrollView с пълноценна система TextKit за атрибутиран текст. UITextField не поддържа NSAttributedString на ниво показване (само чрез attributedText с ограничения), UITextView обработва напълно NSAttributedString с различни шрифтове, стилове на абзаци и вградени изображения. UITextField има вграден бутон за изчистване (clearButtonMode), UITextView няма — изисква персонализирана имплементация. UITextField автоматично променя размера си според съдържанието (intrinsicContentSize), UITextView изисква ръчно управление на височината чрез наблюдение на contentSize или ограничения на Auto Layout. UITextView поддържа dataDetectorTypes (автоматично откриване на връзки), UITextField ги поддържа от iOS 16+. За въвеждане на многоредов текст (коментари, бележки, съобщения) изберете UITextView. За полета на формуляри (име, имейл, парола) използвайте UITextField.

NSAttributedString и форматиране на текст

NSAttributedString е фундаментална възможност на UITextView, която го отличава от UITextField и UILabel. Атрибутираният низ позволява задаване на различни шрифтове, цветове, междуредия, подравняване и връзки в рамките на един текст. Свойства: textView.attributedText = attributedString. Ключови атрибути на NSAttributedString.Key: font (.systemFont, .boldSystemFont, персонализиран UIFont), foregroundColor, backgroundColor, paragraphStyle (NSMutableParagraphStyle с lineSpacing, alignment, lineBreakMode), link (URL за интерактивни връзки), underlineStyle, strikethroughStyle, shadow, baselineOffset, kern (разстояние между букви). За създаване на attributedString използвайте init(string:, attributes:) или NSMutableAttributedString за добавяне на атрибути към различни диапазони. UITextView автоматично показва връзките (link attribute) като интерактивни — при натискане се извиква делегатският метод shouldInteractWithURL. За нулиране на атрибутите за ново въвеждане използвайте typingAttributes.

import UIKit

let textView = UITextView()
textView.isEditable = false
textView.isScrollEnabled = true
textView.dataDetectorTypes = [.link, .phoneNumber]

let attributedString = NSMutableAttributedString(
    string: "Visit our website or call +1-800-555-0199"
)
attributedString.addAttributes([
    .font: UIFont.systemFont(ofSize: 16),
    .foregroundColor: UIColor.label,
], range: NSRange(location: 0, length: 11))

let linkRange = (attributedString.string as NSString)
    .range(of: "website")
attributedString.addAttributes([
    .link: URL(string: "https://example.com")!,
    .foregroundColor: UIColor.systemBlue,
], range: linkRange)

textView.attributedText = attributedString

Делегат UITextViewDelegate и обработка на връзки

UITextViewDelegate е протокол, който управлява редактирането и взаимодействието с текста. Основни методи: textViewDidBeginEditing(textView) — извиква се при започване на редактиране; textViewDidEndEditing — при приключване; textViewDidChange — при всяка промяна на текста; textViewDidChangeSelection — при промяна на селекцията; textViewShouldInteractWithURL — при кликване върху връзка (връща Bool, дали навигацията е разрешена); textViewShouldInteractWithTextAttachment — при кликване върху вградено изображение. За обработка на връзки вътре в UITextView презапишете shouldInteractWithURL — в него можете: да отворите URL в SFSafariViewController, да покажете UIAlertController за потвърждение, да обработите персонализирани URL схеми. Важно: ако textView.isEditable = true, връзките стават недостъпни за кликване до двойно докосване — за интерактивни връзки при редактиране използвайте gesture recognizers.

Обработка на връзки чрез SFSafariViewController

SFSafariViewController е стандартният начин за отваряне на връзки в iOS приложения. В метода shouldInteractWithURL създайте SFSafariViewController с URL и го представете модално или чрез navigationController. За универсални връзки използвайте UIApplication.shared.open(url, options) — но това излиза извън приложението. За забрана на отварянето на връзки върнете false в shouldInteractWithURL и обработете URL сами.

Система Text Container: полета и exclusionPaths

NSTextContainer — част от архитектурата TextKit, определяща геометричната област, в която се показва текстът на UITextView. Всеки UITextView има стандартен textContainer, конфигурируем чрез: textView.textContainerInset — полета на текста от границите на textView (UIEdgeInsets); textView.textContainer.lineFragmentPadding — хоризонтално поле във всеки ред; textView.textContainer.maximumNumberOfLines — ограничение на броя редове (0 = без лимит); textView.textContainer.exclusionPaths — масив от UIBezierPath за области, които текстът трябва да заобикаля (изображения, персонализирани форми). ExclusionPaths позволяват създаване на сложно оформление: текстът обтича кръгла профилна снимка, икона или произволен контур. За динамичен размер на UITextView наблюдавайте contentSize чрез KVO или делегат и актуализирайте ограниченията.

// Динамична височина на UITextView чрез contentSize
func textViewDidChange(textView: UITextView) {
    let fixedWidth = textView.frame.size.width
    let newSize = textView.sizeThatFits(
        CGSize(width: fixedWidth, height: CGFloat.greatestFiniteMagnitude)
    )
    heightConstraint.constant = newSize.height
    UIView.animate(withDuration: 0.1) {
        self.view.layoutIfNeeded()
    }
}

// ExclusionPath за обтичане на изображения
let imageFrame = CGRect(x: 16, y: 100, width: 80, height: 80)
let exclusionPath = UIBezierPath(rect: imageFrame)
textView.textContainer.exclusionPaths = [exclusionPath]

Data Detector Types: автоматично откриване на данни

dataDetectorTypes — свойство на UITextView, което автоматично разпознава и прави интерактивни определени типове данни в текста: .link (URL, имейл), .phoneNumber (телефонни номера), .address (адреси), .calendarEvent (дати и събития), .flightNumber (номера на полети), .lookupSuggestion (търсещи предложения), .trackingNumber (номера за проследяване), .money (суми), .shipmentTrackingNumber, .all (всички типове). Data Detector работи с NSDataDetector и URL, автоматично подчертавайки откритите данни. За персонализиране на обработката задайте dataDetectorTypes и презапишете shouldInteractWithURL в делегата. Важно: dataDetectorTypes работи само за URL и phoneNumber без допълнителна конфигурация — останалите типове може да изискват iOS 16+. Data Detector не конфликтира с link attribute в NSAttributedString — двата механизма работят паралелно. За UITextView само за четене със съдържание (новини, статии) задайте dataDetectorTypes = [.link, .phoneNumber].

• .link — URL, имейл адреси; показват се като сини връзки
• .phoneNumber — телефонни номера; натискането показва действие Call
• .address — пощенски адреси; натискането отваря Maps
• .calendarEvent — дати и часове; натискането създава календарно събитие
• .flightNumber — номера на полети (iOS 16+); бърза проверка на полет

Примери за код с UITextView

Нека разгледаме два практически примера за използване на UITextView в iOS приложения. Първият — text view само за четене с атрибутиран текст и data detector за показване на съдържание. Вторият — редактируем text view с мързелив placeholder и динамична височина за форма за коментар. И двата примера използват best practices на UIKit: делегатски протокол, Auto Layout и TextKit.

UITextView само за четене със съдържание и връзки

Режим само за четене се активира чрез задаване на isEditable = false и isSelectable = true. Това позволява на потребителя да избира текст и да кликва върху връзки, но не и да редактира. Задайте dataDetectorTypes за автоматично откриване на връзки, backgroundColor = .clear за прозрачен фон. За показване на дълго съдържание използвайте attributedText с NSMutableParagraphStyle lineSpacing за четливост. Добавете link attributes за ключови връзки в текста.

import UIKit

class ArticleViewController: UIViewController {
    let contentView = UITextView()

    override func viewDidLoad() {
        super.viewDidLoad()
        contentView.isEditable = false
        contentView.isSelectable = true
        contentView.dataDetectorTypes = [.link, .phoneNumber]
        contentView.backgroundColor = .clear
        contentView.textContainerInset = UIEdgeInsets(
            top: 8, left: 16,
            bottom: 8, right: 16
        )
        contentView.delegate = self
        loadArticleContent()
    }

    func loadArticleContent() {
        guard let url = URL(string: "https://example.com/article")
        else { return }
        // Зареждане на съдържание от URL и задаване на attributedText
    }
}

Редактируем UITextView с placeholder

Placeholder за UITextView не е вграден — имплементирайте го чрез UILabel над textView или чрез attributedText с проверка isEmpty. Прост подход: UILabel със сив текст, който се скрива при започване на редактиране. В textViewDidChange проверявайте наличието на текст и скривайте/показвайте placeholder. За по-елегантно решение използвайте свойството typingAttributes за задаване на цвят на въведения текст. Динамичната височина на textView се постига чрез наблюдение на contentSize и актуализиране на ограничения — това е стандартният модел за чатове и форми за коментари.