Пример
$(document).ready(function() { $("#tabs").tabs(); //Код первой вкладки (стандартное использование) $("#datepicker1").datepicker(); $("#datepicker2").datepicker($.datepicker.regional['']); //Код второй вкладки (иконка подсказка) $("#datepicker3").datepicker({buttonImage:'datePicker.gif', showOn:'button', buttonImageOnly:true}); //Код третьей вкладки (ограничение диапазона дат) $("#datepicker4").datepicker({minDate:-6,maxDate:+4,buttonImage:'datePicker.gif', showOn:'both', buttonImageOnly:true}); //Код четвертой вкладки (редактирование формата) $("#datepicker5").datepicker({dateFormat:'yy-mm-dd'}); $("#datepicker6").datepicker({dateFormat:'yy/mm/dd'}); $("#datepicker7").datepicker({dateFormat:'DD MM dd, yy'}); //Код пятой вкладки (календарь) $("#datepicker8").datepicker(); //Код шестой вкладки (анимация/панель с кнопками) $("#datepicker9").datepicker({showAnim:'slide',showButtonPanel:true}); });
С помощью метода datepicker Вы можете превратить выбранный элемент в виджет datepicker.
Виджет datepicker позволяет пользователям удобно выбирать необходимую дату. Данный виджет может также использоваться для создания календаря.
С помощью дополнительных опций Вы можете настраивать формат и язык выбираемой даты, ограничивать диапазон дат и добавлять навигационные кнопки.
$(селектор).datepicker(опции,события)
селектор выбирает элемент, который будет превращен в виджет.
опции настраивают дополнительные аспекты поведения виджета.
события события связанные с данным виджетом.
Опции | Описание |
---|---|
altField | Позволяет выбрать поле, которое будет заполнено после выбора даты вместе с полем к которому привязан виджет. Значение по умолчанию: ''. Пример использования: .datepicker({altField:'#date2'}) |
altFormat | Устанавливает альтернативный формат даты для поля выбранного с помощью опции altField. Значение по умолчанию: ''. Пример использования: .datepicker({altFormat:'yy-mm-dd'}) |
buttonImage | Позволяет задать произвольную картинку рядом с полем выбора даты.
Значение по умолчанию: ''. Пример использования: .datepicker({buttonImage:'datepicker.gif'}) |
buttonImageOnly | При значение false картинка заданная с помощью опции buttonImage будет отображена внутри кнопки. При значении true будет отображена только картинка.
Значение по умолчанию: false. Пример использования: .datepicker({buttonImageOnly:true}) |
buttonText | Позволяет задать текст, который будет отображаться при наведении указателя мыши на картинку заданную с помощью опции buttonImage.
Значение по умолчанию: '...'. Пример использования: .datepicker({buttonText:'Нажмите на меня, чтобы выбрать дату'}) |
changeMonth | Позволяет выбирать желаемый месяц из выпадающего списка отображающегося в виджете.
Значение по умолчанию: false. Пример использования: .datepicker({changeMonth:true}) |
changeYear | Позволяет выбирать желаемый год из выпадающего списка отображающегося в виджете.
Значение по умолчанию: false. Пример использования: .datepicker({changeYear:true}) |
constraintInput | Ограничивает ввод (значение true) позволяя вводить в поле ввода только те символы, которые соответствуют текущему формату данных заданному с помощью опции dateFormat.
Значение по умолчанию: false. Пример использования: .datepicker({constraintInput:true}) |
dateFormat | Задает формат данных, которые будут вставлены в поле ввода после выбора даты.
Формат может состоять из комбинации следующих символов: d - день месяца (без нуля в начале) dd - день месяца (два числа) o - день года (без нуля в начале) oo - день года (три числа) D - сокращенное название дня недели DD - полное название дня недели m - месяц (без нуля в начале) mm - месяц (два числа) M - сокращенное название месяца MM - полное название месяца y - год (два числа) yy - год (четыре числа) Значение по умолчанию: mm/dd/yy. Пример использования: .datepicker({dateFormat:'yy-mm-dd'}) |
defaultDate | Позволяет задать дату, которая будет выбрана по умолчанию. Дата выбирается путем задания смещения количества дней от текущего (например +5 или -4),
с помощью объекта Date, или как строка в текущем формате данных (заданном с помощью опции dateFormat).
Значение по умолчанию: null. Пример использования: .datepicker({defaultDate:+5}) |
maxDate | Позволяет задать максимально возможную для выбора дату. Дата выбирается путем задания смещения количества дней от текущего (например +5 или -4),
с помощью объекта Date, или как строка в текущем формате данных (заданном с помощью опции dateFormat).
Значение по умолчанию: null. Пример использования: .datepicker({maxDate:+7}) |
minDate | Позволяет задать минимально возможную для выбора дату. Дата выбирается путем указания смещения количества дней от текущего (например +5 или -4),
с помощью объекта Date, или как строка в текущем формате данных (заданном с помощью опции dateFormat).
Значение по умолчанию: null. Пример использования: .datepicker({minDate:-3}) |
numberOfMonths | Позволяет задать количество месяцев отображаемых одновременно.
Значение может быть или обычным целым или многомерным массивом указывающим количество строк и столбцов для отображения.
Значение по умолчанию: null. Пример использования: .datepicker({numberOfMonth:[2,3]}) |
showAnim | Задает анимацию, с помощью которой виджет будет появляться/скрываться.
Значение по умолчанию: 'show'. Пример использования: .datepicker({showAnim:'slide'}) |
showButtonPanel | Позволяет задать отображать (true) или нет (false) панель с кнопками.
Значение по умолчанию: false. Пример использования: .datepicker({showButtonPanel:true}) |
showOn | Позволяет задать будет ли виджет появляться только после щелчка на поле ввода (значение focus), будет ли виджет появляться только после
щелчка на картинку заданную с помощью опции buttonImage (значение button) или будет появляться в обоих вышеперечисленных случаях (значение both).
Значение по умолчанию: 'focus'. Пример использования: .datepicker({showOn:'button'}) |
Синтаксис
$(селектор).datepicker({событие:function(){Код обработчика}})
Обратите внимание: например для того, чтобы привязать к виджету с id='test' обработчик события create, который выводит сообщение "привет" необходимо будет написать следующий код: $("#test").datepicker({create:function(){alert("Привет")}}).
События | Описание |
---|---|
create | Определяет функцию, код которой будет выполнен, когда виджет будет создан. |
beforeShow | Определяет функцию, код которой будет выполнен перед тем как виджет будет отображен. |
onChangeMonthYear | Определяет функцию, код которой будет выполнен при смене месяца или года. |
onClose | Определяет функцию, код которой будет выполнен при закрытии виджета. |
onSelect | Определяет функцию, код которой будет выполнен при выборе даты. |