README

此包通过自动注册 ace_editor 表单类型，为Symfony表单组件提供了 Ace编辑器 的集成。

兼容性

请查看下表以检查您的PHP和symfony版本是否受支持。

对于旧版本的不受支持的版本，请查看 版本发布 页面。

安装

要使用此包与最新版本的Symfony一起使用，请使用 Composer 安装。

composer require norberttech/aceeditor-bundle ^5.0

如果您正在使用 symfony/flex，则包将自动为您注册，否则您需要自行注册包。

// app/config/bundles.php

return [
    // ...
    AceEditorBundle\AceEditorBundle::class => ['all' => true],
    // ...
];

使用

use AceEditorBundle\Form\Extension\AceEditor\Type\AceEditorType;

/** @var $builder \Symfony\Component\Form\FormBuilderInterface */
$builder->add('description', AceEditorType::class, [
    'wrapper_attr' => [], // aceeditor wrapper html attributes.
    'width' => '100%',
    'height' => 250,
    'font_size' => 12,
    'mode' => 'ace/mode/html', // every single default mode must have ace/mode/* prefix
    'theme' => 'ace/theme/monokai', // every single default theme must have ace/theme/* prefix
    'tab_size' => null,
    'read_only' => null,
    'use_soft_tabs' => null,
    'use_wrap_mode' => null,
    'show_print_margin' => null,
    'show_invisibles' => null,
    'highlight_active_line' => null,
    'options_enable_basic_autocompletion' => true,
    'options_enable_live_autocompletion' => true,
    'options_enable_snippets' => false
    'keyboard_handler' => null
]);

上述代码将创建一个文本区域元素，该元素将被Ace编辑器实例替换。在Ace编辑器中进行的每次更改都会更新文本区域值。

配置

本节是可选的，您无需配置任何内容，表单类型仍然可以完美工作。

默认配置

# app/config/config.yml

ace_editor:
    base_path: "vendor/ace" # notice! this is starting from your project's public web root, typically: `%kernel.project_dir%/public`!
    autoinclude: true
    debug: false # sources not minified, based on kernel.debug but it can force it
    noconflict: true # uses ace.require instead of require

您还可以直接从与 https://github.com/ajaxorg/ace-builds 相同目录结构的地址包含Ace编辑器，您只需设置 base_path 选项即可。

ace_editor:
    base_path: "http://rawgithub.com/ajaxorg/ace-builds/master"

Ace编辑器资源

除非您进行一些配置，否则此包期望Ace编辑器文件位于 public/vendor/ace。您可以从中下载任何Ace编辑器构建版本 上游存储库 并将其内容放入相应的文件夹。

ACE_VERSION=1.32.3 # replace with whatever ace version you need

cd <YOUR_PROJECT_ROOT>/public
mkdir vendor && cd vendor
wget https://github.com/ajaxorg/ace-builds/archive/v${ACE_VERSION}.tar.gz
tar -xvf v${ACE_VERSION}.tar.gz
mv ace-${ACE_VERSION} ace
rm v${ACE_VERSION}.tar.gz