[{"data":1,"prerenderedAt":308},["ShallowReactive",2],{"quirekit-doc:\u002Fplugins\u002Freference\u002Fhtml-sandbox":3},{"id":4,"title":5,"body":6,"description":12,"extension":295,"keywords":296,"locale":299,"meta":300,"navigation":301,"order":302,"path":303,"section":304,"seo":305,"stem":306,"__hash__":307},"docs\u002Fplugins\u002Freference\u002Fhtml-sandbox.zh-CN.md","HtmlSandbox · HTML 沙箱",{"type":7,"value":8,"toc":283},"minimark",[9,13,24,28,34,79,88,91,107,119,143,150,153,164,168,171,178,182,185,191,197,200,207,245,253,256,267,279],[10,11,12],"p",{},"保存显式 HTML 源码对象，只有宿主提供 mount 时才挂载隔离预览。静态 HTML 导出保留转义源码，不嵌入执行中的 iframe。",[10,14,15,19,20],{},[16,17,18],"code",{},"@quirekit\u002Fextension-html-sandbox"," · ",[21,22,23],"strong",{},"MIT",[25,26,27],"h2",{"id":27},"编辑器适用范围",[10,29,30,31],{},"层次：",[21,32,33],{},"共享文档能力",[35,36,37,53],"table",{},[38,39,40],"thead",{},[41,42,43,47,50],"tr",{},[44,45,46],"th",{},"编辑器",[44,48,49],{},"状态",[44,51,52],{},"所需装配与边界",[54,55,56,68],"tbody",{},[41,57,58,62,65],{},[59,60,61],"td",{},"Classic",[59,63,64],{},"未验证",[59,66,67],{},"尚未建立此入口的完整产品接入与验证路径。公开 Core 导出不代表当前产品已提供对应呈现、控件或文件支持。",[41,69,70,73,76],{},[59,71,72],{},"Block",[59,74,75],{},"需适配",[59,77,78],{},"需由宿主连接本页所列服务、目标与生命周期，并验证所选 View 和文档模型。核心接口可复用，但没有一段无宿主参数的通用产品安装代码。",[10,80,81,82,87],{},"“直接支持”指已有上述产品装配；具体交互、宿主服务和格式支持仍有各自条件。",[83,84,86],"a",{"href":85},"\u002Fplugins\u002Fcompatibility","状态与接入规则","。许可独立显示。",[25,89,90],{"id":90},"接入",[92,93,98],"pre",{"className":94,"code":95,"language":96,"meta":97,"style":97},"language-sh shiki shiki-themes github-light github-light github-dark","pnpm add @quirekit\u002Fextension-html-sandbox@alpha\n","sh","",[16,99,100],{"__ignoreMap":97},[101,102,105],"span",{"class":103,"line":104},"line",1,[101,106,95],{},[10,108,109,110,113,114,118],{},"在创建 Editor 时放入 ",[16,111,112],{},"extensions","。挂载容器、视图和保存由宿主提供，见",[83,115,117],{"href":116},"\u002Fguide\u002Fquick-start","快速开始","。",[92,120,124],{"className":121,"code":122,"language":123,"meta":97,"style":97},"language-ts shiki shiki-themes github-light github-light github-dark","import { HtmlSandbox } from '@quirekit\u002Fextension-html-sandbox'\n","ts",[16,125,126],{"__ignoreMap":97},[101,127,128,132,136,139],{"class":103,"line":104},[101,129,131],{"class":130},"sDD9d","import",[101,133,135],{"class":134},"sVPnS"," { HtmlSandbox } ",[101,137,138],{"class":130},"from",[101,140,142],{"class":141},"s-HEn"," '@quirekit\u002Fextension-html-sandbox'\n",[10,144,145,146,118],{},"安装时按包声明选择兼容版本，外部可用版本以分发源为准。本站使用工作区 Alpha；许可标签来自入口所属包，使用条件见",[83,147,149],{"href":148},"\u002Fsupport","支持与许可",[25,151,152],{"id":152},"按编辑器接入",[10,154,155,156,159,160,163],{},"以下片段沿用已挂载的宿主元素 ",[16,157,158],{},"element","，宿主负责容器尺寸与保存；退出页面时调用 ",[16,161,162],{},"instance.destroy()","。已有预设装配的能力不要再重复追加；需要宿主端口的入口应先完成下方配置。",[165,166],"plugin-integration",{"name":167},"HtmlSandbox",[25,169,170],{"id":170},"配置",[10,172,173,174,118],{},"下面是扩展自身的默认选项。预设可以覆盖这些值；它们不等于当前文档属性。配置方法见",[83,175,177],{"href":176},"\u002Fplugins\u002Fconfiguration","配置插件",[179,180,181],"h3",{"id":181},"mount",[10,183,184],{},"为 HTML 源码对象挂载隔离预览，返回可更新和销毁的句柄。",[10,186,187,188],{},"类型：",[16,189,190],{},"((container: HTMLElement, document: HtmlSandboxDocument) => HtmlSandboxViewHandle) | null",[10,192,193,194],{},"默认：",[16,195,196],{},"null",[25,198,199],{"id":199},"命令与运行方式",[10,201,202,203,206],{},"以下命令由此扩展直接提供，均在当前 Editor 上调用。命令是否可用由已安装 schema、当前选区与保护策略决定；可以先用 ",[16,204,205],{},"editor.can()"," 查询。",[35,208,209,219],{},[38,210,211],{},[41,212,213,216],{},[44,214,215],{},"命令",[44,217,218],{},"参数签名",[54,220,221,233],{},[41,222,223,228],{},[59,224,225],{},[16,226,227],{},"insertHtmlSandbox",[59,229,230],{},[16,231,232],{},"insertHtmlSandbox(request: HtmlSandboxInsertion)",[41,234,235,240],{},[59,236,237],{},[16,238,239],{},"updateHtmlSandbox",[59,241,242],{},[16,243,244],{},"updateHtmlSandbox(request: HtmlSandboxUpdate)",[10,246,247,248,252],{},"这里只展示参数签名。接界面时见",[83,249,251],{"href":250},"\u002Fbuild\u002Fcommands","命令与控件","，正文变更继续经过同一事务与历史。",[25,254,255],{"id":255},"下一步",[10,257,258,259,263,264,266],{},"返回",[83,260,262],{"href":261},"\u002Fplugins","全部插件","，或阅读",[83,265,177],{"href":176},"区分配置、文档属性与命令。",[10,268,269,270,274,275,118],{},"自己定义能力时见",[83,271,273],{"href":272},"\u002Fbuild\u002Fextension","扩展开发","；搭建完整宿主时见",[83,276,278],{"href":277},"\u002Fbuild","构建产品",[280,281,282],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sDD9d, html code.shiki .sDD9d{--shiki-default:#D73A49;--shiki-light:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVPnS, html code.shiki .sVPnS{--shiki-default:#24292E;--shiki-light:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s-HEn, html code.shiki .s-HEn{--shiki-default:#032F62;--shiki-light:#032F62;--shiki-dark:#9ECBFF}",{"title":97,"searchDepth":284,"depth":284,"links":285},2,[286,287,288,289,293,294],{"id":27,"depth":284,"text":27},{"id":90,"depth":284,"text":90},{"id":152,"depth":284,"text":152},{"id":170,"depth":284,"text":170,"children":290},[291],{"id":181,"depth":292,"text":181},3,{"id":199,"depth":284,"text":199},{"id":255,"depth":284,"text":255},"md",[167,18,297,298,181,227,239,167],"HTML 沙箱","objects","zh-CN",{"navigationTitle":167,"license":23},true,108,"\u002Fplugins\u002Freference\u002Fhtml-sandbox","图形与数据",{"title":5,"description":12},"plugins\u002Freference\u002Fhtml-sandbox.zh-CN","roItK6mrTqI7r0mteMqW9UaAFTU0z7-Z5bZMPqs625k",1793045213698]