iOS 中 UITextView 的展开/收起功能：优雅呈现多行文本

2023-12-17 09:27:11

在 iOS 应用程序的开发中，我们经常面临处理多行文本的情形。UITextView 组件提供了展示和编辑多行文本的便捷方式，但当文本长度超出可用空间时，就有必要实现文本的展开/收起功能。本文将深入探讨如何在 UITextView 中实现这一功能，并提供一个简洁易用的解决方案。

UITextView 基础

UITextView 是一个功能强大的组件，允许用户输入和编辑多行文本。它提供了广泛的属性和方法，可用于定制文本的外观和行为。为了实现展开/收起功能，我们将利用 UITextView 的以下关键属性：

text： 包含文本视图中显示的文本。
contentSize： 表示文本视图的内容大小，包括文本的实际大小和任何内边距或边框。
frame： 定义文本视图在屏幕上的位置和大小。

实现展开/收起功能

为了实现展开/收起功能，我们将遵循以下步骤：

文本截断： 首先，我们需要确定文本是否超出了可用空间。为此，我们可以比较文本视图的内容大小和框架大小。如果内容大小大于框架大小，则需要截断文本。
创建展开/收起按钮： 接下来，我们将创建一个按钮，用户可以点击该按钮来展开或收起文本。我们可以使用 UIButton 或其他自定义控件。
更新文本和按钮状态： 当用户点击展开/收起按钮时，我们将更新文本视图的文本属性和按钮的状态。如果文本处于展开状态，我们将显示完整文本并禁用按钮；如果文本处于收起状态，我们将截断文本并启用按钮。
调整视图布局： 最后，我们将根据文本视图的新状态调整视图布局。如果文本已展开，我们将增加文本视图的高度以容纳完整文本；如果文本已收起，我们将减小文本视图的高度以显示截断文本。

代码示例

以下是一个在 Swift 中实现展开/收起功能的代码示例：

import UIKit

class ViewController: UIViewController {

    // MARK: - Outlets

    @IBOutlet weak var textView: UITextView!
    @IBOutlet weak var expandCollapseButton: UIButton!

    // MARK: - Lifecycle

    override func viewDidLoad() {
        super.viewDidLoad()

        // 设置初始文本
        textView.text = "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas eget lacus eget nunc tincidunt laoreet. Sed eget lacus eget nunc tincidunt laoreet. Sed eget lacus eget nunc tincidunt laoreet."

        // 检查文本是否需要截断
        checkTextTruncation()
    }

    // MARK: - Actions

    @IBAction func expandCollapseButtonTapped(_ sender: UIButton) {
        // 切换文本视图状态
        if textView.isTruncated {
            // 展开文本
            textView.isScrollEnabled = true
            textView.text = originalText
            expandCollapseButton.setTitle("收起", for: .normal)
        } else {
            // 收起文本
            textView.isScrollEnabled = false
            checkTextTruncation()
            expandCollapseButton.setTitle("展开", for: .normal)
        }
    }

    // MARK: - Helper Methods

    func checkTextTruncation() {
        // 检查文本是否超出了可用空间
        let contentSize = textView.contentSize
        let frameSize = textView.frame.size
        
        if contentSize.height > frameSize.height {
            // 截断文本
            let truncatedText = textView.text.prefix(200) + "..."
            textView.text = truncatedText
            expandCollapseButton.isHidden = false
        } else {
            // 禁用按钮
            expandCollapseButton.isHidden = true
        }
    }
}