Элемент preference

Описание

Элемент <preference> позволяет разработчику установить необходимые настройки. Пары ключ-значение, определяемые элементом, устанавливаются в момент первого запуска расширения и затем постоянно хранятся в памяти. Во время работы расширения эти значения доступны скриптам на любой странице расширения в свойствах объекта widget.preferences (см. пример ниже).

Элемент имеет следующие атрибуты.

• name: Указывает имя свойства.
• value: Указывает значение свойства.
• readonly: Определяет, может ли свойство принимать новое значение; для атрибута допустимы булевы значения "true" (указывает, что свойство предназначено только для чтения) или "false" (свойство для чтения и записи).

Пример

Пример того, как определяется некое свойство и его значение:

<widget xmlns="http://www.w3.org/ns/widgets">
  <preference name     = "api-key"
    value    = "abcd123456"
    readonly = "true"/>
</widget>

Затем в исполняемом коде:

//
// background.js
//

// получить значение свойства, указанного в config.xml
var apiKey = widget.preferences["api-key"];