[{"data":1,"prerenderedAt":512},["ShallowReactive",2],{"quirekit-doc:\u002Fplugins\u002Freference\u002Faccessibility":3},{"id":4,"title":5,"body":6,"description":12,"extension":499,"keywords":500,"locale":503,"meta":504,"navigation":505,"order":506,"path":507,"section":508,"seo":509,"stem":510,"__hash__":511},"docs\u002Fplugins\u002Freference\u002Faccessibility.zh-CN.md","Accessibility · 无障碍语义",{"type":7,"value":8,"toc":482},"minimark",[9,13,24,28,34,77,86,89,105,117,141,148,151,162,166,169,176,180,183,189,195,199,202,207,212,216,219,223,228,232,235,239,244,247,250,255,258,429,433,436,441,446,449,452,455,466,478],[10,11,12],"p",{},"在已挂载视图上提供有界的文本输入上下文与分段阅读投影。labels 可本地化；业务节点应声明自己的无障碍语义或提供 describeBlock。",[10,14,15,19,20],{},[16,17,18],"code",{},"@quirekit\u002Faccessibility"," · ",[21,22,23],"strong",{},"AGPL-3.0-only",[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],{},"需由宿主连接本页所列服务、目标与生命周期，并验证所选 View 和文档模型。核心接口可复用，但没有一段无宿主参数的通用产品安装代码。",[41,69,70,73,75],{},[59,71,72],{},"Block",[59,74,64],{},[59,76,67],{},[10,78,79,80,85],{},"“直接支持”指已有上述产品装配；具体交互、宿主服务和格式支持仍有各自条件。",[81,82,84],"a",{"href":83},"\u002Fplugins\u002Fcompatibility","状态与接入规则","。许可独立显示。",[25,87,88],{"id":88},"接入",[90,91,96],"pre",{"className":92,"code":93,"language":94,"meta":95,"style":95},"language-sh shiki shiki-themes github-light github-light github-dark","pnpm add @quirekit\u002Faccessibility@alpha\n","sh","",[16,97,98],{"__ignoreMap":95},[99,100,103],"span",{"class":101,"line":102},"line",1,[99,104,93],{},[10,106,107,108,111,112,116],{},"在创建 Editor 时放入 ",[16,109,110],{},"extensions","。挂载容器、视图和保存由宿主提供，见",[81,113,115],{"href":114},"\u002Fguide\u002Fquick-start","快速开始","。",[90,118,122],{"className":119,"code":120,"language":121,"meta":95,"style":95},"language-ts shiki shiki-themes github-light github-light github-dark","import { Accessibility } from '@quirekit\u002Faccessibility'\n","ts",[16,123,124],{"__ignoreMap":95},[99,125,126,130,134,137],{"class":101,"line":102},[99,127,129],{"class":128},"sDD9d","import",[99,131,133],{"class":132},"sVPnS"," { Accessibility } ",[99,135,136],{"class":128},"from",[99,138,140],{"class":139},"s-HEn"," '@quirekit\u002Faccessibility'\n",[10,142,143,144,116],{},"安装时按包声明选择兼容版本，外部可用版本以分发源为准。本站使用工作区 Alpha；许可标签来自入口所属包，使用条件见",[81,145,147],{"href":146},"\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},"Accessibility",[25,167,168],{"id":168},"配置",[10,170,171,172,116],{},"下面是扩展自身的默认选项。预设可以覆盖这些值；它们不等于当前文档属性。配置方法见",[81,173,175],{"href":174},"\u002Fplugins\u002Fconfiguration","配置插件",[177,178,179],"h3",{"id":179},"enabled",[10,181,182],{},"是否启用此能力的会话行为。禁用不会删除规范文档内容。",[10,184,185,186],{},"类型：",[16,187,188],{},"boolean",[10,190,191,192],{},"默认：",[16,193,194],{},"true",[177,196,198],{"id":197},"textbudget","textBudget",[10,200,201],{},"输入上下文允许包含的文本预算，避免每次输入投影整个文档。",[10,203,185,204],{},[16,205,206],{},"number",[10,208,191,209],{},[16,210,211],{},"2048",[177,213,215],{"id":214},"readingbudget","readingBudget",[10,217,218],{},"分段阅读一次允许包含的文本预算。",[10,220,185,221],{},[16,222,206],{},[10,224,191,225],{},[16,226,227],{},"8192",[177,229,231],{"id":230},"readingblocks","readingBlocks",[10,233,234],{},"单个阅读分段最多包含的块数。",[10,236,185,237],{},[16,238,206],{},[10,240,191,241],{},[16,242,243],{},"40",[177,245,246],{"id":246},"labels",[10,248,249],{},"无障碍入口与导航的本地化文字和文案函数。",[10,251,185,252],{},[16,253,254],{},"QuireAccessibilityLabels",[10,256,257],{},"默认：见下方默认值",[90,259,261],{"className":119,"code":260,"language":121,"meta":95,"style":95},"{ input: \"文档编辑（当前段落上下文）\", reading: \"阅读文档\", returnToEditor: \"返回编辑器\", previous: \"上一段阅读内容\", next: \"下一段阅读内容\", edit: \"编辑此段\", empty: \"空段落\", continuation: \"（段落续文）\", unavailable: \"当前范围暂不支持文本上下文或直接编辑。\", unsupported: (name) => `此区块暂未提供阅读语义：${name}`, segment: (index, last) => `阅读分段 ${index}${last ? \"，已到文档末尾\" : \"，后面还有内容\"}` }\n",[16,262,263],{"__ignoreMap":95},[99,264,265,268,272,275,278,281,284,286,289,291,294,296,299,301,304,306,309,311,314,316,319,321,324,326,329,331,334,336,339,341,344,346,349,351,354,356,359,361,364,367,371,374,377,380,382,385,387,390,392,395,397,400,402,404,407,409,412,414,417,420,423,426],{"class":101,"line":102},[99,266,267],{"class":132},"{ ",[99,269,271],{"class":270},"sgQzM","input",[99,273,274],{"class":132},": ",[99,276,277],{"class":139},"\"文档编辑（当前段落上下文）\"",[99,279,280],{"class":132},", ",[99,282,283],{"class":270},"reading",[99,285,274],{"class":132},[99,287,288],{"class":139},"\"阅读文档\"",[99,290,280],{"class":132},[99,292,293],{"class":270},"returnToEditor",[99,295,274],{"class":132},[99,297,298],{"class":139},"\"返回编辑器\"",[99,300,280],{"class":132},[99,302,303],{"class":270},"previous",[99,305,274],{"class":132},[99,307,308],{"class":139},"\"上一段阅读内容\"",[99,310,280],{"class":132},[99,312,313],{"class":270},"next",[99,315,274],{"class":132},[99,317,318],{"class":139},"\"下一段阅读内容\"",[99,320,280],{"class":132},[99,322,323],{"class":270},"edit",[99,325,274],{"class":132},[99,327,328],{"class":139},"\"编辑此段\"",[99,330,280],{"class":132},[99,332,333],{"class":270},"empty",[99,335,274],{"class":132},[99,337,338],{"class":139},"\"空段落\"",[99,340,280],{"class":132},[99,342,343],{"class":270},"continuation",[99,345,274],{"class":132},[99,347,348],{"class":139},"\"（段落续文）\"",[99,350,280],{"class":132},[99,352,353],{"class":270},"unavailable",[99,355,274],{"class":132},[99,357,358],{"class":139},"\"当前范围暂不支持文本上下文或直接编辑。\"",[99,360,280],{"class":132},[99,362,363],{"class":270},"unsupported",[99,365,366],{"class":132},": (",[99,368,370],{"class":369},"sde8i","name",[99,372,373],{"class":132},") ",[99,375,376],{"class":128},"=>",[99,378,379],{"class":139}," `此区块暂未提供阅读语义：${",[99,381,370],{"class":132},[99,383,384],{"class":139},"}`",[99,386,280],{"class":132},[99,388,389],{"class":270},"segment",[99,391,366],{"class":132},[99,393,394],{"class":369},"index",[99,396,280],{"class":132},[99,398,399],{"class":369},"last",[99,401,373],{"class":132},[99,403,376],{"class":128},[99,405,406],{"class":139}," `阅读分段 ${",[99,408,394],{"class":132},[99,410,411],{"class":139},"}${",[99,413,399],{"class":132},[99,415,416],{"class":128}," ?",[99,418,419],{"class":139}," \"，已到文档末尾\"",[99,421,422],{"class":128}," :",[99,424,425],{"class":139}," \"，后面还有内容\"}`",[99,427,428],{"class":132}," }\n",[177,430,432],{"id":431},"describeblock","describeBlock",[10,434,435],{},"为自定义块补充无障碍阅读语义；避免依赖内部节点名称猜测含义。",[10,437,185,438],{},[16,439,440],{},"(node: Node): QuireAccessibleBlockDescription | null",[10,442,191,443],{},[16,444,445],{},"(node) => node.isTextblock ? { kind: \"paragraph\" } : null",[25,447,448],{"id":448},"命令与运行方式",[10,450,451],{},"此入口没有直接声明可枚举的命令。组合扩展的命令由子扩展提供；产品插件通过 contribution 或文件服务工作。不能把安装入口名称当作命令调用。",[25,453,454],{"id":454},"下一步",[10,456,457,458,462,463,465],{},"返回",[81,459,461],{"href":460},"\u002Fplugins","全部插件","，或阅读",[81,464,175],{"href":174},"区分配置、文档属性与命令。",[10,467,468,469,473,474,116],{},"自己定义能力时见",[81,470,472],{"href":471},"\u002Fbuild\u002Fextension","扩展开发","；搭建完整宿主时见",[81,475,477],{"href":476},"\u002Fbuild","构建产品",[479,480,481],"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}html pre.shiki code .sgQzM, html code.shiki .sgQzM{--shiki-default:#6F42C1;--shiki-light:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sde8i, html code.shiki .sde8i{--shiki-default:#E36209;--shiki-light:#E36209;--shiki-dark:#FFAB70}",{"title":95,"searchDepth":483,"depth":483,"links":484},2,[485,486,487,488,497,498],{"id":27,"depth":483,"text":27},{"id":88,"depth":483,"text":88},{"id":150,"depth":483,"text":150},{"id":168,"depth":483,"text":168,"children":489},[490,492,493,494,495,496],{"id":179,"depth":491,"text":179},3,{"id":197,"depth":491,"text":198},{"id":214,"depth":491,"text":215},{"id":230,"depth":491,"text":231},{"id":246,"depth":491,"text":246},{"id":431,"depth":491,"text":432},{"id":448,"depth":483,"text":448},{"id":454,"depth":483,"text":454},"md",[165,18,501,502,179,198,215,231,246,432,165],"无障碍语义","integration","zh-CN",{"navigationTitle":165,"license":23},true,0,"\u002Fplugins\u002Freference\u002Faccessibility","协作与无障碍",{"title":5,"description":12},"plugins\u002Freference\u002Faccessibility.zh-CN","-FEv-9Vh0Rx5zbrHtA_B1ZuASKtNoqnQAyfB4a1xdB8",1793045213945]