字段

字段就是文档中的各种值:客户名称、过账日期、总计金额。本页介绍如何把它们放到页面上,以及如何修改每个字段的打印方式。

适用于 Frappe v16 及更高版本。

添加字段

  1. 打开左侧面板中的字段标签页。它会列出文档的所有字段,右侧显示字段类型。
  2. 在搜索字段中输入内容来查找字段。在编辑器任意位置按 / 可快速跳到此输入框。
  3. 将字段拖入某一列,或点击它将其添加到所选字段的下方。如果没有选中任何内容,它会添加到最后一个区块中。

要移动字段,把它拖到其他位置,或选中后按 Alt+↑ 或 Alt+↓。要删除字段,选中后按 Delete。

你可以一次选中多个字段:Shift+点击选中一个范围,Ctrl+点击(Mac 上为 Cmd+点击)逐个添加字段。

字段设置

选中一个字段后,右侧面板会显示它的设置。只有适用于该字段的设置才会出现,所以日期字段有日期格式选项,长文本字段可以跨页拆分。

字段

设置 作用
标签 打印在值旁边的文字。可以在这里修改,而不用改动表单,例如把“客户名称”改成“账单抬头”。
显示标签 关闭后只打印值。
日期格式 用于日期字段。选择一种格式,例如 dd-mm-yyyy 或 d MMM yyyy。每个选项都会用该格式显示今天的日期。系统默认使用系统设置中的格式。
隐藏冒号 仅当页面设置中开启了标签后加冒号时显示。用于单独去掉这个字段的冒号。

样式

设置 作用
加粗 以粗体打印值。
字体大小 该字段文字的大小,单位为像素。留空则使用页面字体大小。
标签和值 标签和值的颜色。保持默认则使用页面颜色。

布局

设置 选项 作用
对齐 左、居中、右 设置字段在其列中的对齐方式。
间距 正常、两端对齐、均匀分布 仅当区块的标签位置为左侧时可用。两端对齐会把值推到右边缘,很适合用于合计。
标签间距 像素 仅当标签位置为左侧时可用。标签和值之间的间距。
跨页拆分 开、关 用于条款和备注等长文本字段。让较长的值延续到下一页,而不是整体跳到下一页。

自定义 CSS

仅作用于该字段的 CSS。它会以内联样式应用到该字段,所以直接写声明,不要写选择器:

border-top: 1px solid #e5e7eb;
padding-top: 6px;

可见性

仅在条件成立时打印该字段。参见“显示或隐藏内容”。

空字段

没有值的字段不会出现在打印结果中,标签和值都不会显示。这样可以让页面保持整洁,例如发票没有采购订单号时。在页面上,空字段会以灰色加短横线显示。

如果你希望即使没有值也打印标签,请使用“关联字段”区块,它有一个为空时打印设置。

提示

  • 要让标签和值显示在同一行,请把区块的标签位置设为左侧,而不是逐个设置字段。
  • 要打印其他文档中的值,例如客户的税号,请使用“关联字段”区块。
  • 要打印固定文字,例如“感谢您的惠顾”,请使用“文本”区块。
  • 表格
  • 区块
  • 显示或隐藏内容