Skip to content

A python module to generate xls/x files from a xls/x template.

License

Notifications You must be signed in to change notification settings

zhangyu836/xltpl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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)

相关

说明

xlrd

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

xlwt

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

Releases

No releases published

Packages

No packages published

Languages