## 說明 **表單構建器**提供的表單字段類型（含自定義字段類型）除了在表單構建器里面集成使用外，還可以單獨調用渲染使用。 > 提示！字段集合頂部容器須攜帶屬性lay-filter="{{formId}}" * html ```html <div class="layui-form" lay-filter="test_form"> <div class="field-box text"> <div class="title">單行文本框示例</div> <div class="control"></div> </div> ... </div> ``` * js ```javascript layui.use(['yunj'],function (){ // 配置項 let options = { formId:"test_form", key:"text_key", args:{ "placeholder":"測試文本框" } }; yunj.formField("text",options).then(field=>{ // 指定父容器渲染 return field.render(`.field-box.text .control`).then(res=>{}); }).then(field=>{ // field為當前字段對象 }).catch(err=>console.log(err)); }); ``` ## 方法 **yunj.formField(type,options)** 構建字段對象。 此方法返回值是一個promise對象，執行成功返回字段對象，根據字段對象可渲染字段html結構 / 設置字段值 / 獲取字段值 * 參數 | key | 類型 | 是否必須 | 說明 | | --- | --- | --- | --- | | type | string | 是 | 字段類型，詳見：[字段配置](http://www.hmoore.net/worklz/yunj_admin_tp51/2526419) | | options | object | 是 | 配置項 | * 配置項參數 | key | 類型 | 是否必須 | 說明 | | --- | --- | --- | --- | | formId | string | 是 | 表單id | | key | string | 是 | 字段key | | args | object | 否 | [字段配置](http://www.hmoore.net/worklz/yunj_admin_tp51/2526419) | 注意：字段配置args中`type`屬性不再必須（由`yunj.formField(type,options)`第一個參數取代），`title`/`desc`屬性不設置的情況下，不再渲染對應屬性的html結構。 ## 常用方法 * **yunj.formClear(formId)** 清空表單id對應的所有字段值 * **yunj.formReset(formId)** 重置表單id對應的所有字段值 * **yunj.formData(formId,validate)** 獲取表單id對應的所有字段值，傳入validate則會自動校驗參數。示例如下： ```javascript layui.use(["yunj","validate"],()=>{ let validate = yunj.validate; let data = yunj.formData("test",validate); }); ```