AMP :: HTML 4.01 :: Спецификация HTML 4.01

17.6.1 Предустановленные опции

tabindex (табуляция)

onclick, ondblclick, onmousedown, onmouseup, onmouseover, onmousemove, onmouseout, onkeypress, onkeydown, onkeyup (внутренние события)

Элемент SELECT создает меню. Каждая опция выбора представляется элементом OPTION. Элемент SELECT должен содержать не менее одного элемента OPTION.

Элемент OPTGROUP позволяет группировать опции логически. Это особенно удобно, когда пользователь должен выбрать из большого списка опций: группы связанных опций легче осмыслить и запомнить, чем один большой список опций. В HTML 4 все элементы OPTGROUP должны быть определены непосредственно в элементе SELECT (т.е. группы не могут быть вложенными).

Ноль или более опций могут быть предустановлены для пользователя. ПА должны определять, какая опция является предустановленной, следующим образом:

Если ни один элемент OPTION не имеет установленного атрибута selected, поведение ПА по определению предустановленной опции не определено.
Примечание. Поскольку существующие программы обрабатывают эту ситуацию по-разному, данная спецификация отличается от RFC 1866 ([RFC1866] раздел 8.1.3):

Первоначально выбранной является опция 1, если только отсутствует атрибут SELECTED или любой из элементов <OPTION>.

Поскольку поведение ПА различно, авторы должны удостовериться, что каждое меню включает предустановленную опцию (OPTION)по умолчанию.

Если один из элементов OPTION имеет установленный атрибут selected, он должен быть предустановленным.

Если элемент SELECT имеет установленный атрибут multiple, и более чем один элемент OPTION имеет установленный атрибут selected, они все должны быть предустановлены.

Считается ошибкой, если более чем один элемент OPTION имеет установленный атрибут selected, и элемент SELECT не имеет установленного атрибута multiple. ПА могут по-разному обрабатывать такие ошибки, но не должны предустанавливать более чем одну опцию выбора.

<!ELEMENT OPTGROUP - - (OPTION)+ -- группа опций -->
<!ATTliST OPTGROUP
 %attrs; -- %coreattrs, %i18n, %events --
 disabled (disabled) #ПРЕДПОЛАГАЕТСЯ -- недоступен в этом контексте --
 label %Text; #НЕОБХОДИМ -- для использования в иерархическом меню --
 >

Начальный тег: необходим, Конечный тег: необходим

Определение атрибута элемента OPTGROUP

label = text [CS]

Определяет лэйбл для группы опций.

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

onclick, ondblclick, onmousedown, onmouseup, onmouseover, onmousemove, onmouseout, onkeypress, onkeydown, onkeyup (внутренние события)

Примечание. Разработчики должны помнить, что следующие версии HTML могут расширить механизм группировки, чтобы разрешить вложенные группы (т.е., элементы OPTGROUP могут быть вложенными). Это позволит авторам определять возможность более сложного выбора.

<!ELEMENT OPTION - O (#PCDATA) -- опции выбора -->
<!ATTliST OPTION
 %attrs; -- %coreattrs, %i18n, %events --
 selected (selected) #ПРЕДПОЛАГАЕТСЯ
 disabled (disabled) #ПРЕДПОЛАГАЕТСЯ -- недоступен в данном контексте --
 label %Text; #ПРЕДПОЛАГАЕТСЯ -- для использования в иерархических меню --
 value CDATA #ПРЕДПОЛАГАЕТСЯ -- значения по умолчанию для содержимого элемента --
 >

Начальный тег: необходим, Конечный тег: не обязателен

Определения атрибутов элемента OPTION

selected [CI]

Если установлен, этот булев атрибут определяет, какая из опций предустановлена.

value = cdata [CS]

Определяет начальное значение ЭУ. Если не установлен, начальное значение установлено на содержимое элемента OPTION.

label = text [CS]

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

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

onclick, ondblclick, onmousedown, onmouseup, onmouseover, onmousemove, onmouseout, onkeypress, onkeydown, onkeyup (внутренние события)

При рассмотрении выбора опции меню ПА должен использовать значение атрибута label элемента OPTION в качестве выбора. Если этот атрибут не установлен, ПА должен использовать содержимое элемента OPTION.

Атрибут label элемента OPTGROUP определяет лэйбл для группы выбора.

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

После SELECT идут кнопки submit и reset.

<FORM action="http://somesite.com/prog/component-select" method="post">
 <p>
 <SELECT multiple size="4" name="component-select">
 <OPTION selected value="Component_1_a">Component_1</OPTION>
 <OPTION selected value="Component_1_b">Component_2</OPTION>
 <OPTION>Component_3</OPTION>
 <OPTION>Component_4</OPTION>
 <OPTION>Component_5</OPTION>
 <OPTION>Component_6</OPTION>
 <OPTION>Component_7</OPTION>
 </SELECT>
 <INPUT type="submit" value="Send"><INPUT type="reset">
 </p>
</FORM>

Только выбранные опции будут действующими (используя имя ЭУ "component-select"). Если ни одна опция не выбрана, ЭУ является недействующим, и ни имя, ни какое-либо его значение не отсылаются серверу при отправке формы. Заметьте, что если атрибут value установлен, он определяет начальное значение ЭУ и является в то же время содержимым элемента.

В этом примере использован элемент OPTGROUP для группирования опций. Следующая разметка:

<FORM action="http://somesite.com/prog/someprog" method="post">
 <p>
 <SELECT name="ComOS">
 <OPTION selected label="none" value="none">None</OPTION>
 <OPTGROUP label="PortMaster 3">
 <OPTION label="3.7.1" value="pm3_3.7.1">PortMaster 3 with ComOS 3.7.1</OPTION>
 <OPTION label="3.7" value="pm3_3.7">PortMaster 3 with ComOS 3.7</OPTION>
 <OPTION label="3.5" value="pm3_3.5">PortMaster 3 with ComOS 3.5</OPTION>
 </OPTGROUP>
 <OPTGROUP label="PortMaster 2">
 <OPTION label="3.7" value="pm2_3.7">PortMaster 2 with ComOS 3.7</OPTION>
 <OPTION label="3.5" value="pm2_3.5">PortMaster 2 with ComOS 3.5</OPTION>
 </OPTGROUP>
 <OPTGROUP label="IRX">
 <OPTION label="3.7R" value="IRX_3.7R">IRX with ComOS 3.7R</OPTION>
 <OPTION label="3.5R" value="IRX_3.5R">IRX with ComOS 3.5R</OPTION>
 </OPTGROUP>
 </SELECT>
</FORM>

представляет такую группировку:

 None
 PortMaster 3
 3.7.1
 3.7
 3.5
 PortMaster 2
 3.7
 3.5
 IRX
 3.7R
 3.5R

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

Графический ПА может представить это так:

Этот рисунок показывает элемент SELECT как выпадающее меню. Верхний лэйбл меню показывает выбранное в данный момент значение (PortMaster 3, 3.7.1). Пользователь раскрыл два ниспадающих меню, но еще не выбрал новое значение (PortMaster 2, 3.7). Заметьте, что каждое каскадное меню отображает лэйбл элемента OPTGROUP или OPTION.

17.7 Элемент TEXTAREA

<!ELEMENT TEXTAREA - - (#PCDATA) -- многострочное текстовое поле -->
<!ATTliST TEXTAREA
 %attrs; -- %coreattrs, %i18n, %events --
 name CDATA	 #ПРЕДПОЛАГАЕТСЯ
 rows NUMBER #НЕОБХОДИМ
 cols NUMBER #НЕОБХОДИМ
 disabled (disabled) #ПРЕДПОЛАГАЕТСЯ -- недоступен в данном контексте --
 readonly (readonly) #ПРЕДПОЛАГАЕТСЯ
 tabindex NUMBER #ПРЕДПОЛАГАЕТСЯ -- позиция при табуляции --
 accesskey %Character; #ПРЕДПОЛАГАЕТСЯ -- символ быстрого доступа --
 onfocus %Script; #ПРЕДПОЛАГАЕТСЯ -- элемент получил фокус --
 onblur %Script; #ПРЕДПОЛАГАЕТСЯ -- элемент потерял фокус --
 onselect %Script; #ПРЕДПОЛАГАЕТСЯ -- некоторый текст выделен --
 onchange %Script; #ПРЕДПОЛАГАЕТСЯ -- значение элемента изменено --
 >

Начальный тег: необходим, Конечный тег: необходим

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

name = cdata [CI]

Устанавливает имя элемента.

rows = number [CN]

Количество видимых строк. Пользователь может вводить большее число опций, поэтому ПА должен предоставить возможность прокрутки содержимого элемента, если оно выходит за пределы зоны видимости.

cols = number [CN]

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

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

id, class (информация о документе)

readonly (элемент ввода "только для чтения")

tabindex (табуляция)

onfocus, onblur, onselect, onchange, onclick, ondblclick, onmousedown, onmouseup, onmouseover, onmousemove, onmouseout, onkeypress, onkeydown, onkeyup (внутренние события)

Элемент TEXTAREA создает многострочный ЭУ для ввода текста. ПА должны использовать содержимое этого элемента как начальное значение элемента и отображать этот текст как начальный.

В этом примере создается ЭУ TEXTAREA, в котором 20 рядов и 80 столбцов, содержащий 2 строки начального текста. За ЭУ TEXTAREA идут кнопки submit и reset.

<FORM action="http://somesite.com/prog/text-read" method="post">
 <p>
 <TEXTAREA name="thetext" rows="20" cols="80">
 Первая строка начального текста.
 Вторая строка начального текста.
 </TEXTAREA>
 <INPUT type="submit" value="Send"><INPUT type="reset">
 </p>
</FORM>

Установка атрибута readonly позволяет отображать в TEXTAREA неизменяемый текст.
Это отличается от использования стандартного текста разметки в документе, поскольку значение TEXTAREA отсылается вместе с формой.

17.8 Элемент ISINDEX

ISINDEX не рекомендуется. Этот элемент создает однострочное окно для ввода текста. Авторы должны использовать элемент INPUT для создания элементов для ввода текста.

См. формальное определение: Переходное ОТД/Transitional Dtd.

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

prompt = text [CS]

Не рекомендуется. Этот атрибут определяет строку промпта для текстового поля.

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

Элемент ISINDEX создает однострочный ЭУ для ввода текста, позволяющий вводить любое количество символов. ПА должны использовать значение атрибута prompt как название промпта.

НЕ РЕКОМЕНДУЕТСЯ:
Следующее объявление ISINDEX:

<ISINDEX prompt="Введите Ваш текст для поиска: ">

можно переписать для INPUT так:

<FORM action="..." method="post">
<p>Введите Ваш текст для поиска: <INPUT type="text"></p>
</FORM>

Семантика ISINDEX. В настоящее время семантика элемента ISINDEX определяется хорошо, если только URI документа является HTTP URI. На практике строка ввода ограничивается набором символов Latin-1, так как отсутствует URI механизм определения другого набора символов.

17.9 Лэйблы

Некоторые ЭУ автоматически содержат лэйблы, ассоциированные с ними (кнопки), а другие - нет (поля ввода текста, переключатели, radio-кнопки и меню).

Для ЭУ, имеющих встроенные лэйблы, ПА должны использовать значения атрибута value как строку лэйбла.

Элемент LABEL используется для определения лэйблов в ЭУ, не имеющих встроенных лэйблов.

17.9.1 Элемент LABEL

<!ELEMENT LABEL - - (%inline;)* -(LABEL) -- текст лэйбла элемента формы -->
<!ATTliST LABEL
 %attrs; -- %coreattrs, %i18n, %events --
 for IDREF #ПРЕДПОЛАГАЕТСЯ -- соответствует значению ID поля --
 accesskey %Character; #ПРЕДПОЛАГАЕТСЯ -- символ быстрого доступа --
 onfocus %Script; #ПРЕДПОЛАГАЕТСЯ -- элемент получил фокус --
 onblur %Script; #ПРЕДПОЛАГАЕТСЯ -- элемент потерял фокус --
 >

Начальный тег: необходим, Конечный тег: необходим

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

for = idref [CS]

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

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

style (название стиля)

accesskey (символ быстрого доступа)

onfocus, onblur, onclick, ondblclick, onmousedown, onmouseup, onmouseover, onmousemove, onmouseout, onkeypress, onkeydown, onkeyup (внутренние события)

Элемент LABEL может использоваться для присоединения информации к ЭУ. Каждый элемент LABEL ассоциирован только с одним ЭУ формы.

Атрибут for явно ассоциирует лэйбл с другим ЭУ: значение атрибута for должно быть тем же, что и атрибута id ассоциированного ЭУ. Более, чем один LABEL может быть ассоциирован с элементом путем создания множественных ссылок атрибута for.

В этом примере создается таблица, для выравнивания двух ЭУ text и ассоциированных с ними лэйблов. Каждый лэйбл ассоциируется только с одним ЭУ text:

<FORM action="..." method="post">
<table>
 <tr>
 <td><LABEL for="fname">First Name</LABEL>
 <td><INPUT type="text" name="firstname" id="fname">
 <tr>
 <td><LABEL for="lname">Last Name</LABEL>
 <td><INPUT type="text" name="lastname" id="lname">
</table>
</FORM>

Этот пример дополняет предыдущий включением элементов LABEL:

 <FORM action="http://somesite.com/prog/adduser" method="post">
 <p>
 <LABEL for="firstname">First name: </LABEL>
 <INPUT type="text" id="firstname"><BR>
 <LABEL for="lastname">Last name: </LABEL>
 <INPUT type="text" id="lastname"><BR>
 <LABEL for="email">email: </LABEL>
 <INPUT type="text" id="email"><BR>
 <INPUT type="radio" name="sex" value="Male"> Male<BR>
 <INPUT type="radio" name="sex" value="Female"> Female<BR>
 <INPUT type="submit" value="Send"> <INPUT type="reset">
 </p>
 </FORM>

Чтобы ассоциировать лэйбл с другим ЭУ неявно, ЭУ должен находиться внутри содержимого элемента LABEL. В этом случае LABEL может содержать только один элемент управления. Лэйбл может находиться перед или после ассоциированного ЭУ.

В этом примере мы неявно ассоциируем два лэйбла с двумя ЭУ text:

<FORM action="..." method="post">
<p>
<LABEL>
 First Name
 <INPUT type="text" name="firstname">
</LABEL>
<LABEL>
 <INPUT type="text" name="lastname">
 Last Name
</LABEL>
</p>
</FORM>

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

Если LABEL получает фокус/focus, он передает фокус ассоциированному ЭУ. См. ниже раздел о клавишах быстрого доступа/access keys.

Лэйблы могут рассматриваться ПА различными способами (напр., визуально, речевым синтезатором и т.д.)

17.10 Структурирование формы: элементы FIELDSET и LEGEND

<!--
 #PCDATA здесь решает проблему смешанного содержимого,
 по спецификации здесь допустимы только пробелы!
 -->
<!ELEMENT FIELDSET - - (#PCDATA,LEGEND,(%flow;)*) -- группа ЭУ -->
<!ATTliST FIELDSET
 %attrs; -- %coreattrs, %i18n, %events --
 >

<!ELEMENT LEGEND - - (%inline;)* -- "легенда" набора полей -->

<!ATTliST LEGEND
 %attrs; -- %coreattrs, %i18n, %events --
 accesskey %Character; #ПРЕДПОЛАГАЕТСЯ -- символ быстрого доступа --
 >

Начальный тег: необходим, Конечный тег: необходим

Определение атрибута элемента LEGEND

align = top|bottom|left|right [CI]

Не рекомендуется. Этот атрибут определяет позицию "легенды" в том, что касается набора полей. Возможные значения:

top: "Легенда" находится сверху над набором полей. Это значение по умолчанию.

bottom: "Легенда" находится под набором полей..

left: "Легенда" находится слева от набора полей.

right: "Легенда" находится справа от набора полей.

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