xltpl

使用 xls/x 文件作为模板来生成 xls/x 文件。 English

实现方法

xls/x 文件的每个工作表会被转换为一棵树。 树会被转换为带有自定义 tag 的 jinja2 模板。 渲染模板时，自定义 tag 所对应的 jinja2 扩展调用相应的树节点来写入 xls/x 文件。

安装

pip install xltpl

使用

• 要使用 xltpl，需要了解 jinja2 模板的语法 。

• 选择一个 xls/x 文件作为模板。

• 在单元格中插入变量：

{{name}}

• 在单元格的批注中插入控制语句（使用 beforerow、beforecell 和 aftercell 指定其位置）：

beforerow{% for item in items %}

beforerow{% endfor %}

• 或在单元格中插入控制语句(v0.9)：

{%- for row in rows %}
{% set outer_loop = loop %}{% for row in rows %}
Cell
{{outer_loop.index}}{{loop.index}}
{%+ endfor%}{%+ endfor%}

• 运行代码

from xltpl.writerx import BookWriter
writer = BookWriter('tpl.xlsx')
person_info = {'name': u'Hello Wizard'}
items = ['1', '1', '1', '1', '1', '1', '1', '1', ]
person_info['items'] = items
payloads = [person_info]
writer.render_book(payloads)
writer.save('result.xlsx')

支持的特性

• 合并单元格 (MergedCell)

• 单元格非字符串值 (使用 {% xv variable %} 来表示变量)

• 对于 xlsx

图片 (使用 {% img variable %}) 数据有效性(DataValidation) 筛选 (AutoFilter)

相关

• pydocxtpl

使用 docx 文件作为模板来生成 docx 文件。 其实现方法与 xltpl 类似。

• django-excel-export

利用 xltpl 和 pydocxtpl 在 Django admin 后台以xls/x 和 docx 格式导出数据。 演示项目 在线演示 (用户名: admin 密码: admin)

• nodejs 版本的 xltpl

CodeSandbox examples: browser node

• xltpl for java

说明

xlrd

xlrd 不会读入打印设置。 如果需要一致的打印设置，可以使用这里的 xlrd 。

xlwt

xlwt 总是将默认字体设置为 'Arial'。 Excel 基于默认字体来设置单元格宽度。 如果需要一致的单元格宽度，可以使用这里的 xlwt 。