creative/quilljs-bundle

用于Quill WYSIWYG表单类型的Symfony包

1.0.4 2021-01-27 04:22 UTC

This package is auto-updated.

Last update: 2024-08-27 12:55:26 UTC


README

QuillJS 是一个现代且强大的富文本编辑器。此包允许您在 Symfony 表单的 textarea 字段中使用此编辑器。

安装

Symfony flex

即将推出

直接方式

  • 安装包 composer require creative/quilljs-bundle
  • 将包添加到您的 config/bundles.php
    return [
      // another bundles
      CreativeQuillJs\QuillJsBundle::class => ['all' => true],
    ];
  • 将配置文件(见下文)放置在 config/packages

配置参考

creative_quill_js:
  enabled: true
  theme: ~                # remove this string to use default 'snow' theme
  quill_js_source: ~      # remove this string to use js from CDN (https://cdn.quilljs.com/1.3.6/quill.js)
  quill_css_source: ~     # remove this string to use css from CDN (https://cdn.quilljs.com/1.3.6/quill.snow.css)
  upload_route: ~         # if you have override Quill to upload files (I mean, to not place images as base64 to text), set your route to upload files here. You can set the application route name or absolute url to this parameter (if you using CDN for images)
  upload_route_parameters:
    type: 'image'         # any parameters to upload route
  toolbar_options:        # QuillJS toolbar configuration (https://quilljs.com/docs/modules/toolbar/)
    - ['bold', 'italic', 'underline', 'strike']
    - ['blockquote', 'code-block']
    - [{'header': [2, 3, false]}]
    - [{'list': 'ordered'}, {'list': 'bullet'}]
    - [{'script': 'sub'}, {'script': 'super'}]
    - [{'indent': '-1'}, {'indent': '+1'}]
    - [{'direction': 'rtl'}]
    - [{'size': ['small', false, 'large', 'huge']}]
    - ['link', 'image', 'video']
    - ['clean']
    - [{'color': [], 'background': []}]
    - [{'font': []}]
    - [{'align': []}]

注意

如果您想使用自己的 QuillJS 实例(且其源已加载到页面中),请将配置参数 quill_js_sourcequill_css_source 设置为 null。模板在 JS 块中调用 const quill = new Quill,如果 quill_js_sourcequill_css_source 是 null,则不会尝试加载 css/js 资产。

贡献

请随意使用此代码,修改它,分发它,销售它,并按您所愿处理它。

测试

composer install
vendor/bin/phpunit