日期選擇器元件 date-picker-adaptive-forms-core-component

最適化表單中的日期選擇器元件是使用者介面元素,可讓使用者從行事曆選取日期,或以特定格式手動輸入日期。 日期選擇器元件可設定為有不同的格式、驗證和預設值。

範例

範例

使用情況 reasons-to-use-drop-date-picker

在最適化表單中加入日期選擇器有幾個好處,包括:

  • 便利性:日期選擇器元件可讓使用者輕鬆從行事曆選取日期,而不需在文字欄位中手動輸入日期。 這樣可以節省時間並減少錯誤。

  • 使用者體驗:可以使用日期選擇器元件,讓使用者以清楚且直覺的方式選取日期,讓表單更方便使用。

  • 資料分析:日期選擇器元件可用來收集來自各種來源的資料,並加以分析,或用來作為進一步處理的輸入。

  • 事件管理:日期選擇器元件可用於事件管理網站,以選取事件日期。

  • Booking and reservation:日期選擇器元件可用於預訂和預訂網站,以選取簽到和簽出日期。

  • 日期格式:日期選擇器元件可用來修正顯示和輸入日期的格式。 確保表單中的日期格式一致,以確保一致的使用者體驗。

版本和相容性 version-and-compatibility

最適化Forms摺疊式功能表核心元件於2023年2月發行,屬於AEM 6.5.16.0 Forms或更新版本適用的Cloud Service核心元件2.0.4和核心元件1.1.12的一部分。 下表顯示所有支援版本、AEM相容性以及對應檔案的連結:

元件版本
AEM as a Cloud Service
AEM 6.5.16.0 Forms或更新版本
v1

版本2.0.4和更新版本相容

版本1.1.12及更新版本相容,但小於2.0.0。

如需核心元件版本和發行版本的詳細資訊,請參閱核心元件版本檔案。

技術細節 technical-details

GitHub的技術檔案中取得最適化Forms日期選擇器核心元件的最新資訊。 如需開發核心元件的詳細資訊,請參閱核心元件開發人員檔案

設定對話方塊 configure-dialog

您可以透過「設定」對話方塊輕鬆自訂訪客的日期選擇器體驗。 您也可以輕鬆定義日期選擇器選項,以提供順暢的使用者體驗。

基本標籤 basic-tab

基本索引標籤

  • 名稱 — 此名稱可唯一識別規則編輯器中的元件。 名稱字串中不允許特殊字元和空格。

  • 標題 — 標題是出現在最適化表單中元件頂端的字串。 標題可唯一識別最適化表單樹狀結構中的元件。 如果您未新增標題,則會顯示元件的名稱而非標題文字。

  • 允許標題使用RTF格式 — 此功能可讓使用者格式化純文字標題,並整合如粗體、斜體、底線文字、各種字型、字型大小、顏色等功能以及可增強視覺呈現和自訂的其他選項。 它提供更大的彈性和創意控制,讓標題在檔案、網站或應用程式中脫穎而出。
    選取​ 允許標題為RTF格式 ​的核取方塊後,即可看到格式化選項,以設定元件標題的樣式。 若要存取所有可用的格式選項,您可以按一下 全熒幕圖示 標籤。

    RTF支援

  • 隱藏標題 — 選取此選項可隱藏最適化表單中元件型別的標題。

  • 預留位置文字 — 表單元件中的預留位置文字是指在輸入欄位中顯示的簡短標籤或提示,作為使用者在該欄位中預期輸入何種資訊型別的提示。 當使用者開始在欄位中輸入時,預留位置文字消失,如果欄位留空,則會重新出現。 它向使用者提供視覺提示,但不會作為欄位的永久標籤或值。

  • 繫結參考 — 繫結參考是儲存在外部資料來源中並在表單中使用的資料元素的參考。 繫結參考可讓您將資料動態繫結至表單欄位,讓表單可顯示資料來源的最新資料。 例如,繫結參考可用於根據在表單中輸入的客戶ID在表單中顯示客戶名稱和地址。 繫結參考也可用來使用輸入到表單中的資料更新資料來源。 透過這種方式,AEM Forms可讓您建立與外部資料來源互動的表單,提供順暢的使用者體驗來收集和管理資料。

  • 標籤為未繫結的表單元素:選取選項以設定未連結至任何結構描述的表單欄位。 此選項可讓您儲存資料而不更新資料來源。 它也可讓您以自訂方式處理資料,與標準資料庫整合不同。

  • 隱藏元件 — 選取選項,以隱藏表單中的元件。 元件仍可於其他用途存取,例如將其用於規則編輯器中的計算。 當您需要儲存不需要由使用者看到或直接變更的資訊時,這將很有用。

  • 停用元件 — 選取選項以停用元件。 一般使用者無法啟動或編輯已停用的元件。 使用者可以看到欄位的值,但無法修改它。 元件仍可於其他用途存取,例如將其用於規則編輯器中的計算。

  • 唯讀 — 選取選項,讓元件無法編輯。 使用者可以看到欄位的值,但無法修改它。 元件仍可於其他用途存取,例如將其用於規則編輯器中的計算。

  • 預設日期 — 此選項可讓您新增日期至表單欄位。 依預設,輸入的日期會顯示在元件的位置。 如果使用者未輸入日期,此值會在提交表單時提交。 如果選取​ 已停用的元件 ​或​ 唯讀元件,預設日期會顯示在熒幕上,並在表單提交時提交。

驗證標籤 validation-tab

驗證標籤

  • 必要 — 如果您想要在最適化表單中顯示元件,請選取此選項。 選取選項後,您必須先進行選取,才能繼續提交表單。 選取此選項時,您無法在​ 基本 ​索引標籤中選取​ 隱藏元件 ​或​ 停用元件

  • 錯誤訊息 — 此選項可讓您輸入在勾選「必要」核取方塊並將表單欄位保留空白時顯示的訊息。

  • 指令碼驗證訊息 — 此選項可讓您輸入指令碼驗證失敗時顯示的訊息。

  • 最小日期 — 此選項可讓您輸入所需的最小日期。 如果您輸入的日期早於在「最小日期」中指定的日期,畫面會顯示錯誤訊息。 最小錯誤訊息 ​對話方塊可讓您新增自訂錯誤訊息。

  • 最小錯誤訊息 — 如果您輸入的日期早於​ 最小日期 ​選項中指定的日期,則​ 最小錯誤訊息 ​對話方塊可讓您新增要顯示的自訂錯誤訊息。

  • 排除最小日期 — 此選項允許忽略指定範圍或日期集內的最小日期。

  • 最大日期 — 此選項可讓您輸入所需的最大日期。 如果您輸入的日期晚於在「最大日期」中指定的日期,則畫面會顯示錯誤訊息。 最大錯誤訊息 ​對話方塊可讓您新增自訂錯誤訊息。

  • 最大錯誤訊息 — 如果您輸入的日期晚於​ 最大日期 ​選項中指定的日期,則​ 最大錯誤訊息 ​對話方塊可讓您新增要顯示的自訂錯誤訊息。

  • 排除最大日期 — 此選項可忽略指定範圍或日期集內的最大日期。

說明內容標籤 help-content-tab

說明內容標籤

  • 簡短說明 — 簡短說明是簡短文字說明,提供特定表單欄位用途的其他資訊或說明。 它可協助使用者瞭解應在欄位中輸入哪種資料型別,並可提供指引或範例,以協助確保輸入的資訊有效並符合所需條件。 依預設,簡短說明會維持隱藏狀態。 啟用​ 永遠顯示簡短描述 ​選項,以在元件下方顯示它。

  • 永遠顯示簡短描述 — 啟用選項以在元件下方顯示簡短描述。

  • 說明文字 — 說明文字是指提供給使用者的其他資訊或指引,以協助使用者正確填寫表單欄位。 當使用者按一下放置於元件旁的說明圖示(i)時,就會出現此選項。 說明文字提供的資訊比表單欄位的標籤或預留位置文字更詳細,其設計旨在協助使用者瞭解欄位的需求或限制。 它也可以提供建議或範例,讓填寫表單更容易、更準確。

協助工具標籤 accessibility-tab

協助工具標籤

  • 熒幕助讀程式文字 — 熒幕助讀程式文字是指視力不佳人士使用的輔助技術(例如熒幕助讀程式)專門用於閱讀的其他文字。 此文字提供表單欄位用途的音訊說明,並可包含欄位標題、說明、名稱和任何相關訊息(自訂文字)的相關資訊。 熒幕助讀程式文字可協助確保表單可供所有使用者存取,包括視覺障礙的使用者,並提供他們對表單欄位及其要求的完整瞭解。

    • 自訂文字:選取此選項即可使用ARIA協助工具標籤的自訂文字。 選取此選項會顯示「自訂文字」對話方塊。 您可以在「自訂文字」對話方塊中新增相關資訊。
    • 說明:選取此選項即可使用ARIA協助工具標籤的說明。
    • 標題:選取此選項即可使用ARIA協助工具標籤的標題。
    • 名稱:選取此選項即可使用ARIA協助工具標籤的名稱。
    • :如果您不想新增ARIA協助工具標籤,請選取此選項。

格式標籤 format-tab

格式索引標籤

  • 顯示格式 — 它代表向使用者顯示的日期格式。 型別 ​選項可讓使用者選取日期格式。 您也可以使用​ 型別 ​下拉式功能表中的​ 自訂 ​選項來自訂日期格式。

  • 編輯格式 — 它代表使用者可以編輯日期的日期格式。 型別 ​選項可讓使用者選取日期格式。 您也可以使用​ 型別 ​下拉式功能表中的​ 自訂 ​選項來自訂日期格式。

  • 格式錯誤訊息 — 此選項可讓您在輸入的日期格式不正確時,輸入畫面上顯示的訊息。

  • 語言 — 此功能用於格式化特定欄位。 當使用者從​ 型別 ​下拉式功能表選取任何語言選項時,IETF BCP 47語言標籤 ​選項會出現在面板中。 將最適化表單翻譯成特定語言時,您可以選擇欄位格式化的語言。

預設不會顯示語言集,但使用者可以更新範本原則來輸入自訂​ IETF BCP 47語言標籤

  1. 在範本編輯器中開啟與最適化表單相關的對應範本。

  2. 從下拉式功能表中選取現有原則為datepicker-default-policy

    日期選擇器範本原則

  3. 按一下​ 「完成」

    note note
    NOTE
    如需如何將最適化表單轉譯為特定地區設定的詳細資訊,請按一下這裡

設計對話方塊 design-dialog

「設計」對話方塊可用來定義和管理日期選擇器元件的CSS樣式。

樣式索引標籤 styles-tab

索引標籤可用來定義和管理元件的CSS樣式。 最適化Forms日期選擇器核心元件支援AEM 樣式系統

樣式標籤

  • 預設CSS類別:您可以為最適化Forms日期選擇器核心元件提供預設CSS類別。

  • 允許的樣式:您可以提供名稱以及代表樣式的CSS類別來定義樣式。 例如,您可以建立名為「粗體文字」的樣式,並提供CSS類別「font-weight: bold」。 您可以在最適化Forms編輯器中將這些樣式使用或套用至最適化表單。 若要套用樣式,請在最適化Forms編輯器中,選取您要套用樣式的元件,導覽至屬性對話方塊,然後從​ 樣式 ​下拉式清單中選取所需的樣式。 如果您需要更新或修改樣式,只要返回「設計」對話方塊,更新樣式索引標籤中的樣式,然後儲存變更即可。

自訂屬性

自訂屬性對話方塊

自訂屬性可讓您使用表單範本,將自訂屬性(索引鍵/值組)與最適化表單核心元件建立關聯。 自訂屬性會反映在元件Headless轉譯的properties區段中。 它可讓您建立根據自訂屬性值調整的動態表單行為。 例如,開發人員可以為行動、桌上型電腦或Web平台設計各種無頭Forms元件的轉譯,大幅提升各種裝置的使用者體驗。

  • 群組名稱:您可以提供一個名稱來識別自訂屬性群組。 您可以新增、刪除或重新排列多個自訂屬性群組。 新增自訂屬性群組後,您可以看到下列選項:

    • 索引鍵 — 值配對:您可以按一下每個自訂屬性群組的​ 新增 ​按鈕,以新增多個自訂屬性名稱和自訂屬性值。

    • 刪除:點選或按一下以刪除自訂屬性名稱和自訂屬性值。

    • 重新排列:點選或按一下並拖曳以重新排列自訂屬性名稱和自訂屬性值。

格式標籤 formats-tab

格式索引標籤可讓您指定預設和自訂日期格式。

Formattab

相關文章 related-articles

另請參閱 see-also

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c