# 文本

> 画面上的固定文字：大小、横竖对齐、字重、倾斜和文字颜色，全都由你指定。

**文本**是画面上写的字：一幅画面的标题、图元下面的一句说明、一组东西的抬头。它是唯一一个整份配置都在讲自己的字怎么画的组件：它没有一处是地址，不读任何点位，也从不戴读数异常标记或者锁标记。它属于*显示*类；新放置的一个占 4 × 1 个单元格。

数值、状态指示灯、输入框和滑块都是有意不画自己的说明文字的，所以在仪表画面上给东西起名，靠的正是文本组件：把一个放在它所说明的那个组件旁边，位置随你。

## 内容 {#content}

| 字段 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 文本 | 显示在仪表画面上的文字。它同时也是自动字号背后的那份声明：改写这些字，就改变了字号所受约束的那个宽度。 | 自由文本 | `文本` |

## 字体 {#type}

这些字是怎么画的。本分区是文本组件自己的；组件那个*方框*长什么样，也就是边框、填充、角上标题和内容缩放，属于共用的[外观分区](components#the-shared-property-sections)。

| 字段 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 字号 | 由单元格决定字号，还是由你指定。指定的字号才能让一幅画面上的各句说明文字彼此一致：交给单元格去适配的话，每一句都按自己那个单元格定大小，没有两句会一样。 | `单元格容得下的最大尺寸` · `我指定的大小` | `单元格容得下的最大尺寸` |
| 磅 | 指定的那个字号。只在指定模式下显示，而且照字面来：单元格和内容缩放不再改变它。单元格容不下的文字用省略号截断，完整文字在提示里。超出区间的字号按最近的那个边界取，面板会说明这一点。 | 9 到 144 磅 | 12 |
| 横向 | 这些字在单元格里横着往哪边排。 | `靠左` · `居中` · `靠右` | `靠左` |
| 纵向 | 这一行落在单元格的上下之间的什么位置。单元格短到容不下这一行时，文字从顶部挂下来并保持可读，而不是上下都被切掉。 | `靠上` · `居中` · `靠下` | `居中` |
| 粗体 | 用粗体字重绘制文字。 | 开 / 关 | 关 |
| 斜体 | 让文字倾斜。 | 开 / 关 | 关 |
| 文字颜色 | 文字的颜色从哪里来。界面自身的文字颜色已经会响应当前运行的主题；你自己给的颜色则是一对，每个主题各占一半。 | `界面自身的文字颜色` · `一种颜色` | `界面自身的文字颜色` |
| 浅色 / 深色 | 那对颜色，只在**文字颜色**为`一种颜色`时显示。两半同时留在屏幕上，因为由当前运行的主题决定哪一半上色：只给一种颜色，会悄悄毁掉另一个没被选中的主题。每一半都是一个色块加一个十六进制字段（`#RRGGBB`）；只写了一半的十六进制会被拒绝，字段弹回当前生效的颜色。 | 各写 `#RRGGBB` | 浅色 `#1A1A1A` · 深色 `#F3F3F3` |

## 截断 {#truncation}

两种字号模式下这条规矩都成立：单元格容不下的部分用省略号截断，完整文字在提示里。自动模式下，字号的上限是写好的那些字所预留的宽度，按字符逐个计算，所以 `i` 和 `W` 不会算成一样宽，也正因如此，两个同样大小、写着同样文字的单元格，画出来的字号总是一样的。

共用的外观、标识、位置与图层、动作这几个分区，写在[组件页面](components#the-shared-property-sections)。