django-multiselectfield 0.1.13

使用pip安装

$ pip install django-multiselectfield

配置您的models.py

from multiselectfield import MultiSelectField

# ...

MY_CHOICES = (('item_key1', 'Item title 1.1'),
              ('item_key2', 'Item title 1.2'),
              ('item_key3', 'Item title 1.3'),
              ('item_key4', 'Item title 1.4'),
              ('item_key5', 'Item title 1.5'))

MY_CHOICES2 = ((1, 'Item title 2.1'),
               (2, 'Item title 2.2'),
               (3, 'Item title 2.3'),
               (4, 'Item title 2.4'),
               (5, 'Item title 2.5'))

class MyModel(models.Model):

    # .....

    my_field = MultiSelectField(choices=MY_CHOICES)
    my_field2 = MultiSelectField(choices=MY_CHOICES2,
                                 max_choices=3,
                                 max_length=3)

在您的settings.py中

如果您需要django-multiselectfield的翻译，则仅需要此操作

INSTALLED_APPS = (
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.sites',
    'django.contrib.admin',

    #.....................#

    'multiselectfield',
)

自定义模板

可以在表单模板中自定义此小部件的HTML。要这样做，您需要遍历 form.{field}.field.choices。以下是一个示例，显示了名为 providers 的 MultiSelectField 的字段标签在复选框下方/之后显示。

{% for value, text in form.providers.field.choices %}
  <div class="ui slider checkbox">
    <input id="id_providers_{{ forloop.counter0 }}" name="{{ form.providers.name }}" type="checkbox" value="{{ value }}"{% if value in checked_providers %} checked="checked"{% endif %}>
    <label>{{ text }}</label>
  </div>
{% endfor %}

Django REST框架

Django REST框架附带了一个 MultipleChoiceField，与这个功能配合得很好。

from rest_framework import fields, serializers

from myapp.models import MY_CHOICES, MY_CHOICES2

class MyModelSerializer(serializers.HyperlinkedModelSerializer):
    # ...
    my_field = fields.MultipleChoiceField(choices=MY_CHOICES)
    my_field2 = fields.MultipleChoiceField(choices=MY_CHOICES2)
    # ...

0.1.13 (2024-06-30)

• 从表单字段返回MSFList而不是普通列表（#118，#135）

• 修复CI（#122，#147，#148，#151）

• 在将表单字段转换为默认值时添加 min_choices（#123）

• 支持Django 5.0并删除旧兼容性（#148）

感谢

• tomasgarzon

• aleh-rymasheuski

• nametkin

• karolyi

• olivierdalang

• PetrDlouhy

0.1.12 (2020-02-20)

• 优化multiselectfield的_to_python方法

• 感谢

  • daimon99

0.1.11 (2019-12-19)

• 添加对Django 3的支持

• 添加对Python 3.8的支持

• 感谢

  • thijsBoehme

0.1.9 (2019-10-02)

• 添加对Django 2的支持

• 添加对Python 3.6的支持

• 删除对Python (2.6, 3.3)的支持

• 感谢

  • hirokinko

0.1.6 (2017-05-10)

• 添加对Django 1.11的支持

• 添加对Python 3.6的支持

• 改进Django管理中的渲染

• 改进文档

• 感谢

  • atten

  • ixc

  • LeilaniAnn

0.1.5 (2017-01-02)

• 添加对Django 1.8-1.10的支持

• 添加对选择项中命名组的支持

• 添加对min_choices参数的支持

• 各种修复

• 更多测试

• 感谢

  • danilogbotelho

  • dmitry-krasilnikov

  • Kamil Dębowski

0.1.4 (2016-02-23)

• 修复关于SubfieldBase的警告

• 添加对Django 1.8+的支持

• 添加对命名组的支持

• 我们现在与django-dynamic-fixture兼容

• 更多测试

0.1.3 (2014-10-13)

• 支持Django 1.7（很抱歉延迟）

• 添加get_FIELD_list函数

• 修复在管理站点重新读取MultiSelectField时的错误

• 感谢

  • Hernil

  • Vasyl Stanislavchuk

  • Litchfield

  • Chris-erickson

0.1.2 (2014-04-04)

• 将西班牙语翻译包含到pypi egg中

• README文件改进

• Windows操作系统兼容性

• 感谢

  • StillNewb

  • Diego Yungh

0.1.1 (2013-12-04)

• 将多选字段应用移动到父文件夹

• 详情

0.1.0 (2013-11-30)

• 测试/示例项目

• 现在如果元组列表的第一个元素是整数，则可以工作

• 现在max_length不是必需的，多选字段会自动计算它。

• max_choices属性可以是模型字段中的一个属性

• 重构代码

• 西班牙语翻译

• 支持python2.6

• 感谢

  • Daniele Procida

0.0.3 (2013-09-11)

• Python 3兼容

• 修复一个错误，当选项可翻译时，代码段有另一个错误

• README文件改进

0.0.2 (2012-09-28)

• 修复一个错误，代码段有错误。

0.0.1 (2012-09-27)

• 下一个代码片段的初始版本