Python中Django 后台自定义表单控件

在 django 中我们可以在 admin.py中添加ModelAdmin，这样就能很方便地在后台进行增删改查的操作。然而，对应 Model生成的表单，并不友好，我们希望能像前端开发一样做出各种类型的控件，这就得对其后台的表单进行自定义。

其实 django 已经为我们提供了一些可用的表单控件，比如：多选框、单选按钮等，下面就以单选按钮为例：

    # forms.py
    from django import forms
    from .models import MyModel

    class MyForm(forms.ModelForm):
      xxx = forms.ChoiceField(choices=[...], widget=forms.RadioSelect())

      class Meta:
        model = MyModel
        fields = ['id', 'xxx']


    # admin.py
    from django.contrib import admin
    from .models import MyModel
    from .forms import MyForm

    class MyAdmin(admin.ModelAdmin):
      form = MyForm
      # ...省略若干代码

    admin.site.register(MyModel, MyAdmin)

先自定义一个 MyForm，在里面为字段添加控件，widget用来指定控件的类型，choices指定可选列表，再在 MyAdmin中的 form 指定为自定义表单即可。

在 django 中已经提供了很多 widget(控件)，然而这些还远远满足不了我们的需求，这就需要我们去自定义，下面就以一个 ACE 插件 (ACE 是一个独立的 JavaScript 编写的基于 Web 的代码编辑器)为例，说说怎么自定义 widget：

    #coding: utf-8
    from django import forms
    from django.utils.html import format_html
    from django.forms.utils import flatatt
    from django.utils.encoding import force_text
    from django.utils.safestring import mark_safe


    ACE_RENDER = '''
    <script src="/static/js/jquery-1.11.2.min.js"></script>
    <script src="/static/js/ace/ace.js"></script>
    <script>
      $(function () {
        var textarea = $('textarea');
        var editDiv = $('<div>', {
          position: 'absolute',
          width: textarea.width(),
          height: textarea.height(),
          'class': textarea.attr('class')
        }).insertBefore(textarea);

        textarea.css('display', 'none');

        var editor = ace.edit(editDiv[0]);
        editor.getSession().setValue(textarea.val());
        editor.getSession().setMode("ace/mode/%s");
        editor.setTheme("ace/theme/%s");

        textarea.closest('form').submit(function () {
          textarea.val(editor.getSession().getValue());
        });
      });
    </script>
    '''

    class AceWidget(forms.Textarea):
      def __init__(self, mode="", theme="", attrs=None):
        '''
        为了能在调用的时候自定义代码类型和样式
        :param mode:
        :param theme:
        :param attrs:
        :return:
        '''
        super(AceWidget, self).__init__(attrs)
        self.mode = mode
        self.theme = theme

      def render(self, name, value, attrs=None):
        '''
        关键方法
        :param name:
        :param value:
        :param attrs:
        :return:
        '''
        if value is None:
          value = ''
        final_attrs = self.build_attrs(attrs, name=name)
        output = [format_html('<textarea{}>\r\n{}</textarea>', flatatt(final_attrs), force_text(value))]
        current_ace_render = ACE_RENDER %(self.mode, self.theme)
        output.append(current_ace_render)
        return mark_safe('\n'.join(output))

主要就是自定义的 widget 要继承自 django 的 widget，然后重写 render 方法，在这个方法中，对新的控件进行包装。

在 forms.py 中将自定义的控件 AceWidget引入：

    #coding: utf-8
    from django import forms
    from .models import Code
    from widgets import AceWidget


    class CodeForm(forms.ModelForm):
      code = forms.CharField(label='源码', widget=AceWidget(attrs={'cols': '100', 'rows': '20'}, mode="python", theme="monokai"))

      class Meta:
        model = Code
        fields = ['title', 'code']

需要注意的是：在这里使用的 mode="python", theme="monokai"对应的文件 mode-python.js和 theme-monokai.js 一定要在 /static/js/ace目录下。

效果图

附录：

models.py：

    #coding:utf-8
    from django.db import models


    class Code(models.Model):
      title = models.CharField('标题', max_length=50, unique=True)
      code = models.TextField('源码')

      class Meta:
        db_table = 'code'
        verbose_name = verbose_name_plural = '代码'

      def __unicode__(self):
        return self.title

admin.py：

    from django.contrib import admin
    from .models import Code
    from .forms import CodeForm


    class CodeAdmin(admin.ModelAdmin):
      form = CodeForm
      list_display = ['id', 'title']

    admin.site.register(Code, CodeAdmin)

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。