子表格，比如发票上的明细项或订单上的税费，会以表格形式打印。本页介绍如何选择它们的列、设置样式、将多个值合并到一个单元格中，以及只打印部分行。
适用于 Frappe v16 及更高版本。
添加表格
子表格和其他字段一样位于字段选项卡中，类型为表格。将其拖入某个区域即可。表格通常单独放在一个单列区域中，这样它就能占满页面的整个宽度。
如果你想按自己的方式排列每一行，而不是使用网格布局，请使用自定义表格块。
表格设置
选中表格即可查看其设置。
表格
| 设置 | 选项 | 作用 |
|---|---|---|
| 标题 | 文本，配合显示标题 | 表格上方的标题，例如“明细项”。 |
| 样式 | 网格、行、斑马纹、无 | 网格绘制所有线条。行仅在行之间绘制线条。斑马纹为每隔一行添加底纹。无不绘制任何线条。 |
| 表头 | 带样式、普通、无 | 带样式为表头行添加背景色。普通将其作为普通文本打印。无隐藏表头行。 |
| 单元格内边距 | 像素 | 每个单元格内部的空间。 |
| 圆角 | 像素 | 将表格的角变为圆角。 |
| 最小高度 | 像素 | 即使行数很少，也保持表格至少有这么高。适用于预印好的信纸。 |
列
列列表按打印顺序显示各列，顶部显示列数。
- 添加列：在添加列…中输入内容并选择一个字段。序号会添加行号。
- 重新排序：通过拖动手柄来拖动某一列。
- 重命名：点击列名并输入新的标题。
- 移除：点击旁边的×。
点击列旁边的设置按钮可进行更多操作：
| 设置 | 作用 |
|---|---|
| 宽度 | 该列占表格的比例，以百分比表示。留空则平均分配空间。 |
| 日期格式 | 用于日期列。 |
| 合并字段 | 在同一单元格中、主值下方显示更多字段。见下文。 |
| 显示列条件 | 仅当关于文档的条件为真时才打印该列。 |
如果某一列在每一行中的单元格都为空，该列会被自动省略，其他列会扩展以填补空间。
将字段合并到一个单元格
合并可以让一个单元格承载多个值，例如以粗体显示明细项名称，并在其下方以灰色显示其编码和描述。
- 打开该列的设置，例如明细项。
- 在合并字段下，点击添加字段…并选择一个字段，例如描述。
- 为每个合并字段选择一种样式。该列自身的字段始终以主要样式首先打印。
| 样式 | 外观 |
|---|---|
| 主要 | 粗体、深色文本 |
| 次要 | 正常字重、深色文本 |
| 代码 | 小号灰色等宽文本，用于编码和 SKU |
| 弱化 | 小号灰色文本，用于较长的描述 |
你添加的第一个字段默认为次要，后续字段默认为弱化。
图像字段（例如明细项图片）则会改为获得一个尺寸设置，这样你就可以在明细项名称旁边打印一个小缩略图。
- 将方向设置为垂直以堆叠这些值，或设置为水平以将它们并排放置。
样式
| 设置 | 作用 |
|---|---|
| 表头 | 表头行的背景颜色。当表头为带样式时显示。 |
| 边框 | 线条的颜色。 |
| 自定义 CSS | 你为表格编写的自定义 CSS。 |
可见性
| 设置 | 作用 |
|---|---|
| 条件 | 仅当此条件为真时才打印整个表格。 |
| 显示行条件 | 仅打印满足此条件的行。使用 row. 来引用该行的字段。留空则打印每一行。 |
显示行条件的一些示例：
row.qty > 0 # skip zero quantity rows
row.item_group != "Services" # leave out service items
not row.is_free_item # hide free items
有关条件如何工作，请参阅显示或隐藏内容。
相关主题
- 块：自定义表格
- 显示或隐藏内容