17. Формы

17.3 Элемент FORM

<!ELEMENT FORM - - (%block;|SCRIPT)+ -(FORM) -- interactive form -->
<!ATTLIST FORM
  %attrs;                              -- %coreattrs, %i18n, %events --
  action      %URI;          #REQUIRED -- server-side form handler --
  method      (GET|POST)     GET       -- HTTP method used to submit the form--
  enctype     %ContentType;  "application/x-www-form-urlencoded"
  accept      %ContentTypes; #IMPLIED  -- list of MIME types for file upload --
  name        CDATA          #IMPLIED  -- name of form for scripting --
  onsubmit    %Script;       #IMPLIED  -- the form was submitted --
  onreset     %Script;       #IMPLIED  -- the form was reset --
  accept-charset %Charsets;  #IMPLIED  -- list of supported charsets --
  >

Начальный тег: обязательный, конечный тег: обязательный

Определение атрибутов

action = uri [CT]

Этот атрибут определяет агент обработки формы. Поведение устройства вывода для значения, отличающегося от HTTP URI, не определено.

method = get|post [CI]

Этот атрибут определяет, какой метод HTTP будет использоваться для передачи набора данных формы. Возможные (не чувствительные к регистру) значения являются "get" (по умолчанию) и "post". Смотрите раздел по передачи формы для информации использования.

enctype = content-type [CI]

Этот атрибут определяет тип содержания, используемого для подачи формы на сервер (когда значение method - "post"). Значение по умолчанию для этого атрибута является "application/x-www-form-urlencoded". Значение "multipart/form-data" следует использовать в комбинации с элементом INPUT, type="file".

accept-charset = charset list [CI]

Этот атрибут определяет список кодировок символов для данных ввода, которые передаются серверу, обрабатывающему эту форму. Значение является списком значений charset, разделенных пробелами и/или запятыми. Клиент должен интерпретировать этот список, как исключающий ИЛИ, т.е. сервер способен принять любую кодировку одного символа на полученный примитив.
Значение по умолчанию для этого атрибута - зарезервированная строка "UNKNOWN" ("неизвестный"). Устройства вывода могут интерпретировать это значение, как кодировку символов, которая использовалась для передачи документа, содержащего этот элемент FORM.

accept = content-type-list [CI]

Этот атрибут определяет список, разделенных запятой, типов содержания, с которыми сервер, обрабатывающий эту форму, будет обращаться корректно. Устройства вывода могут использовать эту информацию для фильтрации не согласующихся файлов, когда запрашивают пользователя выбрать файлы, которые будут высланы серверу (сравните элемент INPUT, когда type="file").

name = cdata [CI]

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

Атрибуты, определенные в другом месте

• id, class
• lang, dir
• style
• title
• target
• onsubmit, onreset, onclick, ondblclick, onmousedown, onmouseup, onmouseover, onmousemove, onmouseout, onkeypress, onkeydown, onkeyup

Элемент FORM действует как контейнер для управляющих элементов. Он определяет:

• Разметку формы (данную содержанием элемента).
• Программу, которая будет обращаться с заполненной и переданной формой (атрибут action). Получающая программа должна быть способной проводить синтаксический анализ пар имя/значение для их использования.
• Метод, которым данные пользователя будут отосланы на сервер (атрибут method).
• Кодировка символов, которая должна приниматься сервером для того, чтобы обрабатывать эту форму (атрибут accept-charset). Устройства вывода могут советовать пользователю значение атрибута accept-charset и/или ограничивать способность пользователя вводить нераспознаваемые символы.

Форма может содержать текст и разметку (параграфы, списки и т.д.) дополнительно к элементам управления формы.

Следующий пример показывает форму, которая будет обрабатываться программой "adduser" после передачи. Форма будет выслана программе с использованием метода HTTP "post".

 <FORM action="http://somesite.com/prog/adduser" method="post">
 ...form contents...
 </FORM>

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

Обратите внимание. Дальнейшее обсуждение поведения серверов, которые получают данные формы, находится вне сферы этой спецификации.