Количество элементов в коллекции.
Методы
<b>Element item(unsigned long index)</b>
Возвращает элемент коллекции, расположенный в позиции
<b>index</b>
, или null, если индекс
<b>index</b>
выходит за границы массива. Этот метод можно не вызывать явно, а указать индекс в квадратных скобках (как для массива).
<b>object namedltem(string name)</b>
Возвращает первый элемент из коллекции, имеющий значение name в атрибуте
<b>id</b>
или
<b>name</b>
либо null, если такой элемент отсутствует. Этот метод можно не вызывать явно, а указать имя в квадратных скобках.
HTMLDocument
см. Document
HTMLEIement
см. Element
HTMLFormControlsCollection
<b>объект, подобный массиву, содержащий элементы форм HTMLCollection</b>
Объект
<b>HTMLFormControlsCollection</b>
является специализированным подтипом
<b>HTMLCollection</b>
, используемым элементами
<b>Form</b>
для представления коллекций элементов форм. Подобно объекту
<b>HTMLCollection</b>
, его можно использовать как массив, используя числовые индексы, или как объект, индексируя его значениями атрибутов
<b>name</b>
или
<b>id</b>
элементов форм. HTML-формы часто включают несколько элементов (обычно радиокнопок или флажков), имеющих одинаковые значения в атрибуте
<b>name</b>
, и объект
<b>HTMLFormControlsCollection</b>
обрабатывает их иначе, чем обычный объект
<b>HTMLCollection</b>
. При обращении к свойству объекта
<b>HTMLFormControlsCollection</b>
, которому соответствуют несколько элементов с одинаковыми именами, объект
<b>HTMLFormControlsCollection</b>
возвращает объект, подобный массиву, содержащий все элементы формы, использующие это имя. Кроме того, возвращаемый объект, подобный массиву, имеет свойство
<b>value</b>
, которое содержит значение атрибута
<b>value</b>
первой отмеченной радиокнопки с этим именем. Этому свойству можно даже присвоить значение, чтобы отметить соответствующую ему радиокнопку.
HTMLOptionsCollection
коллекция элементов Option HTMLCollection
Объект
<b>HTMLOptionsCollection</b>
является специализированным подтипом
<b>HTMLCollection</b>
, который представляет элементы
<b>Option</b>
, имеющиеся в элементе
<b>Select</b>
. Он переопределяет метод
<b>namedItem(),</b>
чтобы обеспечить возможность работы с несколькими элементами
<b>Option</b>
, имеющими одинаковые имена, и определяет методы добавления и удаления элементов. По историческим причинам объект
<b>HTMLOptionsCollection</b>
определяет доступное для записи свойство
<b>length</b>
, которое можно использовать для усечения или расширения коллекции.
Свойства
<b>unsigned long length</b>
Возвращает количество элементов в коллекции. Однако, в отличие от свойства
<b>length</b>
обычного объекта
<b>HTMLCollection</b>
, это свойство доступно не только для чтения. Если присвоить ему значение меньше текущего, коллекция элементов
<b>Option</b>
будет усечена, а элементы
<b>Option</b>
, оказавшиеся за пределами коллекции, будут удалены из элемента
<b>Select</b>
. Если присвоить свойству
<b>length</b>
значение больше текущего, будут созданы и добавлены в элемент
<b>Select</b>
и в коллекцию новые пустые элементы
<b><option/></b>
.
<b>long selectedIndex</b>
Индекс первого выбранного элемента
<b>Option</b>
в коллекции или -1, если ни один элемент
<b>Option</b>
не был выбран. Это свойство можно использовать, чтобы программно выбрать требуемый элемент.
Методы
<b>void add(Element option, [any before])</b>
Вставляет элемент
<b>option</b>
(который должен быть элементом
<b><option></b>
или
<b><optgroup></b>
) в данную коллекцию (и в элемент
<b>Select</b>
), в позицию, определяемую аргументом before. Если аргумент before имеет значение null, новый элемент вставляется в конец коллекции. Если аргумент before имеет целочисленное значение, новый элемент будет вставлен перед элементом, который в текущий момент имеет этот индекс. Если передать в аргументе before другой элемент
<b>Element</b>
,
<b>option</b>
будет вставлен перед этим элементом.
<b>Element item(unsigned long index)</b>
Объект
<b>HTMLOptionsCollection</b>
наследует этот метод от
<b>HTMLCollection</b>
. Он возвращает элеммент с индексом index или null, если индекс выходит за границы коллекции.
Коллекцию можно также индексировать непосредственно, используя квадратные скобки и не вызывая этот метод явно.
<b>object namedltem(string name)</b>
Возвращает все элементы
<b>Option</b>
из коллекции, имеющие значение name в атрибуте
<b>id</b>
или
<b>name</b>
. Если элементы с таким именем отсутствуют, возвращается значение null. Этот метод можно не вызывать явно, а указать имя в квадратных скобках. Если заданному имени соответствует только один элемент
<b>Option</b>
, возвращается этот элемент. Если заданному имени соответствует более одного элемента, возвращается объект
<b>NodeList</b>
с этими элементами. Обратите внимание, что объекты
<b>HTMLOptionsCollection</b>
можно индексировать непосредственно, используя значение
<b>name</b>
как имя свойства, вместо явного вызова этого метода.
