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

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

на обложку

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

Шрифт:

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

Select

указан атрибут

multiple

. Если выбор реализован в виде списка (когда значение свойства size > 1), то выбор всех вариантов можно отменить, установив свойство selectedlndex равным -1. Обратите внимание: этот способ изменения выбора не приводит к вызову обработчика события

onchange.

readonly HTMLCollection selectedOptions

Доступный только для чтения oбъект, подобный массиву, содержащий

выбранные элементы

Option

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

Методы

Все методы, перечисленные ниже, делегируют выполнение операций одноименным методам свойства

options

; дополнительные сведения приводятся в справочной статье

HTMLOptionsCollection

. В дополнение к этим методам элементы

Select

реализуют методы интерфейсов

Element

FormControl

void add(Element element, [any before])

Действует подобно методу

options.add,

добавляя новый элемент

Option

any item(unsigned long index)

Действует подобно методу

options.item

и возвращает элемент

Option

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

Select

как к массиву.

any namedltem(string name)

Действует подобно методу

options.namedltem

. См. HTMLOptionsCollection.

void remove(long index)

Действует подобно методу

options.remove,

удаляя элемент

Option

. См. HTMLOptionsCollection.

Storage

хранилище пар имя/значение на стороне клиента

Свойства

localStorage

sessionStorage

объекта

Window

являются объектами

Storage

, которые представляют хранимые на стороне клиента ассоциативные массивы, отображающие строковые ключи в значения. Теоретически объект

Storage

может хранить любые значения, которые можно копировать с применением алгоритма структурированного копирования (врезка «Структурированные копии» в главе 22). Однако на момент написания данных строк броузеры позволяли сохранять только строковые значения.

Методы объекта

Storage

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

delete

и обрабатывать свойства

localStorage

sessionStorage

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

При

изменении содержимого объекта

Storage

любые другие объекты

Window

, имеющие доступ к той же области хранилища (т. е. отображающие документы с тем же происхождением), будут извещены об изменениях с помощью объекта события

StorageEvent

Свойства

readonly unsigned long length

Количество хранящихся пар ключ/значение.

Методы

void clear

Удаляет все хранящиеся пары ключ/значение.

any getltem(string key)

Возвращает значение, связанное с ключом key. (В текущих, на момент написания этих строк, реализациях всегда возвращалась строка.) Этот метод вызывается неявно при индексировании объекта

Storage

, с целью получить значение свойства с именем в аргументе key.

string key(unsigned long n)

Возвращает ключ с индексом л, хранящийся в данном объекте

Storage

, или null, если n больше или равно

length

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

void removeItem(string key)

Удаляет из объекта

Storage

ключ key и связанное с ним значение. Этот метод вызывается неявно при использовании оператора

delete

, с целью удалить свойство с именем в аргументе key.

void setItem(string key, any value)

Добавляет ключ key и значение value в данный объект

Storage

, замещая значение, прежде связанное с этим ключом key. Этот метод вызывается неявно при присваивании значения свойству объекта

Storage

с именем в аргументе key. То есть вместо явного вызова метода

setItem

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

StorageEvent

Event

Свойства

localStorage и sessionStorage

объекта

Window

ссылаются на объекты

Storage

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

Window

, имеющих доступ к этому хранилищу, будет сгенерировано событие «storage». (Обратите внимание, что это событие не генерируется в окне, в котором были выполнены изменения.) События «storage» генерируются в объекте

Window

и не всплывают. Для них не предусматривается действий по умолчанию, которые можно было бы отменить. Обработчикам события «storage» передается объект события

StorageEvent

, свойства которого описывают изменения, внесенные в хранилище.