DIV CSS 佈局教程網

Bootstrap 智能表單實戰:表單配置 JSON 結構詳解
編輯:關於JavaScript     

把表單描述成一份 JSON 配置,再由程式渲染成 DOM,是後台系統常見的做法——新增欄位時不必改 HTML,改配置就好。本文拆解這套智能表單的完整配置結構。

一、config:控制版面配置

config: { autoLayout: true | '1,2,2,4' }

兩種模式:

true(自動):依各配置組中最內層的項目數量,自動套用不同柵格。兩項用 2-4、三項用 1-3,以此類推。

字串(固定):如 '1,2,2,4',明確指定每一組使用的柵格。若配置的組數不足以對應所有元素,會循環取用第一項作為預設。

二、hides:存放不可見欄位

hides: [{ id: 'xxx', value: '' }]

可選項。用於編輯模式時保存主鍵 ID 這類「使用者看不到但送出時要帶」的欄位。渲染時這些欄位會以隱藏元素存在表單中,取資料時一併序列化。

三、eles:表單元素配置(重點)

支援兩種組織方式:

// 非分組:交叉陣列,外層是「組」,內層是元素
eles: [[], []]

// 分組:以 JSON 對象,鍵為組名
eles: { '個人資訊': [] }

為什麼元素外還包一層 ele

每個元素的完整寫法其實是:

{ label: {}, ele: {} }

把標籤屬性與元素屬性分開放,是為了擴充性——label 與 ele 各自會長出不同的屬性,混在一起很快就難以維護。

label 的配置

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> 作為校驗提示的容器。

ele 的配置

{
  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。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved