SettingDefinitionAction

Official

Both Official Unofficial

Both Own Inherited

A setting definition that renders an action row (clickable button or link).

Import:

import type { SettingDefinitionAction } from 'obsidian';

Signature:

export interface SettingDefinitionAction extends SettingDefinitionBase

Extends: SettingDefinitionBase

Properties

	Property	Type	Description
	action	(el: HTMLElement, index: number) => void	Callback invoked when the action setting is clicked. Receives the row element and the row's current index within its parent group or list.
	aliases?	string[]	Additional search terms. (Inherited from SettingDefinitionBase)
	control?	never	Forbidden discriminant key — set only on SettingDefinitionControl.
	desc?	DocumentFragment | string	Description text or fragment. Used for rendering; the textContent of a fragment is used for search. (Inherited from SettingDefinitionBase)
	disabled?	(() => boolean) | boolean	Disables the row. Evaluated on each render. Call update() on the setting tab to re-evaluate.
	name	string	Display name — used for rendering and search. (Inherited from SettingDefinitionBase)
	render?	never	Forbidden discriminant key — set only on SettingDefinitionRender.
	searchable?	(() => boolean) | boolean	Controls search visibility. false or () => false excludes from search. (Inherited from SettingDefinitionBase)
	visible?	(() => boolean) | boolean	Controls whether the item is rendered. false or () => false hides the item and also excludes it from search for that render cycle. Evaluated on each render; call update() on the setting tab to re-evaluate after the underlying state changes. (Inherited from SettingDefinitionBase)

---

Links to this page:

• SettingDefinitionControl
• SettingDefinitionEmpty
• SettingDefinitionRender