Иллюстрированный самоучитель по Perl

CGI-сценарии

Следующие функции используются для создания формы и ее элементов.

• Функция start_form соответствует тэгу <FORM>. Она может иметь три параметра start_form:

  -method › $method,
   -action › $action,
  -encoding › $encoding);
  

  …при помощи которых можно задать метод передачи формы Web-серверу (-method), программу, предназначенную для обработки формы (-action), и способ кодирования данных (-encoding). Все параметры являются необязательными. По умолчанию используются значения:

  method: POST;
  action: данный сценарий;
  encoding: application/x-www-form-urlencoded.
  

• Функция end_form создает закрывающий тэг </FORM>.
• Функция textfieid соответствует тэгу <INPUTE TYPE=TEXT>. Она имеет следующий синтаксис:

  textfieid (-name › ' field__name',
  -default › 'starting value',
  -size › 50,
  -maxlength › 80);
  

  Параметры соответствуют атрибутам тэга. Обязательным является первый параметр.

  х. __ _ _^/
  

• Функция password_fieid соответствует тэгу <INPUTE TYPE=PASSWORD>. Ее синтаксис:

  password_field(-name › 'secret',
  -value › 'starting value',
  -size › 8,
  -maxlength › 12);
  

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

• Функция radio_group служит для создания группы "радиокнопок" – элементов, задаваемых тэгом <INPUTE TYPE=RADIO>. Ее синтаксис имеет следующую форму:

  radio_group(-name › 'group_name',
  -values › ['bim',Jbam','bom'],
  -default › 'bom',
  -linebreak › 'true',
  -lab.els › \%labels);
  

  Первый аргумент является обязательным, соответствует одноименному атрибуту тэга. Второй аргумент тоже обязательный и задает значения элементов. Эти значения отображаются в качестве названий кнопок. Он должен быть ссылкой на массив. Остальные аргументы являются необязательными. Третий аргумент задает кнопку, которая выбрана по умолчанию. Если значение четвертого аргумента 'true', каждая следующая кнопка группы размещается в начале новой строки. Пятым аргументом является ссылка на хеш-массив, который связывает значения, присвоенные кнопкам, с метками, которые отображаются в виде названий кнопок. Если аргумент не задан, то в качестве названий отображаются сами значения.

• Функция checkbox_group служит для создания группы элементов-переключателей, задаваемых тэгом <INPUTE TYPE= CHECKBOX>.

  checkbox_group(-name › 'group_name',
  -values › ['bim','bam','bom'],
  -default › ['bim','bom'],
  -linebreak › 'true',
  -labels › \%labels);
  

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