datepicker - виджет Datepicker

datepicker([methodName, option, value])

datepicker([methodName, param_obj])

datepicker([param_obj])

// локализация
$('#inline').datepicker($.datepicker.regional["uk"]);

$('#datep').datepicker({
    buttonImage: "right.png",
    buttonImageOnly: true,
    changeMonth: true,
    changeYear: true,
    constrainInput: true,
    maxDate: "+1",
    minDate: "-3",
    numberOfMonths: [1, 3],
    showCurrentAtPos: 1,
    showOn: 'both',
    showOtherMonths: true,
    showWeek: true,
    yearRange: "-1:+2",
    weekHeader: "Неделя",

    onClose: function(date, datepicker){
        ...
    },
    onSelect: function(date, datepicker){
        ...
    },
    onChangeMonthYeаr: function(year, month, datepicker){
        ...
    }

});

• methodName

  • destroy - Полностью удаляет функциональность виджета Datepicker из базового элемента

  • disable - Приостанавливает работу виджета Datepicker для базовогоэлемента

  • enable - Возобновляет работу ранее приостановленного виджета Datepicker для базового элемента

  • option - Позволяет получить или установить значения одной или не­скольких опций виджета Datepicker

  • isDisabled - Возвращает true, если виджет Datepicker отключен

  • hide - Скрывает всплывающий календарь, если он видимый

  • show - Отображает всплывающий календарь, если он невидимый

  • refresh - Обновляет календарь для отражения выполненных в базовом элементе изменений

  • getDate - Получает дату, выбранную в календаре

  • setDate - Устанавливает указанное значение в качестве выбранной даты календаря

• param_obj

  • altField - Позволяет задать дополнительное поле, которое будет обновляться при выборе да­ты в календаре

  • appendText - Задает текст подсказки, содержащий дополнительную информацию, например пояснения относительно форматирования даты, который будет вставлен в до­кумент после элемента input

  • buttonImageOnly - Указывает, что вместо вспомогательной кнопки, позволяющей открыть календарь, должно использоваться изображение, заданное опцией buttonimage

  • buttonImage - Определяет URL-адрес изображения, используемого для вспомогательной кнопки открытия всплывающего календаря. По умолчанию не используется

  • buttonText - Определяет текст, который будет отображаться на кнопке открытия всплывающего календаря. Текстом по умолчанию является многоточие ( … )

  • changeMonth - Если эта опция равна true, то в календаре отображается раскрывающийся список, обеспечивающий возможность непосредственной навигации по меся­цам. Значение по умолчанию — false

  • changeYear - Если эта опция равна true, то в календаре отображается раскрывающийся список, обеспечивающий возможность непосредственной навигации по годам. Значение по умолчанию — false

  • closeText - Задает текст для кнопки закрытия календаря, отображающейся на панели вспомогательных кнопок, если она включена. Значение по умолчанию — За­крыть

  • constrainInput - Если эта опция равна true, то виджет Datepicker проверяет соответствие содержимого поля ввода заданному формату даты. Значение по умолчанию — true

  • create - Происходит при создании экземпляра Datepicker

  • currentText - Задает текст для кнопки возврата к текущему месяцу, отображающейся на па­нели вспомогательных кнопок, если она включена. Значение по умолчанию — Сегодня

  • defaultDate - Позволяет установить дату, которая будет подсвечена при открытии календаря

    • null - текущая дата

    • Date - явная дата

    • +/-дни - смещение дат относительно текущей

    • +1d +7w -1m +1y

  • disabled - Указывает, должен ли виджет быть первоначально отключен. Значение по умолча­нию — false

  • duration - Задает скорость или длительность выполнения анимации, заданной опцией showAnim. Значение по умолчанию — normal.

  • gotoCurrent - Если эта опция равна true, то кнопка сегодня, находящаяся на панели вспомогательных кнопок, если она включена, будет осуществлять возврат к вы­бранной, а не к текущей дате. Значение по умолчанию — false

  • hideIfNoPrevNext - Если эта опция равна true, то значки, позволяющие перемещаться по кален­дарю вперед и назад относительно отображаемой даты, полностью скрываются, а не просто отключаются. Значение по умолчанию — false

  • maxDate - Определяет максимальную дату, доступную для выбора. По умолчанию это ограничение отсутствует

  • minDate - Определяет минимальную дату, доступную для выбора. По умолчанию это ограничение отсутствует

  • numberOfMonths - Определяет количество месяцев, одновременно отображаемых в календаре. Значение по умолчанию — 1

  • onChangeMonthYeаr - Происходит при создании экземпляра Datepicker

  • onClose - Происходит при закрытии всплывающего календаря

  • onSelect - Происходит, когда пользователь выбирает дату

  • selectOtherMonths - Если эта опция равна true, то становятся доступными для выбора даты, отображаемые в результате установки равным true значения опции showOtherMonths

  • showAnim - Определяет тип анимации, используемой для отображения и сокрытия всплы­вающих календарей. Значение по умолчанию — false

  • showButtonPanel - Если эта опция равна true, то в календаре будет отображаться вспомога­тельная панель с кнопками, с помощью которых пользователь сможет перехо­дить к текущей дате и (если используется всплывающий виджет) закрывать ка­лендарь. Значение по умолчанию — false

  • showCurrentAtPos - Если для календаря задано одновременное отображение нескольких месяцев, то данная опция определяет номер позиции, в которой должен отображаться текущий или заданный по умолчанию месяц. Значение по умолчанию — 0

  • showOn - Определяет действие, инициирующее открытие всплывающего календаря

    • focus - Всплывающий календарь открывается при получении фокуса ввода элементом input. Это значение используется по умолчанию.

    • button - Всплывающий календарь открывается щелчком на кнопке.

    • both - Всплывающий календарь отображается как после щелчка на кнопке, так и после получения фокуса элементом input.

  • showOptions - Задает опции анимации, указанной опцией showAnim.

  • showOtherMonths - Если эта опция равна true, то пустые поля в календарной сетке будут запол­няться датами из предыдущих и последующих месяцев. Значение по умолча­нию — false

  • showWeek - Если значение этой опции равно true, то в календаре будет отображаться столбец с номерами недель. Значение по умолчанию — false

  • stepMonths - Определяет, на сколько месяцев вперед или назад должна сдвигаться отобра­жаемая в календаре дата при щелчке на кнопке перехода вперед или назад во времени

  • yearRange - Определяет диапазон лет, доступных для выбора в раскрывающемся списке, добавляемом с помощью опции changeYear. По умолчанию этот список включает десять предыдущих и десять последующих лет, а также текущий год

  • weekHeader - Задает заголовок столбца календаря с номерами недель, включенной с помощью опции showWeek. Значение по умолчанию — Нед