富文本编辑器CKEditor4简单使用-08（段落首行缩进插件 + 处理粘贴 Microsoft Word 中的内容后保持原始内容格式（包括首行缩进））

1. 缩进，特殊方式处理——修改原工具栏里的增加缩进量
2 缩进，插件处理
- 2.1 下载段落插件 textindent
- 2.2 使用段落插件 textindent
- 2.3 修改textindent插件中的plugins.js文件
- - 2.3.1 修改插件按钮提示信息
  - 2.3.2 修改插件里的缩进偏移量和缩进单位
- 2.4 开启textindent插件并看效果
- - 2.4.1 开启插件
  - 2.4.2 段落首行缩进测试
  - 2.4.3 来源word粘贴（保留缩进格式测试）
- 2.5 附核心代码
- 2.6 关于安装插件的其他详细内容
3. 缩进，插件处理——优化（简直完美）
- 3.1 如果不优化存在的问题
- 3.2 修改插件的plugin.js——设置缩进2个字体空间
- - 3.2.1 直接换单位（rem）
  - 3.2.2 更改源码，计算缩进空间
  - - 3.2.2.1 更改位置
    - 3.2.2.2 看效果
    - 3.2.2.3 核心代码
    - 3.2.2.4 更改后完整 plugin.js 代码
    - 3.2.2.5 优化后完整 plugin.js 代码
4. 下载项目
5. word里有图片的问题（待解决）
- 4.1 问题描述
- 5.1 查看自己的CKEditor4版本号
- 5.2 关于Paste from Word插件
- - 5.2.1 下载Paste from Word插件
  - 5.3 解压所有插件

1. 缩进，特殊方式处理——修改原工具栏里的增加缩进量

请看上篇文章，如下：

富文本编辑器CKEditor4简单使用-07（处理浏览器不支持通过工具栏粘贴问题和首行缩进的问题）.

2 缩进，插件处理

2.1 下载段落插件 textindent

下载段落缩进插件，如下：

https://ckeditor.com/cke4/addon/textindent.
备注：该插件没有依赖插件，所以只需要下载该一个插件即可使用！

2.2 使用段落插件 textindent

下载之后解压，然后放在plugins目录下，如下：

2.3 修改textindent插件中的plugins.js文件

2.3.1 修改插件按钮提示信息

这个看自己，因为提示信息是一串英文的，所以这里改成明了的汉字，如下：

2.3.2 修改插件里的缩进偏移量和缩进单位

如下：

2.4 开启textindent插件并看效果

2.4.1 开启插件

开启插件配置如下：

2.4.2 段落首行缩进测试

看效果
如果不修改缩进偏移量和缩进单位的话，原本效果如下：
修改缩进偏移量和缩进单位后的效果，如下：

2.4.3 来源word粘贴（保留缩进格式测试）

使用这个插件之后，从word里复制出的内容再粘贴格式保持不变（包括首行缩进格式），如下：
通过工具栏的按钮粘贴也是一样的可以实现缩进效果，但是不一样的是这种缩进不是缩进的两个字符(2em)，而是缩进的两个字体的空间大小（可以理解是保持原文格式不变了）。
注意前提：一定要开启textindent插件，否则首行缩进格式丢失！

2.5 附核心代码

text.html，如下：

<!doctype html>
<html lang="en"><head><meta charset="utf-8"><meta name="robots" content="noindex, nofollow"><title>Setting text part language</title><script src="../ckeditor/ckeditor.js"></script>
</head><body><textarea cols="80" id="editor2" name="editor2" rows="10"></textarea><script>var editor = CKEDITOR.replace('editor2', {});editor.on("beforeCommandExec", function (event) {// 显示粘贴按钮的粘贴对话框并右键单击粘贴if (event.data.name == "paste") {event.editor._.forcePasteDialog = true;}// 不要显示Ctrl+Shift+V的粘贴对话框if (event.data.name == "pastetext" && event.data.commandData.from == "keystrokeHandler") {event.cancel();}});</script>
</body></html>

config.js，如下：

CKEDITOR.editorConfig = function( config ) {// 启用皮肤config.skin = 'office2013';// textindent-首行缩进插件config.extraPlugins = 'textindent';};

2.6 关于安装插件的其他详细内容

可参考下面的文章：
富文本编辑器CKEditor4简单使用-02（常用插件安装及使用）.

3. 缩进，插件处理——优化（简直完美）

3.1 如果不优化存在的问题

上面我们把缩进量和单位配置成2em，看着测试没什么问题，但是我们通过复制粘贴发现，复制粘贴后缩进保留的还是原文的px，所以我们上面测试看着没问题，那是因为字体刚刚好，如果我们把字体调大或者调小再次点击缩进按钮，问题就暴露出来了，如下：
所以，它是一个动态的，我们要做的是如何实现缩进两个字体（根据原文字体的大小缩进），所以我们要设置成动态的缩进2个字体的空间，也就是说：
当设置为2个字体的空间时，即首行缩进的距离为2个字体大小的距离。例如，如果你的文字大小为16px，那么缩进的距离就是32px。

3.2 修改插件的plugin.js——设置缩进2个字体空间

3.2.1 直接换单位（rem）

但是这个有个问题，如果正文字体大小都一样可以，如果第二段字体大小和第一段字体大小不一样的话，效果不是很理想（这时第一段可以实现效果，但是第二段不行）如下：
关于em 和 rem
在 CSS 中，em 和 rem 都是相对长度单位，其中 em 是相对于父元素的字体大小，而 rem 是相对于根元素的字体大小（即 html 元素的字体大小）。具体来说：
- em：表示相对于当前元素的字体大小。例如，如果当前元素的字体大小为 16px，那么 1em 就等于 16px。
- rem：表示相对于根元素（即 html 元素）的字体大小。例如，如果根元素的字体大小为 16px，那么 1rem 就等于 16px。
  由于 rem 单位是相对于根元素的字体大小，因此在整个页面中都是一致的。这使得使用 rem 单位更加方便和灵活，可以避免在多层嵌套中计算父元素字体大小的复杂性。
如果字体不一致的话，上面rem可能还是不能满足，这就需要计算了，如何实现，请继续……

3.2.2 更改源码，计算缩进空间

3.2.2.1 更改位置

如下：

3.2.2.2 看效果

如下：

3.2.2.3 核心代码

添加的核心代码如下：

// 第一个是span，获取span标签
var child_span = node.$.firstElementChild; 
// console.log(child_span);
if(child_span!=null){// 获取span里的 font-size属性的值var spanFontSize = child_span.style.fontSize;indentation = 2 * parseFloat(spanFontSize) + "px"; // 更改缩进量和缩进单位// console.log(spanFontSize);// console.log(indentation);
}

3.2.2.4 更改后完整 plugin.js 代码

如下：

CKEDITOR.plugins.add( 'textindent', {icons: 'textindent',availableLangs: {'pt-br':1, 'en':1},lang: 'pt-br, en',init: function( editor ) {var indentation = editor.config.indentation;var indentationKey = editor.config.indentationKey;if(typeof(indentation) == 'undefined')indentation = '2em';if(typeof(indentationKey) == 'undefined')indentationKey = 'tab';if(editor.ui.addButton){editor.ui.addButton( 'textindent', {// label: editor.lang.textindent.labelName,label: '首行缩进',command: 'ident-paragraph',});}if( indentationKey !== false){editor.on('key', function(ev) {if(ev.data.domEvent.$.key.toLowerCase() === indentationKey.toLowerCase().trim() || ev.data.keyCode === indentationKey){editor.execCommand('ident-paragraph');ev.cancel();  }});}editor.on( 'selectionChange', function(){var style_textindente = new CKEDITOR.style({element: 'p',styles: { 'text-indent': indentation },overrides: [{element: 'text-indent', attributes: { 'size': '0'}}]});if( style_textindente.checkActive(editor.elementPath(), editor) )editor.getCommand('ident-paragraph').setState(CKEDITOR.TRISTATE_ON);elseeditor.getCommand('ident-paragraph').setState(CKEDITOR.TRISTATE_OFF);});editor.addCommand("ident-paragraph", {allowedContent: 'p{text-indent}',requiredContent: 'p',exec: function(evt) {var range = editor.getSelection().getRanges()[0]; var walker = new CKEDITOR.dom.walker( range ),node;var state = editor.getCommand('ident-paragraph').state;while ( ( node = walker.next() ) ) {if ( node.type == CKEDITOR.NODE_ELEMENT ) {if(node.getName() === "p"){// console.log(node);editor.fire('saveSnapshot');if( state == CKEDITOR.TRISTATE_ON){node.removeStyle("text-indent");editor.getCommand('ident-paragraph').setState(CKEDITOR.TRISTATE_OFF);}else{// 第一个是span，获取span标签var child_span = node.$.firstElementChild; console.log(child_span);if(child_span!=null){// 获取span里的 font-size属性的值var spanFontSize = child_span.style.fontSize;indentation = 2 * parseFloat(spanFontSize) + "px";  // 更改缩进量和缩进单位}node.setStyle( "text-indent", indentation );editor.getCommand('ident-paragraph').setState(CKEDITOR.TRISTATE_ON);}}}}if(node === null){node = editor.getSelection().getStartElement().getAscendant('p', true);console.log(node);// var outerHtml = node.getOuterHtml();// console.log(outerHtml);// 获取 childNodes// var childNodes = node.$.childNodes; // console.log(childNodes);// 第一个是span，获取span标签var child_span = node.$.firstElementChild; // console.log(child_span);if(child_span!=null){// 获取span里的 font-size属性的值var spanFontSize = child_span.style.fontSize;indentation = 2 * parseFloat(spanFontSize) + "px"; // 更改缩进量和缩进单位// console.log(spanFontSize);// console.log(indentation);}editor.fire('saveSnapshot');if( state == CKEDITOR.TRISTATE_ON){node.removeStyle("text-indent");editor.getCommand('ident-paragraph').setState(CKEDITOR.TRISTATE_OFF);}else{node.setStyle( "text-indent", indentation );editor.getCommand('ident-paragraph').setState(CKEDITOR.TRISTATE_ON);}}}});}});

3.2.2.5 优化后完整 plugin.js 代码

上述代码修改2处，并且原本也有重复代码，优化后如下：

CKEDITOR.plugins.add( 'textindent', {icons: 'textindent',availableLangs: {'pt-br':1, 'en':1},lang: 'pt-br, en',init: function( editor ) {var indentation = editor.config.indentation;var indentationKey = editor.config.indentationKey;if(typeof(indentation) == 'undefined')indentation = '2em';if(typeof(indentationKey) == 'undefined')indentationKey = 'tab';if(editor.ui.addButton){editor.ui.addButton( 'textindent', {// label: editor.lang.textindent.labelName,label: '首行缩进',command: 'ident-paragraph',});}if( indentationKey !== false){editor.on('key', function(ev) {if(ev.data.domEvent.$.key.toLowerCase() === indentationKey.toLowerCase().trim() || ev.data.keyCode === indentationKey){editor.execCommand('ident-paragraph');ev.cancel();  }});}editor.on( 'selectionChange', function(){var style_textindente = new CKEDITOR.style({element: 'p',styles: { 'text-indent': indentation },overrides: [{element: 'text-indent', attributes: { 'size': '0'}}]});if( style_textindente.checkActive(editor.elementPath(), editor) )editor.getCommand('ident-paragraph').setState(CKEDITOR.TRISTATE_ON);elseeditor.getCommand('ident-paragraph').setState(CKEDITOR.TRISTATE_OFF);});editor.addCommand("ident-paragraph", {allowedContent: 'p{text-indent}',requiredContent: 'p',exec: function(evt) {var range = editor.getSelection().getRanges()[0]; var walker = new CKEDITOR.dom.walker( range ),node;var state = editor.getCommand('ident-paragraph').state;while ( ( node = walker.next() ) ) {if ( node.type == CKEDITOR.NODE_ELEMENT ) {if(node.getName() === "p"){calculateAndDoFirstLineIndent();}}}if(node === null){node = editor.getSelection().getStartElement().getAscendant('p', true);calculateAndDoFirstLineIndent();}/*** 计算并处理首行缩进*/function calculateAndDoFirstLineIndent(){editor.fire('saveSnapshot');if( state == CKEDITOR.TRISTATE_ON){node.removeStyle("text-indent");editor.getCommand('ident-paragraph').setState(CKEDITOR.TRISTATE_OFF);}else{// 第一个是span，获取span标签var child_span = node.$.firstElementChild; if(child_span!=null){// 获取span里的 font-size属性的值var spanFontSize = child_span.style.fontSize;// 更改缩进量和缩进单位(缩进2个字体的空间)indentation = 2 * parseFloat(spanFontSize) + "px"; }node.setStyle( "text-indent", indentation );editor.getCommand('ident-paragraph').setState(CKEDITOR.TRISTATE_ON);}}}});}});

4. 下载项目

如果不想下载官网项目，下载后还需要单独下载插件，可直接从下面链接下载，包括常用的插件，项目拿来即用，如下：

ckeditor4(4.22.1-含上传图片、快速表格、首行缩进等插件).

5. word里有图片的问题（待解决）

4.1 问题描述

如果粘贴的word里有图片，复制之后图片不展示，如下：

5.1 查看自己的CKEditor4版本号

后续下载插件有的会根据CKEditor4的版本下载对应插件的版本号，所以先确定一下自己的版本号，在浏览器的控制台中输入命令即可查询，查询版本号的方式如下：
```
CKEDITOR
或
CKEDITOR.version
```

5.2 关于Paste from Word插件

5.2.1 下载Paste from Word插件

下载地址：
https://ckeditor.com/cke4/addon/pastefromword.
下载所需的所有依赖插件，如下：
关于Paste from Word插件，如下：

5.3 解压所有插件

解压所有插件并放到plugins目录下（已有的插件不用替换），如下
问题是：此插件无论怎么配置都不生效，把默认插件换成下载的插件之后重新配置还是不生效，不知道此插件啥情况！！！
参考官网配置如下：
https://ckeditor.com/docs/ckeditor4/latest/api/CKEDITOR_config.html#cfg-pasteFromWordRemoveFontStyles.
感兴趣的、用过的朋友可以交流一下！