备注表单字段
备注 表单字段类型使您可以创建标题、文本、说明,甚至警告框。它还允许您通过用有用的标题分隔设置来为扩展设置带来顺序。或者为某些设置添加说明(无需依赖工具提示)。或者添加任何其他您想要的文本。
- type (必填) 必须为 note。
- name (必填) 是字段的唯一名称。
- label (如果使用说明则为可选) (可翻译) 是字段的 html 标签。
- description (可选) (可翻译) 是 字段说明。
- heading (可选) 用于标签的标题元素类型 (可选) (默认:h4)
- class (可选) 类名 (或类名),如 alert (有关示例,请参见下文) (可选)
- close (可选) 值为 'true' (对于警告) 或 Bootstrap 关闭图标的 data-dismiss 的值
实现位置:libraries/src/Form/Field/NoteField.php
示例 XML 参数定义
<field
name="mynote"
type="note"
default=""
label="A heading goes here"
description=""
/>
标题和说明
在以下代码示例中,我们将使用这些示例语言字符串
LOREMIPSUM="Lorem ipsum dolor sit amet"
LOREMIPSUM_DESC="Consectetuer adipiscing elit, sed diam"
使用此备注字段,您可以使用标题或说明,或者两者都使用。
<field name="opt10" type="text" label="Some Other Option" />
<field name="note11" type="note" label="LOREMIPSUM" />
<field name="opt11" type="text" label="Some Other Option" />
<field name="note12" type="note" description="LOREMIPSUM_DESC" />
<field name="opt12" type="text" label="Some Other Option" />
<field name="note13" type="note" label="LOREMIPSUM" description="LOREMIPSUM_DESC" />
<field name="opt13" type="text" label="Some Other Option" />
类 (警告)
您可以将类添加到备注中。这样,您可以轻松地创建 (Bootstrap) 警告,并通过类名 (如 'well') 添加其他样式。
<field name="opt20" type="text" label="Some Other Option" />
<field name="note21" type="note" class="alert" label="LOREMIPSUM" description="LOREMIPSUM_DESC" />
<field name="opt21" type="text" label="Some Other Option" />
<field name="note22" type="note" class="alert alert-info" label="LOREMIPSUM" description="LOREMIPSUM_DESC" />
<field name="opt22" type="text" label="Some Other Option" />
<field name="note23" type="note" class="alert alert-success" label="LOREMIPSUM" description="LOREMIPSUM_DESC" />
<field name="opt23" type="text" label="Some Other Option" />
<field name="note24" type="note" class="alert alert-error" label="LOREMIPSUM" description="LOREMIPSUM_DESC" />
<field name="opt24" type="text" label="Some Other Option" />
关闭按钮
可以通过在标签中添加 close="true" 属性来向警告添加关闭按钮。如果您使用的类不是 alert,请使用 Bootstrap 关闭图标的 data-dismiss 所需的值,而不是值 true。以下是在警告上测试关闭图标的代码。
<field name="opt30" type="text" label="Some Other Option" />
<field name="note31" type="note" class="alert" close="true" label="LOREMIPSUM" description="LOREMIPSUM_DESC" />
<field name="opt31" type="text" label="Some Other Option" />
请注意,已关闭的警告/备注无法在用户重新加载页面之前重新打开。这不是显示/隐藏功能。