文本字段#
文本字段允许单行文本输入和编辑。
何时使用#
对于需要文本输入的操作（例如搜索或消息传递）使用文本字段。文本字段也可以用于表单或首选项，但这些情况下，通常更推荐使用 条目行。
指南#
文本字段通用指南
文本字段应具有占位符文本或标签。通常，占位符文本比标签更受欢迎，因为它允许更优雅的 UI 布局。但是，如果文本字段包含文本时其用途不明确，则应使用标签。
文本字段标签应使用 标题大写，并为标签分配访问键，以便人们可以使用键盘来聚焦控件。
占位符文本可以像标签一样措辞。或者，如果文本字段执行某个操作，则可以将其措辞为指令，后跟省略号。例如：“搜索城市…”或“写消息…”
根据文本字段将要包含的内容的可能大小来调整文本字段的大小。这为预期的输入量提供了一个有用的视觉提示。
当文本字段包含属性或设置时，按下 Return 键或字段失去焦点时应用任何更改。
可以将按钮和图标嵌入到文本字段中。这可以帮助提供反馈（例如，指示进度的微调器）或常用操作（例如，清除按钮）。嵌入的按钮和图标应使用 符号样式。
文本验证#
文本字段通常需要其内容具有特定的格式，例如 URL 或十六进制颜色值。在这种情况下，提供有效的反馈非常重要。
在执行此操作时，通常最好在内容有效时显示肯定反馈，而不是在内容无效时显示否定反馈。这可以避免在用户编辑字段时分散注意力和造成困惑。
通常最好在编辑字段时实时显示反馈，而不是等到字段失去焦点。
密码字段#
密码字段是一种特殊的文本字段，GNOME 提供了 专用控件。这隐藏了输入的文本，可以使用按钮显示，并且可以用于任何潜在的敏感文本。
可以在 GTK 4 演示应用程序的 Entry → Password Entry 演示中找到密码字段示例。
自动建议#
当用户在文本字段中键入时，建议潜在的文本通常很有帮助。例如，地址字段可以在用户键入时显示以前的位置。这可以减少用户的工作量并减少错误。
可以在 GTK 4 演示应用程序的 Entry → Completion 示例中找到自动建议示例。