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，或者更常见的，一个计数器表达式。

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

    
        
            •
        
        
            这是列表项一的内容。
        
    
    
        
            •
        
        
            这是列表项二，内容可以很长，会自动换行。
        
    

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

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

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

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

   
       ✔ 
   

   或者

   
       →  
   

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

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

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

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

   
       
           
       
   
   
   
   
       
           
       
       
           这是编号列表项。
       
   

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

   

   万知

   万知: 你的个人AI工作站

   下载

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

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

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

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

    
       ...
       ...
   

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

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

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来推导。

   一个典型的设置：

   
       
           
               1.
           
           
               这是第一项，内容很长，需要自动换行以展示对齐效果。
           
       
       
           
               10. 
           
           
               这是第十项，你会发现尽管标记变宽了，但文本内容依然从同一列开始。
           
       
   

   通过这种“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的子元素。

    
       
           
               1.
           
           
               一级列表项一
                
                   
                       
                           a)
                       
                       
                           二级列表项一
                       
                   
                   
                       
                           b)
                       
                       
                           二级列表项二
                       
                   
               
           
       
       
           
               2.
           
           
               一级列表项二
           
       
   

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

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