定义和使用Jinja2节点的自定义宏

Jinja2是一个模板引擎，用于生成动态的HTML、XML或其他文档。它具有强大的功能和灵活的语法，支持自定义宏，可以使用自定义宏来重用和组织模板代码。

Jinja2的自定义宏类似于函数或代码片段，可以接受参数并在模板中调用。我们可以使用自定义宏来实现一些常用的功能，例如格式化日期、生成链接等。

要定义一个自定义宏，可以在模板中使用{% macro %}标签，后面跟着宏的名称和参数列表。然后在{% endmacro %}标签之前编写宏的代码。宏的代码可以包含Jinja2的标签和表达式。下面是一个简单的示例：

{% macro format_date(date) %}
    {{ date.strftime("%Y-%m-%d") }}
{% endmacro %}

上面的代码定义了一个名为format_date的自定义宏，它接受一个date参数，并使用strftime函数将日期格式化为YYYY-MM-DD的形式。在模板中可以使用{{ format_date(some_date) }}来调用这个宏。

除了宏的名称和参数列表，我们还可以指定宏的参数默认值和关键字参数。这允许我们在调用宏时省略某些参数，或以任意顺序传递参数。下面是一个带有默认值和关键字参数的示例：

{% macro create_link(text, url, target="_blank", class="link") %}
    <a href="{{ url }}" target="{{ target }}" class="{{ class }}">{{ text }}</a>
{% endmacro %}

上面的示例定义了一个名为create_link的自定义宏，它接受一个必需的text参数和一个可选的url参数。target和class参数具有默认值，如果在调用宏时没有提供这些参数，则会使用默认值。在模板中可以使用{{ create_link("Homepage", "https://www.example.com") }}来调用这个宏。

自定义宏还可以包含条件语句、循环语句和其它标签。可以在宏内部使用{% if %}、{% for %}等标签来实现更复杂的逻辑。下面是一个带有条件语句和循环语句的示例：

{% macro render_list(items) %}
    <ul>
    {% for item in items %}
        {% if item.visible %}
            <li>{{ item.name }}</li>
        {% endif %}
    {% endfor %}
    </ul>
{% endmacro %}

上面的示例定义了一个名为render_list的自定义宏，它接受一个items参数，它是一个包含了visible和name属性的对象列表。在宏内部，使用{% for %}循环遍历items列表，并使用{% if %}条件语句检查每个对象的visible属性。只有visible为True的对象才会被渲染为列表项。在模板中可以使用{{ render_list(some_items) }}来调用这个宏。

下面是一个完整的例子，演示了如何使用自定义宏来生成一个包含链接的导航条：

{% macro render_navigation(items) %}
    <nav>
        <ul>
            {% for item in items %}
                {% if item.visible %}
                    <li>{{ create_link(item.name, item.url) }}</li>
                {% endif %}
            {% endfor %}
        </ul>
    </nav>
{% endmacro %}

{% macro create_link(text, url, target="_blank", class="link") %}
    <a href="{{ url }}" target="{{ target }}" class="{{ class }}">{{ text }}</a>
{% endmacro %}

{% set navigation_items = [
    {'name': 'Home', 'url': 'https://www.example.com', 'visible': True},
    {'name': 'About', 'url': 'https://www.example.com/about', 'visible': True},
    {'name': 'Contact', 'url': 'https://www.example.com/contact', 'visible': False},
] %}

{{ render_navigation(navigation_items) }}

上面的例子首先定义了一个名为render_navigation的自定义宏，用于渲染导航条。然后定义了另一个名为create_link的自定义宏，用于生成链接。最后，使用render_navigation宏来渲染一个包含链接的导航条，传递一个对象列表作为参数。

在使用Jinja2的过程中，自定义宏是非常有用的工具，可以帮助我们提高代码的可重用性和可维护性。可以根据实际需求定义各种各样的自定义宏，根据参数的不同生成不同的输出。