> For the complete documentation index, see [llms.txt](/llms.txt).
> The full corpus is at [llms-full.txt](/llms-full.txt).

# useDecoratorButton

> **useDecoratorButton**(`props`): [`DecoratorButton`](/api/toolbar/type-aliases/decoratorbutton/)

Defined in: toolbar/src/use-decorator-button.ts:180

Manages the state, keyboard shortcuts and available events for a decorator
button and sets up mutually exclusive decorator behaviors.

:::caution[Beta]
This API should not be used in production and may be trimmed from a public release.
:::

## Parameters

### props

#### schemaType

[`ToolbarDecoratorSchemaType`](/api/toolbar/type-aliases/toolbardecoratorschematype/)

## Returns

[`DecoratorButton`](/api/toolbar/type-aliases/decoratorbutton/)