最適化表單運算式 adaptive-form-expressions

Adobe 建議使用新式且可擴充的資料擷取核心元件，用來建立新的最適化表單或將最適化表單新增到 AEM Sites 頁面。這些元件代表最適化表單建立方面的重大進步，可確保令人印象深刻的使用者體驗。本文會介紹使用基礎元件編寫最適化表單的舊方法。

適用性表單透過動態指令碼功能，為使用者提供最佳化和簡化的表單填寫體驗。 它可讓您編寫運算式以新增各種行為，例如動態顯示/隱藏欄位和面板。 它也可讓您新增計算欄位、讓欄位成為唯讀、新增驗證邏輯等。 動態行為取決於使用者輸入或預填的資料。

JavaScript是適用性表單的運算式語言。 所有運算式都是有效的JavaScript運算式，並使用適用性表單指令碼模型API。 這些運算式會傳回某些型別的值。 如需最適化表單類別、事件、物件和公用API的完整清單，請參閱最適化表單的JavaScript資料庫API參考。

撰寫運算式的最佳作法 best-practices-for-writing-expressions

涉及重複面板之運算式的最佳作法 best-practices-for-expressions-involving-repeating-panel

重複面板是使用指令碼API或預先填入的資料，以動態方式新增或移除的面板例項。 如需使用重複面板的詳細資訊，請參閱建立具有可重複區段的表單。

運算式型別 expression-types

在調適型表單中，您可以撰寫運算式以新增行為，例如動態顯示/隱藏欄位和面板。 您也可以撰寫運算式來新增計算欄位、讓欄位成為唯讀、驗證邏輯等。 調適型表單支援下列運算式：

存取運算式（啟用運算式） access-expression-enablement-expression

您可以使用存取運算式來啟用或停用欄位。 如果運算式使用欄位的值，則每當欄位的值變更時，就會重新觸發運算式。

套用至：欄位

傳回型別：運算式傳回布林值，代表欄位是啟用還是停用。 true ​代表欄位已啟用，false ​代表欄位已停用。

範例：若要僅在​ 欄位1 ​的值設為​ X ​時啟用欄位，存取運算式為： field1.value == "X"

計算運算式 calculate-expression

計算運算式用於使用運算式自動計算欄位的值。 通常，這類運算式會使用其他欄位的值屬性。 例如 field2.value + field3.value。每當field2或field3的值變更時，就會重新觸發運算式並重新計算值。

套用至：欄位

傳回型別：運算式傳回與顯示運算式結果的欄位相容的值（例如，小數）。

範例：顯示​ 欄位1 ​中兩個欄位總和的計算運算式是：
field2.value + field3.value

按一下運算式 click-expression

click運算式會處理對按鈕的點選事件執行的動作。 GuideBridge開箱即用地提供API來執行各種功能，例如提交、驗證以及按一下運算式使用。 如需API的完整清單，請參閱GuideBridge API。

套用至：按鈕欄位

傳回型別：點選運算式未傳回任何值。 如果有任何運算式傳回值，則會忽略值。

範例：若要在值為​ AEM Forms ​之按鈕的點選動作上填入文字方塊​ textbox1，按鈕的點選運算式為textbox1.value="AEM Forms"

初始化指令碼 initialization-script

初始化最適化表單時會觸發初始化指令碼。 根據情境，初始化指令碼會以下列方式運作：

套用至： ​欄位和面板

傳回型別： ​初始化指令碼運算式未傳回任何值。 如果有任何運算式傳回值，則會忽略值。

範例： ​在資料預填案例中，若要在欄位的值儲存為Null時以預設值'Adaptive Forms'填入欄位，初始化指令碼運算式為：
if(this.value==null) this.value='Adaptive Forms';

選項運算式 options-expression

選項運算式可用來動態填入下拉式清單欄位的選項。

套用至：下拉式清單欄位

傳回型別：選項運算式會傳回字串值的陣列。 每個值都可以是簡單字串，例如​ Male，或是索引鍵=值配對格式，例如​ 1=Male

範例：若要根據其他欄位的值填入欄位的值，請提供簡單的選項運算式。 例如，若要根據其他欄位中表達的​ 婚姻狀況 ​填入欄位​ Number of Kids，運算式為：

marital_status.value == "married" ? ["1=One", "2=two"] : ["0=Zero"].

每當​ writure_status ​欄位的值變更時，就會重新觸發運算式。 您也可以填入REST服務的下拉式清單。 如需詳細資訊，請參閱動態填入下拉式清單。

摘要運算式 summary

摘要運算式會動態計算摺疊式功能表版面面板的子面板標題。 您可以在規則中指定摘要運算式，該運算式使用表單欄位或自訂邏輯來評估標題。 運算式會在表單初始化時執行。 如果您要預先填寫表單，則運算式會在資料預先填寫後或運算式中使用的相依欄位值變更時執行。

摘要運算式通常用於重複摺疊式功能表版面面板的子面板，以對每個子面板提供有意義的標題。

套用至： ​面板，這些面板是配置為Accordion之面板的直接子項。

傳回型別： ​運算式傳回的字串會成為摺疊式功能表的標題。

範例：「帳號： " + textbox1.value

驗證運算式 validate-expression

驗證運算式是使用指定的運算式來驗證欄位。 通常，這類運算式會使用規則運算式以及欄位值來驗證欄位。 系統會重新觸發運算式，並在欄位值發生任何變更時，重新計算欄位的驗證狀態。

套用至：欄位

傳回型別：運算式傳回代表欄位驗證狀態的布林值。 值​ false ​表示欄位無效，true ​表示欄位有效。
範例：對於代表UK郵遞區號的欄位，驗證運算式為：

(this.value && this.value.match(/^(GIR 0AA|[A-Z]{1,2}\d[A-Z0-9]? ?[0-9][A-Z]{2}\s*)$/i) == null) ? false : true

在上述範例中，如果非空白值不符合模式，運算式會傳回​ false ​以表示欄位無效。

值認可指令碼 value-commit-script

當出現下列情況時，就會觸發值認可指令碼：

套用至： ​欄位

傳回型別： ​值認可指令碼運算式未傳回任何值。 如果有任何運算式傳回值，則會忽略值。

範例： ​若要將在欄位中輸入的字母大小寫轉換成認可時的大寫，值認可運算式為：
this.value=this.value.toUpperCase()

可見性運算式 visibility-expression

「可見性」運算式用於控制欄位/面板的可見性。 通常，可見性運算式會使用欄位的值屬性，每當該值變更時就會重新觸發。

套用至：欄位和面板

傳回型別：運算式傳回布林值，代表欄位/面板是否可見。 false ​代表未顯示欄位或面板，而true代表顯示欄位或面板。

範例：對於只有當​ 欄位1 ​的值設定為​ 男性 ​時才可見的面板，可見性運算式是： field1.value == "Male"

步驟完成運算式 step-completion-expression

步驟完成運算式用於防止使用者進入精靈配置的下一個步驟。 當面板有精靈版面配置（一次顯示一個步驟的多步驟表單）時，就會使用這些運算式。 只有當目前區段中的所有必要值都已填寫且有效時，使用者才能移至下一個步驟、面板或子區段。

套用至：專案配置設定為精靈的面板。

傳回型別：運算式傳回布林值，代表目前的面板是否有效。 True ​表示目前的面板有效，使用者可以導覽至下一個面板。

範例：在組織於各種面板的表單中，在導覽至下一個面板之前，將會驗證目前的面板。 在這種情況下，會使用步驟完成運算式。 一般而言，這些運算式會使用GuideBridge驗證API。 步驟完成運算式的範例為：
window.guideBridge.validate([],this.panel.navigationContext.currentItem.somExpression)

最適化表單中的驗證 validations-in-adaptive-form

有多種方法可以將欄位驗證新增到最適化表單。 如果在欄位上新增驗證檢查，True ​表示在欄位中輸入的值有效。 False ​表示值無效。 如果您在欄位中或欄位之外使用Tab鍵，則不會產生錯誤訊息。

在欄位中新增驗證的方法如下：

必填 required

若要讓元件成為必要元件，請在元件的​ 編輯 ​對話方塊中，選取選項​ 標題與文字>必要。 您也可以新增適當的​ 必要訊息 （選擇性）。

驗證模式 validation-patterns

有一個欄位可使用多個現成的驗證模式。 若要選取驗證模式，請在元件的​ 編輯 ​對話方塊中，找到​ 模式 ​區段並選取​ 模式。 您可以在​ 模式 ​文字方塊中建立您自己的自訂驗證模式。 只有在填入的資料符合驗證模式時，才會傳回驗證狀態​ True，否則會傳回​ False。 若要撰寫您自己的自訂驗證模式，請參閱HTML5表單🔗的Picture子句支援。

驗證運算式 validation-expressions

欄位驗證也可使用不同欄位上的運算式計算。 這些運算式會寫入元件​ 編輯 ​對話方塊之​ 指令碼 ​索引標籤的​ 驗證指令碼 ​欄位中。 欄位的驗證狀態取決於運算式傳回的值。 如需如何撰寫這類運算式的資訊，請參閱驗證運算式。

其他資訊 additional-information

使用欄位顯示格式 using-field-display-format

「顯示格式」可用於以不同格式顯示資料。 例如，您可以使用顯示格式來顯示連字型大小的電話號碼、郵遞區號格式或日期選擇器。 您可以從元件之「編輯」對話方塊的​ 模式 ​區段選取這些顯示模式。 您可以撰寫與上述驗證模式類似的自訂顯示模式。

GuideBridge - API和事件 guidebridge-apis-and-events

GuideBridge是API的集合，可用來與瀏覽器中記憶體模型中的調適型表單互動。 如需指南Bridge API、類別方法、公開事件的詳細介紹，請參閱最適化表單的JavaScript資料庫API參考。

在各種運算式中使用GuideBridge guidebridge-usage-in-various-expressions

在運算式外部使用GuideBridge  using-guidebridge-outside-expressions-nbsp

您也可以在運算式之外使用GuideBridge API。 例如，您可以使用GuideBridge API來設定託管最適化表單和表單模型的頁面HTML之間的通訊。 此外，您也可以設定來自託管表單之Iframe父級的值。

若要針對上述範例使用GuideBridge API，請擷取GuideBridge的例項。 若要擷取執行個體，請接聽window物件的bridgeInitializeStart事件：

window.addEventListener("bridgeInitializeStart", function(evnt) {

     // get hold of the guideBridge object

     var gb = evnt.detail.guideBridge;

     //wait for the completion of AF

     gb.connect(function (){

        //this function will be called after Adaptive Form is initialized

     })

})

若要在初始化表單之後使用GuideBridge （已傳送bridgeInitializeComplete事件），請使用window.guideBridge取得GuideBridge執行個體。 您可以使用guideBride.isConnected API來檢查GuideBridge初始化狀態。

GuideBridge事件 guidebridge-events

GuideBridge也在託管頁面上提供某些外部指令碼事件。 外部指令碼可監聽這些事件並執行各種作業。 例如，每當表單中的使用者名稱變更時，顯示在頁面標題中的名稱也會變更。 如需這類事件的詳細資訊，請參閱最適化表單的JavaScript資料庫API參考。

請使用下列程式碼來註冊處理常式：

guideBridge.on("elementValueChanged", function (event, data)  {

      // execute some logic when value of a field is changed

});

為欄位建立自訂模式 creating-custom-patterns-for-a-field

如上所述，調適型表單可讓作者提供驗證或顯示格式的模式。 除了使用現成可用的模式外，您還可以為最適化表單元件定義可重複使用的自訂模式。 例如，您可以定義文字欄位或數值欄位。 定義之後，您可以在指定元件型別的所有表單中使用這些模式。 例如，您可以建立文字欄位的自訂模式，並在其最適化表單的文字欄位中使用它。 您可以存取元件之「編輯」對話方塊中的「模式」區段，以選取自訂模式。 如需有關模式定義或格式的詳細資訊，請參閱HTML5表單🔗的Picture子句支援。

執行以下步驟來建立特定欄位型別的自訂模式，並重複用於相同型別的其他欄位：