如何编写用于水平显示多个复选框的小部件?

How can I write widget for horizontal displaying multiple checkbox?

我有一个带有多个复选框的表单。但默认情况下它们是垂直显示的。我想水平显示它们。我需要为此任务创建自定义小部件。我找到了 CheckboxSelectMultiple

的默认代码

https://github.com/django/django/blob/master/django/forms/widgets.py#L765

class CheckboxSelectMultiple(ChoiceWidget):
    allow_multiple_selected = True
    input_type = 'checkbox'
    template_name = 'django/forms/widgets/checkbox_select.html'
    option_template_name = 'django/forms/widgets/checkbox_option.html'

    def use_required_attribute(self, initial):
        # Don't use the 'required' attribute because browser validation would
        # require all checkboxes to be checked instead of at least one.
        return False

    def value_omitted_from_data(self, data, files, name):
        # HTML checkboxes don't appear in POST data if not checked, so it's
        # never known if the value is actually omitted.
        return False

    def id_for_label(self, id_, index=None):
        """"
        Don't include for="field_0" in <label> because clicking such a label
        would toggle the first checkbox.
        """
        if index is None:
            return ''
        return super().id_for_label(id_, index)

link 到 git 使用 django 小部件

https://github.com/django/django/tree/master/django/forms/templates/django/forms/widgets

我还找到了 bootstrap 水平显示的形式 multiple checkboxes

{% for ... %}
    <div class="form-check form-check-inline">
      <input type="checkbox" class="form-check-input" id="materialInline{{ .id}}">
      <label class="form-check-label" for="materialInline{{ .id}}">{{ .title}}</label>
    </div>
{% endfor %}

可是我不知道怎么统一这个

您看对了。如您所见,默认的 CheckboxSelectMultiple 使用这两个模板:

template_name = 'django/forms/widgets/checkbox_select.html'
option_template_name = 'django/forms/widgets/checkbox_option.html'

因此,您唯一需要做的就是使用您自己的小部件对其进行子类化,并根据自己的喜好更改模板:

class HorizontalCheckboxSelectMultiple(CheckboxSelectMultiple):
    template_name = 'my_app/widgets/checkbox_select.html'
    option_template_name = 'my_app/widgets/checkbox_option.html'

checkbox_select.html 模板实际上是 multiple_input.html 模板,它只是包装了一组选项(在默认情况下带有 <ul><li>...)。 checkbox_option.html 模板实际上是用于每个选项的模板,您可以在其中放置没有 for 循环的 bootstrap 代码。

您还需要查看 input.html 模板以及 Django 包含在 checkbox_option.html 模板中的模板,以了解您可以使用的各种小部件变量(如 widget.namewidget.attrs.id 等等...).