subform子表單表單字段類型提供了一種在另一個(gè)表單中使用 XML 表單或在現(xiàn)有表單中重用表單的方法.如果屬性 multiple 設(shè)置為 true，則包含的表單將是可重復(fù)的。

表現(xiàn)形式

字段配置參數(shù)

專屬屬性：

• type (必填) 必須為 subform.
• formsource(必填) 要包含的表單定義，可以是XML文件的相對路徑（相對于站點(diǎn)的根目錄）或者可通過JForm::getInstance()找到的有效的表單名稱.
• multiple (選填) (true/false) 是否允許重復(fù)
• min (選填) 當(dāng)選擇可重復(fù)的時(shí)候，最小的重復(fù)次數(shù)。默認(rèn)為0.
• max (選填) 當(dāng)選擇可重復(fù)的時(shí)候，最大的重復(fù)次數(shù)。默認(rèn)為1000.
• default (選填)  默認(rèn)值,這里應(yīng)該是一個(gè)JSON字符串
• groupByFieldset (選填) 是否按照子表單的fieldset進(jìn)行分組，可選擇true|false。默認(rèn)為false
• buttons (選填) 。在多選模式下，需要顯示的按鈕，默認(rèn)為 add,remove,move
• layout (選填) 顯示子表單時(shí)使用的布局
• validate (選填) 推薦被設(shè)置為SubForm(注意，這里是大小寫敏感的！)，只有這樣，子表單中的字段才會被校驗(yàn)。默認(rèn)情況下，子表單的字段是不會被校驗(yàn)的，即便你指定了校驗(yàn)規(guī)則也是無效的。

通用屬性：

• name (必填)  能代表該字段的唯一的名稱.
• label (選填) (支持多語言機(jī)制) 字段的標(biāo)題
• description (選填) (支持多語言機(jī)制) 該字段的描述信息。當(dāng)鼠標(biāo)移動(dòng)到標(biāo)簽上面的時(shí)候，會以tooltip的形式顯示出來.
• default (選填) (不支持多語言機(jī)制) 默認(rèn)值
• class (選填) 表單字段的css類名。如果省略，默認(rèn)為'text_area'.
• required (選填l)  是否必須填寫內(nèi)容，用于在提交表單是進(jìn)行校驗(yàn). ( "true", "1", "readonly"這些都表示true)
• hint 顯示在html占位符元素中的文本，通常是在空白字段內(nèi)顯示的淺色提示
• readonly (選填l) 是否只讀，字段的值不能編輯. ("true", "1", "readonly" 這些都表示true)
• disabled (選填) 是否禁用字段。如果為true，那么這個(gè)字段的值不能填寫，只能展示 - 并且這個(gè)值不會在表單中提交. (可設(shè)置的值: "true", "1", "readonly" 這些都表示true)

使用方法

要使用子表單字段需要有兩個(gè)步驟。

第一步定義字段，將字段類型定義為subform,同時(shí)指定formsouce.

<field
        name="value"
        type="subform"             
        description="單選框的選項(xiàng)"
         formsource="administrator/components/com_zmaxappbuilder/fieldtype/zmaxradio/option.xml"
        multiple="true"
        label="選項(xiàng)"
        min="2"
        />

 第二步定義子表單的XML。也就是 administrator/components/com_zmaxappbuilder/fieldtype/zmaxradio/option.xml的內(nèi)容如下：

<?xml version="1.0" encoding="utf-8"?>
<form>
    <field
        name="text"
        type="text"
        required="true"
        label="選項(xiàng)文本"
    />
    <field
        name="value"
        type="text"
        hint="默認(rèn)系統(tǒng)自動(dòng)生成"
        label="選項(xiàng)值"
        description="一般供開發(fā)者傳遞參數(shù)使用，普通用戶保持默認(rèn)即可"
    />
</form>

除了單獨(dú)使用單獨(dú)的XML文件來定子表單，也可以使用內(nèi)聯(lián)的方式來定義。上面的表單可以簡化在一個(gè)XML文件中。如下：

<field
                name="value"
                type="subform"             
                description="單選框的選項(xiàng)"
                multiple="true"
                label="選項(xiàng)"
                min="2"
                >
                <form>
                    <field
                        name="text"
                        type="text"
                        required="true"
                        label="選項(xiàng)文本"
                    />
                    <field
                        name="value"
                        type="text"
                        hint="默認(rèn)系統(tǒng)自動(dòng)生成"
                        label="選項(xiàng)值"
                        description="一般供開發(fā)者傳遞參數(shù)使用，普通用戶保持默認(rèn)即可"
                    />
                </form>
            </field>

關(guān)于布局

subfrom字段有兩個(gè)“預(yù)定義”布局，用于將子表單顯示為表格或 div 容器，并支持自定義布局。布局的可選值如下：

• joomla.form.field.subform.default 以div的方式來渲染子表單，不支持重復(fù)模式。在單個(gè)記錄的時(shí)候默認(rèn)使用這個(gè)布局
• joomla.form.field.subform.repeatable 以div的方式來渲染子表單，支持重復(fù)模式。支持groupByFieldset參數(shù)
• joomla.form.field.subform.repeatable-table 以table的方式來渲染子表單，支持重復(fù)模式，支持groupByFieldset參數(shù)。默認(rèn)情況下，每一個(gè)字段梅擋住table的一欄來輸出。當(dāng)groupByFieldset=true的時(shí)候，此時(shí)每一個(gè)fieldset被擋住table的一欄來輸出。