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

发布时间 - 2026-01-11 00:24:27    点击率:

在 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)

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


# django  # 表单  # form表单  # 自定义表单  # Django自定义用户认证示例详解  # 详解Django admin高级用法  # Django后台admin的使用详解  # Django自定义用户表+自定义admin后台中的字段实例  # 自定义  # 这就  # 为例  # 就以  # 单选  # 的是  # 是一个  # 在这里  # 在这个  # 就能  # 能在  # 我们可以  # 对其  # 重写  # 可选  # 在里面  # 很方便  # 编辑器  # 需要注意 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 音响网站制作视频教程,隆霸音响官方网站?  Laravel如何使用Blade组件和插槽?(Component代码示例)  Laravel如何使用Passport实现OAuth2?(完整配置步骤)  如何用y主机助手快速搭建网站?  laravel服务容器和依赖注入怎么理解_laravel服务容器与依赖注入解析  Laravel如何使用Eloquent ORM进行数据库操作?(CRUD示例)  如何用wdcp快速搭建高效网站?  Android滚轮选择时间控件使用详解  Laravel如何实现数据导出到PDF_Laravel使用snappy生成网页快照PDF【方案】  linux top下的 minerd 木马清除方法  如何在 Pandas 中基于一列条件计算另一列的分组均值  今日头条AI怎样推荐抢票工具_今日头条AI抢票工具推荐算法与筛选【技巧】  Laravel如何发送系统通知?(Notification渠道示例)  如何快速使用云服务器搭建个人网站?  Windows10如何更改计算机工作组_Win10系统属性修改Workgroup  悟空识字如何进行跟读录音_悟空识字开启麦克风权限与录音  Laravel Vite是做什么的_Laravel前端资源打包工具Vite配置与使用  Laravel怎么做缓存_Laravel Cache系统提升应用速度的策略与技巧  西安专业网站制作公司有哪些,陕西省建行官方网站?  Laravel怎么实现模型属性的自动加密  Python结构化数据采集_字段抽取解析【教程】  瓜子二手车官方网站在线入口 瓜子二手车网页版官网通道入口  详解CentOS6.5 安装 MySQL5.1.71的方法  Python高阶函数应用_函数作为参数说明【指导】  阿里云网站搭建费用解析:服务器价格与建站成本优化指南  如何用IIS7快速搭建并优化网站站点?  高端企业智能建站程序:SEO优化与响应式模板定制开发  Python进程池调度策略_任务分发说明【指导】  Swift中循环语句中的转移语句 break 和 continue  如何使用 Go 正则表达式精准提取括号内首个纯字母标识符(忽略数字与嵌套)  使用豆包 AI 辅助进行简单网页 HTML 结构设计  zabbix利用python脚本发送报警邮件的方法  装修招标网站设计制作流程,装修招标流程?  小视频制作网站有哪些,有什么看国内小视频的网站,求推荐?  浅析上传头像示例及其注意事项  PHP 500报错的快速解决方法  Internet Explorer官网直接进入 IE浏览器在线体验版网址  Laravel数据库迁移怎么用_Laravel Migration管理数据库结构的正确姿势  活动邀请函制作网站有哪些,活动邀请函文案?  如何为不同团队 ID 动态生成多个独立按钮  Laravel怎么进行数据库事务处理_Laravel DB Facade事务操作确保数据一致性  JavaScript如何实现类型判断_typeof和instanceof有什么区别  如何快速生成专业多端适配建站电话?  Laravel怎么返回JSON格式数据_Laravel API资源Response响应格式化【技巧】  在线制作视频的网站有哪些,电脑如何制作视频短片?  独立制作一个网站多少钱,建立网站需要花多少钱?  如何破解联通资金短缺导致的基站建设难题?  如何注册花生壳免费域名并搭建个人网站?  在线制作视频网站免费,都有哪些好的动漫网站?  CSS3怎么给轮播图加过渡动画_transition加transform实现【技巧】