配置参考 \ URL处理配置设置编辑器处理URL的方式

此页更新时间：2019-03-02 21:47

此页英文文档：https://www.tiny.cloud/docs/configure/url-handling/

allow_script_urls（允许链接和图像url使用js）

开启此选项则允许href="javascript:alert('hello');"这类代码不会被编辑器过滤掉。出于安全考虑，该选项默认关闭，因为从别处复制来的内容中可能会携带js代码。

取值：true / false

默认：false

allow_script_urls: true

convert_urls（自动转换URL）

关闭此选项，TinyMCE将不会自动处理URL，也就是说，插入的URL原本是什么就是什么，不会自动转换相对或绝对路径，这样会导致内容URL极其混乱。所以，默认此选项是开启的。

取值：true / false

默认：true

convert_urls: false

document_base_url（设置URL的基本目录）

它常与下面的relative_urls配合使用，用于统一内容区URL格式。此参数的值必须是一个URL，且必须以/结尾。

取值：String（必须以/结尾）

默认：当前目录

document_base_url : "http://tinymce.ax-z.cn/demo/",

如何全局定义URL为相对URL、绝对URL或带域名的URL？

relative_urls（相对URL）

此设置将把当前域名中的所有URL转换为相对URL。相对位置基于document_base_url的配置。

取值：true / false

相对URL

tinymce.init({
    selector: '#textarea1',
    relative_urls : true,
    document_base_url : "http://tinymce.ax-z.cn/demo/",
});

结果示例：http://tinymce.ax-z.cn/demo/images/1.jpg 将被转换为 images/1.jpg

绝对URL

tinymce.init({
    selector: '#textarea1',
    relative_urls : false,
    remove_script_host : true,
    document_base_url : "http://tinymce.ax-z.cn/demo/",
});

结果示例：images/1.jpg 将被转换为 /demo/images/1.jpg

带域名的绝对URL

tinymce.init({
    selector: '#textarea1',
    relative_urls : false,
    remove_script_host : false,
    document_base_url : "http://tinymce.ax-z.cn/demo/",
});

结果示例：images/1.jpg 将被转换为 http://tinymce.ax-z.cn/demo/images/1.jpg

remove_script_host（删除URL的域名部分）

取值：true / false

默认：true

remove_script_host: false

例子参见上文。

urlconverter_callback（自定义URL转换逻辑）

使用自定义的URL转换逻辑处理文档中的URL。

该函数有三个参数：

  • url：原始url字符串。
  • node：url所在的DOM。
  • on_save：该值一直为true
  • name：正在设置的属性名。

该函数的返回值应是转换后的URL字符串。

此选项的默认值为TinyMCE内部函数convertURL(url:string, name:string, elm:string):string，有关该函数细节需参见文档关于API的部分

取值：Function

function myCustomURLConverter(url, node, on_save, name) {
    url = url.substring(3);
    return url;
}
tinymce.init({
    selector: '#textarea1',
    urlconverter_callback : 'myCustomURLConverter',
});

anchor_top

anchor_bottom

不知道干嘛用的。

取值：string / flase

默认：anchor_top:'#top' , anchor_bottom:'#bottom'

下一节：其它配置

▲