ILLA home page
  1. Date Range

日付範囲コンポーネントは、ユーザーがカレンダーインターフェイスから日付の範囲を選択できるUIコンポーネントです。 通常、ユーザーが開始日と終了日付の範囲を指定する必要があるフォームまたはデータ入力インターフェイスで使用されます。

日付範囲コンポーネントがキャンバスに追加されると、2つのカレンダーインターフェイスが並行して表示されます。 開始日を選択するにはカレンダーインターフェイスを使用し、終了日を選択するにはカレンダーインターフェイスを使用します。 ユーザーは、別の月に移動する前または次の矢印をクリックしてカレンダーをナビゲートすることができます。 または特定の日付をクリックして選択します。 選択した日付が入力フィールドに表示されます。

Properties

日付範囲の利用可能なプロパティ JavaScript はコンポーネントに関する情報を読み取りまたは変更するために書かれることがあります。

プロパティー説明
開始日コンポーネントのデフォルトの開始日時の値
終了日コンポーネントのデフォルトの終了日時の値
書式有効な日付フォーマット文字列。 https://day.js.org/docs/en/parse/string-format を参照してください。
開始プレースホルダー値は開始日時の入力フィールドが空の場合に表示されます。
エンドプレースホルダー値は、終了日時の入力フィールドが空の場合に表示されます。
最大日付カレンダーインターフェイスからユーザーが選択できる最大日付を設定します。
最小日付カレンダーインターフェイスからユーザーが選択できる最も早い日付を指定します。
ラベルユーザーに表示されるフィールドの名前
図表番号フィールドを詳細に説明するために使用されるキャプションです。
非表示ラベルラベルを表示するかどうかを設定します
位置コンポーネントに対する相対的なラベルの位置を設定します
配置ラベルの配置(左右に揃える) を設定します
Widthラベルがコンポーネントの左側にある場合、ラベルの幅比率を設定します。
イベントハンドラートリガクエリ、コンポーネントのイベントに応じてコンポーネントを制御したり、他のAPIを呼び出したりします。
無効コンポーネントが無効化されているかどうかのステータスを制御します。 無効になっている場合、コンポーネントを変更したりフォーカスしたりすることはできません。
読み取り専用コンポーネントが読み取り専用かどうかのステータスを制御します。 読み取り専用コンポーネントを選択してフォーカスできますが、変更することはできません。
ツールチップユーザはコンポーネントツールチップを入力できます。 ツールチップがフォーカスされると表示されます。 Markdown 形式がサポートされています。
クリアボタンを表示入力フィールドにクリアボタンを表示するかどうかを制御します
必須項目スイッチがオンの場合のみ有効です。
カスタムルールここにバリデーションロジックを作成します。 ルールはJavaScriptで行われ、{{}}でカバーされるべきです。
検証メッセージを隠す入力値が正しくない場合は非表示の状態を切り替えることでエラーメッセージを非表示にできます。 非表示状態はJavaScriptで動的に変更できます。
フォームデータキーdata 属性を構築する際に、ラッピングフォームコンポーネントのキーを指定します。
Hiddenコンポーネントが非表示になるかどうかを動的に制御します。 動的ブール値を使用して非表示状態を変更できます。
テーマの色ボタンの背景色と不透明度を指定できます

Methods

他のコンポーネントを使用してコンポーネントを制御できます。 以下の 2 つの方法をサポートします。

  • setStartValue

開始日時の値を設定するには {{“value1”}}

プロパティー説明
入力開始値
  • setEndValue

終了日時の値を設定するには {{“value2”}}

プロパティー説明
Input end value
  • clearValue

選択したコンポーネントの値をクリアするには

  • validate

入力情報が合法であることを確認するには

  • clearValidate

検証メッセージを消去するには

イベントハンドラ:

イベント説明
変更ユーザーが選択した日付値を変更すると、ユーザーによってカスタマイズされた特定のアクションを実行します。

データ

コンポーネントには一般的に使用されているデータがいくつか含まれており、アプリで {{componentName.propertyName}} を介して呼び出すことができます。

プロパティ名説明
colorScheme日付の色属性
customRuleユーザーが指定したカスタムルール
日付フォーマット「日付の形成」
無効ブール値は無効状態を示します
displayNameこのコンポーネントの名前 (すなわちカスケード1)
startPlaceholder開始日時のプレースホルダ値
endPlaceholder終了日時のプレースホルダ値
イベントイベントのシーケンスに対する配列値
formDataKey日付のフォームデータキー
hiddenブール値はボタンの非表示状態を示します
hideValidationMessageブール値は、検証メッセージが非表示かどうかを示します。
ラベルラベルの値
ラベルの揃えカスケードラベルの配置 (左右)
labelPositionカスケードラベルの位置 (左または右)
ラベル幅ラベルの幅を表す整数
readOnlyブール値は入力の readyOnly ステータスを示します。
必須ブール値は必須の状態を示します。
showClearブール値は日付が明確に表示されることを示します
選択した値

例: {{dateRange1.value[0]}}

大文字小文字を区別する

次に、データソースからのデータを日付範囲にマッピングし、ボタンで今日の日付に終了値を設定する方法を説明します。

ステップ 1 アクションを追加

promoteCodeと呼ばれるREST APIで、6つの列を含むテーブルを作成しましょう: codeidcreatedAtexpiredAtstartedAt`updatedAt**。 startedAt と expiredAt を使用してサンプルを使用します。

次に、アクションリストからREST APIの新しいアクションを作成し、promotecodeのすべてのデータをリストし、restapi1という名前を付けます。

SaveRunをクリックしてアクションを有効にします。

ステップ2 コンポーネントを追加

次に、date range コンポーネントと button コンポーネントをキャンバスに追加します。 日付範囲コンポーネントのデフォルトの開始日時の値には、残りの api データから最初のプロモーションコードの startedAt を使用します。

{{restapi1.data.promoteCodes[0].startedAt}}

同様に、デフォルトの終了日値では、expiredAt を使用します残りの api データから最初のプロモーションコードを使用します。

{{restapi1.data.promoteCodes[0].expiredAt}}

次に示すように、このボタンも「更新」とラベル付けしました。

date_range_0

ステップ 3 コンポーネントの設定

button コンポーネントについては、終了日時の値を date range コンポーネントに今日の日付に設定します。

  1. Edit event handlerでControl component を実行中に選択します。 イベントのターゲットとして更新する date range コンポーネントを選択します。
  2. setEndValueアクションを選択し、終了日を{{currentUserInfo.updatedAt}}`に設定します。

date_range_config

ステップ4 テスト

「更新」ボタンをクリックすると、終了日が今日の日付に変更されます。 ここでは、2023-5-6がありますが、テストしている場合は異なる場合があります。

date_range_1