[]
事前定義された範囲が選択されている場合でも、 カレンダーをドロップダウンに表示したままにするかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値はfalseです。
これにより、事前定義された範囲が選択された場合、コントロールはカレンダーを非表示にします。
ドロップダウンから選択または入力要素をクリックした後に、テキスト部分がクリックされたときに単語/数字部分を選択するかどうかを示す値を取得または設定します。
このプロパティのデフォルト値はtrueです。
ドロップダウンボックスに表示されるCalendar コントロールへの参照を取得します。
ユーザーがコントロールの入力要素をクリックしたときに実行する操作を決定する値を取得または設定します。
ほとんどのドロップダウンコントロールに対して、このプロパティはデフォルトで ClickAction.Select に設定されます。これにより、ユーザーはマウスでテキストの一部を選択できます。
編集不可のテキストを表示するドロップダウンコントロール(MultiSelectなど)の場合、このプロパティはデフォルトでClickAction.Toggleに設定されます。
ユーザーが選択操作を行ったときにドロップダウンを自動的に閉じるかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値はtrueです。
isDroppedDown プロパティがtrueに設定されているときに表示されるドロップダウン要素を取得します。
コントロールのドロップダウン要素に追加するCSSクラス名を取得または設定します。
このプロパティは、ドロップダウン要素をスタイル設定する場合に便利です。 ドロップダウン要素は、 コントロール自体の子としてではなく、ドキュメントボディの子として表示され、 親コントロールに基づいてCSSセレクタを使用することができないためです。
選択された日付の表示に使用される書式を取得または設定します。
選択された日付の表示に使用される書式を取得または設定します。
書式文字列は、.NET形式の 日付書式文字列として表されます。 このプロパティのデフォルト値は 'd'で、カルチャに依存する短い日付形式 (例:米国では6/15/2020、フランスでは15/6/2020、 日本では2020/6/15)を表します。
ユーザーがマウスホイールで現在の値を編集できるかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値はtrueです。
このプロパティをfalseに設定すると、コントロールのドロップダウンcalendarのカスタムのホイール操作も無効になります。
コントロールをホストしているDOM要素を取得します。
コントロールによってホストされているHTML入力要素を取得します。
このプロパティは、入力要素の属性をカスタマイズする場合に使用します。
たとえば、以下のコードはinputElementプロパティを使用して、コントロールの入力要素にaria-label属性を追加することでアクセシビリティを向上させます。
// InputDateコントロールを作成し、アクセシビリティを向上させるためにaria-labelを追加します
let inputDate = new InputDate('#theInputDate');
inputDate.inputElement.setAttribute('aria-label', 'enter trip start date in format month/day/year')
コントロールによってホストされているHTML入力要素の"type"属性を取得または設定します。
デフォルト設定が現在のカルチャ、デバイス、またはアプリケーションでうまく機能しない場合は、 このプロパティを使用してデフォルト設定を変更します。 このような場合は、値を「tel」または「text」に変更してください。
ドロップダウンを表示するときにコントロールがフェードインアニメーションを使用するかどうかを示す値を取得または設定します。
このプロパティのデフォルト値はfalseです。
コントロールが無効かどうかを判定する値を取得または設定します。
無効化されたコントロールは、マウスイベントやキーボードイベントを取得できません。
ドロップダウンが現在表示されているかどうかを示す値を取得または設定します。
このプロパティのデフォルト値はfalseです。
ユーザーがマウスとキーボードを使用してコントロール値を変更できるかどうかを示す値を取得または設定します。
このプロパティのデフォルト値はfalseです。
コントロール値をnull以外の値に設定する必要があるか、 それとも(コントロールのコンテンツを削除することで)nullに設定できるかを 決定する値を取得または設定します。
このプロパティは、ComboBox、InputDate、InputTime、InputDateTime、 およびInputColor などのほとんどのコントロールに対してデフォルトでtrueに設定されます。 AutoComplete コントロールに対してデフォルトでfalseに設定されます。
現在、コントロールがタッチイベントを処理しているかどうかを示す値を取得します。
コントロールが現在更新中かどうかを示す値を取得します。
ドロップダウンカレンダーの日付をカスタマイズするフォーマッター関数を取得または設定します。
このフォーマッター関数は、任意の日付に任意の内容を追加できます。そのため、カレンダーの外観と動作を全面的にカスタマイズすることが可能です。
この関数は以下の2つのパラメーターをとります。
以下のサンプルコードは週末を無効な状態で表示します。
inputDate.itemFormatter = (date, element) => {
const day = date.getDay();
element.style.backgroundColor = day == 0 || day == 6 ? 'yellow' : '';
}
日付が選択可能かどうかを決定するバリデーター関数を取得または設定します。
指定された場合、このバリデーター関数は、調べる日付を表す1つのパラメーターを受け取り、その日付が無効で選択できない場合、falseを返す必要があります。
以下のサンプルコードは、週末の日付を選択できないようにします。
inputDate.itemValidator = date => {
const weekday = date.getDay();
return weekday != 0 && weekday != 6;
}
編集中に使用するマスクを取得または設定します。
マスクの書式は、wijmo.input.InputMask コントロールで使用される書式と同じです。
指定する場合、このマスクは format プロパティおよびseparatorプロパティの値と互換性がある必要があります。 たとえば、「MM/dd/yyyy」と書式設定された日付範囲の入力に、「-」区切り文字でマスク「99/99/9999 - 99/99/9999」を使用できます。
ユーザーが入力できる最も遅い日付を取得または設定します。
このプロパティのデフォルト値は nullです。これは、最も早い日付が定義されていないことを意味します。
min およびmax プロパティの使用方法については、 「minおよびmaxプロパティの使用<」トピックを参照してください。
ユーザーが入力できる最も早い日付を取得または設定します。
このプロパティのデフォルト値は nullです。これは、最も早い日付が定義されていないことを意味します。
min およびmax プロパティの使用方法については、 「minおよびmaxプロパティの使用<」トピックを参照してください。
ドロップダウンカレンダーに表示する月数を取得または設定します。
このプロパティのデフォルト値は2です。
このプロパティの詳細については、Calendar.monthCountプロパティを参照してください。
同じカレンダーに複数の月を表示する場合、月は折り返し可能なflex-boxコンテナを使用して表示されます。 CSSを使用して、ドロップダウンの行ごとに表示される月数を制限できます。
たとえば、次のサンプルコードドは、行ごとに3か月を表示するドロップダウンを使用してInputDateコントロールを作成します。
import { InputDate } from '@grapecity/wijmo.input';
let idt = new InputDate(document.createElement('#theInputDate'), {
monthCount: 6,
dropDownCssClass: 'three-months-per-row'
});
.three-months-per-row .wj-calendar-multimonth {
width: calc(3 * 21em);
}
コントロールが空のときにヒントとして表示される文字列を取得または設定します。
事前定義された範囲を定義するオブジェクトを取得または設定します。
このプロパティは、selectionModeプロパティがDateSelectionMode.Rangeに設定されている場合にのみ役に立ちます。
オブジェクト内の各プロパティは、事前定義された範囲を表し、プロパティ名で識別され、2つの日付(範囲の開始と終了)を持つ配列で定義されます。
null値のプロパティは、カレンダーをクリックして定義するカスタム範囲を表します。
以下に例を示します。
import { DateTime } from '@grapecity/wijmo';
import { InputDate } from '@grapecity/wijmo.input';
new InputDate(host, {
selectionMode: 'Range',
predefinedRanges: getRanges()
});
function getRanges() {
let dt = DateTime,
now = new Date();
return {
'今週': [dt.weekFirst(now), dt.weekLast(now)],
'先週': [dt.weekFirst(dt.addDays(now, -7)), dt.weekLast(dt.addDays(now, -7))],
'来週': [dt.weekFirst(dt.addDays(now, +7)), dt.weekLast(dt.addDays(now, +7))],
'今月': [dt.monthFirst(now), dt.monthLast(now)],
'先月': [dt.monthFirst(dt.addMonths(now, -1)), dt.monthLast(dt.addMonths(now, -1))],
'来月': [dt.monthFirst(dt.addMonths(now, +1)), dt.monthLast(dt.addMonths(now, +1))],
'カスタムの範囲': null
};
}
範囲選択で最後に選択された日付を取得または設定します。
日付範囲の選択を有効にするには、selectionModeプロパティをDateSelectionMode.Rangeに設定します。
日付範囲の編集時に許可される最大長を取得または設定します。
このプロパティは、selectionModeプロパティがDateSelectionMode.Rangeに設定されている場合にのみ使用されます。
このプロパティのデフォルト値は0です。これは、範囲の長さの最大値がないことを意味します。
日付範囲の編集時に許可される最小日数を取得または設定します。
このプロパティは、selectionModeプロパティがDateSelectionMode.Rangeに設定されている場合にのみ使用されます。
このプロパティのデフォルト値は0です。これは、範囲の長さの最小値がないことを意味します。
カレンダーボタンがリピートボタン(押された状態で繰り返し実行するボタン)として動作するかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値はtrueです。
要素内のコントロールを右から左のレイアウトでホストするかどうかを示す値を取得します。
ユーザーが日、範囲や月を選択できるか、またはどの値も選択できないかを決定する値を取得または設定します。
このプロパティは、ドロップダウンカレンダーの動作に影響しますが、 日付の表示に使用する書式には影響しません。 selectionMode を'Month'に設定した場合は、通常、 format プロパティを'MMM yyyy'などの日を含まない書式に 設定する必要があります。次に例を示します。
import { InputDate } from '@grapecity/wijmo.input';
var inputDate = new InputDate('#el, {
selectionMode: 'Month',
format: 'MMM yyyy'
});
このプロパティのデフォルト値はDateSelectionMode.Dayです。
このプロパティは、selectionModeプロパティがDateSelectionMode.Rangeに設定されている場合にのみ使用されます。
このプロパティのデフォルト値は「 - 」です。
コントロールにドロップダウンボタンを表示するかどうかを示す値を取得または設定します。
このプロパティのデフォルト値はtrueです。
カレンダーに現在の月とナビゲーションボタンのある領域を表示するかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値はtrueです。
ユーザーが月カレンダーのヘッダー要素をクリックすると、カレンダーに 月のリストを表示するかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値はShowMonthPicker.Firstです。
ユーザーが年カレンダーのヘッダー要素をクリックすると、ドロップダウンカレンダーに 年のリストを表示するかどうかを決定する値を取得または設定します。
このプロパティのデフォルト値はtrueです。
コントロールに関連付けられたtabindex属性の値を取得または設定します。
tabindex属性値は、コントロールのホストHTML要素で指定することで、 Wijmoコントロールに対して静的に定義できます。 ただし、Wijmoコントロールは複雑な構造であり、コントロールが正しく機能できるように、属性値を内部要素に伝達する必要があるため、 この値をアプリケーションのライフサイクルの後半で変更することはできません。
そのため、コントロールのtabindexを動的に読み取ったり変更したりするには、このプロパティを使用して行う必要があります。
コントロールに表示されるテキストを取得または設定します。
現在選択されている日付を取得または設定します。
このプロパティのデフォルト値は現在の日付です。
カレンダーに現在の月の後に表示する週数を取得または設定します。
このプロパティのデフォルト値はzeroです。
カレンダーに現在の月の前に表示する週数を取得または設定します。
このプロパティのデフォルト値はzeroです。
DropDown コントロールのインスタンス化に使用されるテンプレートを取得または設定します。
このControl が所有する要素にイベントリスナーを追加します。
コントロールは、アタッチされているリスナーとそのハンドラのリストを保持し、 コントロール が破棄されているときにそれらを簡単に削除すること ができます(dispose と removeEventListener ) メソッドを参照してください)。
イベントリスナーを削除しないと、メモリリークが発生する可能があります。
デフォルトでは passive パラメータはfalseに設定されています。これはイベントハンドラが event.preventDefault() を呼び出すことを意味します。 タッチイベントまたはマウスホイールイベントにpassiveハンドラを追加する場合は、このパラメータをtrueに設定するとアプリケーションのパフォーマンスが向上します。
passive イベントリスナーの詳細については、「Improving scrolling performance with passive listeners」を参考してください。
イベントのターゲット要素。
イベントを指定する文字列。
イベントが発生したときに実行する関数。
リスナーがターゲット要素によって処理される前にコントロールによって処理される必要があるかどうかを示します。
ハンドラーが preventDefault() を呼び出さないことを示します。
コントロールの新しいインスタンスにテンプレートを適用し、ルート要素を返します。
このメソッドは、テンプレート化されたコントロールのコンストラクターによって呼び出される必要があるため、 このメソッドを使用することができません。 また、テンプレートのパーツを対応するコントロールのメンバに連結します。
以下のサンプルコードは、InputNumber コントロールのインスタンスにテンプレートを適用します。 このテンプレートには、'wj-part'属性が'input'、'btn-inc'、および'btn-dec'に設定された要素を含める必要があります。 コントロールのメンバである'_tbx'、'_btnUp'、'_btnDn'には、これらの要素への参照が割り当てられます。
this.applyTemplate('wj-control wj-inputnumber', templateString, {
_tbx: 'input',
_btnUp: 'btn-inc',
_btnDn: 'btn-dec'
}, 'input');
@param classNames コントロールのホスト要素に追加するクラスの名前。 @param template コントロールのテンプレートを定義するHTML文字列。 @param parts パーツ変数とその名前のディクショナリー。 @param namePart ホスト要素にちなんで名付けられたパーツの名前。 これにより、コントロールがフォームで使用されたときにデータをどのように送信するかが決まります。
次にendUpdate が呼び出されるまで通知を中断します。
このコントロールにフォーカスのある要素が含まれているかどうかをチェックします。
beginUpdate/endUpdate ブロック内で関数を実行します。
この関数の実行が完了するまでコントロールは更新されません。 このメソッドは、関数が例外を生成した場合でも endUpdate が呼び出されるようにします。
実行する関数。
beginUpdate の呼び出しによって中断された通知を再開します。
このコントロールにフォーカスを設定します。
オブジェクトが指定されたプロパティを持つかどうかを判定します。
プロパティの名前。
指定したオブジェクトからプロパティをコピーしてコントロールを初期化します。
このメソッドを使用すると、各プロパティの値をコードで設定する代わりにプレーンなデータオブジェクトを使用してコントロールを初期化できます。
例:
grid.initialize({
itemsSource: myList,
autoGenerateColumns: false,
columns: [
{ binding: 'id', header: 'Code', width: 130 },
{ binding: 'name', header: 'Name', width: 60 }
]
});
// 以下と同等です。
grid.itemsSource = myList;
grid.autoGenerateColumns = false;
// など
初期化データは適用時に型チェックされます。 初期化オブジェクトに不明なプロパティ名または無効なデータ型が含まれている場合、このメソッドは例外を発生します。
初期化データを含むオブジェクト。
非同期更新を発生させるため、コントロールを無効にします。
内容だけでなくコントロールのレイアウトも更新するかどうか。
オブジェクトが別のオブジェクトのプロトタイプチェーンに存在するかどうかを判定します。
プロトタイプチェーンが判定される別のオブジェクト。
invalidInput イベントを発生させます。
イベントハンドラーがイベントをキャンセルした場合、コントロールは無効な入力内容とフォーカスを保持します。
rangeChanged イベントを発生させます。
rangeEndChanged イベントを発生させます。
refreshing イベントを発生させます。
textChanged イベントを発生させます。
valueChanged イベントを発生させます。
指定されたプロパティが列挙可能かどうかを判断します。
プロパティの名前。
このControl が所有する要素にアタッチされている1つまたは複数のイベントリスナーを解除します。
イベントのターゲット要素。 nullの場合、すべてのターゲットにアタッチされているリスナーが解除されます
イベントを指定する文字列。 nullの場合、すべてのイベントにアタッチされているリスナーが解除されます。
削除するハンドラ。 nullの場合は、すべてのハンドラが削除されます。
リスナーがキャプチャリスナーかどうか。 nullの場合、キャプチャリスナーと非キャプチャリスナーの両方が解除されます。
削除されたリスナーの数。
コントロールにフォーカスを設定してそのすべての内容を選択します。
現在のロケールを使用して文字列に変換された日付を返します。
オブジェクトの文字列表現を返します。
指定されたオブジェクトのプリミティブ値を返します。
HTML要素に含まれるすべてのWijmoコントロールを破棄します。
コンテナー要素。
指定したDOM要素でホストされているコントロールを取得します。
コントロールをホストするDOM要素、またはホスト要素のCSS セレクター(例: '#theCtrl')。
指定したHTML要素に含まれるすべてのWijmoコントロールを無効化します。
このメソッドは、コントロールの表示状態やサイズを変更する 動的なパネルをアプリケーションで使用している場合に使用します。 たとえば、スプリッタ、アコーディオン、およびタブコントロールは通常、 その中の要素の表示状態を変更します。この場合、その要素に含まれるコントロールに通知しないと、 それらのコントロールが適切に機能しなくなる可能性があります。 これが起こる場合は、動的コンテナーで適切なイベントを処理し、 Control.invalidateAll メソッドを呼び出してコンテナー内のWijmoコントロールの レイアウト情報が適切に更新されるようにする必要があります。
コンテナー要素。nullに設定すると、ページ上に存在するすべてのWijmoコントロールが無効化されます。
HTML要素で存在するすべてのWijmoコントロールを更新します。
コントロールが時間おいて更新される代わりに直ちに更新されること以外はinvalidateAll メソッドと同様です。
コンテナー要素。nullに設定すると、ページ上に存在するすべてのWijmoコントロールが無効化されます。
コントロールがフォーカスを取得したときに発生します。
無効な文字が入力されたときに発生します。
ユーザーが入力した値が適切な種類に変換できない値、または有効な範囲外の値を貼り付ける場合、 無効な入力エラーが発生する場合があります。
イベントハンドラーがイベントをキャンセルする場合、 ユーザーがエラーを修正できるように、 コントロールは無効なコンテンツとフォーカスを保持します。
イベントがキャンセルされない場合、コントロールは無効な入力エラーを無視し、 元のコンテンツを保持します。
ドロップダウンが表示または非表示になった後に発生します。
ドロップダウンが表示または非表示になる前に発生します。
コントロールがフォーカスを失ったときに発生します。
rangeEnd プロパティの値がnull以外の値に変更されたときに発生します。 本動作は、データ範囲が選択されたことを示します。
rangeEnd プロパティの値が変更されたときに発生します。
コントロールが内容を更新した後で発生します。
コントロールが内容を更新する直前に発生します。
text プロパティの値が変更されたときに発生します。
value プロパティの値が変更されたときに発生します。
{@link InputDateコントロールでは}、ユーザーが {@link Globalizeクラスでサポートされている書式を使用して日付を入力するか}、 {@link Calendarコントロールに含まれるドロップダウンから日付を選択できます}。
minプロパティとmaxプロパティを使用して、ユーザーが入力できる値の範囲を制限します。
minおよびmaxプロパティの使用の詳細については、minおよびmaxプロパティの使用を参照してください。
現在選択されている日付を取得または設定するには、valueプロパティを使用します。
autoExpandSelectionプロパティを使用して、ユーザーが入力要素をクリックしたときに、 コントロールが選択範囲を単語、数字、または日付全体に自動的に展開するかどうかを決定します。
以下の例は、InputDateコントロールを使用して日付値を編集する方法を示しています。
デモ
InputDateおよびCalendarコントロールには、ユーザー補助機能のサポートが組み込まれています。 キーボードコマンドをサポートし、カレンダーのすべての要素にaria-label属性を提供します。 InputDateコントロールのメイン入力要素に独自のアプリケーション固有のaria-label属性を追加することで、 アクセシビリティを向上させることができます。 例えば:
// InputDateコントロールを作成し、アクセシビリティを向上させるためにaria-labelを追加します let inputDate = new InputDate('#theInputDate'); inputDate.inputElement.setAttribute('aria-label', 'enter trip start date in format month/day/year')