JavaScript. Подробное руководство, 6-е издание

Флэнаган Дэвид

Свойства

unsigned long length

Возвращает количество элементов в коллекции. Однако, в отличие от свойства

length

обычного объекта

HTMLCollection

, это свойство доступно не только для чтения. Если присвоить ему значение меньше текущего, коллекция элементов

Option

будет усечена, а элементы

Option

, оказавшиеся за пределами коллекции, будут удалены из элемента

Select

. Если присвоить свойству

length

значение больше текущего, будут созданы и добавлены в элемент

Select

и в коллекцию новые пустые элементы

<option/>

.

long selectedIndex

Индекс первого выбранного элемента

Option

в коллекции или -1, если ни один элемент

Option

не был выбран. Это свойство можно использовать, чтобы программно выбрать требуемый элемент.

Методы

void add(Element option, [any before])

Вставляет элемент

option

(который должен быть элементом

<option>

или

<optgroup>

) в данную коллекцию (и в элемент

Select

), в позицию, определяемую аргументом before. Если аргумент before имеет значение null, новый элемент вставляется в конец коллекции. Если аргумент before имеет целочисленное значение, новый элемент будет вставлен перед элементом, который в текущий момент имеет этот индекс. Если передать в аргументе before другой элемент

Element

,

option

будет вставлен перед этим элементом.

Element item(unsigned long index)

Объект

HTMLOptionsCollection

наследует этот метод от

HTMLCollection

. Он возвращает элеммент с индексом index или null, если индекс выходит за границы коллекции.

Коллекцию можно также индексировать непосредственно, используя квадратные скобки и не вызывая этот метод явно.

object namedltem(string name)

Возвращает все элементы

Option

из коллекции, имеющие значение name в атрибуте

id

или

name

. Если элементы с таким именем отсутствуют, возвращается значение null. Этот метод можно не вызывать явно, а указать имя в квадратных скобках. Если заданному имени соответствует только один элемент

Option

, возвращается этот элемент. Если заданному имени соответствует более одного элемента, возвращается объект

NodeList

с этими элементами. Обратите внимание, что объекты

HTMLOptionsCollection

можно индексировать непосредственно, используя значение

name

как имя свойства, вместо явного вызова этого метода.

void remove(long index)

Удаляет из коллекции элемент

<option>

с индексом

index

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

IFrame

HTML-тег <iframe> Node, Element

Объект

IFrame

представляет элемент

<iframe>

в HTML-документе. Если попробовать отыскать элемент

<iframe>

с помощью метода getElementByld или подобного ему, вы получите объект

IFrame

. Однако, если обратиться к элементу

<iframe>

через свойство frames объекта

Window

или используя имя элемента

<iframe>

как свойство содержащего

его окна, вы получите объект

Window

, представляющий элемент

<iframe>

.

Свойства

readonly Document contentDocument

Документ, содержащий данный элемент

<iframe>

. Если документ отображается в

<iframe>

с другим происхождением, доступ к этому документу будет закрыт из-за ограничений, накладываемых политикой общего происхождения (раздел 13.6.2).

readonly Window contentWindow

Объект

Window

, содержащий элемент

<iframe>

. (Свойство

frameElement

этого объекта

Window

будет ссылаться обратно на данный объект

IFrame

.)

string height

Высота элемента

<iframe>

в CSS-пикселах. Это свойство соответствует атрибуту

height

.

string name

Имя элемента

<iframe>

. Это свойство соответствует атрибуту

name

, а его значение можно присваивать свойству

target

объектов

Link

и

Form

.

readonly DOMSettableTokenList sandbox

Это свойство соответствует НТМL-атрибуту

sandbox

и может использоваться как строка или как множество отдельных лексем.

Атрибут

sandbox

определяет, какие дополнительные ограничения должны накладываться броузером на содержимое, отображаемое в элементе

<iframe>

. Если атрибут

sandbox

присутствует в элементе, но имеет пустое значение, содержимое фрейма

<iframe>

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

location

окна, содержащего фрейм. Атрибуту

sandbox

можно также присвоить список лексем, разделенных пробелами, снимающих эти дополнительные ограничения. Допустимыми лексемами являются: «allow-same-origin», «allow-scripts», «аі-low-forms* и «allow-top-navigation*.

На момент написания этих строк атрибут sandbox был реализован не во всех броузерах. Дополнительные сведения приводятся в справочной статье HTML,

boolean seamless

Это свойство соответствует атрибуту

seamless

. Если оно имеет значение true, броузер должен отображать содержимое элемента

<iframe>

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

seamless

был введен в спецификации HTML5 и на момент написания этих строк был реализован не во всех броузерах.

string src

Это свойство соответствует атрибуту

src

элемента

<iframe>

: он определяет URL-адрес содержимого фрейма.

string srcdoc

Это свойство соответствует атрибуту

srcdoc

и определяет содержимое элемента

<iframe>

в виде строки. Атрибут

srcdoc

был введен в спецификации HTML5 совсем недавно и на момент написания этих строк был реализован не во всех броузерах.