# Embed

带宽高比锁定的 Iframe 包装器，为视频、地图和嵌入内容提供合理的默认配置。

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

## Agent payload (JSON)

```json
{
  "slug": "embed",
  "name": "Embed",
  "description": "Responsive iframe / video / external content wrapper.",
  "tagline": "带宽高比锁定的 Iframe 包装器，为视频、地图和嵌入内容提供合理的默认配置。",
  "install": "nimbus-docs add embed",
  "sourcePath": "src/components/ui/embed/",
  "canonicalUrl": "https://nimbus-docs.cn/components/embed/",
  "props": [
    {
      "name": "src",
      "type": "string",
      "required": true,
      "description": "要在 iframe 中嵌入的 URL。"
    },
    {
      "name": "title",
      "type": "string",
      "required": true,
      "description": "iframe 的无障碍名称。"
    },
    {
      "name": "ratio",
      "type": "string",
      "defaultValue": "\"16/9\"",
      "required": false,
      "description": "CSS 宽高比（例如 \"16/9\"、\"4/3\"、\"1/1\"）。"
    },
    {
      "name": "allow",
      "type": "string",
      "defaultValue": "\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\"",
      "required": false,
      "description": "传递给 iframe 的权限策略。"
    },
    {
      "name": "allowfullscreen",
      "type": "boolean",
      "defaultValue": "true",
      "required": false,
      "description": "允许嵌入内容进入全屏模式。"
    }
  ],
  "registryDependencies": [
    "cn"
  ],
  "dependencies": []
}
```