编程开源技术交流,分享技术与知识

网站首页 > 开源技术 正文

django框架中富文本的应用库(react富文本框)

wxchong 2025-04-11 08:41:54 开源技术 18 ℃ 0 评论


在Django框架中,常用的富文本编辑器有以下几种:

  1. Django-ckeditor

Django-ckeditor是一个基于ckeditor的富文本编辑器。它支持图片上传、管理、插入,以及代码高亮等功能。使用方法如下:

  • 安装ckeditor
pip install django-ckeditor
  • 在settings.py中设置
INSTALLED_APPS = [
    ...
    'ckeditor',
    ...
]

CKEDITOR_UPLOAD_PATH = "uploads/" # 设置上传图片的路径
  • 在models.py中使用
from django.db import models
from ckeditor.fields import RichTextField

class Post(models.Model):
    title = models.CharField(max_length=200)
    content = RichTextField()
  • 在form中使用
from django import forms
from ckeditor.widgets import CKEditorWidget
from .models import Post

class PostForm(forms.ModelForm):
    content = forms.CharField(widget=CKEditorWidget())
    class Meta:
        model = Post
        fields = ('title', 'content',)
  1. Django-tinymce

Django-tinymce是基于tinymce的富文本编辑器。它也支持图片上传、管理、插入等功能。使用方法如下:

  • 安装tinymce
pip install django-tinymce4-lite
  • 在settings.py中设置
INSTALLED_APPS = [
    ...
    'tinymce',
    ...
]
  • 在models.py中使用
from django.db import models
from tinymce.models import HTMLField

class Post(models.Model):
    title = models.CharField(max_length=200)
    content = HTMLField()
  • 在form中使用
from django import forms
from tinymce.widgets import TinyMCE
from .models import Post

class PostForm(forms.ModelForm):
    content = forms.CharField(widget=TinyMCE(attrs={'cols': 80, 'rows': 30}))
    class Meta:
        model = Post
        fields = ('title', 'content',)

以上两种富文本编辑器都可以满足图片上传、管理、插入等功能,具体选择哪一种,可以根据自己的实际需求进行选择。

----------------另外两种富文本编辑器---------------------

如:

  1. Summernote: 一款简单易用的富文本编辑器,支持图片上传、管理等功能。使用方法如下:
  2. 安装:
   pip install django-summernote

在settings.py中添加以下配置:

   INSTALLED_APPS = [
       # ...
       'django_summernote',
       # ...
   ]

   # 富文本编辑器配置
   SUMMERNOTE_CONFIG = {
       # 启用图片上传功能
       'summernote': {
           'toolbar': [
               ['style', ['style']],
               ['font', ['bold', 'underline', 'clear']],
               ['fontname', ['fontname']],
               ['color', ['color']],
               ['para', ['ul', 'ol', 'paragraph']],
               ['table', ['table']],
               ['insert', ['link', 'picture', 'video']],
               ['view', ['fullscreen', 'codeview', 'help']],
           ],
           'lang': 'zh-CN',
           'height': 300,
           'width': '100%',
           'callbacks': {
               'onImageUpload': 'onImageUpload',
           },
       },
   }

在app中的models.py中使用:

   from django.db import models
   from django_summernote.fields import SummernoteTextField

   class Post(models.Model):
       title = models.CharField(max_length=200)
       content = SummernoteTextField()
  1. CKEditor 5: 一款全新的富文本编辑器,支持图片上传、管理等功能。使用方法如下:
  2. 安装:
   pip install django-ckeditor-5

在settings.py中添加以下配置:

   INSTALLED_APPS = [
       # ...
       'ckeditor',
       # ...
   ]

   # 富文本编辑器配置
   CKEDITOR_UPLOAD_PATH = "uploads/"
   CKEDITOR_IMAGE_BACKEND = "pillow"
   CKEDITOR_CONFIGS = {
       'default': {
           'toolbar': [
               ['bold', 'italic', 'underline'],
               ['link', 'image'],
               ['source'],
           ],
           'image_previewText': ' ',
           'width': '100%',
           'height': 400,
       },
   }

在app中的models.py中使用:

   from django.db import models
   from ckeditor.fields import RichTextField

   class Post(models.Model):
       title = models.CharField(max_length=200)
       content = RichTextField()

以上两种富文本编辑器都支持图片上传、管理等功能,并且使用简单、配置灵活。


--------------------------------更精彩的来了------------------

除了Django-ckeditor、Django-tinymce、Summernote和CKEditor以外,还有一些其他的富文本库可以在Django中使用,例如Froala Editor、TinyMDE等。

其中比较推荐的是Froala Editor,它具有以下特点:

  • 支持图片的插入和管理
  • 可以自定义配置,包括字体、颜色、表情等
  • 支持响应式设计,适用于不同的设备和屏幕大小
  • 支持多种语言和主题
  • 支持多种格式,包括HTML、Markdown等

下面是在Django中使用Froala Editor的方法:

  1. 安装froala-editor

可以通过pip安装froala-editor:

pip install froala-editor
  1. 配置settings.py文件

在INSTALLEDAPPS中添加froalaeditor和froalaeditor.widgets,并设置FROALAEDITOR_OPTIONS:

INSTALLED_APPS = [
    ...
    'froala_editor',
    'froala_editor.widgets',
    ...
]

FROALA_EDITOR_OPTIONS = {
    'toolbarInline': False,
    'height': 200,
    'width': '100%',
    'theme': 'dark',
    'language': 'zh_cn',
    'imageUploadURL': '/upload_image/',
    'imageUploadParams': {
        'csrfmiddlewaretoken': '{{ csrf_token }}'
    }
}

其中,toolbarInline表示是否使用行内工具栏,height和width表示编辑器的高度和宽度,theme表示编辑器的主题,language表示编辑器的语言,imageUploadURL表示上传图片的URL地址,imageUploadParams表示上传图片时需要的参数。

  1. 创建表单

在表单中使用FroalaEditorWidget作为字段的widget,例如:

from django import forms
from froala_editor.widgets import FroalaEditorWidget

class ArticleForm(forms.Form):
    title = forms.CharField(max_length=100)
    content = forms.CharField(widget=FroalaEditorWidget())
  1. 处理上传图片的URL

在urls.py中添加上传图片的URL:

from django.urls import path
from . import views

urlpatterns = [
    ...
    path('upload_image/', views.upload_image, name='upload_image'),
    ...
]

并在views.py中定义upload_image函数,例如:

from django.http import JsonResponse

def upload_image(request):
    if request.method == 'POST':
        image = request.FILES.get('file')
        # 处理上传图片的逻辑
        return JsonResponse({'link': 'http://example.com/path/to/image.jpg'})

其中,如果上传成功,需要返回一个包含图片链接的JSON格式的响应。在Froala Editor中,使用imageUploadURL和imageUploadParams指定上传图片的URL和需要的参数,上传成功后,就会自动将图片插入到编辑器中。

以上就是在Django中使用Froala Editor的方法,其他富文本库的使用方法也类似,只需要根据具体的文档进行配置即可。

Tags:

本文暂时没有评论,来添加一个吧(●'◡'●)

欢迎 发表评论:

最近发表
标签列表