Руководство по Smarty
Пред.	Глава 8. Пользовательские Функции	След.

{html_select_date}

{html_select_date} является пользовательской функцией, которая создает выпадающее меню для выбора даты. Она может отображать поля для года, месяца и дня.

Имя атрибута	Тип	Обязателен	По умолчанию	Описание
prefix	string	Нет	Date_	префикс названий переменных
time	timestamp/ГГГГ-ММ-ДД	Нет	текущее время в формате unix timestamp или ГГГГ-ММ-ДД	используемое время
start_year	string	Нет	текущий год	Начальный год в выпадающем списке. Либо указывается явно, либо относительно текущего года (+/- N)
end_year	string	Нет	аналогично start_year	Конечный год в выпадающем списке. Либо указывается явно, либо относительно текущего года (+/- N)
display_days	boolean	Нет	true	выводить ли список дней
display_months	boolean	Нет	true	выводить ли список месяцев
display_years	boolean	Нет	true	выводить ли список лет
month_format	string	Нет	%B	Формат названия месяцев (strftime)
day_format	string	Нет	%02d	формат названия дней (sprintf)
day_value_format	string	Нет	%d	формат значения дней (sprintf)
year_as_text	boolean	Нет	false	Выводить ли значение года текстом
reverse_years	boolean	Нет	false	Выводить года в обратном порядке
field_array	string	Нет	null	название переменной (name), которая будет содержать выбранные значения в виде массива: name[Day], name[Year], name[Month].
day_size	string	Нет	null	Устанавливает атрибут size тэга select для дней
month_size	string	Нет	null	Устанавливает атрибут size тэга select для месяцев
year_size	string	Нет	null	Устанавливает атрибут size тэга select для лет
all_extra	string	Нет	null	Устанавливает дополнительные атрибуты для всех тэгов select/input
day_extra	string	Нет	null	Устанавливает дополнительные атрибуты тэгов select/input для дней
month_extra	string	Нет	null	Устанавливает дополнительные атрибуты тэгов select/input для месяцев
year_extra	string	Нет	null	Устанавливает дополнительные атрибуты тэгов select/input для лет
field_order	string	Нет	MDY	Порядок следования полей (МДГ)
field_separator	string	Нет	\n	текст, разделяющий поля
month_value_format	string	Нет	%m	формат значения месяца (strftime). По умолчанию - %m (номер месяца).
year_empty	string	Нет	null	Если указан, первый пункт элемента для выбора года станет такой надписью с пустым ("") значением. Это удобно для создания надписей вроде "Пожалуйста, выберите год" в качестве первого пункта выпадающего меню. Обратите внимание, что вы можете использовать значения типа "-MM-DD" для атрибута time, чтобы не выбирать год заранее.
month_empty	string	No	null	Если указан, первый пункт элемента для выбора месяца станет такой надписью с пустым ("") значением. Обратите внимание, что вы можете использовать значения типа "YYYY--DD" для атрибута time, чтобы не выбирать месяц заранее.
day_empty	string	No	null	Если указан, первый пункт элемента для выбора дня станет такой надписью с пустым ("") значением. Обратите внимание, что вы можете использовать значения типа "YYY-MM-" для атрибута time, чтобы не выбирать день заранее.

Все параметры, которые не указаны в списке, выводятся в виде пар name/value в каждом созданном тэге <select> для дня, месяца и года.

Пример 8-17. {html_select_date}

Шаблон:

{html_select_date}

Результат обработки шаблона:

<select name="Date_Month">
<option value="1">January</option>
<option value="2">February</option>
<option value="3">March</option>
  ..... snipped .....
<option value="10">October</option>
<option value="11">November</option>
<option value="12" selected="selected">December</option>
</select>
<select name="Date_Day">
<option value="1">01</option>
<option value="2">02</option>
<option value="3">03</option>
  ..... snipped .....
<option value="11">11</option>
<option value="12">12</option>
<option value="13" selected="selected">13</option>
<option value="14">14</option>
<option value="15">15</option>
  ..... snipped .....
<option value="29">29</option>
<option value="30">30</option>
<option value="31">31</option>
</select>
<select name="Date_Year">
<option value="2001" selected="selected">2001</option>
</select>

Пример 8-18. {html_select_date}

{* года начала и конца могут быть заданы относительно текущего года *}
{html_select_date prefix="StartDate" time=$time start_year="-5"
   end_year="+1" display_days=false}

Результатом обработки шаблона будет: (текущий год - 2000)

<select name="StartDateMonth">
<option value="1">January</option>
<option value="2">February</option>
<option value="3">March</option>
<option value="4">April</option>
<option value="5">May</option>
<option value="6">June</option>
<option value="7">July</option>
<option value="8">August</option>
<option value="9">September</option>
<option value="10">October</option>
<option value="11">November</option>
<option value="12" selected="selected">December</option>
</select>
<select name="StartDateYear">
<option value="1995">1995</option>
<option value="1996">1996</option>
<option value="1997">1997</option>
<option value="1998">1998</option>
<option value="1999">1999</option>
<option value="2000" selected="selected">2000</option>
<option value="2001">2001</option>
</select>

См. также {html_select_time}, date_format, $smarty.now и Советы относительно дат.

Пред.	Начало	След.
{html_radios}	Уровень выше	{html_select_time}