При изменении содержимого объекта
<b>Storage</b>
любые другие объекты
<b>Window</b>
, имеющие доступ к той же области хранилища (т. е. отображающие документы с тем же происхождением), будут извещены об изменениях с помощью объекта события
<b>StorageEvent</b>
.
Свойства
<b>readonly unsigned long length</b>
Количество хранящихся пар ключ/значение.
Методы
<b>void clear()</b>
Удаляет все хранящиеся пары ключ/значение.
<b>any getltem(string key)</b>
Возвращает значение, связанное с ключом key. (В текущих, на момент написания этих строк, реализациях всегда возвращалась строка.) Этот метод вызывается неявно при индексировании объекта
<b>Storage</b>
, с целью получить значение свойства с именем в аргументе key.
<b>string key(unsigned long n)</b>
Возвращает ключ с индексом л, хранящийся в данном объекте
<b>Storage</b>
, или null, если n больше или равно
<b>length</b>
. Обратите внимание, что порядок следования ключей может изменяться при добавлении и удалении пар ключ/значение.
<b>void removeItem(string key)</b>
Удаляет из объекта
<b>Storage</b>
ключ key и связанное с ним значение. Этот метод вызывается неявно при использовании оператора
<b>delete</b>
, с целью удалить свойство с именем в аргументе key.
<b>void setItem(string key, any value)</b>
Добавляет ключ key и значение value в данный объект
<b>Storage</b>
, замещая значение, прежде связанное с этим ключом key. Этот метод вызывается неявно при присваивании значения свойству объекта
<b>Storage</b>
с именем в аргументе key. То есть вместо явного вызова метода
<b>setItem()</b>
можно использовать обычную операцию присваивания значения свойству.
StorageEvent
Event
Свойства
<b>localStorage и sessionStorage</b>
объекта
<b>Window</b>
ссылаются на объекты
<b>Storage</b>
, представляющие хранилища на стороне клиента (раздел 20.1). Если имеется несколько окон, вкладок или фреймов, отображающих документы с общим происхождением, все они будут иметь доступ к одному и тому же хранилищу. Если сценарий в одном окне изменит содержимое хранилища, во всех других объектах
<b>Window</b>
, имеющих доступ к этому хранилищу, будет сгенерировано событие «storage». (Обратите внимание, что это событие не генерируется в окне, в котором были выполнены изменения.) События «storage» генерируются в объекте
<b>Window</b>
и не всплывают. Для них не предусматривается действий по умолчанию, которые можно было бы отменить. Обработчикам события «storage» передается объект события
<b>StorageEvent</b>
, свойства которого описывают изменения, внесенные в хранилище.
Свойства
<b>readonly string key</b>
Это свойство хранит ключ, который был установлен или удален. Если все хранилище было очищено вызовом метода
<b>Storage.clear()</b>
, это свойство (а также свойства
<b>newValue</b>
и
<b>oldValue</b>
) будет иметь значение null.
<b>readonly any newValue</b>
Новое значение ключа key. Будет иметь значение null при удалении ключа. На момент написания этих строк броузеры позволяли сохранять только строковые значения.
<b>readonly any oldValue</b>
Старое значение изменившегося ключа key. Будет иметь значение null при добавлении нового ключа. На момент написания этих строк броузеры позволяли сохранять только строковые значения.
<b>readonly Storage storageArea</b>
Это свойство будет содержать то же значение, что и свойство
<b>localStorage</b>
или
<b>sessionStorage</b>
объекта
<b>Window</b>
, принявшего это событие, и указывает, содержимое какого хранилища изменилось.
<b>readonly string url</b>
URL-адрес документа, сценарий которого внес изменения в хранилище.
Style
HTML-элемент <style> (Node, Element)
Объект
<b>Style</b>
представляет HTML-тег
<b><style>.</b>
Свойства
<b>boolean disabled</b>
Установка этого свойства в значение true отключит таблицу стилей, связанную с данным элементом <style>, а установка в значение false снова включит ее.
<b>string media</b>
Это свойство соответствует HTML-атрибуту
<b>media</b>
и определяет устройства, при отображении в которых должна применяться указанная таблица стилей.
<b>boolean scoped</b>
Имеет значение true, если в элементе
<b><style></b>
присутствует HTML-атрибут
<b>scoped</b>
, и false - в противном случае. На момент написания этих строк броузеры не поддерживали контекстные (scoped) таблицы стилей.
<b>readonly CSSStyleSheet sheet</b>
Объект
<b>CSSStyleSheet</b>
, определяемый данным элементом
<b><style></b>
.
<b>string title</b>
Все HTML-элементы имеют атрибут
<b>title</b>
. С помощью этого атрибута или свойства элемента
<b><style></b>
можно дать пользователю возможность выбрать альтернативную таблицу стилей по названию, и указанное значение свойства
<b>title</b>
может отображаться в интерфейсе броузера в некотором оформлении.
<b>string type</b>
Соответствует HTML-атрибуту
<b>type</b>
. По умолчанию имеет значение «text/css*, и обычно нет необходимости указывать другое значение этого атрибута.
