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

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

範例

範例

用途 reasons-to-use-drop-date-picker

在自適應表單中加入日期挑選器有多項好處,包括:

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

  • 使用者體驗:透過日期挑選器元件,可讓使用者以清晰直觀的方式選取日期,使表單更加易於使用。

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

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

  • 預約和預訂:日期挑選器元件可用於預約和預訂網站,以選取簽到和簽出日期。

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

版本和相容性 version-and-compatibility

自適應表單日期挑選器核心元件於 2023 年 2 月發行,屬於 Cloud Service 核心元件 2.0.4 和 AEM 6.5.16.0 Forms 或更新版本的核心元件 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 的技術文件中可找到自適應表單日期挑選器核心元件的最新資訊。如需開發核心元件的更多資訊,請參閱核心元件開發人員文件

設定對話框 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 樣式。自適應表單日期挑選器核心元件支援 AEM 樣式系統

樣式索引標籤

  • 預設 CSS 類別:您可以為自適應表單日期挑選器核心元件提供預設 CSS 類別。

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

自訂屬性

自訂屬性對話框

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

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

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

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

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

格式索引標籤 formats-tab

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

格式索引標籤

另請參閱 see-also

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