React XDate Picker (XDate ピッカー) の概要
XDate Picker コンポーネントは、ドロップダウン カレンダー UI を使用して日、月、年を直感的に選択できます。これは、アプリケーション ユーザーが特定の日付を選択する必要があり、複数のエディターを組み合わせて日付範囲 UI を作成する場合に便利です。
[!WARNING]
XDatePickerコンポーネントは、Ignite UI for React のバージョン 18.7.0 以降では非推奨です。サポートされている最新の Ignite UI for React Date Picker コンポーネントについては、「スケジュール」のそれぞれのページを参照してください。
React XDate Picker の例
このサンプルは、単一の日付を選択するオプションを使用して XDatePicker を作成する方法を示しています。
依存関係
XDate Picker コンポーネントをインストールするときに core と input のパッケージもインストールする必要があります。
npm install --save igniteui-react-core
npm install --save igniteui-react-inputs
npm install --save igniteui-react-layouts
コンポーネント モジュール
XDate Picker コンポーネントを使用するには、以下のモジュールを登録する必要があります。
import { IgrXDatePickerModule } from 'igniteui-react-inputs';
IgrXDatePickerModule.register();
使用方法
React XDate Picker エディター コンポーネントは、デフォルトでは、テキスト領域、カレンダー ドロップダウン ボタン、およびクリア ボタンの 3 つの構成されます。これらの領域について以下に説明します。
テキスト領域: エディターの
Valueプロパティに保存されている選択した日付を表示します。カレンダー: カレンダー ボタンをクリックすると、XDate Picker のカレンダー ドロップダウンが開きます。カレンダーが開き、現在選択されている
Valueの月が表示されます。Valueが指定されていない場合、カレンダーは現在の日付に対応する月を表示します。上部の月をクリックすると、月のリストが表示され、年も同様です。月と年の可視化の左右にある矢印ボタンは、表示されている月を時系列で増減します。クリア ボタン: x アイコンは現在の値をクリアします。
| プロパティ | タイプ | 説明 |
|---|---|---|
IconColor |
string | カレンダー ボタンの色を変更します。 |
AllowTextInput |
bool | このプロパティを true に切り替えることで、XDate Picker の値を入力して変更できます。 |
DateFormat |
enum | デフォルトは DateShort です。例: 'mm/dd/yyyy'。DateLong に設定すると、エディターに表示される曜日を含めた日付が表示されます。例: 2021年4月14日水曜日。 |
FirstDayOfWeek |
enum | デフォルトは日曜日です。特定の曜日が、カレンダーの各週の行の最初の日として使用されます。例えば、月曜日から日曜日。 |
FormatString |
string | DateShort を使用すると、日付の形式を構成できます。例えば、'dd/mm/yyyy'。DateFormat の DateLong と FormatString が設定されている場合、DateFormat は無視されることに注意してください。 |
Label |
string | XDate Picker の左上隅の日付の上にカスタム テキストを表示します。 |
MinDate |
DateTime | 以前の日付が選択または表示されないように制限します。 |
MaxDate |
DateTime | 後の日付が選択または表示されないように制限します。 |
Placeholder |
string | カレンダーの編集部分の値がクリアされたときに表示されるカスタム文字列。 |
ShowClearButton |
bool | デフォルトは true で、クリア ボタンはカレンダー ボタンのすぐ左にあり、X で視覚化されます。クリックすると、XDate Picker の Value がクリアされます。クリア ボタンの表示は、オンとオフを切り替えることができます。 |
ShowTodayButton |
bool | 本日は、カレンダーが開かれた日付のすぐ下に表示されます。クリックすると、現在の日付が選択されます。本日のボタンの表示は、オンとオフを切り替えることができます。 |
ShowWeekNumbers |
bool | 週番号は、XDate Picker のドロップダウン部分の日付のすべての行の左側に番号として表示できます。週番号の表示のオンとオフを切り替えることができます。 |
FirstWeekOfYear |
enum | 年間の週の開始番号を構成します。FirstDay、FirstFourDayWeek、FirstFullWeek に設定できます。 |
OpenOnFocus |
bool | デフォルトでは、XDate Picker のドロップダウン部分はシングル クリックで開かれ、ユーザーはカレンダー ボタンをクリックしてカレンダーをドロップダウンする必要があります。 |
Value |
date | XDate Picker の値を設定し、ドロップダウン カレンダーで選択します。 |
ユーザーは、コントロールのさまざまなテキスト プロパティを使用して XDate Picker のフォントをカスタマイズできます。使用できるプロパティは TextColor、TextFontFamily、TextFontSize、TextFontStyle、および TextFontWeight です。
編集
次の例は、XDatePicker で編集を有効にする方法を示しています。
日付制限
次の例は、XDatePicker で選択した日付を制限する方法を示しています。
日付の書式
次の例は、XDatePicker で長い日付を適用する方法を示しています。
日付範囲
次の例は、複数の XDatePicker コントロールを組み合わせる方法を示しています。
API リファレンス
以下は上記のセクションで説明した API メンバーのリストです。
XDatePickerIconColorAllowTextInputDateFormatFirstDayOfWeekFormatStringLabelMinDateMaxDatePlaceholderShowClearButtonShowTodayButtonShowWeekNumbersFirstWeekOfYearOpenOnFocusValueTextColorTextFontFamilyTextFontSizeTextFontStyleTextFontWeight