smarty/docs/ru/designers/language-custom-functions/language-function-html-select-date.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 0 Maintainer: freespace Status: ready -->
<sect1 id="language.function.html.select.date">
 <title>{html_select_date}</title>
 <para>
  {html_select_date} является
  <link linkend="language.custom.functions">пользовательской функцией</link>,
  которая создает выпадающее меню для выбора даты.
  Она может отображать поля для года, месяца и дня.
 </para>

 <informaltable frame="all">
  <tgroup cols="5">
  <colspec colname="param" align="center" />
  <colspec colname="type" align="center" />
  <colspec colname="required" align="center" />
  <colspec colname="default" align="center" />
  <colspec colname="desc" />
  <thead>
   <row>
    <entry>Имя атрибута</entry>
    <entry>Тип</entry>
    <entry>Обязателен</entry>
    <entry>По умолчанию</entry>
    <entry>Описание</entry>
   </row>
  </thead>
  <tbody>
   <row>
    <entry>prefix</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>Date_</entry>
    <entry>префикс названий переменных</entry>
   </row>
   <row>
    <entry>time</entry>
    <entry>timestamp/ГГГГ-ММ-ДД</entry>
    <entry>Нет</entry>
    <entry>
     текущее время в формате unix timestamp или ГГГГ-ММ-ДД
    </entry>
    <entry>используемое время</entry>
   </row>
   <row>
    <entry>start_year</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>текущий год</entry>
    <entry>
     Начальный год в выпадающем списке. Либо указывается явно, либо
     относительно текущего года (+/- N)
    </entry>
   </row>
   <row>
    <entry>end_year</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>аналогично start_year</entry>
    <entry>
     Конечный год в выпадающем списке. Либо указывается явно, либо
     относительно текущего года (+/- N)
    </entry>
   </row>
   <row>
    <entry>display_days</entry>
    <entry>boolean</entry>
    <entry>Нет</entry>
    <entry>true</entry>
    <entry>выводить ли список дней</entry>
   </row>
   <row>
    <entry>display_months</entry>
    <entry>boolean</entry>
    <entry>Нет</entry>
    <entry>true</entry>
    <entry>выводить ли список месяцев</entry>
   </row>
   <row>
    <entry>display_years</entry>
    <entry>boolean</entry>
    <entry>Нет</entry>
    <entry>true</entry>
    <entry>выводить ли список лет</entry>
   </row>
   <row>
    <entry>month_format</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>%B</entry>
    <entry>Формат названия месяцев (strftime)</entry>
   </row>
   <row>
    <entry>day_format</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>%02d</entry>
    <entry>формат названия дней (sprintf)</entry>
   </row>
   <row>
    <entry>day_value_format</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>%d</entry>
    <entry>формат значения дней (sprintf)</entry>
   </row>
   <row>
    <entry>year_as_text</entry>
    <entry>boolean</entry>
    <entry>Нет</entry>
    <entry>false</entry>
    <entry>Выводить ли значение года текстом</entry>
   </row>
   <row>
    <entry>reverse_years</entry>
    <entry>boolean</entry>
    <entry>Нет</entry>
    <entry>false</entry>
    <entry>Выводить года в обратном порядке</entry>
   </row>
   <row>
    <entry>field_array</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>null</entry>
    <entry>
     название переменной (name), которая будет
     содержать выбранные значения в виде массива:
     name[Day], name[Year], name[Month].
    </entry>
   </row>
   <row>
    <entry>day_size</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>null</entry>
    <entry>Устанавливает атрибут size тэга select для дней</entry>
   </row>
   <row>
    <entry>month_size</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>null</entry>
    <entry>Устанавливает атрибут size тэга select для месяцев</entry>
   </row>
   <row>
    <entry>year_size</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>null</entry>
    <entry>Устанавливает атрибут size тэга select для лет</entry>
   </row>
   <row>
    <entry>all_extra</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>null</entry>
    <entry>
     Устанавливает дополнительные атрибуты для всех тэгов
     select/input
    </entry>
   </row>
   <row>
    <entry>day_extra</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>null</entry>
    <entry>
     Устанавливает дополнительные атрибуты тэгов select/input для
     дней
    </entry>
   </row>
   <row>
    <entry>month_extra</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>null</entry>
    <entry>
     Устанавливает дополнительные атрибуты тэгов select/input для месяцев
    </entry>
   </row>
   <row>
    <entry>year_extra</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>null</entry>
    <entry>
     Устанавливает дополнительные атрибуты тэгов select/input для лет
    </entry>
   </row>
   <row>
    <entry>field_order</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>MDY</entry>
    <entry>Порядок следования полей (МДГ)</entry>
   </row>
   <row>
    <entry>field_separator</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>\n</entry>
    <entry>текст, разделяющий поля</entry>
   </row>
   <row>
    <entry>month_value_format</entry>
    <entry>string</entry>
    <entry>Нет</entry>
    <entry>%m</entry>
    <entry>
     формат значения месяца (strftime).
     По умолчанию - %m (номер месяца).
    </entry>
   </row>
    <row>
     <entry>year_empty</entry>
     <entry>string</entry>
     <entry>Нет</entry>
     <entry>null</entry>
     <entry>
      Если указан, первый пункт элемента для выбора года станет такой надписью
      с пустым ("") значением.
      Это удобно для создания надписей вроде "Пожалуйста, выберите год" в
      качестве первого пункта выпадающего меню.
      Обратите внимание, что вы можете использовать значения типа "-MM-DD"
      для атрибута time, чтобы не выбирать год заранее.
     </entry>
    </row>
    <row>
     <entry>month_empty</entry>
     <entry>string</entry>
     <entry>No</entry>
     <entry>null</entry>
     <entry>
      Если указан, первый пункт элемента для выбора месяца станет такой надписью
      с пустым ("") значением.
      Обратите внимание, что вы можете использовать значения типа "YYYY--DD"
      для атрибута time, чтобы не выбирать месяц заранее.
     </entry>
    </row>
    <row>
     <entry>day_empty</entry>
     <entry>string</entry>
     <entry>No</entry>
     <entry>null</entry>
     <entry>
      Если указан, первый пункт элемента для выбора дня станет такой надписью
      с пустым ("") значением.
      Обратите внимание, что вы можете использовать значения типа "YYY-MM-"
      для атрибута time, чтобы не выбирать день заранее.
     </entry>
    </row>
  </tbody>
  </tgroup>
 </informaltable>
 <para>
  Все параметры, которые не указаны в списке, выводятся в виде
  пар name/value в каждом созданном тэге &lt;select&gt; для дня,
  месяца и года.
 </para>
 <example>
  <title>{html_select_date}</title>
  <para>Шаблон:</para>
  <programlisting>
<![CDATA[
{html_select_date}
]]>
  </programlisting>
  <para>
   Результат обработки шаблона:
  </para>
  <screen>
<![CDATA[
<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>
]]>
  </screen>
 </example>

 <example>
  <title>{html_select_date}</title>
  <programlisting>
<![CDATA[
{* года начала и конца могут быть заданы относительно текущего года *}
{html_select_date prefix="StartDate" time=$time start_year="-5"
   end_year="+1" display_days=false}
]]>
  </programlisting>
  <para>
   Результатом обработки шаблона будет: (текущий год - 2000)
  </para>
  <screen>
<![CDATA[
<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>
]]>
  </screen>
 </example>
 <para>
  См. также
  <link linkend="language.function.html.select.time">{html_select_time}</link>,
  <link linkend="language.modifier.date.format">date_format</link>,
  <link linkend="language.variables.smarty.now">$smarty.now</link>
  и
  <link linkend="tips.dates">Советы относительно дат</link>.
 </para>
</sect1>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->