mirror of
https://github.com/XiaoDaiGua-Ray/ray-template.git
synced 2026-11-21 19:03:35 +08:00
6 lines
5.6 KiB
JavaScript
6 lines
5.6 KiB
JavaScript
import{_ as e,o as a,c as i,a3 as t}from"./chunks/framework.BNdm2jZV.js";const k=JSON.parse('{"title":"RIframe","description":"","frontmatter":{},"headers":[],"relativePath":"reference/components/iframe.md","filePath":"reference/components/iframe.md"}'),d={name:"reference/components/iframe.md"};function r(n,s,o,h,p,l){return a(),i("div",null,[...s[0]||(s[0]=[t(`<h1 id="riframe" tabindex="-1">RIframe <a class="header-anchor" href="#riframe" aria-label="Permalink to "RIframe""></a></h1><p><code>RIframe</code> 封装原生 iframe 和 Naive UI Spin。它适合嵌入允许被加载的页面,页面自身的 CSP、嵌入授权和同源策略仍生效。<code>load</code> 事件并不能证明业务内容加载成功。</p><div class="language-tsx vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">tsx</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">import</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> { RIframe } </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">from</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> '@/components'</span></span>
|
||
<span class="line"></span>
|
||
<span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">export</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> const</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> renderReport</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> =</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (</span><span style="--shiki-light:#E36209;--shiki-dark:#FFAB70;">url</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> string</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">) </span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=></span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (</span></span>
|
||
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> <</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">RIframe</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> src</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{url} </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">title</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"库存报表"</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> height</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">460</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">} </span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">lazy</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">"eager"</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> /></span></span>
|
||
<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">)</span></span></code></pre></div><table tabindex="0"><thead><tr><th>属性</th><th>默认</th><th>说明</th></tr></thead><tbody><tr><td><code>src</code></td><td>必填</td><td>iframe 地址。接收用户输入时应由业务限制可嵌入来源。</td></tr><tr><td><code>width</code> / <code>height</code></td><td><code>'100%'</code></td><td>CSS 尺寸。百分比高度依赖父级。</td></tr><tr><td><code>frameborder</code></td><td><code>0</code></td><td>模板边框样式变量。</td></tr><tr><td><code>iframeWrapperClass</code> / <code>iframeClass</code></td><td>无</td><td>外层容器与原生 iframe 的类名。</td></tr><tr><td><code>title</code> / <code>name</code> / <code>allow</code></td><td>无</td><td>原生 iframe 属性。<code>title</code> 用于辅助技术识别。</td></tr><tr><td><code>lazy</code></td><td><code>true</code></td><td>字符串 <code>'lazy'</code> 或 <code>'eager'</code>。当前实现把布尔 <code>true</code> 和 <code>false</code> 都映射为 <code>'lazy'</code>,主动加载请写 <code>'eager'</code>。</td></tr><tr><td><code>customSpinProps</code></td><td><code>{}</code></td><td>NSpin 配置,<code>show</code> 由组件内状态覆盖。</td></tr></tbody></table><p><code>onSuccess(iframe, event)</code> 和 <code>onError</code> 支持函数或回调数组。当前错误分支只传 <code>event</code>,与 Props 类型声明的双参数有差异;需要处理错误时不要假定有元素参数。首次 <code>load</code> / <code>error</code> 后关闭 Spin,当前实现不在 <code>src</code> 变更时重置加载状态;每次切换地址都要显示加载时可给组件不同的 <code>key</code>。<code>iframeInst</code> 是组件实际暴露的 DOM 引用。额外插槽交给 Spin,但默认内容始终为 iframe。</p><p><a href="https://github.com/XiaoDaiGua-Ray/ray-template/blob/403fdd589abbe37b38e1240d34f8daf2a60d3690/packages/ui/src/RIframe/src/Iframe.tsx" target="_blank" rel="noreferrer">组件实现</a> · <a href="https://github.com/XiaoDaiGua-Ray/ray-template/blob/403fdd589abbe37b38e1240d34f8daf2a60d3690/packages/ui/src/RIframe/src/props.ts" target="_blank" rel="noreferrer">Props</a></p>`,6)])])}const g=e(d,[["render",r]]);export{k as __pageData,g as default};
|