• Django-DjangoUeditor


    项目中用到了富文本编辑器DjangoUeditor,便开始学习。还有一个轻量级的编辑器是TinyHTML Editor,这个也可以,大家可以去了解一下。不过今天在这里主要说一下DjangoUeditor。

    Ueditor是百度开源的Web编辑器,可以感受一下百度的Web编辑器:

    http://ueditor.baidu.com/website/umeditor.html

    DjangoUeditor是基于Ueditor开发的,有个大神已经自己开发好啦,大家直接用。地址如下:

    https://github.com/zhangfisher/DjangoUeditor

    1.下载DjangoUeditor:

      1.安装包安装:

         http://ueditor.baidu.com/website/download.html 下载app

         类似于django其他的插件的安装,将DjangoUeditor的文件夹复制到当前App的同级目录 

      2.直接pip3 install DjangoUeditor(推荐)

    2、在INSTALL_APPS里面增加DjangoUeditor app,如下:
         
            INSTALLED_APPS = (
                #........
                'DjangoUeditor',
            )
    
    
    3、在urls.py中增加:
    
        url(r'^ueditor/',include('DjangoUeditor.urls' )),
    
    4、在models中这样定义:
        
        from DjangoUeditor.models import UEditorField
        class Blog(models.Model):
            Name=models.CharField(,max_length=100,blank=True)
            Content=UEditorField('内容    ',height=100,width=500,default='test',imagePath="uploadimg/",imageManagerPath="imglib",toolbars='mini',options={"elementPathEnabled":True},filePath='upload',blank=True)
    
        说明:
        UEditorField继承自models.TextField,因此你可以直接将model里面定义的models.TextField直接改成UEditorField即可。
        UEditorField提供了额外的参数:
            toolbars:配置你想显示的工具栏,取值为mini,normal,full,besttome, 代表小,一般,全部,涂伟忠贡献的一种样式。如果默认的工具栏不符合您的要求,您可以在settings里面配置自己的显示按钮。参见后面介绍。
            imagePath:图片上传的路径,如"images/",实现上传到"{{MEDIA_ROOT}}/images"文件夹
            filePath:附件上传的路径,如"files/",实现上传到"{{MEDIA_ROOT}}/files"文件夹
            scrawlPath:涂鸦文件上传的路径,如"scrawls/",实现上传到"{{MEDIA_ROOT}}/scrawls"文件夹,如果不指定则默认=imagepath
            imageManagerPath:图片管理器显示的路径,如"imglib/",实现上传到"{{MEDIA_ROOT}}/imglib",如果不指定则默认=imagepath。
            options:其他UEditor参数,字典类型。参见Ueditor的文档ueditor_config.js里面的说明。
            css:编辑器textarea的CSS样式
            width,height:编辑器的宽度和高度,以像素为单位。
    
    5、在表单中使用非常简单,与常规的form字段没什么差别,如下:
        
        class TestUeditorModelForm(forms.ModelForm):
            class Meta:
                model=Blog
        ***********************************
        如果不是用ModelForm,可以有两种方法使用:
    
        1: 使用forms.UEditorField
    
        from  DjangoUeditor.forms import UEditorField
        class TestUEditorForm(forms.Form):
            Description=UEditorField("描述",initial="abc",width=600,height=800)
        
        2: widgets.UEditorWidget
    
        from  DjangoUeditor.widgets import UEditorWidget
        class TestUEditorForm(forms.Form):
            Content=forms.CharField(label="内容",widget=UEditorWidget(width=800,height=500, imagePath='aa', filePath='bb',toolbars={}))
        
        widgets.UEditorWidget和forms.UEditorField的输入参数与上述models.UEditorField一样。
    
    6、Settings配置
         
          在Django的Settings可以配置以下参数:
                UEDITOR_SETTINGS={
                    "toolbars":{           #定义多个工具栏显示的按钮,允行定义多个
                        "name1":[[ 'source', '|','bold', 'italic', 'underline']],
                        "name2",[]
                    },
                    "images_upload":{
                        "allow_type":"jpg,png",    #定义允许的上传的图片类型
                        "max_size":"2222kb"        #定义允许上传的图片大小,0代表不限制
                    },
                    "files_upload":{
                         "allow_type":"zip,rar",   #定义允许的上传的文件类型
                         "max_size":"2222kb"       #定义允许上传的文件大小,0代表不限制
                     },,
                    "image_manager":{
                         "location":""         #图片管理器的位置,如果没有指定,默认跟图片路径上传一样
                    },
                }
    7、在模板里面:
    
        <head>
            ......
            {{ form.media }}        #这一句会将所需要的CSS和JS加进来。
            ......
        </head>
        注:运行collectstatic命令,将所依赖的css,js之类的文件复制到{{STATIC_ROOT}}文件夹里面。
    
    8、高级运用:
    
         ****************
         动态指定imagePath、filePath、scrawlPath、imageManagerPath
         ****************
         这几个路径文件用于保存上传的图片或附件,您可以直接指定路径,如:
              UEditorField('内容',imagePath="uploadimg/")
         则图片会被上传到"{{MEDIA_ROOT}}/uploadimg"文件夹,也可以指定为一个函数,如:
    
          def getImagePath(model_instance=None):
              return "abc/"
          UEditorField('内容',imagePath=getImagePath)
          则图片会被上传到"{{MEDIA_ROOT}}/abc"文件夹。
         ****************
         使上传路径(imagePath、filePath、scrawlPath、imageManagerPath)与Model实例字段值相关
         ****************
            在有些情况下,我们可能想让上传的文件路径是由当前Model实例字值组名而成,比如:
            class Blog(Models.Model):
                Name=models.CharField('姓名',max_length=100,blank=True)
                Description=UEditorField('描述',blank=True,imagePath=getUploadPath,toolbars="full")
    
         id  |   Name    |       Description
         ------------------------------------
         1   |   Tom     |       ...........
         2   |   Jack    |       ...........
    
          我们想让第一条记录上传的图片或附件上传到"{{MEDIA_ROOT}}/Tom"文件夹,第2条记录则上传到"{{MEDIA_ROOT}}/Jack"文件夹。
          该怎么做呢,很简单。
          def getUploadPath(model_instance=None):
              return "%s/" % model_instance.Name
          在Model里面这样定义:
          Description=UEditorField('描述',blank=True,imagePath=getUploadPath,toolbars="full")
          这上面model_instance就是当前model的实例对象。
          还需要这样定义表单对象:
          from  DjangoUeditor.forms import UEditorModelForm
          class UEditorTestModelForm(UEditorModelForm):
                class Meta:
                    model=Blog
          特别注意:
             **表单对象必须是继承自UEditorModelForm,否则您会发现model_instance总会是None。
             **同时在Admin管理界面中,此特性无效,model_instance总会是None。
             **在新建表单中,model_instance由于还没有保存到数据库,所以如果访问model_instance.pk可能是空的。因为您需要在getUploadPath处理这种情况
    
    
    class UEditorTestModelForm(UEditorModelForm):
        class Meta:
            model=Blog
  • 相关阅读:
    Hibernate官方文档翻译-(第二章,入门)
    关于我的Blog
    退役记
    考场上要写的emacs
    关于在linux下将caps lock键改成ctrl的方法
    SXOI2020退役记
    min_25筛学习笔记
    带花树学习笔记
    [CF438E] 小朋友和二叉树
    多项式中步
  • 原文地址:https://www.cnblogs.com/kmnskd/p/10006039.html
Copyright © 2020-2023  润新知