mirror of
https://github.com/XiaoDaiGua-Ray/ray-template.git
synced 2026-11-17 16:13:36 +08:00
2.8 KiB
2.8 KiB
RIframe
RIframe 封装原生 iframe 和 Naive UI Spin。它适合嵌入允许被加载的页面,页面自身的 CSP、嵌入授权和同源策略仍生效。load 事件并不能证明业务内容加载成功。
交互示例
::: details 查看示例源码 <<< @/../admin/src/views/demo/iframe/index.tsx :::
import { RIframe } from '@/components'
export const renderReport = (url: string) => (
<RIframe src={url} title="库存报表" height={460} lazy="eager" />
)
| 属性 | 默认 | 说明 |
|---|---|---|
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。