poi-tl list标签
时间: 2025-06-23 08:51:12 浏览: 6
### 关于 poi-tl 中 List 标签的使用方法
在 poi-tl 中,`List` 标签用于生成列表内容。与表格和图片标签类似,`List` 标签可以通过 `Documents.of()` 方法创建文档元素,并结合自定义内容进行渲染。以下是对 `List` 标签的详细说明和示例代码。
#### 1. 创建 List 元素
通过 `Lists.of()` 方法可以创建一个列表构建器,该构建器支持添加多个列表项。每个列表项可以通过 `Rows.of()` 方法定义[^2]。
```java
// 创建 List 构建器
Lists.ListBuilder listBuilder = Lists.of().border(BorderStyle.DEFAULT);
// 添加列表项
listBuilder.addListItem(Rows.of("第一项").create());
listBuilder.addListItem(Rows.of("第二项").create());
listBuilder.addListItem(Rows.of("第三项").create());
// 将列表添加到文档中
Documents.DocumentBuilder document = Documents.of();
document.addList(listBuilder.create());
```
#### 2. 替换模板中的 List 标签
在模板文件中,需要预先定义一个占位符(例如 `${listName}`)。然后通过 `map.put("listName", document.create())` 将生成的列表内容插入到模板中。
```java
Map<String, Object> map = new HashMap<>();
map.put("listName", document.create());
```
#### 3. 示例代码
以下是一个完整的示例,展示如何在 poi-tl 中使用 `List` 标签生成列表内容并替换模板中的占位符。
```java
// 创建 List 构建器
Lists.ListBuilder listBuilder = Lists.of().border(BorderStyle.DEFAULT);
// 添加列表项
listBuilder.addListItem(Rows.of("Java").create());
listBuilder.addListItem(Rows.of("Python").create());
listBuilder.addListItem(Rows.of("C++").create());
// 创建 Document 构建器
Documents.DocumentBuilder document = Documents.of();
document.addList(listBuilder.create());
// 将生成的列表内容放入 Map 中
Map<String, Object> map = new HashMap<>();
map.put("programmingLanguages", document.create());
```
在模板文件中,定义如下占位符:
```
${programmingLanguages}
```
运行上述代码后,模板中的 `${programmingLanguages}` 将被替换为生成的列表内容。
#### 4. 自定义样式
通过 `Rows.of()` 方法,可以为每个列表项设置文本颜色、对齐方式等样式。
```java
listBuilder.addListItem(Rows.of("第一项").textColor("FF0000").center().create());
listBuilder.addListItem(Rows.of("第二项").textColor("00FF00").left().create());
listBuilder.addListItem(Rows.of("第三项").textColor("0000FF").right().create());
```
---
###
阅读全文
相关推荐


















