# Dialog

基于原生 <dialog> 元素的模态弹窗——自动处理滚动锁定和点击背景关闭。

**Install:** `nimbus-docs add dialog`  
**Source:** `src/components/ui/dialog/`  
**Canonical:** https://nimbus-docs.cn/components/dialog/

## Agent payload (JSON)

```json
{
  "slug": "dialog",
  "name": "Dialog",
  "description": "Modal dialog with focus-trap and body-scroll lock.",
  "tagline": "基于原生 <dialog> 元素的模态弹窗——自动处理滚动锁定和点击背景关闭。",
  "install": "nimbus-docs add dialog",
  "sourcePath": "src/components/ui/dialog/",
  "canonicalUrl": "https://nimbus-docs.cn/components/dialog/",
  "props": [
    {
      "name": "id",
      "type": "string",
      "required": false,
      "description": "Dialog 属性。用于通过 `document.getElementById(id).showModal()` 打开模态弹窗。"
    }
  ],
  "registryDependencies": [
    "cn"
  ],
  "dependencies": []
}
```