[{"data":1,"prerenderedAt":770},["ShallowReactive",2],{"navigation_docs_zh":3,"-zh-xml-escape":237,"-zh-xml-escape-surround":765},[4,23,61,91,163],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":22},"快速开始","i-lucide-rocket","\u002Fzh\u002Fgetting-started","zh\u002F01.getting-started",[10,14,18],{"title":11,"path":12,"stem":13},"简介","\u002Fzh\u002Fgetting-started\u002Fintroduction","zh\u002F01.getting-started\u002F01.introduction",{"title":15,"path":16,"stem":17},"安装","\u002Fzh\u002Fgetting-started\u002Finstallation","zh\u002F01.getting-started\u002F02.installation",{"title":19,"path":20,"stem":21},"AI 集成","\u002Fzh\u002Fgetting-started\u002Fai-integration","zh\u002F01.getting-started\u002F03.ai-integration",false,{"title":24,"icon":25,"path":26,"stem":27,"children":28,"page":22},"CORE","i-lucide-box","\u002Fzh\u002Fcore","zh\u002F02.core",[29,33,37,41,45,49,53,57],{"title":30,"path":31,"stem":32},"@office-open\u002Fcore","\u002Fzh\u002Fcore\u002Foverview","zh\u002F02.core\u002F01.overview",{"title":34,"path":35,"stem":36},"XML 组件","\u002Fzh\u002Fcore\u002Fxml-components","zh\u002F02.core\u002F02.xml-components",{"title":38,"path":39,"stem":40},"值与验证","\u002Fzh\u002Fcore\u002Fvalues","zh\u002F02.core\u002F03.values",{"title":42,"path":43,"stem":44},"单位转换器","\u002Fzh\u002Fcore\u002Fconverters","zh\u002F02.core\u002F04.converters",{"title":46,"path":47,"stem":48},"Formatter","\u002Fzh\u002Fcore\u002Fformatter","zh\u002F02.core\u002F05.formatter",{"title":50,"path":51,"stem":52},"Parser","\u002Fzh\u002Fcore\u002Fparser","zh\u002F02.core\u002F06.parser",{"title":54,"path":55,"stem":56},"Archive","\u002Fzh\u002Fcore\u002Farchive","zh\u002F02.core\u002F07.archive",{"title":58,"path":59,"stem":60},"Charts","\u002Fzh\u002Fcore\u002Fcharts","zh\u002F02.core\u002F08.charts",{"title":62,"icon":63,"path":64,"stem":65,"children":66,"page":22},"XML","i-lucide-code-xml","\u002Fzh\u002Fxml","zh\u002F03.xml",[67,71,75,79,83,87],{"title":68,"path":69,"stem":70},"@office-open\u002Fxml","\u002Fzh\u002Fxml\u002Foverview","zh\u002F03.xml\u002F01.overview",{"title":72,"path":73,"stem":74},"解析","\u002Fzh\u002Fxml\u002Fparsing","zh\u002F03.xml\u002F02.parsing",{"title":76,"path":77,"stem":78},"序列化","\u002Fzh\u002Fxml\u002Fserialization","zh\u002F03.xml\u002F03.serialization",{"title":80,"path":81,"stem":82},"查询工具","\u002Fzh\u002Fxml\u002Fquery-utilities","zh\u002F03.xml\u002F04.query-utilities",{"title":84,"path":85,"stem":86},"XML 转义","\u002Fzh\u002Fxml\u002Fescape","zh\u002F03.xml\u002F05.escape",{"title":88,"path":89,"stem":90},"类型参考","\u002Fzh\u002Fxml\u002Ftypes","zh\u002F03.xml\u002F06.types",{"title":92,"icon":93,"path":94,"stem":95,"children":96,"page":22},"DOCX","i-lucide-file-text","\u002Fzh\u002Fdocx","zh\u002F04.docx",[97,101,104,108,112,116,120,124,128,132,136,140,144,148,152,156,160],{"title":98,"path":99,"stem":100},"@office-open\u002Fdocx","\u002Fzh\u002Fdocx\u002Foverview","zh\u002F04.docx\u002F01.overview",{"title":5,"path":102,"stem":103},"\u002Fzh\u002Fdocx\u002Fquickstart","zh\u002F04.docx\u002F02.quickstart",{"title":105,"path":106,"stem":107},"文本与段落","\u002Fzh\u002Fdocx\u002Ftext-and-paragraphs","zh\u002F04.docx\u002F03.text-and-paragraphs",{"title":109,"path":110,"stem":111},"表格","\u002Fzh\u002Fdocx\u002Ftables","zh\u002F04.docx\u002F04.tables",{"title":113,"path":114,"stem":115},"图片","\u002Fzh\u002Fdocx\u002Fimages","zh\u002F04.docx\u002F05.images",{"title":117,"path":118,"stem":119},"图表","\u002Fzh\u002Fdocx\u002Fcharts","zh\u002F04.docx\u002F06.charts",{"title":121,"path":122,"stem":123},"SmartArt","\u002Fzh\u002Fdocx\u002Fsmartart","zh\u002F04.docx\u002F07.smartart",{"title":125,"path":126,"stem":127},"媒体","\u002Fzh\u002Fdocx\u002Fmedia","zh\u002F04.docx\u002F08.media",{"title":129,"path":130,"stem":131},"链接","\u002Fzh\u002Fdocx\u002Flinks","zh\u002F04.docx\u002F09.links",{"title":133,"path":134,"stem":135},"页眉与页脚","\u002Fzh\u002Fdocx\u002Fheaders-and-footers","zh\u002F04.docx\u002F10.headers-and-footers",{"title":137,"path":138,"stem":139},"公式与符号","\u002Fzh\u002Fdocx\u002Fequations-and-symbols","zh\u002F04.docx\u002F11.equations-and-symbols",{"title":141,"path":142,"stem":143},"样式与主题","\u002Fzh\u002Fdocx\u002Fstyles-and-themes","zh\u002F04.docx\u002F12.styles-and-themes",{"title":145,"path":146,"stem":147},"页面布局","\u002Fzh\u002Fdocx\u002Fpage-layout","zh\u002F04.docx\u002F13.page-layout",{"title":149,"path":150,"stem":151},"引用","\u002Fzh\u002Fdocx\u002Freferences","zh\u002F04.docx\u002F14.references",{"title":153,"path":154,"stem":155},"批注与修订","\u002Fzh\u002Fdocx\u002Fcomments-and-revisions","zh\u002F04.docx\u002F15.comments-and-revisions",{"title":157,"path":158,"stem":159},"导出","\u002Fzh\u002Fdocx\u002Fexport","zh\u002F04.docx\u002F16.export",{"title":72,"path":161,"stem":162},"\u002Fzh\u002Fdocx\u002Fparsing","zh\u002F04.docx\u002F17.parsing",{"title":164,"icon":165,"path":166,"stem":167,"children":168,"page":22},"PPTX","i-lucide-presentation","\u002Fzh\u002Fpptx","zh\u002F05.pptx",[169,173,176,180,183,186,189,192,195,198,201,204,208,211,215,219,223,227,230,233],{"title":170,"path":171,"stem":172},"@office-open\u002Fpptx","\u002Fzh\u002Fpptx\u002Foverview","zh\u002F05.pptx\u002F01.overview",{"title":5,"path":174,"stem":175},"\u002Fzh\u002Fpptx\u002Fquickstart","zh\u002F05.pptx\u002F02.quickstart",{"title":177,"path":178,"stem":179},"形状与文本","\u002Fzh\u002Fpptx\u002Fshapes-and-text","zh\u002F05.pptx\u002F03.shapes-and-text",{"title":109,"path":181,"stem":182},"\u002Fzh\u002Fpptx\u002Ftables","zh\u002F05.pptx\u002F04.tables",{"title":113,"path":184,"stem":185},"\u002Fzh\u002Fpptx\u002Fimages","zh\u002F05.pptx\u002F05.images",{"title":117,"path":187,"stem":188},"\u002Fzh\u002Fpptx\u002Fcharts","zh\u002F05.pptx\u002F06.charts",{"title":121,"path":190,"stem":191},"\u002Fzh\u002Fpptx\u002Fsmartart","zh\u002F05.pptx\u002F07.smartart",{"title":125,"path":193,"stem":194},"\u002Fzh\u002Fpptx\u002Fmedia","zh\u002F05.pptx\u002F08.media",{"title":129,"path":196,"stem":197},"\u002Fzh\u002Fpptx\u002Flinks","zh\u002F05.pptx\u002F09.links",{"title":133,"path":199,"stem":200},"\u002Fzh\u002Fpptx\u002Fheaders-and-footers","zh\u002F05.pptx\u002F10.headers-and-footers",{"title":137,"path":202,"stem":203},"\u002Fzh\u002Fpptx\u002Fequations-and-symbols","zh\u002F05.pptx\u002F11.equations-and-symbols",{"title":205,"path":206,"stem":207},"线条与连接符","\u002Fzh\u002Fpptx\u002Flines-and-connectors","zh\u002F05.pptx\u002F12.lines-and-connectors",{"title":141,"path":209,"stem":210},"\u002Fzh\u002Fpptx\u002Fstyles-and-themes","zh\u002F05.pptx\u002F13.styles-and-themes",{"title":212,"path":213,"stem":214},"效果与填充","\u002Fzh\u002Fpptx\u002Feffects-and-fills","zh\u002F05.pptx\u002F14.effects-and-fills",{"title":216,"path":217,"stem":218},"幻灯片布局","\u002Fzh\u002Fpptx\u002Fslide-layout","zh\u002F05.pptx\u002F15.slide-layout",{"title":220,"path":221,"stem":222},"切换效果","\u002Fzh\u002Fpptx\u002Ftransitions","zh\u002F05.pptx\u002F16.transitions",{"title":224,"path":225,"stem":226},"动画效果","\u002Fzh\u002Fpptx\u002Fanimations","zh\u002F05.pptx\u002F17.animations",{"title":157,"path":228,"stem":229},"\u002Fzh\u002Fpptx\u002Fexport","zh\u002F05.pptx\u002F18.export",{"title":72,"path":231,"stem":232},"\u002Fzh\u002Fpptx\u002Fparsing","zh\u002F05.pptx\u002F19.parsing",{"title":234,"path":235,"stem":236},"批注","\u002Fzh\u002Fpptx\u002Fcomments","zh\u002F05.pptx\u002F20.comments",{"id":238,"title":84,"body":239,"description":759,"extension":760,"links":761,"meta":762,"navigation":304,"path":85,"seo":763,"stem":86,"__hash__":764},"docs_zh\u002Fzh\u002F03.xml\u002F05.escape.md",{"type":240,"value":241,"toc":752},"minimark",[242,246,251,254,332,366,370,373,423,429,432,435,575,592,596,599,748],[243,244,245],"p",{},"在编程构建 XML 内容时，特殊字符必须转义。escape 模块提供了安全的 XML 字符串处理工具。",[247,248,250],"h2",{"id":249},"escapexml","escapeXml",[243,252,253],{},"转义 XML 元素内的文本内容：",[255,256,261],"pre",{"className":257,"code":258,"language":259,"meta":260,"style":260},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { escapeXml } from \"@office-open\u002Fxml\";\n\nescapeXml(\"Hello \u003CWorld> & 'Friends'\"); \u002F\u002F \"Hello <World> & 'Friends'\"\n","ts","",[262,263,264,299,306],"code",{"__ignoreMap":260},[265,266,269,273,277,281,284,287,290,293,296],"span",{"class":267,"line":268},"line",1,[265,270,272],{"class":271},"s7zQu","import",[265,274,276],{"class":275},"sMK4o"," {",[265,278,280],{"class":279},"sTEyZ"," escapeXml",[265,282,283],{"class":275}," }",[265,285,286],{"class":271}," from",[265,288,289],{"class":275}," \"",[265,291,68],{"class":292},"sfazB",[265,294,295],{"class":275},"\"",[265,297,298],{"class":275},";\n",[265,300,302],{"class":267,"line":301},2,[265,303,305],{"emptyLinePlaceholder":304},true,"\n",[265,307,309,312,315,317,320,322,325,328],{"class":267,"line":308},3,[265,310,250],{"class":311},"s2Zo4",[265,313,314],{"class":279},"(",[265,316,295],{"class":275},[265,318,319],{"class":292},"Hello \u003CWorld> & 'Friends'",[265,321,295],{"class":275},[265,323,324],{"class":279},")",[265,326,327],{"class":275},";",[265,329,331],{"class":330},"sHwdD"," \u002F\u002F \"Hello <World> & 'Friends'\"\n",[243,333,334,335,338,339,342,343,338,346,342,349,338,352,342,355,338,357,342,360,338,363],{},"转义规则：",[262,336,337],{},"&"," → ",[262,340,341],{},"&","、",[262,344,345],{},"\u003C",[262,347,348],{},"<",[262,350,351],{},">",[262,353,354],{},">",[262,356,295],{},[262,358,359],{},""",[262,361,362],{},"'",[262,364,365],{},"'",[247,367,369],{"id":368},"escapeattributevalue","escapeAttributeValue",[243,371,372],{},"转义属性值，额外处理已转义的实体：",[255,374,376],{"className":257,"code":375,"language":259,"meta":260,"style":260},"import { escapeAttributeValue } from \"@office-open\u002Fxml\";\n\nescapeAttributeValue('value with \"quotes\"'); \u002F\u002F 'value with "quotes"'\n",[262,377,378,399,403],{"__ignoreMap":260},[265,379,380,382,384,387,389,391,393,395,397],{"class":267,"line":268},[265,381,272],{"class":271},[265,383,276],{"class":275},[265,385,386],{"class":279}," escapeAttributeValue",[265,388,283],{"class":275},[265,390,286],{"class":271},[265,392,289],{"class":275},[265,394,68],{"class":292},[265,396,295],{"class":275},[265,398,298],{"class":275},[265,400,401],{"class":267,"line":301},[265,402,305],{"emptyLinePlaceholder":304},[265,404,405,407,409,411,414,416,418,420],{"class":267,"line":308},[265,406,369],{"class":311},[265,408,314],{"class":279},[265,410,362],{"class":275},[265,412,413],{"class":292},"value with \"quotes\"",[265,415,362],{"class":275},[265,417,324],{"class":279},[265,419,327],{"class":275},[265,421,422],{"class":330}," \u002F\u002F 'value with "quotes"'\n",[243,424,425,426,428],{},"与 ",[262,427,250],{}," 不同，此函数保留已转义的实体，防止双重转义。",[247,430,431],{"id":431},"attrs",[243,433,434],{},"从记录对象构建 XML 属性字符串：",[255,436,438],{"className":257,"code":437,"language":259,"meta":260,"style":260},"import { attrs } from \"@office-open\u002Fxml\";\n\nconst attrStr = attrs({\n    \"w:val\": \"single\",\n    \"w:sz\": 4,\n    \"w:space\": \"\",\n    \"w:color\": undefined,\n});\n\u002F\u002F ' w:val=\"single\" w:sz=\"4\" w:space=\"\"'\n",[262,439,440,461,465,484,509,527,544,559,569],{"__ignoreMap":260},[265,441,442,444,446,449,451,453,455,457,459],{"class":267,"line":268},[265,443,272],{"class":271},[265,445,276],{"class":275},[265,447,448],{"class":279}," attrs",[265,450,283],{"class":275},[265,452,286],{"class":271},[265,454,289],{"class":275},[265,456,68],{"class":292},[265,458,295],{"class":275},[265,460,298],{"class":275},[265,462,463],{"class":267,"line":301},[265,464,305],{"emptyLinePlaceholder":304},[265,466,467,471,474,477,479,481],{"class":267,"line":308},[265,468,470],{"class":469},"spNyl","const",[265,472,473],{"class":279}," attrStr ",[265,475,476],{"class":275},"=",[265,478,448],{"class":311},[265,480,314],{"class":279},[265,482,483],{"class":275},"{\n",[265,485,487,490,494,496,499,501,504,506],{"class":267,"line":486},4,[265,488,489],{"class":275},"    \"",[265,491,493],{"class":492},"swJcz","w:val",[265,495,295],{"class":275},[265,497,498],{"class":275},":",[265,500,289],{"class":275},[265,502,503],{"class":292},"single",[265,505,295],{"class":275},[265,507,508],{"class":275},",\n",[265,510,512,514,517,519,521,525],{"class":267,"line":511},5,[265,513,489],{"class":275},[265,515,516],{"class":492},"w:sz",[265,518,295],{"class":275},[265,520,498],{"class":275},[265,522,524],{"class":523},"sbssI"," 4",[265,526,508],{"class":275},[265,528,530,532,535,537,539,542],{"class":267,"line":529},6,[265,531,489],{"class":275},[265,533,534],{"class":492},"w:space",[265,536,295],{"class":275},[265,538,498],{"class":275},[265,540,541],{"class":275}," \"\"",[265,543,508],{"class":275},[265,545,547,549,552,554,556],{"class":267,"line":546},7,[265,548,489],{"class":275},[265,550,551],{"class":492},"w:color",[265,553,295],{"class":275},[265,555,498],{"class":275},[265,557,558],{"class":275}," undefined,\n",[265,560,562,565,567],{"class":267,"line":561},8,[265,563,564],{"class":275},"}",[265,566,324],{"class":279},[265,568,298],{"class":275},[265,570,572],{"class":267,"line":571},9,[265,573,574],{"class":330},"\u002F\u002F ' w:val=\"single\" w:sz=\"4\" w:space=\"\"'\n",[576,577,578,586,589],"ul",{},[579,580,581,582,585],"li",{},"自动跳过 ",[262,583,584],{},"undefined"," 值",[579,587,588],{},"将数字转换为字符串",[579,590,591],{},"转义字符串值",[593,594,595],"h3",{"id":595},"构建元素",[243,597,598],{},"与其他函数结合构建 XML 片段：",[255,600,602],{"className":257,"code":601,"language":259,"meta":260,"style":260},"import { attrs, escapeXml } from \"@office-open\u002Fxml\";\n\nconst name = \"w:spacing\";\nconst attributes = attrs({ \"w:before\": \"240\", \"w:after\": \"120\" });\nconst xml = `\u003C${name}${attributes}\u002F>`;\n\u002F\u002F '\u003Cw:spacing w:before=\"240\" w:after=\"120\"\u002F>'\n",[262,603,604,629,633,651,707,743],{"__ignoreMap":260},[265,605,606,608,610,612,615,617,619,621,623,625,627],{"class":267,"line":268},[265,607,272],{"class":271},[265,609,276],{"class":275},[265,611,448],{"class":279},[265,613,614],{"class":275},",",[265,616,280],{"class":279},[265,618,283],{"class":275},[265,620,286],{"class":271},[265,622,289],{"class":275},[265,624,68],{"class":292},[265,626,295],{"class":275},[265,628,298],{"class":275},[265,630,631],{"class":267,"line":301},[265,632,305],{"emptyLinePlaceholder":304},[265,634,635,637,640,642,644,647,649],{"class":267,"line":308},[265,636,470],{"class":469},[265,638,639],{"class":279}," name ",[265,641,476],{"class":275},[265,643,289],{"class":275},[265,645,646],{"class":292},"w:spacing",[265,648,295],{"class":275},[265,650,298],{"class":275},[265,652,653,655,658,660,662,664,667,669,672,674,676,678,681,683,685,687,690,692,694,696,699,701,703,705],{"class":267,"line":486},[265,654,470],{"class":469},[265,656,657],{"class":279}," attributes ",[265,659,476],{"class":275},[265,661,448],{"class":311},[265,663,314],{"class":279},[265,665,666],{"class":275},"{",[265,668,289],{"class":275},[265,670,671],{"class":492},"w:before",[265,673,295],{"class":275},[265,675,498],{"class":275},[265,677,289],{"class":275},[265,679,680],{"class":292},"240",[265,682,295],{"class":275},[265,684,614],{"class":275},[265,686,289],{"class":275},[265,688,689],{"class":492},"w:after",[265,691,295],{"class":275},[265,693,498],{"class":275},[265,695,289],{"class":275},[265,697,698],{"class":292},"120",[265,700,295],{"class":275},[265,702,283],{"class":275},[265,704,324],{"class":279},[265,706,298],{"class":275},[265,708,709,711,714,716,719,721,724,727,730,733,735,738,741],{"class":267,"line":511},[265,710,470],{"class":469},[265,712,713],{"class":279}," xml ",[265,715,476],{"class":275},[265,717,718],{"class":275}," `",[265,720,345],{"class":292},[265,722,723],{"class":275},"${",[265,725,726],{"class":279},"name",[265,728,729],{"class":275},"}${",[265,731,732],{"class":279},"attributes",[265,734,564],{"class":275},[265,736,737],{"class":292},"\u002F>",[265,739,740],{"class":275},"`",[265,742,298],{"class":275},[265,744,745],{"class":267,"line":529},[265,746,747],{"class":330},"\u002F\u002F '\u003Cw:spacing w:before=\"240\" w:after=\"120\"\u002F>'\n",[749,750,751],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}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 .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 .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 .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":260,"searchDepth":301,"depth":301,"links":753},[754,755,756],{"id":249,"depth":301,"text":250},{"id":368,"depth":301,"text":369},{"id":431,"depth":301,"text":431,"children":757},[758],{"id":595,"depth":308,"text":595},"安全地转义和构建 XML 属性字符串","md",null,{},{"title":84,"description":759},"TP851LDJDqlhbpz9EN6NszYdvGa-EDoaT2HWg4OkNrI",[766,768],{"title":80,"path":81,"stem":82,"description":767,"children":-1},"使用辅助函数遍历和检查已解析的 XML Element 树",{"title":88,"path":89,"stem":90,"description":769,"children":-1},"XML 解析和序列化的核心 TypeScript 类型",1778862993854]