[{"data":1,"prerenderedAt":437},["ShallowReactive",2],{"quirekit-doc:\u002Fplugins\u002Freference\u002Fword-block-interaction":3},{"id":4,"title":5,"body":6,"description":12,"extension":424,"keywords":425,"locale":428,"meta":429,"navigation":430,"order":431,"path":432,"section":433,"seo":434,"stem":435,"__hash__":436},"docs\u002Fplugins\u002Freference\u002Fword-block-interaction.zh-CN.md","WordBlockInteraction · Word 块操作准入",{"type":7,"value":8,"toc":408},"minimark",[9,13,24,28,34,84,92,95,101,104,111,140,148,151,162,166,169,176,180,183,189,192,244,247,250,254,260,264,267,272,277,280,283,288,293,297,300,305,310,313,320,370,378,381,392,404],[10,11,12],"p",{},"在通用块交互之上约束 Word 的可移动范围与结构完整性。完整 Word 文档应使用此策略处理表格、分节等特殊结构。",[10,14,15,19,20],{},[16,17,18],"code",{},"@quirekit\u002Fclassic-block-interaction"," · ",[21,22,23],"strong",{},"Commercial",[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,73],"tbody",{},[41,57,58,62,65],{},[59,60,61],"td",{},"Classic",[59,63,64],{},"直接支持",[59,66,67,72],{},[68,69,71],"a",{"href":70},"\u002Fplugins\u002Freference\u002Fcreate-classic-word-preset","createClassicWordPreset"," — 使用 createClassicWordPreset 装配 Word 模型、布局与产品适配；具体控件、开关、宿主服务及文件支持以本页说明为准。批注、修订和内容控件的完整创作界面另需 Pro。",[41,74,75,78,81],{},[59,76,77],{},"Block",[59,79,80],{},"未验证",[59,82,83],{},"尚未建立此入口的完整产品接入与验证路径。公开 Core 导出不代表当前产品已提供对应呈现、控件或文件支持。",[10,85,86,87,91],{},"“直接支持”指已有上述产品装配；具体交互、宿主服务和格式支持仍有各自条件。",[68,88,90],{"href":89},"\u002Fplugins\u002Fcompatibility","状态与接入规则","。许可独立显示。",[25,93,94],{"id":94},"接入",[10,96,97,98,100],{},"当前 ",[16,99,18],{}," 的包元数据标为 private。本站使用工作区源码；外部项目需先取得对应分发包，不能把下面的公开导出理解为已经能从公共 npm 安装。",[10,102,103],{},"此入口属于商业组件。使用前先取得相应分发与授权；安装命令仅适用于已配置该分发源的项目。",[10,105,106,107,110],{},"Word 产品通常从 ",[68,108,109],{"href":70},"Word 预设","开始。这里的公开符号用于独立 Core 或自定义预设；需按领域补齐配套节点、命令和布局，已有同名扩展时不能重复追加。",[112,113,118],"pre",{"className":114,"code":115,"language":116,"meta":117,"style":117},"language-ts shiki shiki-themes github-light github-light github-dark","import { WordBlockInteraction } from '@quirekit\u002Fclassic-block-interaction'\n","ts","",[16,119,120],{"__ignoreMap":117},[121,122,125,129,133,136],"span",{"class":123,"line":124},"line",1,[121,126,128],{"class":127},"sDD9d","import",[121,130,132],{"class":131},"sVPnS"," { WordBlockInteraction } ",[121,134,135],{"class":127},"from",[121,137,139],{"class":138},"s-HEn"," '@quirekit\u002Fclassic-block-interaction'\n",[10,141,142,143,147],{},"安装时按包声明选择兼容版本，外部可用版本以分发源为准。本站使用工作区 Alpha；许可标签来自入口所属包，使用条件见",[68,144,146],{"href":145},"\u002Fsupport","支持与许可","。",[25,149,150],{"id":150},"按编辑器接入",[10,152,153,154,157,158,161],{},"以下片段沿用已挂载的宿主元素 ",[16,155,156],{},"element","，宿主负责容器尺寸与保存；退出页面时调用 ",[16,159,160],{},"instance.destroy()","。已有预设装配的能力不要再重复追加；需要宿主端口的入口应先完成下方配置。",[163,164],"plugin-integration",{"name":165},"WordBlockInteraction",[25,167,168],{"id":168},"配置",[10,170,171,172,147],{},"下面是扩展自身的默认选项。预设可以覆盖这些值；它们不等于当前文档属性。配置方法见",[68,173,175],{"href":174},"\u002Fplugins\u002Fconfiguration","配置插件",[177,178,179],"h3",{"id":179},"types",[10,181,182],{},"需要附加此能力的节点或标记类型名，必须与当前 schema 的实际名称一致。",[10,184,185,186],{},"类型：",[16,187,188],{},"readonly string[]",[10,190,191],{},"默认：见下方默认值",[112,193,195],{"className":114,"code":194,"language":116,"meta":117,"style":117},"[\"paragraph\", \"wordTable\", \"horizontalRule\", \"codeBlock\", \"blockquote\", \"bulletList\", \"orderedList\", \"wordBlockContentControl\"]\n",[16,196,197],{"__ignoreMap":117},[121,198,199,202,205,208,211,213,216,218,221,223,226,228,231,233,236,238,241],{"class":123,"line":124},[121,200,201],{"class":131},"[",[121,203,204],{"class":138},"\"paragraph\"",[121,206,207],{"class":131},", ",[121,209,210],{"class":138},"\"wordTable\"",[121,212,207],{"class":131},[121,214,215],{"class":138},"\"horizontalRule\"",[121,217,207],{"class":131},[121,219,220],{"class":138},"\"codeBlock\"",[121,222,207],{"class":131},[121,224,225],{"class":138},"\"blockquote\"",[121,227,207],{"class":131},[121,229,230],{"class":138},"\"bulletList\"",[121,232,207],{"class":131},[121,234,235],{"class":138},"\"orderedList\"",[121,237,207],{"class":131},[121,239,240],{"class":138},"\"wordBlockContentControl\"",[121,242,243],{"class":131},"]\n",[177,245,246],{"id":246},"scopes",[10,248,249],{},"可容纳块操作的结构范围类型，例如 doc。",[10,251,185,252],{},[16,253,188],{},[10,255,256,257],{},"默认：",[16,258,259],{},"[\"wordSection\"]",[177,261,263],{"id":262},"createid","createId",[10,265,266],{},"为新块生成稳定身份的函数。复制与拆分仍需遵循块身份规则。",[10,268,185,269],{},[16,270,271],{},"(): string",[10,273,256,274],{},[16,275,276],{},"createBlockId",[177,278,279],{"id":279},"admit",[10,281,282],{},"块移动或插入前的准入函数，拒绝会破坏结构或业务规则的操作。",[10,284,185,285],{},[16,286,287],{},"(context: BlockAdmissionContext): BlockRejection | null",[10,289,256,290],{},[16,291,292],{},"admitWordBlockOperation",[177,294,296],{"id":295},"requireportableidentity","requirePortableIdentity",[10,298,299],{},"是否要求参与操作的块具备可持久化的稳定身份。",[10,301,185,302],{},[16,303,304],{},"boolean",[10,306,256,307],{},[16,308,309],{},"false",[25,311,312],{"id":312},"命令与运行方式",[10,314,315,316,319],{},"以下命令由此扩展直接提供，均在当前 Editor 上调用。命令是否可用由已安装 schema、当前选区与保护策略决定；可以先用 ",[16,317,318],{},"editor.can()"," 查询。",[35,321,322,332],{},[38,323,324],{},[41,325,326,329],{},[44,327,328],{},"命令",[44,330,331],{},"参数签名",[54,333,334,346,358],{},[41,335,336,341],{},[59,337,338],{},[16,339,340],{},"selectBlockRange",[59,342,343],{},[16,344,345],{},"selectBlockRange(range: BlockRangeRef | null)",[41,347,348,353],{},[59,349,350],{},[16,351,352],{},"moveBlockRange",[59,354,355],{},[16,356,357],{},"moveBlockRange(request: BlockMoveRequest)",[41,359,360,365],{},[59,361,362],{},[16,363,364],{},"insertBlockAt",[59,366,367],{},[16,368,369],{},"insertBlockAt(request: BlockInsertRequest)",[10,371,372,373,377],{},"这里只展示参数签名。接界面时见",[68,374,376],{"href":375},"\u002Fbuild\u002Fcommands","命令与控件","，正文变更继续经过同一事务与历史。",[25,379,380],{"id":380},"下一步",[10,382,383,384,388,389,391],{},"返回",[68,385,387],{"href":386},"\u002Fplugins","全部插件","，或阅读",[68,390,175],{"href":174},"区分配置、文档属性与命令。",[10,393,394,395,399,400,147],{},"自己定义能力时见",[68,396,398],{"href":397},"\u002Fbuild\u002Fextension","扩展开发","；搭建完整宿主时见",[68,401,403],{"href":402},"\u002Fbuild","构建产品",[405,406,407],"style",{},"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}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);}",{"title":117,"searchDepth":409,"depth":409,"links":410},2,[411,412,413,414,422,423],{"id":27,"depth":409,"text":27},{"id":94,"depth":409,"text":94},{"id":150,"depth":409,"text":150},{"id":168,"depth":409,"text":168,"children":415},[416,418,419,420,421],{"id":179,"depth":417,"text":179},3,{"id":246,"depth":417,"text":246},{"id":262,"depth":417,"text":263},{"id":279,"depth":417,"text":279},{"id":295,"depth":417,"text":296},{"id":312,"depth":409,"text":312},{"id":380,"depth":409,"text":380},"md",[165,18,426,427,179,246,263,279,296,340,352,364,165],"Word 块操作准入","word","zh-CN",{"navigationTitle":165,"license":23},true,146,"\u002Fplugins\u002Freference\u002Fword-block-interaction","Word 文档扩展",{"title":5,"description":12},"plugins\u002Freference\u002Fword-block-interaction.zh-CN","IWlDM7b9nv4FYkDgxzIfMXZplwFBr-cP1W8iCxONN4Q",1793045214428]