![]() |
「文字欄位」小器具可作為平台中的標準小器具使用,也可作為可從 SDL 匯入的 Web 元件 SDK 使用。
|
![]() | 您可以使用不同類型的符號,例如句點、破折號、斜線等作為字元之間的分隔符號。 |
![]() | 「文字欄位」小器具可作為平台中的標準小器具使用,也可作為可從 SDL 匯入的 web 元件使用。 |
屬性名稱 | 描述 | 基礎類型 | 預設值 | 可繫結? (Y/N) | 可當地語系化? (Y/N) | ||
---|---|---|---|---|---|---|---|
Text | 文字欄位中顯示的文字。 | STRING | n/a | Y | Y | ||
Label | 文字欄位標籤中顯示的文字。 | STRING | n/a | Y | Y | ||
Counter | 計算並顯示在文字欄位中輸入的字元數。 | BOOLEAN | False | N | N | ||
MaxNumberOfCharacters | 可讓您設定文字欄位中的最大字元數。 | NUMBER | 100 | Y | N | ||
HintText | 顯示預留位置文字,說明應在欄位中輸入的內容。 | STRING | n/a | N | Y | ||
Disabled | 使用此內容可禁用混搭中的小器具。小器具會顯示在混搭中,但您無法按一下。 | BOOLEAN | False | Y | N | ||
ReadOnly | 可讓您將文字欄位設定為唯讀,且使用者無法編輯文字。 | BOOLEAN | False | N | N | ||
Password | 可讓您隱藏文字欄位項目。 | BOOLEAN | False | N | N | ||
ShowClearText | 可讓您在文字欄位內新增「清除」按鈕,此按鈕可讓使用者於執行時間在按一下按鈕時清除欄位中的文字 | BOOLEAN | True | N | N | ||
LabelAlignment | 可讓您向左、向右或置中對齊標籤。 | STRING | 左 | N | N | ||
TextAlignment | 可讓您將文字對齊到欄位的左側或右側。 | STRING | 左 | N | N | ||
Mask | 可讓您在文字欄位中設定預先定義字元。在內容組態欄位中,使用 "a" 設定字母項目,使用 "9" 設定數字項目,使用 "*" 設定字母數字項目。 | STRING | n/a | N | N | ||
TabSequence | 使用者按下 Tab 鍵時小器具反白的順序。 | NUMBER | n/a | N | N | ||
CustomClass | 可讓您定義小器具頂部分區之 CSS。可輸入多個類別,之間以空格分隔。 | STRING | n/a | Y | N | ||
EnterKeyPressed | 在編輯文字值的情況下,按下 ENTER 鍵時觸發的事件。
| n/a | n/a | Y | N | ||
FocusLost | 在編輯文字值的情況下,使用者按下 TAB 鍵或按一下小器具之外的區域變更焦點時觸發的事件。 | n/a | n/a | Y | N | ||
Changed | 修改此小器具的資料時所觸發的事件。 | n/a | n/a | Y | N | ||
ResetToDefaultValue | 將此小器具的輸入重設為其預設值。 | n/a | n/a | Y | N | ||
Width | 小器具寬度。 | NUMBER | 273 | N | N | ||
Height | 小器具高度。預設會自動計算。如果您在文字欄位內包括標籤,高度會增加。 | NUMBER | 自動調整 | N | N | ||
TooltipField | 設定將游標置於小器具上時顯示的工具提示文字。 | STRING | n/a | Y | Y | ||
TooltipIcon | 為小器具的工具提示設定圖示圖像。 您可以新增圖像或指定圖像 URL 路徑。 | MEDIA ENTITY | n/a | N | N | ||
Icon | 指定要在文字方塊內顯示的圖示。 | SVG 圖示的清單 | n/a | N | N |
內容 | 描述 | 基礎類型 | 預設值 | 是否可繫結 (Y/N) | 可當地語系化 (Y/N) |
---|---|---|---|---|---|
CriteriaMessage | 為驗證條件以及驗證失敗時顯示的訊息。 | STRING | n/a | Y | Y |
CriteriaMessageDetails | 為驗證條件和失敗訊息顯示的詳細資訊。 | STRING | n/a | Y | Y |
MaxLength | 文字欄位值的最大長度。 | STRING | n/a | Y | N |
MaxLengthFailureMessage | 目前值超過最大字元長度時顯示的訊息。 | STRING | ${value} characters is the maximum | Y | Y |
MinLength | 文字欄位值的最小長度。 | STRING | n/a | Y | N |
MinLengthFailureMessage | 目前值小於最小字元長度時顯示的訊息。 | STRING | ${value} characters is the minimum | Y | Y |
RequiredMessage | 當「必須填寫值」設定為 true 且未選取項目時顯示的訊息。 | STRING | 需要有值 | Y | Y |
ShowValidationCriteria | 編輯文字欄位時,顯示有關所需輸入的提示訊息。 | BOOLEAN | False | Y | N |
ShowValidationFailure | 當所輸入值未通過驗證時顯示失敗訊息。 | BOOLEAN | False | Y | N |
ShowValidationSuccess | 當所輸入值成功通過驗證時,顯示成功訊息。 | BOOLEAN | False | Y | N |
SuccessMessage | 驗證成功時顯示的訊息。 | STRING | n/a | Y | Y |
SuccessMessageDetails | 顯示有關驗證成功訊息之詳細資訊的次要訊息。 | STRING | n/a | Y | Y |
Validate | 小器具值變更時觸發的可繫結事件。將此事件繫結至服務或函數以套用驗證模式或運算式。 | 事件 | n/a | Y | N |
ValidationCriteriaIcon | 設定要在驗證條件的提示訊息中顯示的 SVG 圖示。 | IMAGELINK | info | N | N |
ValidationFailureIcon | 設定當驗證失敗時要在狀況訊息中顯示的 SVG 圖示。 | IMAGELINK | error | N | N |
ValidationOutput | 擷取小器具驗證的輸出。傳回的值為 Undefined、Unvalidated、Valid 或 Invalid。 | STRING | n/a | Y | N |
ValidationState | 這是設定驗證狀態的可繫結內容。您可以將此內容設定為 Undefined、Unvalidated、Valid 或 Invalid。 | STRING | Undefined | Y | N |
ValidationSuccessIcon | 選取當驗證成功時要在狀況訊息中顯示的 SVG 圖示。 | IMAGELINK | success | N | N |
ValueRequired | 需選取清單中某一項目。 | BOOLEAN | False | Y | N |