尧图网页设计 
后端【免费下载链接】PHPWordA pure PHP library for reading and writing word processing documents项目地址https://gitcode.com/gh_mirrors/ph/PHPWord点击查看免费下载导读本文聚焦 PHPWord 中目录Table of ContentsTOC的生成与样式控制。你将学会通过addTOC方法在一节Section中插入目录理解$fontStyle、$tocStyle、$minDepth、$maxDepth四个参数的完整含义与默认值掌握tabLeader、tabPos、indent三个目录样式的取值细节并了解 Word2007 与 ODText 两种输出格式在目录实现上的本质差异。读完本文你能够在自己用 PHPWord 生成的长文档中一键产出带页码、带超链接的专业目录。一、先决条件目录的前提是标题TitleTOC 元素本身不会凭空生成条目。文档明确指出只有当文档中至少添加了一个标题Title时目录才能生成。在 PHPWord 中标题通过addTitle方法添加到 Section 中其第二个参数表示标题层级depth例如$section-addTitle(Foo n Bar, 1); // 一级标题 $section-addTitle(I am a Subtitle, 2); // 二级标题从源码看每个标题都会被收集到全局的标题集合中。元素类 Title.php 保存了$depth层级默认 1与可选的$pageNumber页码并通过collectionRelation true表明自身参与集合关联集合本身定义在 Collection/Titles.php是对Title元素的包装。当TOC::getTitles()被调用时它会从PhpWord::getTitles()中取出全部标题再按minDepth/maxDepth过滤见 Element/TOC.php。关于标题样式的完整用法可参考文档 docs/usage/elements/title.md。二、核心用法addTOC方法签名与参数详解在 Section 上直接调用addTOC即可插入目录。该方法的完整签名定义在容器基类 AbstractContainer.php 的method注解中$section-addTOC([$fontStyle], [$tocStyle], [$minDepth], [$maxDepth]);对应元素构造函数的实际签名为Element/TOC.phppublic function __construct($fontStyle null, ?array $tocStyle null, $minDepth 1, $maxDepth 9)四个参数的作用如下参数类型默认值说明$fontStyle数组 / 样式名string/ nullnull目录条目的字体样式见 字体样式文档$tocStyle数组 / nullnull目录排版样式可选键tabLeader、tabPos、indent见下文$minDepthint1参与目录的标题最小层级小于该层级的标题被过滤$maxDepthint9参与目录的标题最大层级大于该层级的标题被过滤2.1$fontStyle目录条目的字体样式$fontStyle可以是关联样式名string例如TOCFont指向通过PhpWord::addFontStyle()注册的命名样式样式数组array直接内联定义如[size 12, bold true]。从构造函数源码可见当传入数组时PHPWord 会将其转为Font样式对象setStyleByArray传入字符串时则原样保存为命名样式引用Element/TOC.php。在 Word2007 写入器中字符串样式会被写入w:rStyle引用而数组样式则通过FontStyleWriter逐项写为内联属性Writer/Word2007/Element/TOC.php。2.2$minDepth/$maxDepth标题层级过滤这两个参数控制哪些层级的标题出现在目录中$minDepth默认 1即从一级标题开始收录$maxDepth默认 9即最多收录到九级标题。需要注意一个特殊行为在 getTitles() 的过滤逻辑中当$maxDepth为 0 时上限过滤会被跳过($this-maxDepth ! 0) ...此时目录将收录所有层级标题。元素类还提供了setMinDepth()/setMaxDepth()与对应的 getter可在创建后动态调整。官方示例 Sample_17_TitleTOC.php 就演示了这种动态调整$toc2 $section-addTOC($fontStyle10); $toc2-setMinDepth(2); // 只收录二级及以上标题 $toc2-setMaxDepth(3); // 且不超过三级三、$tocStyle目录样式tabLeader / tabPos / indent$tocStyle接受一个关联数组支持以下三个键键单位默认值说明tabLeader—dot标题文本与页码之间的填充符类型必须使用\PhpOffice\PhpWord\Style\TOC中定义的常量tabPostwip9062页码出现的制表位位置twip1 磅 20 twipindenttwip200各级标题的缩进系数twip示例$section-addTOC( [size 11], [tabLeader \PhpOffice\PhpWord\Style\TOC::TAB_LEADER_DOT, tabPos 9000, indent 240], 1, 3 );3.1 源码级解读默认值与底层实现目录样式类 Style/TOC.php 继承自 Style/Tab.php其构造函数给出了三个属性的默认值parent::__construct(self::TAB_STOP_RIGHT, 9062, self::TAB_LEADER_DOT);即默认制表位类型为右对齐right默认位置9062 twip约 4.5 英寸默认引导符为点线dot——这正是 Word 文档目录最常见的标题……页码视觉效果。可选的tabLeader常量全部定义在 Style/Tab.phpTAB_LEADER_NONE无填充TAB_LEADER_DOT点线默认TAB_LEADER_HYPHEN连字符TAB_LEADER_UNDERSCORE下划线TAB_LEADER_HEAVY粗线TAB_LEADER_MIDDLEDOT中点这些值经由setEnumVal校验非法值会被回退为默认值Style/Tab.php。indent的语义比较特别它不是每级标题的固定缩进量而是缩进系数。Word2007 写入器在输出时按如下公式计算实际缩进Writer/Word2007/Element/TOC.php$indent (int) (($title-getDepth() - 1) * $tocStyle-getIndent());即一级标题缩进 0二级标题缩进 1 × indent三级标题缩进 2 × indent以此类推形成逐级递进的层级感。3.2 Word2007 中的输出细节当写入 .docx 时Word2007 写入器会把目录实现为 Word 原生域field在目录第一行写入字段指令TOC \o {minDepth}-{maxDepth} \h \z \u见 writeFieldMark其中\h表示生成超链接、\z隐藏制表符页码格式、\u使用大纲级别每个目录条目通过w:hyperlink锚定到对应标题w:anchor_Toc{rId}页码部分写入PAGEREF {rId} \h字段指令若标题带有已知页码还会写入fldChar separate与静态页码文本writeTitle。因此生成的 .docx 打开后目录会显示为可点击、可更新的域。这正是官方示例末尾注释Note: Please refresh TOC manually.的原因Word 打开文档后需要手动刷新一次域F9 / 右键更新域目录才会填入实际页码。同时示例开头还调用了$phpWord-getSettings()-setUpdateFields(true)指示 Word 打开文档时自动更新域。四、ODText 支持原生可刷新的目录除了 Word2007PHPWord 的 ODText 写入器也对目录提供专门支持。与 DOCX 使用域指令不同ODText 写入器Writer/ODText/Element/TOC.php将目录序列化为 ODF 原生元素text:table-of-content元素上带有text:style-name当$fontStyle传入命名样式字符串时与text:nameTable of Contents配置的最小/最大标题层级被映射为 ODF 的outline-level 源设置text:outline-level等于$maxDepth和entry-template 条目模板为$minDepth到$maxDepth之间的每一级生成一个text:table-of-content-entry-template内含文本、制表位、页码三个索引条目同时设置text:use-outline-leveltrue、text:use-index-marksfalse、text:use-index-source-stylesfalse表明目录内容源自大纲层级而非手工索引标记。ODF 目录的核心特点是消费端应用负责生成条目与页码当文档在 LibreOffice 等办公软件中被刷新时应用会自动生成目录条目与对应页码PHPWord 不会复制 DOCX 的 TOC 域指令也不会写入一份静态的标题列表。这一点在测试 tests/PhpWordTests/Writer/ODText/Element/TOCTest.php 中有对应验证例如传入命名字体样式TOCFont与[indent 300], 2, 4组合参数的场景。五、完整可运行示例综合以上内容一个完整的目录生成流程如下参考官方示例 Sample_17_TitleTOC.php?php require_once vendor/autoload.php; use PhpOffice\PhpWord\PhpWord; $phpWord new PhpWord(); $phpWord-getSettings()-setUpdateFields(true); // 打开文档时自动更新域页码 // 定义各级标题样式 $phpWord-addTitleStyle(1, [size 20, color 333333, bold true]); $phpWord-addTitleStyle(2, [size 16, color 666666]); $section $phpWord-addSection(); // 页面标题depth0不出现在目录中 $section-addTitle(Contents, 0); $section-addTextBreak(2); // 插入目录默认收录 1~9 级标题 $section-addTOC([size 12, spaceAfter 60]); // 文档正文标题会被目录收录 $section-addPageBreak(); $section-addTitle(Chapter 1, 1); $section-addTitle(Chapter 1.1, 2); $section-addTitle(Chapter 2, 1); $writer new \PhpOffice\PhpWord\Writer\Word2007($phpWord); $writer-save(document-with-toc.docx);六、常见疑问与注意事项生成的目录没有页码这是域未刷新的表现。在 Word 中按 F9或右键更新域刷新目录ODT 文件在 LibreOffice 中打开时同样需要允许应用刷新索引。目录是空的检查文档中是否确实添加了addTitle()且层级落在$minDepth~$maxDepth范围内。TOC 元素只能从全局标题集合中取数Element/TOC.php没有任何标题时getTitles()返回空数组。$tocStyle的键写错会不会报错不会但非法值会被回退为默认值setStyleByArray仅设置合法属性因此建议严格使用tabLeader/tabPos/indent三个键。tabLeader需要导入什么使用\PhpOffice\PhpWord\Style\TOC::TAB_LEADER_*系列常量继承自Style\Tab避免硬编码字符串拼写错误。相关文档导航字体样式完整参数见 docs/usage/styles/font.md标题元素用法见 docs/usage/elements/title.md段落与分节管理见 docs/usage/containers.md。赞分享后端【免费下载链接】PHPWordA pure PHP library for reading and writing word processing documents项目地址https://gitcode.com/gh_mirrors/ph/PHPWord点击查看免费下载相关推荐PHPWord自动目录生成终极指南5个高效TOC创建技巧PHPWord自动目录生成终极指南5个高效TOC创建技巧 PHPWord是一个纯PHP库专门用于读写Word文档处理。作为PHPWord的核心功能之一自动后端PHPWord实用技巧文档生成与样式控制指南PHPWord实用技巧文档生成与样式控制指南 PHPWord作为一款强大的PHP文档处理库能够帮助开发者轻松生成和操作Word文档。本文将介绍几个实用技巧后端PDF目录自动生成wkhtmltopdf TOC样式定制与深度控制PDF目录自动生成wkhtmltopdf TOC样式定制与深度控制 你是否还在为PDF文档手动创建目录而烦恼是否因目录样式与文档整体风格不符而反复调整本文CLI上一篇数据恢复终极指南3分钟学会TestDisk与PhotoRec免费修复技术下一篇快速掌握FF14国际服中文汉化FFXIVChnTextPatch完整使用教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 PHPWord 目录（TOC）生成实战指南：addTOC 方法、样式参数与 ODText 原生支持
后端【免费下载链接】PHPWordA pure PHP library for reading and writing word processing documents项目地址https://gitcode.com/gh_mirrors/ph/PHPWord点击查看免费下载导读本文聚焦 PHPWord 中目录Table of ContentsTOC的生成与样式控制。你将学会通过addTOC方法在一节Section中插入目录理解$fontStyle、$tocStyle、$minDepth、$maxDepth四个参数的完整含义与默认值掌握tabLeader、tabPos、indent三个目录样式的取值细节并了解 Word2007 与 ODText 两种输出格式在目录实现上的本质差异。读完本文你能够在自己用 PHPWord 生成的长文档中一键产出带页码、带超链接的专业目录。一、先决条件目录的前提是标题TitleTOC 元素本身不会凭空生成条目。文档明确指出只有当文档中至少添加了一个标题Title时目录才能生成。在 PHPWord 中标题通过addTitle方法添加到 Section 中其第二个参数表示标题层级depth例如$section-addTitle(Foo n Bar, 1); // 一级标题 $section-addTitle(I am a Subtitle, 2); // 二级标题从源码看每个标题都会被收集到全局的标题集合中。元素类 Title.php 保存了$depth层级默认 1与可选的$pageNumber页码并通过collectionRelation true表明自身参与集合关联集合本身定义在 Collection/Titles.php是对Title元素的包装。当TOC::getTitles()被调用时它会从PhpWord::getTitles()中取出全部标题再按minDepth/maxDepth过滤见 Element/TOC.php。关于标题样式的完整用法可参考文档 docs/usage/elements/title.md。二、核心用法addTOC方法签名与参数详解在 Section 上直接调用addTOC即可插入目录。该方法的完整签名定义在容器基类 AbstractContainer.php 的method注解中$section-addTOC([$fontStyle], [$tocStyle], [$minDepth], [$maxDepth]);对应元素构造函数的实际签名为Element/TOC.phppublic function __construct($fontStyle null, ?array $tocStyle null, $minDepth 1, $maxDepth 9)四个参数的作用如下参数类型默认值说明$fontStyle数组 / 样式名string/ nullnull目录条目的字体样式见 字体样式文档$tocStyle数组 / nullnull目录排版样式可选键tabLeader、tabPos、indent见下文$minDepthint1参与目录的标题最小层级小于该层级的标题被过滤$maxDepthint9参与目录的标题最大层级大于该层级的标题被过滤2.1$fontStyle目录条目的字体样式$fontStyle可以是关联样式名string例如TOCFont指向通过PhpWord::addFontStyle()注册的命名样式样式数组array直接内联定义如[size 12, bold true]。从构造函数源码可见当传入数组时PHPWord 会将其转为Font样式对象setStyleByArray传入字符串时则原样保存为命名样式引用Element/TOC.php。在 Word2007 写入器中字符串样式会被写入w:rStyle引用而数组样式则通过FontStyleWriter逐项写为内联属性Writer/Word2007/Element/TOC.php。2.2$minDepth/$maxDepth标题层级过滤这两个参数控制哪些层级的标题出现在目录中$minDepth默认 1即从一级标题开始收录$maxDepth默认 9即最多收录到九级标题。需要注意一个特殊行为在 getTitles() 的过滤逻辑中当$maxDepth为 0 时上限过滤会被跳过($this-maxDepth ! 0) ...此时目录将收录所有层级标题。元素类还提供了setMinDepth()/setMaxDepth()与对应的 getter可在创建后动态调整。官方示例 Sample_17_TitleTOC.php 就演示了这种动态调整$toc2 $section-addTOC($fontStyle10); $toc2-setMinDepth(2); // 只收录二级及以上标题 $toc2-setMaxDepth(3); // 且不超过三级三、$tocStyle目录样式tabLeader / tabPos / indent$tocStyle接受一个关联数组支持以下三个键键单位默认值说明tabLeader—dot标题文本与页码之间的填充符类型必须使用\PhpOffice\PhpWord\Style\TOC中定义的常量tabPostwip9062页码出现的制表位位置twip1 磅 20 twipindenttwip200各级标题的缩进系数twip示例$section-addTOC( [size 11], [tabLeader \PhpOffice\PhpWord\Style\TOC::TAB_LEADER_DOT, tabPos 9000, indent 240], 1, 3 );3.1 源码级解读默认值与底层实现目录样式类 Style/TOC.php 继承自 Style/Tab.php其构造函数给出了三个属性的默认值parent::__construct(self::TAB_STOP_RIGHT, 9062, self::TAB_LEADER_DOT);即默认制表位类型为右对齐right默认位置9062 twip约 4.5 英寸默认引导符为点线dot——这正是 Word 文档目录最常见的标题……页码视觉效果。可选的tabLeader常量全部定义在 Style/Tab.phpTAB_LEADER_NONE无填充TAB_LEADER_DOT点线默认TAB_LEADER_HYPHEN连字符TAB_LEADER_UNDERSCORE下划线TAB_LEADER_HEAVY粗线TAB_LEADER_MIDDLEDOT中点这些值经由setEnumVal校验非法值会被回退为默认值Style/Tab.php。indent的语义比较特别它不是每级标题的固定缩进量而是缩进系数。Word2007 写入器在输出时按如下公式计算实际缩进Writer/Word2007/Element/TOC.php$indent (int) (($title-getDepth() - 1) * $tocStyle-getIndent());即一级标题缩进 0二级标题缩进 1 × indent三级标题缩进 2 × indent以此类推形成逐级递进的层级感。3.2 Word2007 中的输出细节当写入 .docx 时Word2007 写入器会把目录实现为 Word 原生域field在目录第一行写入字段指令TOC \o {minDepth}-{maxDepth} \h \z \u见 writeFieldMark其中\h表示生成超链接、\z隐藏制表符页码格式、\u使用大纲级别每个目录条目通过w:hyperlink锚定到对应标题w:anchor_Toc{rId}页码部分写入PAGEREF {rId} \h字段指令若标题带有已知页码还会写入fldChar separate与静态页码文本writeTitle。因此生成的 .docx 打开后目录会显示为可点击、可更新的域。这正是官方示例末尾注释Note: Please refresh TOC manually.的原因Word 打开文档后需要手动刷新一次域F9 / 右键更新域目录才会填入实际页码。同时示例开头还调用了$phpWord-getSettings()-setUpdateFields(true)指示 Word 打开文档时自动更新域。四、ODText 支持原生可刷新的目录除了 Word2007PHPWord 的 ODText 写入器也对目录提供专门支持。与 DOCX 使用域指令不同ODText 写入器Writer/ODText/Element/TOC.php将目录序列化为 ODF 原生元素text:table-of-content元素上带有text:style-name当$fontStyle传入命名样式字符串时与text:nameTable of Contents配置的最小/最大标题层级被映射为 ODF 的outline-level 源设置text:outline-level等于$maxDepth和entry-template 条目模板为$minDepth到$maxDepth之间的每一级生成一个text:table-of-content-entry-template内含文本、制表位、页码三个索引条目同时设置text:use-outline-leveltrue、text:use-index-marksfalse、text:use-index-source-stylesfalse表明目录内容源自大纲层级而非手工索引标记。ODF 目录的核心特点是消费端应用负责生成条目与页码当文档在 LibreOffice 等办公软件中被刷新时应用会自动生成目录条目与对应页码PHPWord 不会复制 DOCX 的 TOC 域指令也不会写入一份静态的标题列表。这一点在测试 tests/PhpWordTests/Writer/ODText/Element/TOCTest.php 中有对应验证例如传入命名字体样式TOCFont与[indent 300], 2, 4组合参数的场景。五、完整可运行示例综合以上内容一个完整的目录生成流程如下参考官方示例 Sample_17_TitleTOC.php?php require_once vendor/autoload.php; use PhpOffice\PhpWord\PhpWord; $phpWord new PhpWord(); $phpWord-getSettings()-setUpdateFields(true); // 打开文档时自动更新域页码 // 定义各级标题样式 $phpWord-addTitleStyle(1, [size 20, color 333333, bold true]); $phpWord-addTitleStyle(2, [size 16, color 666666]); $section $phpWord-addSection(); // 页面标题depth0不出现在目录中 $section-addTitle(Contents, 0); $section-addTextBreak(2); // 插入目录默认收录 1~9 级标题 $section-addTOC([size 12, spaceAfter 60]); // 文档正文标题会被目录收录 $section-addPageBreak(); $section-addTitle(Chapter 1, 1); $section-addTitle(Chapter 1.1, 2); $section-addTitle(Chapter 2, 1); $writer new \PhpOffice\PhpWord\Writer\Word2007($phpWord); $writer-save(document-with-toc.docx);六、常见疑问与注意事项生成的目录没有页码这是域未刷新的表现。在 Word 中按 F9或右键更新域刷新目录ODT 文件在 LibreOffice 中打开时同样需要允许应用刷新索引。目录是空的检查文档中是否确实添加了addTitle()且层级落在$minDepth~$maxDepth范围内。TOC 元素只能从全局标题集合中取数Element/TOC.php没有任何标题时getTitles()返回空数组。$tocStyle的键写错会不会报错不会但非法值会被回退为默认值setStyleByArray仅设置合法属性因此建议严格使用tabLeader/tabPos/indent三个键。tabLeader需要导入什么使用\PhpOffice\PhpWord\Style\TOC::TAB_LEADER_*系列常量继承自Style\Tab避免硬编码字符串拼写错误。相关文档导航字体样式完整参数见 docs/usage/styles/font.md标题元素用法见 docs/usage/elements/title.md段落与分节管理见 docs/usage/containers.md。赞分享后端【免费下载链接】PHPWordA pure PHP library for reading and writing word processing documents项目地址https://gitcode.com/gh_mirrors/ph/PHPWord点击查看免费下载相关推荐PHPWord自动目录生成终极指南5个高效TOC创建技巧PHPWord自动目录生成终极指南5个高效TOC创建技巧 PHPWord是一个纯PHP库专门用于读写Word文档处理。作为PHPWord的核心功能之一自动后端PHPWord实用技巧文档生成与样式控制指南PHPWord实用技巧文档生成与样式控制指南 PHPWord作为一款强大的PHP文档处理库能够帮助开发者轻松生成和操作Word文档。本文将介绍几个实用技巧后端PDF目录自动生成wkhtmltopdf TOC样式定制与深度控制PDF目录自动生成wkhtmltopdf TOC样式定制与深度控制 你是否还在为PDF文档手动创建目录而烦恼是否因目录样式与文档整体风格不符而反复调整本文CLI上一篇数据恢复终极指南3分钟学会TestDisk与PhotoRec免费修复技术下一篇快速掌握FF14国际服中文汉化FFXIVChnTextPatch完整使用教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考