office-viewer 0.3.16 → 0.3.17

package/esm/Word.d.ts

@@ -168,6 +168,14 @@ export default class Word implements OfficeViewer {
      * 当前渲染的段落，主要用于获取 fldSimple
      */
     currentParagraph: Paragraph;
+    /**
+     * 文档中所有标题段落（用于动态生成目录），在 renderBody 预扫描时填充
+     */
+    tocHeadings: Array<{
+        level: number;
+        text: string;
+        id: string;
+    }>;
     footNotes: Record<string, Note>;
     endNotes: Record<string, Note>;
     /**

package/esm/Word.js

@@ -75,6 +75,10 @@ var Word = /** @class */ (function () {
          */
         this.styleIdNum = 0;
         this.wrapClassName = 'docx-viewer-wrapper';
+        /**
+         * 文档中所有标题段落（用于动态生成目录），在 renderBody 预扫描时填充
+         */
+        this.tocHeadings = [];
         this.footNotes = {};
         this.endNotes = {};
         /**

package/esm/openxml/word/Paragraph.d.ts

@@ -28,6 +28,8 @@ export declare class Paragraph {
     properties: ParagraphPr;
     children: ParagraphChild[];
     fldSimples: FldSimple[];
+    isTOC: boolean;
+    tocHeadingId?: string;
     addChild(child: ParagraphChild): void;
     static parseParagraphPr(word: Word, element: Element): ParagraphPr;
     static fromXML(word: Word, element: Element): Paragraph;

package/esm/openxml/word/Paragraph.js

@@ -7,6 +7,7 @@ import { NumberPr } from './numbering/NumberProperties.js';
 import { Run } from './Run.js';
 import { Tab } from './Tab.js';
 import { FldSimple } from './FldSimple.js';
+import { InstrText } from './InstrText.js';
 import { OMath } from '../math/OMath.js';
 import { mergeSdt } from '../../word/parse/mergeSdt.js';
 
@@ -38,6 +39,8 @@ var Paragraph = /** @class */ (function () {
         this.properties = {};
         this.children = [];
         this.fldSimples = [];
+        // 是否是 TOC 字段段落（包含 TOC 指令）
+        this.isTOC = false;
     }
     Paragraph.prototype.addChild = function (child) {
         this.children.push(child);
@@ -74,20 +77,40 @@ var Paragraph = /** @class */ (function () {
         return { cssStyle: cssStyle, pStyle: pStyle, numPr: numPr, tabs: tabs, autoSpace: autoSpace };
     };
     Paragraph.fromXML = function (word, element) {
-        var e_2, _a;
+        var e_2, _a, e_3, _b;
         var paragraph = new Paragraph();
         paragraph.fldSimples = [];
         paragraph.paraId = element.getAttribute('w14:paraId') || '';
         try {
-            for (var _b = __values(mergeSdt(element)), _c = _b.next(); !_c.done; _c = _b.next()) {
-                var child = _c.value;
+            for (var _c = __values(mergeSdt(element)), _d = _c.next(); !_d.done; _d = _c.next()) {
+                var child = _d.value;
                 var tagName = child.tagName;
                 switch (tagName) {
                     case 'w:pPr':
                         paragraph.properties = Paragraph.parseParagraphPr(word, child);
                         break;
                     case 'w:r':
-                        paragraph.addChild(Run.fromXML(word, child));
+                        var run = Run.fromXML(word, child);
+                        paragraph.addChild(run);
+                        // 检测 TOC 字段指令
+                        if (!paragraph.isTOC) {
+                            try {
+                                for (var _e = (e_3 = void 0, __values(run.children)), _f = _e.next(); !_f.done; _f = _e.next()) {
+                                    var rc = _f.value;
+                                    if (rc instanceof InstrText && rc.text.trim().startsWith('TOC')) {
+                                        paragraph.isTOC = true;
+                                        break;
+                                    }
+                                }
+                            }
+                            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                            finally {
+                                try {
+                                    if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
+                                }
+                                finally { if (e_3) throw e_3.error; }
+                            }
+                        }
                         break;
                     case 'w:hyperlink':
                         paragraph.addChild(Hyperlink.fromXML(word, child));
@@ -122,7 +145,7 @@ var Paragraph = /** @class */ (function () {
         catch (e_2_1) { e_2 = { error: e_2_1 }; }
         finally {
             try {
-                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+                if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
             }
             finally { if (e_2) throw e_2.error; }
         }

package/esm/word/render/renderBody.js

@@ -5,6 +5,8 @@ import { Table } from '../../openxml/word/Table.js';
 import renderParagraph from './renderParagraph.js';
 import { renderSection } from './renderSection.js';
 import renderTable from './renderTable.js';
+import { Run, Text } from '../../openxml/word/Run.js';
+import { Hyperlink } from '../../openxml/word/Hyperlink.js';
 
 /**
  * 渲染 body 节点
@@ -125,11 +127,143 @@ function renderSectionInPage(word, wDocument, bodyEl, renderOptions, sectionEl,
         }
     }, 0);
 }
+/**
+ * 获取段落纯文本（用于目录标题显示）
+ */
+function getParagraphText(paragraph) {
+    var e_2, _a, e_3, _b, e_4, _c, e_5, _d;
+    var text = '';
+    try {
+        for (var _e = __values(paragraph.children), _f = _e.next(); !_f.done; _f = _e.next()) {
+            var child = _f.value;
+            if (child instanceof Run) {
+                try {
+                    for (var _g = (e_3 = void 0, __values(child.children)), _h = _g.next(); !_h.done; _h = _g.next()) {
+                        var rc = _h.value;
+                        if (rc instanceof Text) {
+                            text += rc.text;
+                        }
+                    }
+                }
+                catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                finally {
+                    try {
+                        if (_h && !_h.done && (_b = _g.return)) _b.call(_g);
+                    }
+                    finally { if (e_3) throw e_3.error; }
+                }
+            }
+            else if (child instanceof Hyperlink) {
+                try {
+                    for (var _j = (e_4 = void 0, __values(child.children)), _k = _j.next(); !_k.done; _k = _j.next()) {
+                        var run = _k.value;
+                        try {
+                            for (var _l = (e_5 = void 0, __values(run.children)), _m = _l.next(); !_m.done; _m = _l.next()) {
+                                var rc = _m.value;
+                                if (rc instanceof Text) {
+                                    text += rc.text;
+                                }
+                            }
+                        }
+                        catch (e_5_1) { e_5 = { error: e_5_1 }; }
+                        finally {
+                            try {
+                                if (_m && !_m.done && (_d = _l.return)) _d.call(_l);
+                            }
+                            finally { if (e_5) throw e_5.error; }
+                        }
+                    }
+                }
+                catch (e_4_1) { e_4 = { error: e_4_1 }; }
+                finally {
+                    try {
+                        if (_k && !_k.done && (_c = _j.return)) _c.call(_j);
+                    }
+                    finally { if (e_4) throw e_4.error; }
+                }
+            }
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_f && !_f.done && (_a = _e.return)) _a.call(_e);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return text;
+}
+/**
+ * 判断段落是否是标题，返回标题级别（1-9），非标题返回 0
+ */
+function getHeadingLevel(word, paragraph) {
+    var _a, _b;
+    var pStyle = paragraph.properties.pStyle;
+    if (!pStyle)
+        return 0;
+    // 匹配 Heading1~Heading9 或 1~9（中文 Word 直接用数字 styleId）
+    var m = pStyle.match(/^[Hh]eading(\d)$/) ||
+        (pStyle.match(/^(\d)$/) &&
+            ((_b = (_a = word.getStyle(pStyle)) === null || _a === void 0 ? void 0 : _a.name) === null || _b === void 0 ? void 0 : _b.match(/^heading\s*(\d)$/i)));
+    if (m)
+        return parseInt(m[1], 10);
+    // 通过样式 name 来识别
+    var style = word.getStyle(pStyle);
+    if (style === null || style === void 0 ? void 0 : style.name) {
+        var nm = style.name.match(/^heading\s*(\d)$/i);
+        if (nm)
+            return parseInt(nm[1], 10);
+    }
+    return 0;
+}
+var _tocHeadingCounter = 0;
+/**
+ * 预扫描文档，收集标题并为 TOC 段落标记
+ */
+function prescanHeadings(word, body) {
+    var e_6, _a, e_7, _b;
+    _tocHeadingCounter = 0;
+    word.tocHeadings = [];
+    try {
+        for (var _c = __values(body.sections), _d = _c.next(); !_d.done; _d = _c.next()) {
+            var section = _d.value;
+            try {
+                for (var _e = (e_7 = void 0, __values(section.children)), _f = _e.next(); !_f.done; _f = _e.next()) {
+                    var child = _f.value;
+                    if (!(child instanceof Paragraph))
+                        continue;
+                    var level = getHeadingLevel(word, child);
+                    if (level > 0) {
+                        var id = "toc-h-".concat(_tocHeadingCounter++);
+                        child.tocHeadingId = id;
+                        word.tocHeadings.push({ level: level, text: getParagraphText(child), id: id });
+                    }
+                }
+            }
+            catch (e_7_1) { e_7 = { error: e_7_1 }; }
+            finally {
+                try {
+                    if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
+                }
+                finally { if (e_7) throw e_7.error; }
+            }
+        }
+    }
+    catch (e_6_1) { e_6 = { error: e_6_1 }; }
+    finally {
+        try {
+            if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+        }
+        finally { if (e_6) throw e_6.error; }
+    }
+}
 /**
  * 渲染文档主体
  */
 function renderBody(root, word, bodyEl, wDocument, body, renderOptions) {
-    var e_2, _a, e_3, _b;
+    var e_8, _a, e_9, _b;
+    // 预扫描标题，为动态目录生成准备数据
+    prescanHeadings(word, body);
     var page = renderOptions.page || false;
     var rootWidth = root.getBoundingClientRect().width -
         (renderOptions.pageWrapPadding || 0) * 2;
@@ -155,7 +289,7 @@ function renderBody(root, word, bodyEl, wDocument, body, renderOptions) {
             }
             else {
                 try {
-                    for (var _c = (e_3 = void 0, __values(section.children)), _d = _c.next(); !_d.done; _d = _c.next()) {
+                    for (var _c = (e_9 = void 0, __values(section.children)), _d = _c.next(); !_d.done; _d = _c.next()) {
                         var child = _d.value;
                         if (child instanceof Paragraph) {
                             var p = renderParagraph(word, child);
@@ -170,22 +304,22 @@ function renderBody(root, word, bodyEl, wDocument, body, renderOptions) {
                         }
                     }
                 }
-                catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                catch (e_9_1) { e_9 = { error: e_9_1 }; }
                 finally {
                     try {
                         if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
                     }
-                    finally { if (e_3) throw e_3.error; }
+                    finally { if (e_9) throw e_9.error; }
                 }
             }
         }
     }
-    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    catch (e_8_1) { e_8 = { error: e_8_1 }; }
     finally {
         try {
             if (sections_1_1 && !sections_1_1.done && (_a = sections_1.return)) _a.call(sections_1);
         }
-        finally { if (e_2) throw e_2.error; }
+        finally { if (e_8) throw e_8.error; }
     }
     setTimeout(function () {
         if (renderOptions.zoom) {

package/esm/word/render/renderInstrText.js

@@ -12,6 +12,10 @@ function renderInstrText(word, instrText) {
     var _b;
     var text = instrText.text;
     var span = createElement('span');
+    // TOC 字段指令不渲染原始指令文本，目录条目已作为普通段落存在于文档中
+    if (text.trim().startsWith('TOC')) {
+        return span;
+    }
     var fldSimples = (_b = word.currentParagraph) === null || _b === void 0 ? void 0 : _b.fldSimples;
     if (fldSimples) {
         try {

package/esm/word/render/renderParagraph.js

@@ -11,6 +11,7 @@ import { setElementStyle } from './setElementStyle.js';
 import { renderTab } from './renderTab.js';
 import { OMath } from '../../openxml/math/OMath.js';
 import { renderOMath } from './renderMath.js';
+import { renderTOC } from './renderTOC.js';
 
 /**
  * 渲染段落
@@ -21,17 +22,27 @@ function renderParagraph(word, paragraph, renderEmptySpace, inHeader) {
     if (renderEmptySpace === void 0) { renderEmptySpace = true; }
     if (inHeader === void 0) { inHeader = false; }
     word.currentParagraph = paragraph;
+    // 如果是 TOC 字段段落且文档中有标题，动态生成目录
+    if (paragraph.isTOC && word.tocHeadings.length > 0) {
+        return renderTOC(word);
+    }
     var p = createElement('p');
     word.addClass(p, 'p');
     var properties = paragraph.properties;
     setElementStyle(word, p, properties);
     // 默认情况下 drawing 是相对段落的
     p.style.position = 'relative';
+    // 如果是标题段落，为目录锚点添加 id
+    if (paragraph.tocHeadingId) {
+        p.id = paragraph.tocHeadingId;
+    }
     // 渲染列表前缀
     if (properties.numPr) {
         appendChild(p, renderNumbering(p, word, properties.numPr));
     }
-    var inFldChar = false;
+    // 复杂字段状态: 'outside' | 'instr' | 'content'
+    // begin -> instr, separate -> content, end -> outside
+    var fldCharState = 'outside';
     if (properties.tabs && properties.tabs.length) {
         // 目前只支持渲染第一个，因为第二个位置取决于前面内容位置，挺麻烦
         // 虽然目前这个实现很 hack，但可以支持常见情况
@@ -58,12 +69,19 @@ function renderParagraph(word, paragraph, renderEmptySpace, inHeader) {
             var child = _c.value;
             if (child instanceof Run) {
                 if (child.fldChar === 'begin') {
-                    inFldChar = true;
+                    fldCharState = 'instr';
+                }
+                else if (child.fldChar === 'separate') {
+                    fldCharState = 'content';
+                }
+                else if (child.fldChar === 'end') {
+                    fldCharState = 'outside';
                 }
-                else if (child) {
-                    inFldChar = false;
+                // 跳过 instrText 所在的 run（字段指令本身不渲染），fldChar 节点本身正常渲染
+                if (fldCharState === 'instr' && !child.fldChar) {
+                    continue;
                 }
-                appendChild(p, renderRun(word, child, paragraph, inFldChar, inHeader));
+                appendChild(p, renderRun(word, child, paragraph, false, inHeader));
             }
             else if (child instanceof BookmarkStart) {
                 appendChild(p, renderBookmarkStart(word, child));

package/esm/word/render/renderTOC.d.ts

@@ -0,0 +1,5 @@
+import Word from '../../Word';
+/**
+ * 动态生成目录 HTML（当文档 TOC 字段没有缓存条目时使用）
+ */
+export declare function renderTOC(word: Word): HTMLElement;

package/esm/word/render/renderTOC.js

@@ -0,0 +1,34 @@
+import { __values } from 'tslib';
+import { createElement, appendChild } from '../../util/dom.js';
+
+/**
+ * 动态生成目录 HTML（当文档 TOC 字段没有缓存条目时使用）
+ */
+function renderTOC(word) {
+    var e_1, _a;
+    var nav = createElement('nav');
+    nav.className = 'docx-toc';
+    try {
+        for (var _b = __values(word.tocHeadings), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var heading = _c.value;
+            var item = createElement('div');
+            item.className = "docx-toc-item docx-toc-level-".concat(heading.level);
+            item.style.paddingLeft = "".concat((heading.level - 1) * 2, "em");
+            var a = createElement('a');
+            a.href = '#' + heading.id;
+            a.textContent = heading.text;
+            appendChild(item, a);
+            appendChild(nav, item);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return nav;
+}
+
+export { renderTOC };

package/lib/Word.d.ts

@@ -168,6 +168,14 @@ export default class Word implements OfficeViewer {
      * 当前渲染的段落，主要用于获取 fldSimple
      */
     currentParagraph: Paragraph;
+    /**
+     * 文档中所有标题段落（用于动态生成目录），在 renderBody 预扫描时填充
+     */
+    tocHeadings: Array<{
+        level: number;
+        text: string;
+        id: string;
+    }>;
     footNotes: Record<string, Note>;
     endNotes: Record<string, Note>;
     /**

package/lib/Word.js

@@ -79,6 +79,10 @@ var Word = /** @class */ (function () {
          */
         this.styleIdNum = 0;
         this.wrapClassName = 'docx-viewer-wrapper';
+        /**
+         * 文档中所有标题段落（用于动态生成目录），在 renderBody 预扫描时填充
+         */
+        this.tocHeadings = [];
         this.footNotes = {};
         this.endNotes = {};
         /**

package/lib/excel/lang/lang.d.ts

@@ -23,7 +23,7 @@ declare const languages: {
         count: string;
         sum: string;
     };
-    zh_CN: Record<"autoFilter.sortAscending" | "autoFilter.sortDescending" | "checkBox.selectAll" | "checkBox.search" | "customFilter.equal" | "customFilter.notEqual" | "customFilter.greaterThan" | "customFilter.greaterThanOrEqual" | "customFilter.lessThan" | "customFilter.lessThanOrEqual" | "customFilter.beginsWith" | "customFilter.notBeginsWith" | "customFilter.endsWith" | "customFilter.notEndsWith" | "customFilter.contains" | "customFilter.notContains" | "customFilter.and" | "customFilter.or" | "average" | "count" | "sum", string>;
+    zh_CN: Record<"average" | "autoFilter.sortAscending" | "autoFilter.sortDescending" | "checkBox.selectAll" | "checkBox.search" | "customFilter.equal" | "customFilter.notEqual" | "customFilter.greaterThan" | "customFilter.greaterThanOrEqual" | "customFilter.lessThan" | "customFilter.lessThanOrEqual" | "customFilter.beginsWith" | "customFilter.notBeginsWith" | "customFilter.endsWith" | "customFilter.notEndsWith" | "customFilter.contains" | "customFilter.notContains" | "customFilter.and" | "customFilter.or" | "count" | "sum", string>;
 };
 export type Language = keyof typeof languages;
 export declare function getTranslate(language: string): (key: EnKeys) => string;

package/lib/excel/render/dnd/mousedownColHeader.d.ts

@@ -10,7 +10,7 @@ import { HitTestResult } from '../selection/hitTest';
 export declare function mousedownColHeader(workbook: Workbook, hitTestResult: HitTestResult): {
     user: string;
     region: import("../../sheet/ViewRange").Region;
-    selectType: "drawing" | "corner" | "cell" | "row-header" | "col-header" | "row-grid" | "col-grid";
+    selectType: "corner" | "drawing" | "cell" | "row-header" | "col-header" | "row-grid" | "col-grid";
     activeCell: RangeRef;
     sheetIndex: number;
     cellRanges: {

package/lib/excel/render/dnd/mousedownRowHeader.d.ts

@@ -10,7 +10,7 @@ import { HitTestResult } from '../selection/hitTest';
 export declare function mousedownRowHeader(workbook: Workbook, hitTestResult: HitTestResult): {
     user: string;
     region: import("../../sheet/ViewRange").Region;
-    selectType: "drawing" | "corner" | "cell" | "row-header" | "col-header" | "row-grid" | "col-grid";
+    selectType: "corner" | "drawing" | "cell" | "row-header" | "col-header" | "row-grid" | "col-grid";
     activeCell: RangeRef;
     sheetIndex: number;
     cellRanges: {

package/lib/openxml/word/Paragraph.d.ts

@@ -28,6 +28,8 @@ export declare class Paragraph {
     properties: ParagraphPr;
     children: ParagraphChild[];
     fldSimples: FldSimple[];
+    isTOC: boolean;
+    tocHeadingId?: string;
     addChild(child: ParagraphChild): void;
     static parseParagraphPr(word: Word, element: Element): ParagraphPr;
     static fromXML(word: Word, element: Element): Paragraph;

package/lib/openxml/word/Paragraph.js

@@ -11,6 +11,7 @@ var NumberProperties = require('./numbering/NumberProperties.js');
 var Run = require('./Run.js');
 var Tab = require('./Tab.js');
 var FldSimple = require('./FldSimple.js');
+var InstrText = require('./InstrText.js');
 var OMath = require('../math/OMath.js');
 var mergeSdt = require('../../word/parse/mergeSdt.js');
 
@@ -42,6 +43,8 @@ var Paragraph = /** @class */ (function () {
         this.properties = {};
         this.children = [];
         this.fldSimples = [];
+        // 是否是 TOC 字段段落（包含 TOC 指令）
+        this.isTOC = false;
     }
     Paragraph.prototype.addChild = function (child) {
         this.children.push(child);
@@ -78,20 +81,40 @@ var Paragraph = /** @class */ (function () {
         return { cssStyle: cssStyle, pStyle: pStyle, numPr: numPr, tabs: tabs, autoSpace: autoSpace };
     };
     Paragraph.fromXML = function (word, element) {
-        var e_2, _a;
+        var e_2, _a, e_3, _b;
         var paragraph = new Paragraph();
         paragraph.fldSimples = [];
         paragraph.paraId = element.getAttribute('w14:paraId') || '';
         try {
-            for (var _b = tslib.__values(mergeSdt.mergeSdt(element)), _c = _b.next(); !_c.done; _c = _b.next()) {
-                var child = _c.value;
+            for (var _c = tslib.__values(mergeSdt.mergeSdt(element)), _d = _c.next(); !_d.done; _d = _c.next()) {
+                var child = _d.value;
                 var tagName = child.tagName;
                 switch (tagName) {
                     case 'w:pPr':
                         paragraph.properties = Paragraph.parseParagraphPr(word, child);
                         break;
                     case 'w:r':
-                        paragraph.addChild(Run.Run.fromXML(word, child));
+                        var run = Run.Run.fromXML(word, child);
+                        paragraph.addChild(run);
+                        // 检测 TOC 字段指令
+                        if (!paragraph.isTOC) {
+                            try {
+                                for (var _e = (e_3 = void 0, tslib.__values(run.children)), _f = _e.next(); !_f.done; _f = _e.next()) {
+                                    var rc = _f.value;
+                                    if (rc instanceof InstrText.InstrText && rc.text.trim().startsWith('TOC')) {
+                                        paragraph.isTOC = true;
+                                        break;
+                                    }
+                                }
+                            }
+                            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                            finally {
+                                try {
+                                    if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
+                                }
+                                finally { if (e_3) throw e_3.error; }
+                            }
+                        }
                         break;
                     case 'w:hyperlink':
                         paragraph.addChild(Hyperlink.Hyperlink.fromXML(word, child));
@@ -126,7 +149,7 @@ var Paragraph = /** @class */ (function () {
         catch (e_2_1) { e_2 = { error: e_2_1 }; }
         finally {
             try {
-                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+                if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
             }
             finally { if (e_2) throw e_2.error; }
         }

package/lib/word/parse/jcToTextAlign.d.ts

@@ -2,4 +2,4 @@
  *
  * http://webapp.docx4java.org/OnlineDemo/ecma376/WordML/ST_Jc.html
  */
-export declare function jcToTextAlign(jc: string): "center" | "justify" | "left" | "right";
+export declare function jcToTextAlign(jc: string): "center" | "left" | "right" | "justify";