admin.py
中添加 ModelAdmin
,这样就能很方便地在后台进行增删改查的操作。然而,对应 Model
生成的表单,并不友好,我们希望能像前端开发一样做出各种类型的控件,这就得对其后台的表单进行自定义。# forms.pyfrom django import formsfrom .models import MyModelclass MyForm(forms.ModelForm): xxx = forms.ChoiceField(choices=[...], widget=forms.RadioSelect()) class Meta: model = MyModel fields = ['id', 'xxx']# admin.pyfrom django.contrib import adminfrom .models import MyModelfrom .forms import MyFormclass MyAdmin(admin.ModelAdmin): form = MyForm # ...省略若干代码admin.site.register(MyModel, MyAdmin)
先自定义一个 MyForm
,在里面为字段添加控件,widget
用来指定控件的类型,choices
指定可选列表,再在 MyAdmin
中的 form 指定为自定义表单即可。
在 django 中已经提供了很多 widget(控件),然而这些还远远满足不了我们的需求,这就需要我们去自定义,下面就以一个 ACE 插件 (ACE 是一个独立的 JavaScript 编写的基于 Web 的代码编辑器)为例,说说怎么自定义 widget:
#coding: utf-8from django import formsfrom django.utils.html import format_htmlfrom django.forms.utils import flatattfrom django.utils.encoding import force_textfrom django.utils.safestring import mark_safeACE_RENDER = ''' $(function () { var textarea = $('textarea'); var editp = $('', { position: 'absolute', width: textarea.width(), height: textarea.height(), 'class': textarea.attr('class') }).insertBefore(textarea); textarea.css('display', 'none'); var editor = ace.edit(editp[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()); }); });'''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('', 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-8from django import formsfrom .models import Codefrom widgets import AceWidgetclass 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-8from django.db import modelsclass 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 adminfrom .models import Codefrom .forms import CodeFormclass CodeAdmin(admin.ModelAdmin): form = CodeForm list_display = ['id', 'title']admin.site.register(Code, CodeAdmin)