Question

我有一个Django网站，其中有许多页面都有自己独特的内容和标记（而不是动态填充数据的单个模板）。这些页面的模板源自一个通用的“工具”模板，该模板又来自“基础”模板。每个页面还有一个JS文件，用于为该页面编写脚本。每页数据分布在3或4个位置：

模板
页面脚本（可能还有其他特定于页面的静态）
一个中央“工具注册表”，其中包含工具名称，描述和类别
用于某些工具，一组模板标签，用于执行特定于该页面的某些HTML构造（例如，要在表格中显示的数据）。

然而，虽然每个页面都有独特的布局和内容，但我仍然希望能够在页面之间共享常用的参数化HTML“片段”。例如，一个页面的输入带有一个下拉按钮，使用Bootstrap，如下所示：

<div class="input-group">
    <span class="input-group-btn">
        <a class="btn btn-default dropdown-toggle" data-toggle="dropdown" href="#">
            Common baudrates
            <span class="caret"></span>
        </a>
        <ul class="dropdown-menu pull-right" id="common-baudrate-list">
            <li><a href='#'>9600</a></li>
            <li><a href='#'>115200</a></li>
        </ul> 
    </span>           
    <input class="form-control" type="text" id="baudrate-input" val="115200">
</div>

我想制作一个可重复使用的参数化函数/模板/标签，它允许我输入这样的结构，例如“组ID”，“条目列表”，“左/右按钮位置” ，“默认值”。

到目前为止我看到的方法是：

作为一个模板，其语法相当有限，并且很难像下面这样的条目列表：['Entry 1', 'Entry 2']
作为模板，通过视图将数据传递到上下文中（因为我会将页面内容传播得更多，所以不具吸引力。）
作为模板标记，将HTML构建为一个非常讨厌的字符串
作为模板标签使用像lxml这样的XML库，这是一种非常灵活的方法，但是语法冗长，过于复杂，我仍然可以从模板中获取数据！

这些看起来都不像是一个整洁，可重复使用且松散耦合的方式来解决这个问题（例如，如果我将来更改为Bootstrap 4，我可能需要重新编写这些组件，而且我会而只需要做一次）。拥有这样的组件库也将使未来的页面更容易构建。是否有规范的“正确”方式来做到这一点，甚至是常用的习惯用法？

编辑以显示解决方案实施

使用Wolph下面回答的包含标签，我避免使用像这样的笨重结构

{% with [1,2,3] as items %}
    {% my_tag items.split %}
{% endwith %}

如下：

@register.inclusion_tag('components/this_component.html')
def input_with_dropdown(dropdown_title, dropdown_items, default_value, group_id, button_left, *args, **kwargs):

    split_char = kwargs['split_char'] if 'split_char' in kwargs else ' '

    return {
        'dropdown_items': dropdown_items.split(split_char),
        'dropdown_title': dropdown_title,
        'group_id': group_id,
        'default_value' : default_value,
        'button_left': button_left
    }

然后传递这样的变量：

{% input_with_dropdown 'Common baudrates' '9600 48000 115200' 115200 'baudrate-input' 0 %}

Answer 1

您是否看过包含标签？ https://docs.djangoproject.com/en/dev/howto/custom-template-tags/#inclusion-tags

我相信这些会完全符合您的要求，您仍然可以指定参数，但您只需传递一个模板即可轻松渲染。

示例：

from django import template
register = template.Library()

@register.inclusion_tag('list_results.html')
def list_results(results):
    return {
        'results': results,
        'count': len(results),
    }

list_results.html：

Found {{ count }} results.<br>
<ul>
{% for result in results %}
    <li>{{ result }}</li>
{% endfor %}
</ul>

Answer 2

使用templatetags和html模板......然后你可以重用那个HTML模板......

Django中可重用的HTML组件库

2 个答案: