На этой страницеНативные настройки
Настройки плагина
Системные контролы из схемы и отдельные команды на странице настроек.
Нативные настройки
Для простых параметров объявите settingsSchema в манифесте. Приложение построит страницу настроек, а плагин прочитает сохранённые значения через api.settings.get().
Типы полей
| Тип | Пример |
|---|---|
boolean |
Переключатель функции |
string |
Шаблон или собственная замена |
number, integer |
Ограниченное числовое значение |
Поле с enum |
Выбор одного из допустимых значений |
{
"settingsSchema": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"title": "Режим",
"default": "short",
"enum": ["short", "full"]
}
}
}
}
Кнопка в настройках
Зарегистрируйте команду с placement: "settings". Объявите ui.contribute / settings.
await api.commands.register({
id: "open-tools",
title: "Команды и свои замены",
placement: "settings",
async run() {
await api.ui.render({
id: "tools",
title: "Мои команды",
nodes: [{ id: "intro", type: "text", text: "Добавьте свою замену" }]
});
}
});
Команда выполняется только при работающем runtime. Статические поля схемы и сведения об установленном пакете не требуют выполнения собственного UI-кода плагина.
Своя страница
Для нескольких действий, изображений или зависимых контролов используйте ui.render. Это нативное описание страницы, а не HTML или WebView.
Хранение
Ключи и типы должны оставаться совместимыми между обновлениями. Подробности чтения и записи — в сохранении настроек.