Плагин DatePicker для Cordova/PhoneGap 4.0 (iOS, Android и Windows)

Это объединённая версия плагина DatePicker для iOS, Android и Windows для Cordova/Phonegap 4.0.

• Оригинальная версия для iOS: https://github.com/sectore/phonegap3-ios-datepicker-plugin.

• Оригинальная версия для Android: https://github.com/bikasv/cordova-android-plugins/tree/master/datepicker.

Новое в версии 0.8.0 (только для Android):

• Рефакторинг кода для Android.

• Добавлена опция datetime (по умолчанию, если режим неизвестен), открывающая новый диалог времени после установки даты.

• Опции okText и cancelText для определения меток для кнопок POSITIVE и NEGATIVE.

• Опция todayText для установки метки кнопки, которая выбирает текущую дату (дата и время).

• Опция nowText для установки метки кнопки, которая выбирает текущее время (время и дата и время).

• Добавлена опция is24Hour.

Установка

• Локальный рабочий процесс разработки с использованием Cordova CLI.

cordova plugin add cordova-plugin-datepicker

• Локальный рабочий процесс разработки с использованием PhoneGap CLI.

phonegap local plugin add cordova-plugin-datepicker

• Рабочий процесс облачной разработки с использованием PhoneGap Build.

<gap:plugin name="cordova-plugin-datepicker" source="npm" />

Использование

var options = {
    date: new Date(),
    mode: 'date'
};

function onSuccess(date) {
    alert('Выбранная дата: ' + date);
}

function onError(error) { // только для Android
    alert('Ошибка: ' + error);
}

datePicker.show(options, onSuccess, onError);

Опции

mode — iOS, Android, Windows

Режим выбора даты.

Тип: String

Значения: date | time | datetime (только iOS и Windows)

По умолчанию: date.

date — iOS, Android, Windows

Выбранная дата.

Тип: Date

По умолчанию: new Date().

minDate — iOS, Android, Windows

Минимальная дата.

Тип: Date | пустая строка

По умолчанию: (пустая строка).

minDate — это объект Date для iOS и миллисекундная точность unix timestamp для Android, поэтому вам необходимо учитывать это при использовании плагина. Кроме того, на Android применяется только дата (время не учитывается).

maxDate — iOS, Android, Windows

Максимальная дата.

Тип: Date | пустая строка

По умолчанию: (пустая строка).

titleText — Android

Метка заголовка диалога. Если пусто, используется значение по умолчанию для Android (Установить дату/Установить время).

Тип: String | пустая строка

По умолчанию: (пустая строка).

okText — Android

Метка кнопки BUTTON_POSITIVE (кнопка «Готово»). Если пусто, использует android.R.string.ok.

Тип: String | пустая строка

По умолчанию: (пустая строка).

cancelText — Android

Метка кнопки BUTTON_NEGATIVE (кнопка отмены). Если пусто, использует android.R.string.cancel.

Тип: String | пустая строка

По умолчанию: (пустая строка).

todayText — Android

Метка кнопки «Сегодня». Если пусто, не отображается опция выбора текущей даты.

Тип: String | пустая строка

По умолчанию: (пустая строка).

nowText — Android

Метка кнопки «Сейчас». Если пусто, не отображается опция выбора текущего времени.

Тип: String | пустая строка

По умолчанию: (пустая строка).

is24Hour — Android

Отображает диалоговое окно времени в 24-часовом формате.

Тип: Boolean

Значения: true | false

По умолчанию: false.

androidTheme — Android

Выберите тему выбора.

Тип: Int

Значения: THEME_TRADITIONAL | THEME_HOLO_DARK | THEME_HOLO_LIGHT | THEME_DEVICE_DEFAULT_DARK | THEME_DEVICE_DEFAULT_LIGHT

По умолчанию: THEME_TRADITIONAL.

allowOldDates — iOS

Показывает или скрывает даты раньше выбранной даты.

Тип: Boolean

Значения: true | false

По умолчанию: true.

allowFutureDates — iOS

Показывает или скрывает даты после выбранной даты.

Тип: Boolean

Значения: true | false

По умолчанию: true.

doneButtonLabel — iOS

Метка кнопки «Готово».

Тип: String

По умолчанию: Done.

doneButtonColor — iOS

Цвет кнопки «Готово» в шестнадцатеричном формате.

Тип: String

По умолчанию: #0000FF.

cancelButtonLabel — iOS

Метка кнопки отмены.

Тип: String

По умолчанию: Cancel.

cancelButtonColor — iOS

Цвет кнопки отмены в шестнадцатеричном формате.

Тип: String

По умолчанию: #000000.

x — iOS (iPad только)

X-позиция выбора даты. Позиция абсолютна относительно корневого представления приложения.

Тип: String

По умолчанию: 0

y — iOS (iPad only)

Y-позиция средства выбора даты. Позиция задаётся абсолютно относительно корневого представления приложения.

Тип: String

По умолчанию: 0

minuteInterval — iOS

Интервал между опциями в минутном разделе средства выбора даты.

Тип: Integer

По умолчанию: 1

popoverArrowDirection — iOS

Принудительное использование перечисления UIPopoverArrowDirection. Значение «any» вернёт значение по умолчанию UIPopoverArrowDirectionAny и позволит приложению самостоятельно выбрать правильное направление.

Значения: up | down | left | right | any

Тип: String

По умолчанию: any

locale — iOS

Форсированный выбор локали для datePicker.

Тип: String

По умолчанию: en_us

Требования

— Cordova 3.0+ — iOS 6.0+ — Android 2.3+