在 Python 中，我们可以使用dominate库来创建和操作 HTML 文档，从而实现 HTML 报告的生成。以下是一个详细的实战指南，包含安装、基本使用、示例代码和代码解释。

1. 安装dominate库

推荐使用pip来安装dominate库，在命令行中执行以下命令：

bash

pip install dominate

2. 基本使用思路

dominate库提供了一个优雅的 DOM API，允许我们使用纯 Python 代码编写 HTML 页面。主要步骤包括：

• 导入必要的模块和标签。
• 创建一个document对象来表示 HTML 文档。
• 使用各种 HTML 标签（如h1、p、table等）来构建文档内容。
• 将生成的 HTML 文档保存到文件中。

3. 示例代码

以下是一个简单的示例，展示如何使用dominate库生成一个包含标题、段落和表格的 HTML 报告：

python

from dominate import document
from dominate.tags import *

def generate_html_report():
    # 创建一个新的文档对象，并设置标题
    doc = document(title='示例HTML报告')

    # 在文档头部添加样式表链接
    with doc.head:
        link(rel='stylesheet', href='style.css')

    # 在文档主体中添加内容
    with doc:
        # 添加标题
        h1('这是一个示例HTML报告')

        # 添加段落
        p('本报告展示了如何使用Python的dominate库生成HTML报告。')

        # 创建一个表格
        with table(border='1').add(tbody()):
            # 添加表头
            with tr():
                th('序号')
                th('名称')
                th('描述')

            # 添加表格数据
            data = [
                (1, '项目A', '这是项目A的描述'),
                (2, '项目B', '这是项目B的描述'),
                (3, '项目C', '这是项目C的描述')
            ]
            for index, name, description in data:
                with tr():
                    td(index)
                    td(name)
                    td(description)

    # 将生成的HTML文档保存到文件中
    with open('report.html', 'w', encoding='utf-8') as file:
        file.write(str(doc))

if __name__ == "__main__":
    generate_html_report()

4. 代码解释

• 导入模块和标签：

python

from dominate import document
from dominate.tags import *

导入document类用于创建 HTML 文档，导入所有标签（如h1、p、table等）以便在代码中使用。

• 创建文档对象：

python

doc = document(title='示例HTML报告')

创建一个新的document对象，并设置文档的标题为 “示例 HTML 报告”。

• 添加样式表链接：

python

with doc.head:
    link(rel='stylesheet', href='style.css')

使用with语句进入文档头部的上下文，添加一个样式表链接，引用名为style.css的外部样式表。

• 添加标题和段落：

python

h1('这是一个示例HTML报告')
p('本报告展示了如何使用Python的dominate库生成HTML报告。')

使用h1标签添加一个一级标题，使用p标签添加一个段落。

• 创建表格：

python

with table(border='1').add(tbody()):
    # 添加表头
    with tr():
        th('序号')
        th('名称')
        th('描述')

    # 添加表格数据
    data = [
        (1, '项目A', '这是项目A的描述'),
        (2, '项目B', '这是项目B的描述'),
        (3, '项目C', '这是项目C的描述')
    ]
    for index, name, description in data:
        with tr():
            td(index)
            td(name)
            td(description)

使用table标签创建一个表格，并设置边框为 1。使用tbody标签添加表格主体。使用tr标签添加表格行，使用th标签添加表头单元格，使用td标签添加数据单元格。

• 保存 HTML 文档：

python

with open('report.html', 'w', encoding='utf-8') as file:
    file.write(str(doc))

使用open函数打开一个名为report.html的文件，将生成的 HTML 文档写入文件中。

5. 总结

通过使用dominate库，我们可以方便地使用 Python 代码生成 HTML 报告。可以根据需要添加更多的 HTML 标签和样式，以满足不同的报告需求。

GitHub：https://github.com/Knio/dominate

感谢关注【AI码力】，获取更多效率工具！