Календарь (datepicker)
Полный список свойств и функций, а так же общие правила их использования, см. здесь: Краткий обзор и правила, список функций VcorpJS.
Календарь (datepicker) - встроенный плагин VcorpJS, по юзабилити похож на встроенный календарик Windows7.
Визуальный пример календаря (по кнопкам).
Позволяет работать с датами в различных форматах: "yyyymmdd" или "yyyy-mm-dd" или "dd.mm.yyyy" или "mm/dd/yyyy".
Поддерживает русский и английский интерфейс RU / EN (день начала недели различается).
Может иметь стартовый вид: дни/месяцы, месяцы/годы, годы/века.
Минимально возможная дата : 0001-01-01. Максимально-возможная дата: 2499-12-31
Блок с календарём можно перемещать за заголовок (на сенсорных тоже), выбор по кнопке "Ok" или двойным кликом.
При клике вне календаря или клавише <Esc> выбор даты отменяется.
Календарь выводится в виде блочного элемента с полупрозрачным слоем под ним, zIndex слоя и блока равен 298.
Плагин использует CSS-классы .pb_calendar и другие, вложенные в него.
У блочного элемента класса pb_calendar всегда принудительно выставляется position: absolute;
Все элементы веб-страницы, которые могут получить фокус (input, button, select, textarea, a , iframe), получают временное значение tabIndex = -1 (их текущие значения tabIndex запоминаются в создаваемых свойствах .pb_cOldTabIndex).
.calendar( date , min , max , left , top , handler , [ startView ] , [ lang ] )
Выводит календарь на экран и позволяет выбрать (или очистить) дату.
date - объект типа Date или строка вида "yyyymmdd" или "yyyy-mm-dd" или "dd.mm.yyyy" или "mm/dd/yyyy"
min - минимальная дата (строка, например "0001-01-01" или "01.01.1900" или "01/01/1900" или "19000101")
max - максимальная дата (строка, например "2099-12-31" или "31.12.2099" или "12/31/2099" или "20991231")
left, top - координаты вывода календаря относительно л.в.угла веб-страницы (документа).
startView - стартовый вид календаря (0 - дни/месяцы, 1 - месяцы/годы, 2 - годы/века).
lang - язык интерфейса (0 - en, 1 - ru).
handler - callback-функция, вызывается при завершении работы календаря (см. правила для callback - функций),
формат вызова: function( e, oper, date, f1, f2, f3, f4 ); где:
- e - объект event события "click" или "keydown" (если была нажата клавиша <Esc>)
- oper - код завершения, 0 : отмена выбора даты, 1 : установка, -1 : сброс (очистка) даты.
- date - объект типа Date
- f1 - строка в формате "yyyymmdd"
- f2 - строка в формате "yyyy-mm-dd"
- f3 - строка в формате "dd.mm.yyyy"
- f4 - строка в формате "mm/dd/yyyy"
При любом коде завершения, параметры callback-функции содержат значение даты, выделенной на календаре.
Функция .calendar() возвращает true при успешном показе календаря, или false если параметры некорректные или другая ошибка.
Визуальный пример календаря
Календарь можно перемещать по странице. При клике по кнопкам выполняется примерно такой код:
VcorpJS.uMXY(event);
VcorpJS.calendar(new Date(), "21.07.2001", "07/11/2023", VcorpJS.gMX(), VcorpJS.gMY(), ...);
Плагин использует CSS-классы .pb_calendar и другие, вложенные в него.
Для навигации по всем страницам этого раздела сайта используйте пиктограмму или ссылку Навигация в верхней строке навигации.