跳至主要内容

TextArea

在 ChatGPT 中打开
阴影 dwc-textarea 24.10
Java API

TextArea 组件提供了一个多行文本输入字段，用户可以在其中输入和编辑较长的文本块。它支持最大字符限制、段落结构、换行和验证规则，以控制输入的处理方式。

创建 TextArea​

通过将标签传递给其构造函数来创建 TextArea。可以通过设置方法配置占位符文本、字符限制和换行行为等属性。

显示代码

管理段落​

TextArea 组件提供处理文本段落的功能，非常适合需要文档编辑或结构化文本输入的应用程序。

以下是如何构建和操作段落内容的快速示例：

TextArea textArea = new TextArea();

// 在开头插入一个段落
textArea.addParagraph(0, "这是第一段。");

// 在末尾添加另一段
textArea.addParagraph("这是第二段。");

// 向第一段追加内容
textArea.appendToParagraph(0, " 这句话继续第一段。");

// 删除第二段
textArea.removeParagraph(1);

// 检索并打印所有当前段落
List<String> paragraphs = textArea.getParagraphs();
for (int i = 0; i < paragraphs.size(); i++) {
  System.out.println("段落 " + i + ": " + paragraphs.get(i));
}

验证​

TextArea 组件支持两种互补的验证类型：结构约束和内容约束。

结构约束 关注文本的组织和视觉布局。例如：

  • setLineCountLimit(int maxLines) 限制文本区域中的行数。
  • setParagraphLengthLimit(int maxCharsPerLine) 限制每段（或每行）的字符数，有助于强制执行可读性或格式标准。

内容约束 则处理输入的总体文本量，无论其分布如何：

  • setMaxLength(int maxChars) 限制所有段落允许的总字符数。
  • setMinLength(int minChars) 强制最低长度，确保提供足够的内容。

以下演示允许用户实时调整验证限制，例如最大字符数、段落长度和行数，并查看 TextArea 是如何响应的。

显示代码

单词换行和行换行​

可以通过 setLineWrap() 控制文本是换行还是水平滚动。当换行被禁用时，行会在可见区域之外水平延续，需要滚动。当启用时，文本在达到组件边缘时会自动换行到下一行。

为了进一步细化换行的行为，setWrapStyle() 让您可以选择两种样式：

  • WORD_BOUNDARIES 在完整单词处换行，保持自然的阅读流。
  • CHARACTER_BOUNDARIES 在单个字符处换行，允许对布局进行更严格的控制，特别是在狭窄或固定宽度的容器中。

这些换行选项与结构约束（如行数和段落长度限制）密切配合。换行决定了文本在可用空间内如何流动，而结构限制定义了文本被允许占用多少空间。它们共同帮助维护视觉结构和用户输入边界。

显示代码

预测文本​

TextArea 组件支持智能文本建议，以帮助用户更快速且更少错误地输入文本。当用户输入文本时，会根据当前输入显示预测建议，允许他们完成常见或预期的短语。

通过按 Tab 或 ArrowRight 键可以接受预测，将建议的文本无缝插入到输入中。如果在给定时刻没有合适的预测，输入保持不变，用户可以继续输入而不会中断——确保此功能不会妨碍用户。

这种预测行为提高了速度和准确性，尤其是在重复输入场景或短语一致性很重要的应用中。

显示代码

信息

此演示使用 Datamuse API 提供基于用户输入的单词建议。预测的质量和相关性完全依赖于 API 的数据集和得分机制。它不使用 AI 模型或大型语言模型（LLMs）；建议是从一个轻量级、基于规则的引擎生成的，侧重于词汇相似性。

只读和禁用状态​

TextArea 组件可以设置为只读或禁用，以控制用户交互。

只读 文本区域允许用户查看和选择内容，但不能编辑。这对于显示动态或预填信息而不应更改非常有用。

禁用 文本区域则阻止所有交互——包括焦点和文本选择——并通常样式为非活动或灰色。

当内容相关但不可变时使用只读模式；当输入当前不适用或应暂时禁用时使用禁用模式。

显示代码

样式​

Loading...