把表單描述成一份 JSON 配置,再由程式渲染成 DOM,是後台系統常見的做法——新增欄位時不必改 HTML,改配置就好。本文拆解這套智能表單的完整配置結構。
config: { autoLayout: true | '1,2,2,4' }
兩種模式:
true(自動):依各配置組中最內層的項目數量,自動套用不同柵格。兩項用 2-4、三項用 1-3,以此類推。
字串(固定):如 '1,2,2,4',明確指定每一組使用的柵格。若配置的組數不足以對應所有元素,會循環取用第一項作為預設。
hides: [{ id: 'xxx', value: '' }]
可選項。用於編輯模式時保存主鍵 ID 這類「使用者看不到但送出時要帶」的欄位。渲染時這些欄位會以隱藏元素存在表單中,取資料時一併序列化。
支援兩種組織方式:
// 非分組:交叉陣列,外層是「組」,內層是元素
eles: [[], []]
// 分組:以 JSON 對象,鍵為組名
eles: { '個人資訊': [] }
每個元素的完整寫法其實是:
{ label: {}, ele: {} }
把標籤屬性與元素屬性分開放,是為了擴充性——label 與 ele 各自會長出不同的屬性,混在一起很快就難以維護。
label: {
target: '#contain.id', // for 屬性指向的元素
className: 'col-sm-2', // 套用到 label 的 class
text: '#contain.title' // 顯示文字
}
target 預設為 ele 的 id;text 預設為 ele 的 title。若 ele 中設定了 required: true,會自動在 label 內生成一個 <span> 作為校驗提示的容器。
{
type: '', // text(預設) | select | radio | checkbox | textarea | datetime | search
id: '',
name: '',
value: '', // 預設值
className: 'col-sm-4', // 元素套用的 class
readonly: false,
disable: false,
extendAttr: { key: value }, // 轉為 data- 屬性
required: false,
render: '', // 直接指定 HTML,優先級最高
prev: { type: 'button', iconClassName: '', ele: { render: '' } },
next: { iconClassName: '', ele: { render: '' } }
}
type 與數據源
當 type 為 select、radio、checkbox 時,必須提供 items:
items: [{ text: '男', value: 1, select: '可選' }]
其中 select 標記該項是否為預設選中。
select 的 withNull
{ type: 'select', withNull: true, items: [...] }
設為 true 時會在數據源最前面補一項「-- 請選擇 --」空值選項,常用於「可不填」的下拉。
checkbox 的特殊性
items 中的每一項都可以有自己的 id、name 與 select,這讓多選組的每個選項能被獨立定位與預設勾選。
render:完全自訂
render: '<input type="file" name="" id="" />'
設了 render 之後,其他配置項都會被忽略,直接以這段 HTML 作為元素內容。prev 與 next 中的 ele 同樣支援:
prev: { ele: { render: '' } }
prev 與 next:前後綴元素
用於在輸入框前面或後面附加元素,例如前置單選框、後置驗證碼圖:
{
ele: {
pre: { text: '<input type="radio">' },
type: 'text',
name: 'DisplayName',
title: '顯示名稱:'
}
}

前後同時配置也是支援的。
extendAttr:擴充屬性
extendAttr: { select: true }
// 渲染結果:<select data-select="true">
只支援 HTML5 的 data- 屬性,鍵值會自動加上前綴。這是掛自訂標記給外掛使用的主要管道。
readonly / disable
控制元素狀態。要注意兩者差異:readonly 的元素仍會隨表單提交,disabled 的則不會。若某欄位要顯示但不能改,用 readonly;若要暫時排除某欄位不送出,用 disabled。
'組名': [{}, {}]
例如 '個人資訊': [{...}, {...}]。分組模式會在渲染時產生對應的分區標題與容器,適合欄位較多的表單。
優點:表單結構資料化,易於動態生成、易於版本比對、易於做權限控制(依角色決定哪些 ele 要渲染或設為 disabled)。
缺點:配置語言本身是一種小型 DSL,團隊成員需要學習成本;遇到配置表達不了的複雜交互(例如「A 選了某值時 B 才顯示且必填」),仍得回頭寫程式碼,此時配置反而成為障礙。
實務上的建議是:把「欄位清單、型別、標籤、必填」這類靜態資訊放進配置,把「跨欄位聯動邏輯」留在程式碼中,兩者分工,不要硬把全部塞進 JSON。