表单组 formGroup

用法

将 input、select、textarea 等输入标签 与 label 标签结合为一组渲染输出到表单中的部件。

zin 声明

form
(
    formRow
    (
        formGroup
        (
            set::width('1/2'),
            set::label('所属项目集'),
            set::name('program'),
            set::control('inputControl')
        )
    )
);

render();

生成的 HTML

<form class="form form-grid form-ajax" id="zin4" method="post">
    <div class="form-row grow-0">
        <div class="form-group grow-0 w-1/2">
            <label class="form-label">所属项目集</label>
            <div class="input-control">
                <input class="form-control" type="text" autocomplete="off" name="program" id="program">
            </div>
        </div>
    </div>
    <div class="form-row">
        <div class="toolbar form-actions form-group gap-4 no-label">
            <button class="toolbar-item btn primary" type="submit"><span class="text">保存</span></button>
            <a class="toolbar-item btn btn-default" type="button" href=""><span class="text">返回</span></a>
        </div>
    </div>
    <script>(function(){$(() => zui.create("ajaxForm","#zin4",[]));}())</script>
</form>

属性

名称	类型	可选	默认值	说明
id	string	✓	null	ID。
name	string	✓	null	字段名，可能影响到表单提交的域名称，如果是多个值的表单控件，可能需要将名称定义为 key[] 的形式。
label	stringbool	✓	null	标签文本。
labelFor	string	✓	null	标签的 for 属性。
labelClass	string	✓	null	标签的 class 属性。
labelProps	string	✓	null	标签的其它属性。
labelWidth	intstring	✓	null	标签的宽度。
labelHint	string	✓	null	标签的提示文本。
labelHintIcon	string	✓	"help"	标签的提示图标。
labelHintClass	string	✓	null	标签的提示 class 属性。
labelHintProps	array	✓	null	标签的提示其它属性。
labelActions	array	✓	null	标签的操作按钮。
labelActionsClass	string	✓	null	标签的操作按钮 class 属性。
labelActionsProps	array	✓	null	标签的操作按钮其它属性。
checkbox	boolarray	✓	null	标签的复选框属性定义。
required	boolstring	✓	"auto"	是否必填。
requiredFields	string	✓	null	必填字段列表，例如 'product,branch'。
tip	string	✓	null	提示文本。
tipClass	stringarray	✓	null	提示 class 属性。
tipProps	array	✓	null	提示其它属性。
control	arraystring	✓	null	表单控件类型或控件属性定义。
width	string	✓	null	界面宽度。
strong	bool	✓	null	是否加粗。
value	stringarray	✓	null	值。
disabled	bool	✓	null	是否禁用。
readonly	bool	✓	null	是否只读。
multiple	bool	✓	null	是否多选。
hidden	bool	✓	null	是否隐藏。
items	array	✓	null	选项列表。
placeholder	string	✓	null	占位符。
foldable	bool	✓	null	是否可折叠。
pinned	bool	✓	null	是否固定。
children	arrayobject	✓	null	内部自定义内容。