🧬 コンポーネントを組み立てます
日付範囲コンポーネントは、ユーザーがカレンダーインターフェイスから日付の範囲を選択できるUIコンポーネントです。 通常、ユーザーが開始日と終了日付の範囲を指定する必要があるフォームまたはデータ入力インターフェイスで使用されます。
日付範囲コンポーネントがキャンバスに追加されると、2つのカレンダーインターフェイスが並行して表示されます。 開始日を選択するにはカレンダーインターフェイスを使用し、終了日を選択するにはカレンダーインターフェイスを使用します。 ユーザーは、別の月に移動する前または次の矢印をクリックしてカレンダーをナビゲートすることができます。 または特定の日付をクリックして選択します。 選択した日付が入力フィールドに表示されます。
日付範囲の利用可能なプロパティ JavaScript はコンポーネントに関する情報を読み取りまたは変更するために書かれることがあります。
プロパティー | 説明 |
---|---|
開始日 | コンポーネントのデフォルトの開始日時の値 |
終了日 | コンポーネントのデフォルトの終了日時の値 |
書式 | 有効な日付フォーマット文字列。 https://day.js.org/docs/en/parse/string-format を参照してください。 |
開始プレースホルダー | 値は開始日時の入力フィールドが空の場合に表示されます。 |
エンドプレースホルダー | 値は、終了日時の入力フィールドが空の場合に表示されます。 |
最大日付 | カレンダーインターフェイスからユーザーが選択できる最大日付を設定します。 |
最小日付 | カレンダーインターフェイスからユーザーが選択できる最も早い日付を指定します。 |
ラベル | ユーザーに表示されるフィールドの名前 |
図表番号 | フィールドを詳細に説明するために使用されるキャプションです。 |
非表示ラベル | ラベルを表示するかどうかを設定します |
位置 | コンポーネントに対する相対的なラベルの位置を設定します |
配置 | ラベルの配置(左右に揃える) を設定します |
Width | ラベルがコンポーネントの左側にある場合、ラベルの幅比率を設定します。 |
イベントハンドラー | トリガクエリ、コンポーネントのイベントに応じてコンポーネントを制御したり、他のAPIを呼び出したりします。 |
無効 | コンポーネントが無効化されているかどうかのステータスを制御します。 無効になっている場合、コンポーネントを変更したりフォーカスしたりすることはできません。 |
読み取り専用 | コンポーネントが読み取り専用かどうかのステータスを制御します。 読み取り専用コンポーネントを選択してフォーカスできますが、変更することはできません。 |
ツールチップ | ユーザはコンポーネントツールチップを入力できます。 ツールチップがフォーカスされると表示されます。 Markdown 形式がサポートされています。 |
クリアボタンを表示 | 入力フィールドにクリアボタンを表示するかどうかを制御します |
必須項目 | スイッチがオンの場合のみ有効です。 |
カスタムルール | ここにバリデーションロジックを作成します。 ルールはJavaScriptで行われ、{{}}でカバーされるべきです。 |
検証メッセージを隠す | 入力値が正しくない場合は非表示の状態を切り替えることでエラーメッセージを非表示にできます。 非表示状態はJavaScriptで動的に変更できます。 |
フォームデータキー | data 属性を構築する際に、ラッピングフォームコンポーネントのキーを指定します。 |
Hidden | コンポーネントが非表示になるかどうかを動的に制御します。 動的ブール値を使用して非表示状態を変更できます。 |
テーマの色 | ボタンの背景色と不透明度を指定できます |
他のコンポーネントを使用してコンポーネントを制御できます。 以下の 2 つの方法をサポートします。
開始日時の値を設定するには {{“value1”}}
プロパティー | 説明 |
---|---|
値 | 入力開始値 |
終了日時の値を設定するには {{“value2”}}
プロパティー | 説明 |
---|---|
値 | Input end value |
選択したコンポーネントの値をクリアするには
入力情報が合法であることを確認するには
検証メッセージを消去するには
イベント | 説明 |
---|---|
変更 | ユーザーが選択した日付値を変更すると、ユーザーによってカスタマイズされた特定のアクションを実行します。 |
コンポーネントには一般的に使用されているデータがいくつか含まれており、アプリで {{componentName.propertyName}}
を介して呼び出すことができます。
プロパティ名 | 説明 |
---|---|
colorScheme | 日付の色属性 |
customRule | ユーザーが指定したカスタムルール |
日付フォーマット | 「日付の形成」 |
無効 | ブール値は無効状態を示します |
displayName | このコンポーネントの名前 (すなわちカスケード1) |
startPlaceholder | 開始日時のプレースホルダ値 |
endPlaceholder | 終了日時のプレースホルダ値 |
イベント | イベントのシーケンスに対する配列値 |
formDataKey | 日付のフォームデータキー |
hidden | ブール値はボタンの非表示状態を示します |
hideValidationMessage | ブール値は、検証メッセージが非表示かどうかを示します。 |
ラベル | ラベルの値 |
ラベルの揃え | カスケードラベルの配置 (左右) |
labelPosition | カスケードラベルの位置 (左または右) |
ラベル幅 | ラベルの幅を表す整数 |
readOnly | ブール値は入力の readyOnly ステータスを示します。 |
必須 | ブール値は必須の状態を示します。 |
showClear | ブール値は日付が明確に表示されることを示します |
値 | 選択した値 |
例: {{dateRange1.value[0]}}
次に、データソースからのデータを日付範囲にマッピングし、ボタンで今日の日付に終了値を設定する方法を説明します。
promoteCode
と呼ばれるREST APIで、6つの列を含むテーブルを作成しましょう: code
、id
、createdAt
、expiredAt
、startedAt
、`updatedAt**。 startedAt と expiredAt を使用してサンプルを使用します。
次に、アクションリストからREST APIの新しいアクションを作成し、promotecodeのすべてのデータをリストし、restapi1という名前を付けます。
Save
と Run
をクリックしてアクションを有効にします。
次に、date range
コンポーネントと button
コンポーネントをキャンバスに追加します。 日付範囲コンポーネントのデフォルトの開始日時の値には、残りの api データから最初のプロモーションコードの startedAt を使用します。
{{restapi1.data.promoteCodes[0].startedAt}}
同様に、デフォルトの終了日値では、expiredAt を使用します残りの api データから最初のプロモーションコードを使用します。
{{restapi1.data.promoteCodes[0].expiredAt}}
次に示すように、このボタンも「更新」とラベル付けしました。
button
コンポーネントについては、終了日時の値を date range
コンポーネントに今日の日付に設定します。
Control component
を実行中に選択します。 イベントのターゲットとして更新する date range
コンポーネントを選択します。setEndValue
アクションを選択し、終了日
を{{currentUserInfo.updatedAt}}`に設定します。 「更新」ボタンをクリックすると、終了日が今日の日付に変更されます。 ここでは、2023-5-6がありますが、テストしている場合は異なる場合があります。