ui:inputDateTime
日時を入力するための入力項目。
ui:inputDateTime コンポーネントは、text 型の HTML input タグとして表示される、日時の入力項目を表します。ブラウザの言語ロケールで指定されたデフォルト形式で値が表示されます。
次に、7/29/2014 1:11 PM 形式で現在の日時を表示する、日付ピッカーがある日付項目の基本設定を示します。
この例の結果、次の HTML になります。
デスクトップでは、input タグが form タグでラップされ、日付と時間の項目が 2 つの別個の項目として表示されます。フォーム要素 (DESKTOP、MOBILE、PHONE) により、日付ピッカーのサイズが決まります。時間ピッカーには、30 分単位で増分する時間のリストが表示されます。
次の例は、ui:inputDateTime コンポーネントの値を取得し、ui:outputDateTime を使用して値を表示します。
属性
| 属性名 | 属性型 | 説明 | 必須項目 |
|---|---|---|---|
| body | Component[] | コンポーネントのボディ。マークアップでは、これはタグのボディに含まれるすべてを指します。 | |
| class | String | コンポーネントに添付される CSS スタイル。このスタイルは、コンポーネントで出力される基本スタイルに追加されます。 | |
| disabled | Boolean | コンポーネントを無効な状態で表示するかどうかを指定します。デフォルト値は「false」です。 | |
| displayDatePicker | Boolean | ui:datePicker が表示されるかどうかを示します。 | |
| format | String | java.text.SimpleDateFormat スタイル形式の文字列。 | |
| label | String | 表示ラベルコンポーネントのテキスト。 | |
| labelClass | String | 表示ラベルコンポーネントの CSS クラス。 | |
| langLocale | String | 日時の書式設定に使用される言語ロケール。 | |
| required | Boolean | 入力が必須かどうかを指定します。デフォルト値は「false」です。 | |
| requiredIndicatorClass | String | 必須のインジケータコンポーネントの CSS クラス。 | |
| updateOn | String | 処理されたイベントに updateOn 属性が設定されている場合、コンポーネントの値のバインドを更新します。デフォルト値は「change」です。 | |
| value | String | 日付/時間の入力値。 |
イベント
| イベント名 | イベントタイプ | 説明 |
|---|---|---|
| dblclick | COMPONENT | コンポーネントがダブルクリックされたことを示します。 |
| mouseover | COMPONENT | ユーザがマウスポインタをコンポーネントに移動したことを示します。 |
| mouseout | COMPONENT | ユーザがマウスポインタをコンポーネントから移動したことを示します。 |
| mouseup | COMPONENT | ユーザがマウスボタンを放したことを示します。 |
| mousemove | COMPONENT | ユーザがマウスポインタを移動したことを示します。 |
| click | COMPONENT | コンポーネントがクリックされたことを示します。 |
| mousedown | COMPONENT | ユーザがマウスキーを押したことを示します。 |
| select | COMPONENT | ユーザが選択を行ったことを示します。 |
| blur | COMPONENT | コンポーネントからフォーカスが離れたことを示します。 |
| focus | COMPONENT | コンポーネントにフォーカスが置かれたことを示します。 |
| keypress | COMPONENT | ユーザがキーボードキーを押したままにしたことを示します。 |
| keyup | COMPONENT | ユーザがキーボードキーを放したことを示します。 |
| keydown | COMPONENT | ユーザがキーボードキーを押してから放したことを示します。 |
| cut | COMPONENT | ユーザがコンテンツを��り取ってクリップボードに保存したことを示します。 |
| validationError | COMPONENT | コンポーネントに検証エラーがあることを示します。 |
| clearErrors | COMPONENT | 検証エラーをすべてクリアする必要があることを示します。 |
| change | COMPONENT | コンポーネントのコンテンツまたは状況が変更されたことを示します。 |
| copy | COMPONENT | ユーザがコンテンツをクリップボードにコピーしたことを示します。 |
| paste | COMPONENT | ユーザがコンテンツをクリップボードから貼り付けたことを示します。 |