# RIframe
`RIframe` 封装原生 iframe 和 Naive UI Spin。它适合嵌入允许被加载的页面,页面自身的 CSP、嵌入授权和同源策略仍生效。`load` 事件并不能证明业务内容加载成功。
## 交互示例
::: details 查看示例源码
<<< @/../admin/src/views/demo/iframe/index.tsx
:::
```tsx
import { RIframe } from '@/components'
export const renderReport = (url: string) => (
)
```
| 属性 | 默认 | 说明 |
| ------------------------------------ | -------- | ---------------------------------------------------------------------------------------------------------- |
| `src` | 必填 | iframe 地址。接收用户输入时应由业务限制可嵌入来源。 |
| `width` / `height` | `'100%'` | CSS 尺寸。百分比高度依赖父级。 |
| `frameborder` | `0` | 模板边框样式变量。 |
| `iframeWrapperClass` / `iframeClass` | 无 | 外层容器与原生 iframe 的类名。 |
| `title` / `name` / `allow` | 无 | 原生 iframe 属性。`title` 用于辅助技术识别。 |
| `lazy` | `true` | 字符串 `'lazy'` 或 `'eager'`。当前实现把布尔 `true` 和 `false` 都映射为 `'lazy'`,主动加载请写 `'eager'`。 |
| `customSpinProps` | `{}` | NSpin 配置,`show` 由组件内状态覆盖。 |
`onSuccess(iframe, event)` 和 `onError` 支持函数或回调数组。当前错误分支只传 `event`,与 Props 类型声明的双参数有差异;需要处理错误时不要假定有元素参数。首次 `load` / `error` 后关闭 Spin,当前实现不在 `src` 变更时重置加载状态;每次切换地址都要显示加载时可给组件不同的 `key`。`iframeInst` 是组件实际暴露的 DOM 引用。额外插槽交给 Spin,但默认内容始终为 iframe。
[组件实现](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/packages/ui/src/RIframe/src/Iframe.tsx) · [Props](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/packages/ui/src/RIframe/src/props.ts)