日付ピッカー
日付ピッカーを使用すると、ユーザーはインタラクティブなカレンダーから日付を選択できます。
<input type="text" class="datepicker">
初期化
document.addEventListener('DOMContentLoaded', function() {
var elems = document.querySelectorAll('.datepicker');
var instances = M.Datepicker.init(elems, options);
});
// Or with jQuery
$(document).ready(function(){
$('.datepicker').datepicker();
});
オプション
| 名前 | タイプ | デフォルト | 説明 |
|---|---|---|---|
| autoClose | ブール値 | false | 日付を選択すると自動的にピッカーを閉じます。 |
| format | 文字列 | 'mmm dd, yyyy' | 入力フィールド値の日付出力形式。 |
| parse | 関数 | null | 現在の入力文字列から日付オブジェクトを作成するために使用されます。 |
| defaultDate | 日付 | null | 最初に開いたときに表示する初期の日付。 |
| setDefaultDate | ブール値 | false | defaultDateを初期選択値にします。 |
| disableWeekends | ブール値 | false | 週末のいずれかの日付の選択を禁止します。 |
| disableDayFn | 関数 | null | 特定の日を無効にするカスタム関数。 |
| firstDay | 数値 | 0 | 週の最初の日(0:日曜日、1:月曜日など)。 |
| minDate | 日付 | null | 選択できる最も早い日付。 |
| maxDate | 日付 | null | 選択できる最も遅い日付。 |
| yearRange | 数値 || 配列 | 10 | 両側の年の数、または上限/下限の範囲の配列。 |
| isRTL | ブール値 | false | 日付ピッカーをRTLに変更します。 |
| showMonthAfterYear | ブール値 | false | 日付ピッカーのタイトルに年を月の後に表示します。 |
| showDaysInNextAndPreviousMonths | ブール値 | false | 次の月または前の月に該当するカレンダーグリッドの日数を表示します。 |
| container | 要素 | null | カレンダーを表示するDOM要素を指定します。デフォルトでは、入力の前に配置されます。 |
| showClearBtn | ブール値 | false | 日付ピッカーにクリアボタンを表示します。 |
| i18n | オブジェクト | i18nドキュメントを参照してください。 | 国際化オプション。 |
| events | 配列 | [] | `Date.toDateString()`によって返される文字列の配列で、指定された日にイベントがあることを示します。 |
| onSelect | 関数 | null | 日付が選択されたときのコールバック関数。最初の引数は新しく選択された日付です。 |
| onOpen | 関数 | null | 日付ピッカーが開かれたときのコールバック関数。 |
| onClose | 関数 | null | 日付ピッカーが閉じられたときのコールバック関数。 |
| onDraw | 関数 | null | 日付ピッカーのHTMLが更新されたときのコールバック関数。 |
日付形式オプション
これらのオプションをformatオプションで使用して、日付文字列をカスタマイズします。
| キー | 説明 | 出力 |
|---|---|---|
| d | 月の日の日付。 | 1-31 |
| dd | 月の日の日付(2桁)。 | 01-31 |
| ddd | i18nオプションで設定された略式の曜日の名前。 | Sun-Sat |
| dddd | i18nオプションで設定された完全な曜日の名前。 | Sunday-Saturday |
| m | 年の月の数値。 | 1-12 |
| mm | 年の月の数値(2桁)。 | 01-12 |
| mmm | i18nオプションで設定された略式の月の名前。 | Jan-Dec |
| mmmm | i18nオプションで設定された完全な月の名前。 | January-December |
| yy | 2桁の年。 | 17 |
| yyyy | 4桁の年。 | 2017 |
日付ピッカーの国際化オプション
これらのオプションをi18nオプションで使用して、日付ピッカーをローカライズします。
| キー | テキスト |
|---|---|
| cancel | 'Cancel' |
| clear | 'Clear' |
| done | 'Ok' |
| previousMonth | '‹' |
| nextMonth | '›' |
| months |
[
'January',
'February',
'March',
'April',
'May',
'June',
'July',
'August',
'September',
'October',
'November',
'December'
]
|
| monthsShort |
[
'Jan',
'Feb',
'Mar',
'Apr',
'May',
'Jun',
'Jul',
'Aug',
'Sep',
'Oct',
'Nov',
'Dec'
]
|
| weekdays |
[
'Sunday',
'Monday',
'Tuesday',
'Wednesday',
'Thursday',
'Friday',
'Saturday'
]
|
| weekdaysShort |
[
'Sun',
'Mon',
'Tue',
'Wed',
'Thu',
'Fri',
'Sat'
]
|
| weekdaysAbbrev | ['S','M','T','W','T','F','S'] |
プロパティ
| 名前 | タイプ | 説明 |
|---|---|---|
| el | 要素 | プラグインが初期化された入力要素。 |
| options | オブジェクト | インスタンスが初期化されたオプション。 |
| isOpen | ブール値 | ピッカーが開いているかどうか。 |
| date | 日付 | 選択された日付。 |
メソッド
jQueryはもはや依存関係ではないため、すべてのメソッドはプラグインインスタンスで呼び出されます。プラグインインスタンスは次のように取得できます。
var instance = M.Datepicker.getInstance(elem); /* jQuery Method Calls You can still use the old jQuery plugin method calls. But you won't be able to access instance properties. $('.datepicker').datepicker('methodName'); $('.datepicker').datepicker('methodName', paramName); */
.open();
日付ピッカーを開きます
instance.open();
.close();
日付ピッカーを閉じます
instance.close();
.toString();
選択された日付の文字列表現を取得します
instance.toString();
.setDate();
日付ピッカーに日付を設定します
引数
日付(オプション):日付ピッカーに設定する日付。
instance.setDate(new Date());
.gotoDate();
日付ピッカーの特定の日付に日付表示を変更します
引数
日付:日付ピッカーに表示する日付。
instance.gotoDate(new Date());
.destroy();
プラグインインスタンスを破棄し、終了します
instance.destroy();
時間ピッカー
時間ピッカーを使用すると、ユーザーはインタラクティブな時計から時間を選択できます。
<input type="text" class="timepicker">
初期化
document.addEventListener('DOMContentLoaded', function() {
var elems = document.querySelectorAll('.timepicker');
var instances = M.Timepicker.init(elems, options);
});
// Or with jQuery
$(document).ready(function(){
$('.timepicker').timepicker();
});
オプション
| 名前 | タイプ | デフォルト | 説明 |
|---|---|---|---|
| duration | 数値 | 350 | 時間/分ビューへの/からのトランジション時間。 |
| container | 文字列 | null | カレンダーを表示するDOM要素のセレクタを指定します。デフォルトでは、入力の前に配置されます。 |
| showClearBtn | ブール値 | false | 時間ピッカーにクリアボタンを表示します。 |
| defaultTime | 文字列 | 'now' | 時間ピッカーに設定するデフォルトの時間 'now' または '13:14' |
| fromNow | 数値 | 0 | defaultTimeからのミリ秒オフセット。 |
| i18n | オブジェクト | i18nドキュメントを参照してください。 | 国際化オプション。 |
| autoClose | ブール値 | false | 分を選択すると自動的にピッカーを閉じます。 |
| twelveHour | ブール値 | true | 24時間制の時計ではなく、12時間制のAM/PM時計を使用します。 |
| vibrate | ブール値 | true | 時計の針をドラッグするときにデバイスを振動させます。 |
| onOpenStart | 関数 | null | モーダルが開かれる前に呼び出されるコールバック関数。 |
| onOpenEnd | 関数 | null | モーダルが開かれた後に呼び出されるコールバック関数。 |
| onCloseStart | 関数 | null | モーダルが閉じられる前に呼び出されるコールバック関数。 |
| onCloseEnd | 関数 | null | モーダルが閉じられた後に呼び出されるコールバック関数。 |
| onSelect | 関数 | null | 時間が選択されたときのコールバック関数。最初の引数は時間、2番目の引数は分です。 |
時間ピッカーの国際化オプション
これらのオプションをi18nオプションで使用して、時間ピッカーをローカライズします。
| キー | テキスト |
|---|---|
| cancel | 'Cancel' |
| clear | 'Clear' |
| done | 'Ok' |
プロパティ
| 名前 | タイプ | 説明 |
|---|---|---|
| el | 要素 | プラグインが初期化された入力要素。 |
| options | オブジェクト | インスタンスが初期化されたオプション。 |
| isOpen | ブール値 | ピッカーが開いているかどうか。 |
| time | 文字列 | 選択された時間。 |
メソッド
jQueryはもはや依存関係ではないため、すべてのメソッドはプラグインインスタンスで呼び出されます。プラグインインスタンスは次のように取得できます。
var instance = M.Timepicker.getInstance(elem); /* jQuery Method Calls You can still use the old jQuery plugin method calls. But you won't be able to access instance properties. $('.timepicker').timepicker('methodName'); $('.timepicker').timepicker('methodName', paramName); */
.open();
時間ピッカーを開きます
instance.open();
.close();
時間ピッカーを閉じます
instance.close();
.showView();
時間ピッカーで時間または分のビューを表示します
引数
文字列:切り替えたいビューの名前「hours」または「minutes」。
instance.showView('hours');
.destroy();
プラグインインスタンスを破棄し、終了します
instance.destroy();
