XSL-FO的list-block如何定义列表样式？-XML/RSS教程-PHP中文网

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的list-block如何定义列表样式？

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属性或者直接的文本内容。

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

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

登录后复制

或者

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

登录后复制

使用图片作为标记： 如果你想用图片作为列表项的标记，可以在fo:list-item-label内部放置一个fo:external-graphic元素。
```
<fo:list-item-label end-indent="provisional">
    <fo:block>
        <fo:external-graphic src="url('path/to/your/bullet.png')" width="0.15in" height="0.15in"/>
    </fo:block>
</fo:list-item-label>
```
登录后复制
这里要注意图片的尺寸，可能需要调整width和height属性来确保它看起来合适。
自动编号： 这是最常用的功能之一，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>


<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被处理时发生，但你也可以显式地控制它。

Block Survey
BlockSurvey是一个保护隐私和数据安全调查工具，可以让你使用AI来创建调查表单。

28

查看详情

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

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

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

列表项之间的垂直间距： 最直接的方式是在fo:list-item元素上使用space-before或space-after属性。
```
<fo:list-item space-after="0.1in"> 
    <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来控制整个列表块与其前后内容的间距。
整个列表的缩进： 在fo:list-block上使用start-indent和end-indent来控制整个列表相对于页面边缘的左右缩进。
```
<fo:list-block start-indent="1in" end-indent="0.5in">
    
</fo:list-block>
```
登录后复制
标记和内容之间的对齐与间距： 这是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里<ul><li><ul>...</ul></li></ul>的思路是完全一致的。

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

结构上的嵌套： 你只需将子列表（一个完整的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>

登录后复制

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

多级编号的管理： 这是最需要技巧的部分。你需要为每一级列表定义一个独立的计数器，并在适当的时候重置和递增它们。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，在每一级上都需要重新考虑和设置，以确保视觉上的协调和清晰。这确实需要一点经验和反复的测试。

以上就是XSL-FO的list-block如何定义列表样式？的详细内容，更多请关注php中文网其它相关文章！