Skip to content

PluginSettingsTabBaseSettingExParams

Params for PluginSettingsTabBase.settingEx.

Import:

import type { PluginSettingsTabBaseSettingExParams } from 'obsidian-dev-utils/obsidian/plugin/plugin-settings-tab';

Signature:

export interface PluginSettingsTabBaseSettingExParams

Properties

PropertyTypeDescription
aliases?string[]Additional search terms for the setting.
desc?DocumentFragment | stringThe description of the setting. Used for rendering; the text content of a fragment is used for search.
disabled?(() => boolean) | booleanWhether the setting row is disabled.

A function form is re-evaluated on every render AND on every PluginSettingsTabBase.refreshDomState call, so it can reflect runtime state. Obsidian applies it with Setting.setDisabled, which disables the row and every component registered on it.
namestringThe display name of the setting. Used for rendering and search.
searchable?(() => boolean) | booleanControls whether the setting is included in the settings search. Defaults to true.
visible?(() => boolean) | booleanControls whether the setting row is rendered. A function form is re-evaluated on every render and on every PluginSettingsTabBase.refreshDomState call. Defaults to true.

Methods

MethodReturnsDescription
render(setting, group)(() => void) | voidRenders the setting row imperatively, typically via the SettingEx adders and PluginSettingsTabBase.bind.

The setting Obsidian creates for the row is adopted into a SettingEx before it is handed over, so an imperative row body carries over unchanged. May return a cleanup function, invoked before the row is torn down or re-rendered.