# @univerjs-pro/docs-sdt-ui

> Language fallback: requested `zh-CN`; content is `en-US`.

- Human documentation: [https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/docs-sdt-ui](https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/docs-sdt-ui)

- Agent Markdown: [https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/docs-sdt-ui.md](https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/docs-sdt-ui.md)

- Requested language: `zh-CN`

- Content language: `en-US`

- Documentation version: `1.0.0`

- Source: [packages/plugins/univerjs-pro/docs-sdt-ui.mdx](https://github.com/dream-num/documentation/blob/dev/content/reference/packages/plugins/univerjs-pro/docs-sdt-ui.mdx)

---

Insertion menus, properties popups, interaction, and highlighting for Docs content controls.

```ts
import { UniverDocsSdtPlugin } from '@univerjs-pro/docs-sdt'
import { UniverDocsSdtUIPlugin } from '@univerjs-pro/docs-sdt-ui'
import DocsSdtUIEnUS from '@univerjs-pro/docs-sdt-ui/locale/en-US'
import { LocaleType } from '@univerjs/core'

import '@univerjs-pro/docs-sdt-ui/lib/index.css'

univerAPI.loadLocales(LocaleType.EN_US, DocsSdtUIEnUS)

univer.registerPlugin(UniverDocsSdtPlugin)
univer.registerPlugin(UniverDocsSdtUIPlugin)
```

Merge `DocsSdtUIEnUS` into the application's locales. Register Docs core, Docs UI, the render engine, and the license plugin first. This UI accepts `menu?: MenuConfig` and has no Facade entry. The current Docs advanced preset does not include the SDT plugins.

## Insert a control

```ts
import { InsertSdtCommand } from '@univerjs-pro/docs-sdt-ui'

await univerAPI.executeCommand(InsertSdtCommand.id, { kind: 'checkbox' })
```

The command uses the active document and text selection. `kind` supports `richText`, `text`, `checkbox`, `date`, `dropDownList`, `comboBox`, `picture`, `group`, `repeatingSection`, and `docPartObj`. Repeating-section items are created through their parent section rather than inserted independently.

The root also exports `IInsertSdtCommandParams`, `InsertableSdtKind`, and `SdtPopupService`. See the [content-controls guide](https://docs.univer.ai/zh-CN/guides/docs/features/content-controls.md).