XSL-FO的list-block如何定义列表样式？

xsl-fo中定义列表样式的核心是fo:list-block容器及其内部的fo:list-item、fo:list-item-label和fo:list-item-body四个元素；2. 自定义编号或符号需在fo:list-item-label的fo:block中设置content、文本或fo:external-graphic图片，并可结合计数器实现自动编号；3. 列表项间距通过fo:list-item的space-after或space-before控制，对齐依赖fo:list-block的provisional-distance-between-starts和provisional-label-separation属性配合label与body的provisional缩进；4. 多级嵌套列表通过在fo:list-item-body中嵌套fo:list-block实现，每级独立设置start-indent控制缩进，并用counter-reset和counter()函数管理多级编号，确保层级清晰对齐。

XSL-FO中定义列表样式，核心在于fo:list-block这个容器元素，它内部由一系列fo:list-item组成，而每个list-item又进一步细分为fo:list-item-label（用于显示列表标记，比如编号或符号）和fo:list-item-body（承载列表项的实际内容）。通过对这些元素的属性进行精细控制，就能实现各种复杂的列表样式。

解决方案

用XSL-FO处理列表，一开始确实有点绕，不像HTML那么直观。但一旦掌握了list-block、list-item、list-item-label和list-item-body这四个核心元素，以及它们之间的一些关键属性，你就会发现它的强大之处。

fo:list-block是整个列表的外部容器，它决定了列表作为一个整体的边距、对齐等。
每个fo:list-item代表列表中的一个单独条目。
fo:list-item-label承载着列表项前面的标记，可以是数字、符号、图片，甚至是复杂的文本。它的宽度和内容直接影响列表的视觉布局。
fo:list-item-body则是列表项的主体内容，所有文本、图片、甚至嵌套的块级元素都放在这里。

定义列表样式时，你会频繁用到以下属性：

• start-indent / end-indent: 控制整个list-block的左右缩进，或者list-item-body相对于list-item-label的起始位置。
• provisional-distance-between-starts: 这个属性有点意思，它定义了list-item-label的起始边界和list-item-body的起始边界之间的距离。对于对齐编号和文本非常有用。
• provisional-label-separation: 定义list-item-label的结束边界和list-item-body的起始边界之间的距离。
• space-before / space-after: 控制列表项之间或列表块与其他内容之间的垂直间距。
• text-align: 在list-item-body上控制文本对齐。
• content: 这是list-item-label的关键属性，用于生成标记。它可以是字符串、图片URL，或者更常见的，一个计数器表达式。

一个基本的例子可能会是这样：

<fo:list-block start-indent="1in" provisional-distance-between-starts="0.25in" provisional-label-separation="0.1in">
<fo:list-item space-after="0.1em">
<fo:list-item-label end-indent="provisional">
<fo:block>•</fo:block>
</fo:list-item-label>
<fo:list-item-body start-indent="provisional">
<fo:block>这是列表项一的内容。</fo:block>
</fo:list-item-body>
</fo:list-item>
<fo:list-item space-after="0.1em">
<fo:list-item-label end-indent="provisional">
<fo:block>•</fo:block>
</fo:list-item-label>
<fo:list-item-body start-indent="provisional">
<fo:block>这是列表项二，内容可以很长，会自动换行。</fo:block>
</fo:list-item-body>
</fo:list-item>
</fo:list-block>

如何在XSL-FO列表中实现自定义编号或符号？

自定义列表标记是XSL-FO列表样式中最常见也最灵活的需求之一。我个人觉得，这块的强大之处在于它不仅仅是简单的“点”或“数字”，你可以玩出很多花样。

关键在于fo:list-item-label元素内部的fo:block，以及这个block的content属性或者直接的文本内容。

1. 自定义文本或Unicode符号：
   最直接的方式就是在fo:list-item-label内部的fo:block中直接写入你想要的文本或Unicode符号。

   <fo:list-item-label end-indent="provisional">
   <fo:block font-family="ZapfDingbats" font-size="12pt">✔</fo:block> <!-- 使用Unicode勾号 -->
   </fo:list-item-label>

   或者

   <fo:list-item-label end-indent="provisional">
   <fo:block>→ </fo:block> <!-- 使用箭头符号 -->
   </fo:list-item-label>

2. 使用图片作为标记：
   如果你想用图片作为列表项的标记，可以在fo:list-item-label内部放置一个fo:external-graphic元素。

   <fo:list-item-label end-indent="provisional">
   <fo:block>
   <fo:external-graphic src="https://www.php.cn/faq/url('path/to/your/bullet.png')" width="0.15in" height="0.15in"/>
   </fo:block>
   </fo:list-item-label>

   这里要注意图片的尺寸，可能需要调整width和height属性来确保它看起来合适。

3. 自动编号：
   这是最常用的功能之一，XSL-FO通过counter函数和相关的计数器属性来实现。这需要一点点设置。

   你需要在XSL-FO文档的fo:declarations部分定义一个计数器，然后通过counter-reset来重置它，并通过counter(your-counter-name)来引用并自动递增。

   <fo:declarations>
   <fo:initial-property-set>
   <fo:counter-reset counter-name="my-list-counter"/>
   </fo:initial-property-set>
   </fo:declarations>
   <!-- 在你的list-block中 -->
   <fo:list-item>
   <fo:list-item-label end-indent="provisional">
   <fo:block><xsl:value-of select="format-number(counter(my-list-counter), '0.')"/></fo:block>
   </fo:list-item-label>
   <fo:list-item-body start-indent="provisional">
   <fo:block>这是编号列表项。</fo:block>
   </fo:list-item-body>
   </fo:list-item>

   format-number是XSLT的函数，这里用来格式化计数器的输出，比如加上小数点。counter-increment属性通常隐式地在每次fo:list-item被处理时发生，但你也可以显式地控制它。

这几种方式，结合fo:block的字体、颜色、大小等属性，几乎可以满足所有自定义标记的需求。

XSL-FO列表项之间的间距和对齐方式如何控制？

列表项的间距和对齐，是决定列表美观度的关键。我发现很多人在XSL-FO里做列表，最头疼的往往就是对不齐或者间距不对，尤其是那个“项目符号”和“文本内容”之间的关系。

1. 列表项之间的垂直间距：
   最直接的方式是在fo:list-item元素上使用space-before或space-after属性。

   <fo:list-item space-after="0.1in"> <!-- 每个列表项后留出0.1英寸的空白 -->
   <fo:list-item-label>...</fo:list-item-label>
   <fo:list-item-body>...</fo:list-item-body>
   </fo:list-item>

   你也可以在fo:list-block上设置space-before或space-after来控制整个列表块与其前后内容的间距。

2. 整个列表的缩进：
   在fo:list-block上使用start-indent和end-indent来控制整个列表相对于页面边缘的左右缩进。

   <fo:list-block start-indent="1in" end-indent="0.5in">
   <!-- 列表内容 -->
   </fo:list-block>

3. 标记和内容之间的对齐与间距：
   这是XSL-FO列表最独特也最需要理解的地方。provisional-distance-between-starts和provisional-label-separation是这里的核心。

   • provisional-distance-between-starts (在fo:list-block上设置):
     定义了list-item-label的起始位置和list-item-body的起始位置之间的距离。这对于确保所有列表项的文本内容都从同一起点开始非常有用，无论标记的宽度如何。

   • provisional-label-separation (在fo:list-block上设置):
     定义了list-item-label的结束位置和list-item-body的起始位置之间的距离。这个属性控制了标记和文本之间的空白。

   • end-indent=”provisional” (在fo:list-item-label上设置):
     告诉处理器，list-item-label的结束位置应该由provisional-distance-between-starts和provisional-label-separation来推导。

   • start-indent=”provisional” (在fo:list-item-body上设置):
     告诉处理器，list-item-body的起始位置应该由provisional-distance-between-starts和provisional-label-separation来推导。

   一个典型的设置：

   <fo:list-block provisional-distance-between-starts="0.5in" provisional-label-separation="0.1in">
   <fo:list-item>
   <fo:list-item-label end-indent="provisional">
   <fo:block>1.</fo:block>
   </fo:list-item-label>
   <fo:list-item-body start-indent="provisional">
   <fo:block>这是第一项，内容很长，需要自动换行以展示对齐效果。</fo:block>
   </fo:list-item-body>
   </fo:list-item>
   <fo:list-item>
   <fo:list-item-label end-indent="provisional">
   <fo:block>10.</fo:block> <!-- 标记更宽了 -->
   </fo:list-item-label>
   <fo:list-item-body start-indent="provisional">
   <fo:block>这是第十项，你会发现尽管标记变宽了，但文本内容依然从同一列开始。</fo:block>
   </fo:list-item-body>
   </fo:list-item>
   </fo:list-block>

   通过这种“provisional”机制，XSL-FO能够实现非常精确的列表对齐，即便标记的宽度不一，文本内容也能保持整齐的左对齐。调试的时候，往往需要耐心调整provisional-distance-between-starts和provisional-label-separation的值来达到最佳视觉效果。

在XSL-FO中创建多级嵌套列表的策略是什么？

多级嵌套列表在XSL-FO里实现起来，逻辑上其实非常直接，就是把一个fo:list-block放到另一个fo:list-item-body里面。这和HTML里

• …

的思路是完全一致的。

主要的挑战在于如何管理每一级的缩进和编号。

1. 结构上的嵌套：
   你只需将子列表（一个完整的fo:list-block）作为父列表项的fo:list-item-body的子元素。

   <fo:list-block start-indent="1in"> <!-- 第一级列表 -->
   <fo:list-item>
   <fo:list-item-label end-indent="provisional">
   <fo:block>1.</fo:block>
   </fo:list-item-label>
   <fo:list-item-body start-indent="provisional">
   <fo:block>一级列表项一</fo:block>
   <fo:list-block start-indent="0.2in"> <!-- 第二级列表，相对于父列表项的body再缩进 -->
   <fo:list-item>
   <fo:list-item-label end-indent="provisional">
   <fo:block>a)</fo:block>
   </fo:list-item-label>
   <fo:list-item-body start-indent="provisional">
   <fo:block>二级列表项一</fo:block>
   </fo:list-item-body>
   </fo:list-item>
   <fo:list-item>
   <fo:list-item-label end-indent="provisional">
   <fo:block>b)</fo:block>
   </fo:list-item-label>
   <fo:list-item-body start-indent="provisional">
   <fo:block>二级列表项二</fo:block>
   </fo:list-item-body>
   </fo:list-item>
   </fo:list-block>
   </fo:list-item-body>
   </fo:list-item>
   <fo:list-item>
   <fo:list-item-label end-indent="provisional">
   <fo:block>2.</fo:block>
   </fo:list-item-label>
   <fo:list-item-body start-indent="provisional">
   <fo:block>一级列表项二</fo:block>
   </fo:list-item-body>
   </fo:list-item>
   </fo:list-block>

2. 缩进的控制：
   每一级的fo:list-block都需要独立设置其start-indent。这个start-indent是相对于其父容器（通常是fo:list-item-body）的。所以，如果你想让二级列表相对于一级列表的文本内容再向右缩进一点，就在二级fo:list-block上设置一个正的start-indent值。

3. 多级编号的管理：
   这是最需要技巧的部分。你需要为每一级列表定义一个独立的计数器，并在适当的时候重置和递增它们。counter()函数可以接收多个计数器名称，用点号连接，来生成多级编号，比如1.1, 1.2, 2.1等。

   <fo:declarations>
   <fo:initial-property-set>
   <fo:counter-reset counter-name="level1-counter"/>
   <fo:counter-reset counter-name="level2-counter"/>
   </fo:initial-property-set>
   </fo:declarations>
   <fo:list-block provisional-distance-between-starts="0.5in" provisional-label-separation="0.1in">
   <fo:list-item>
   <fo:list-item-label end-indent="provisional">
   <fo:block><xsl:value-of select="format-number(counter(level1-counter), '0.')"/></fo:block>
   </fo:list-item-label>
   <fo:list-item-body start-indent="provisional">
   <fo:block>一级列表项内容</fo:block>
   <fo:list-block start-indent="0.2in" provisional-distance-between-starts="0.3in" provisional-label-separation="0.05in">
   <fo:list-item>
   <fo:list-item-label end-indent="provisional">
   <fo:block><xsl:value-of select="format-number(counter(level1-counter, level2-counter), '0.0')"/></fo:block>
   </fo:list-item-label>
   <fo:list-item-body start-indent="provisional">
   <fo:block>二级列表项内容</fo:block>
   </fo:list-item-body>
   </fo:list-item>
   <fo:list-item>
   <fo:list-item-label end-indent="provisional">
   <fo:block><xsl:value-of select="format-number(counter(level1-counter, level2-counter), '0.0')"/></fo:block>
   </fo:list-item-label>
   <fo:list-item-body start-indent="provisional">
   <fo:block>二级列表项内容</fo:block>
   </fo:list-item-body>
   </fo:list-item>
   </fo:list-block>
   </fo:list-item-body>
   </fo:list-item>
   <fo:list-item>
   <fo:list-item-label end-indent="provisional">
   <fo:block><xsl:value-of select="format-number(counter(level1-counter), '0.')"/></fo:block>
   </fo:list-item-label>
   <fo:list-item-body start-indent="provisional">
   <fo:block>另一项一级列表内容</fo:block>
   </fo:list-item-body>
   </fo:list-item>
   </fo:list-block>

   在fo:list-item-label中使用counter(level1-counter, level2-counter)时，level2-counter会在每次新的level1-counter开始时自动重置。这是一种非常方便的机制。

嵌套列表的样式控制，尤其是provisional-distance-between-starts和provisional-label-separation，在每一级上都需要重新考虑和设置，以确保视觉上的协调和清晰。这确实需要一点经验和反复的测试。