CodeMirror 使用方法
初步建立步骤
- npm install codemirror下载组件
- 引入核心配置包
import * as CodeMirror from 'codemirror/lib/codemirror' import 'codemirror/lib/codemirror.css'
3.引入后在html界面中建立textarea标签,用于生成代码框
<textarea class="form-control" id="code" name="code"></textarea>
4.根据textarea的id获取到标签元素,将容器转换为编辑器
let myTextarea = document.getElementById('editor'); this.CodeMirrorEditor = CodeMirror.fromTextArea(myTextarea, { mode:'javascript'//编辑器语言 theme:'monokai', //编辑器主题 extraKeys: {"Ctrl": "autocomplete"},//ctrl可以弹出选择项 lineNumbers: true//显示行号 });
5.根据设置的主题,引入相应的主题包,主题包存储在theme下,使用其他主题包时设置option中theme为对应主题
import 'codemirror/theme/monokai.css'
6.根据设置的编辑器语言,引入相应工具包,以下为常用语言包
import 'codemirror/mode/javascript/javascript' import 'codemirror/mode/clike/clike' import 'codemirror/mode/go/go' import 'codemirror/mode/htmlmixed/htmlmixed' import 'codemirror/mode/http/http' import 'codemirror/mode/php/php' import 'codemirror/mode/python/python' import 'codemirror/mode/http/http' import 'codemirror/mode/sql/sql' import 'codemirror/mode/vue/vue' import 'codemirror/mode/xml/xml'
7.初始化编译器时可设置属性:
- value:初始内容
- Mode:设置编译器编程语言关联内容,对应的mine值
- Theme:编译器的主题,需要引入对应的包
- tabSize:tab的空格宽度
- lineNumbers:是否使用行号
- smartIndent:自动缩进是否开启
- indentUnit:缩进单位
- keyMap:快捷键,default使用默认快捷键,除此之外包括emacs,sublime,vim快捷键,使用需引入工具
import codemirror/keymap/sublime.js import codemirror/keymap/emacs.js import codemirror/keymap/vim.js
- extraKeys 快捷键,例如 {“Ctrl-Q”: “autocomplete”}:自动补全使用需要引入工具:
import 'codemirror/addon/hint/show-hint' import 'codemirror/addon/hint/javascript-hint' import 'codemirror/addon/hint/sql-hint' import 'codemirror/addon/hint/html-hint' import 'codemirror/addon/hint/xml-hint' import 'codemirror/addon/hint/anyword-hint' import 'codemirror/addon/hint/css-hint' import 'codemirror/addon/hint/show-hint'
extraKeys的快捷键绑定命令:
- selectAllCtrl-A :选择编辑器的全部内容。
- killLine:Emacs式的清除行。用于删除行内光标后的内容。如果只包含空白字符,行尾的新行(应该是指换行 字符)也会被删除。
- deleteLine :删除光标所在整行,包括行尾的新行。
- delLineLeft:删除行内光标前的内容。
- delWrappedLineLeft:删除光标所在可见行左边到光标处的部分。(这里是针对在行内有换行显示的情况,也就是说可能不是一行全部处理,而是只处理行的一部分)
- delWrappedLineRight:删除光标所在可见行光标处到右边的部分。(同上)
- undo:撤消最后一次更改。
- redo:重做最后一次撤消更改。
- undoSelection:撤消最后一次选择的更改,如果没有选择更改,那么就撤消最后一次文本更改。
- redoSelection:重做最后一次选择的更改,如果没有选择更改,那么就重做最后一次文本更改。
- goDocStart:移动光标到文档开始处。
- goDocEnd:移动光标到文档结束处。
- goLineStart:移动光标到行开始处。
- goLineStartSmartHome:移动光标到行文字开始处,如果光标已经在那,那么就移动到行的真正开始处。
- goLineEnd:移动光标到行结束处。
- goLineRight:移动光标到可见行右边。
- goLineLeft:移动光标到可见行左边。如果行内有换行,那么可能不会移动到行开始处。
- goLineLeftSmart:移动光标到行文字开始处,如果光标已经在那,那么就移动到行的真正开始处。
- goLineUp:移动光标到上一行。
- goLineDown:移动光标到下一行。
- goPageUp:移动光标到上一屏,(每次)向上滚动相同距离。
- goPageDown:移动光标到下一屏,(每次)向下滚动相同距离。
- goCharLeft:光标向左移动一个字符,如果在光标行首,那么移动到前一行。
- goCharRight:光标向右移动一个字符,如果在光标行尾,那么移动到后一行。
- goColumnLeft:光标向左移动一个字符,但是不会超过行边界。
- goColumnRight:光标向右移动一个字符,但是不会超过行边界。
- goWordLeft:光标移动到前一个词开始处。
- goWordRight:光标移动到后一个词结束处。
- goGroupLeft:移动光标到光标前的组的左边。组是词的扩展,扩展到标点符号,新行或者是多个空白字符。
- goGroupRight:移动光标到光标后的组的右边。组是词的扩展,扩展到标点符号,新行或者是多个空白字符。
- delCharBefore:删除光标前的一个字符。
- delCharAfter:删除光标后的一个字符。
- delWordBefore:删除光标前的一个词。
- delWordAfter:删除光标后的一个词。
- delGroupBefore:删除光标前的一个组。
- delGroupAfter:删除光标后的一个组。
- indentAuto:自动缩进当前行或选中行。
- indentMore:缩进当前行或选中行一个缩进单位。
- indentLess:反缩进当前行或选中行一个缩进单位。(移除一个缩进单元)
- insertTab:在光标处插入Tab字符。
- insertSoftTab:在光标处插入与Tab字符等宽的空格字符。
- defaultTabTab:如果有选中行,则缩进一个缩进单位;如果没有选择行,则插入一个Tab字符。
- transposeChars:交换光标前后的字符。
- newlineAndIndentEnter:插入新行并且自动缩进。
- toggleOverwriteInsert:反转overwrite标志。
- save:只存在快捷键中,核心库未定义。这是为了给用户编码提供一个简单的方法来定义保存命令。
- find:查找。
- findNext:向前查找。
- findPrev:向后查找。
- replace:替换。
- replaceAll:全部替换。
- scrollbarStyle: 设置滚动条,默认为"null"为不显示的滚动条,可以使用提供的其他滚动条:“simple”,"overlay"选择内侧与外侧的滚动条,使用需引入以下工具包:
import 'codemirror/addon/scroll/simplescrollbars.css' import 'codemirror/addon/scroll/simplescrollbars'
- readOnly:设置为只读true/false;也可设置为"nocursor"失去焦点
- Autofocus:初始时是否自动获取焦点boolean
- styleActiveLine: 设置光标所在行高亮true/false,需引入工具包:
import 'codemirror/addon/selection/active-line'
8.动态设置CodeMirror属性:(以设置支持语言mode为例)
this.CodeMirrorEditor.setOption("mode",this.something)
编译器的事件触发器
触发器使用方法:(change事件为例)
this.CodeMirrorEditor.on("change",function(){ //事件触发后执行事件 alert("change") });
取消触发器方法:
this.CodeMirrorEditor.off("change")
- “changes”:每次编辑器内容更改时触发
- “beforeChange”:事件在更改生效前触发
- “cursorActivity”:当光标或选中(内容)发生变化,或者编辑器的内容发生了更改的时候触发。
- “keyHandled”:快捷键映射(key map)中的快捷键被处理(handle)后触发
- “inputRead”:当用户输入或粘贴时编辑器时触发。
- “electrictInput”:收到指定的electrict输入时触发
- “beforeSelectionChange”:此事件在选中内容变化前触发
- “viewportChange”:编辑器的视口( view port )改变(滚动,编辑或其它动作)时触发
- “gutterClick”:编辑器的gutter(行号区域)点击时触发
- “focus”:编辑器收到焦点时触发
- “blur”:编辑器失去焦点时触发
- “scroll”:编辑器滚动条滚动时触发
- “keydown”, “keypress”, “keyup”,“mousedown”, “dblclick”硬件事件触发器
API
- this.CodeMirrorEditor.setValue(“Hello Kitty”):设置编辑器内容
- this.CodeMirrorEditor.getValue():获取编辑器内容
- this.CodeMirrorEditor.getLine(n):获取第n行的内容
- this.CodeMirrorEditor.lineCount():获取当前行数
- this.CodeMirrorEditor.lastLine():获取最后一行的行号
- this.CodeMirrorEditor.isClean():boolean类型判断编译器是否是clean的
- this.CodeMirrorEditor.getSelection():获取选中内容
- this.CodeMirrorEditor.getSelections():返回array类型选中内容
- this.CodeMirrorEditor.replaceSelection(“替换后的内容”):替换选中的内容
- this.CodeMirrorEditor.getCursor():获取光标位置,返回{line,char}
- this.CodeMirrorEditor.setOption("",""):设置编译器属性
- this.CodeMirrorEditor.getOption(""):获取编译器属性
- this.CodeMirrorEditor.addKeyMap("",""):添加key-map键值,该键值具有比原来键值更高的优先级
- this.CodeMirrorEditor.removeKeyMap(""):移除key-map
- this.CodeMirrorEditor.addOverlay(""):Enable a highlighting overlay…没试出效果
- this.CodeMirrorEditor.removeOverlay(""):移除Overlay
- this.CodeMirrorEditor.setSize(width,height):设置编译器大小
- this.CodeMirrorEditor.scrollTo(x,y):设置scroll到position位置
- this.CodeMirrorEditor.refresh():刷新编辑器
- this.CodeMirrorEditor.execCommand(“命令”):执行命令
效果图:(和编辑器好像啊)
实现代码:
setting.ts
import Vue from 'vue' import { Component, Prop, Watch} from 'vue-property-decorator' import * as WithRender from './setting.html?style=./setting.less' import * as CodeMirror from 'codemirror/lib/codemirror' import 'codemirror/theme/monokai.css' import 'codemirror/lib/codemirror.css' import 'codemirror/mode/javascript/javascript' import 'codemirror/mode/clike/clike' import 'codemirror/mode/go/go' import 'codemirror/mode/htmlmixed/htmlmixed' import 'codemirror/mode/http/http' import 'codemirror/mode/php/php' import 'codemirror/mode/python/python' import 'codemirror/mode/http/http' import 'codemirror/mode/sql/sql' import 'codemirror/mode/vue/vue' import 'codemirror/mode/xml/xml' import 'codemirror/addon/scroll/simplescrollbars.css' import 'codemirror/addon/scroll/simplescrollbars' import 'codemirror/addon/hint/show-hint' import 'codemirror/addon/hint/javascript-hint' import 'codemirror/addon/hint/sql-hint' import 'codemirror/addon/hint/html-hint' import 'codemirror/addon/hint/xml-hint' import 'codemirror/addon/hint/anyword-hint' import 'codemirror/addon/hint/css-hint' import 'codemirror/addon/hint/show-hint.css' import 'codemirror/addon/fold/markdown-fold' import 'codemirror/mode/meta' import "codemirror/addon/fold/foldgutter.css" import "codemirror/addon/fold/foldcode" import "codemirror/addon/fold/brace-fold" import 'codemirror/addon/selection/active-line' @WithRender @Component export class Setting extends Vue{ nameArray=new Array(); modeArray=new Array(); mapArray=new Array(); CodeMirrorEditor; something=""; mounted(){ console.log(CodeMirror) for(var i=0;i{ this.CodeMirrorEditor.setOption("mode",this.something) } } setmirror(){ let myTextarea = document.getElementById('editor'); this.CodeMirrorEditor = CodeMirror.fromTextArea(myTextarea, { theme:'monokai', styleActiveLine: true, mode:'javascript', extraKeys: {"Ctrl": "autocomplete"},//输入s然后ctrl就可以弹出选择项 // lineNumbers: true, tabSize:10, // readOnly:"nocursor", smartIndent:true, scrollbarStyle:"overlay" // keymap:"defaule" }); // this.CodeMirrorEditor.setOption('lineWrapping', true); this.CodeMirrorEditor.on("keypress",() =>{ //编译器内容更改事件 console.log(this.CodeMirrorEditor) this.CodeMirrorEditor.showHint(); }); this.CodeMirrorEditor.setValue("Hello Kitty\nHello Tony\nHow are you\nFine thank you and you \nI love you") this.CodeMirrorEditor.setOption("lineNumbers","true") // this.CodeMirrorEditor.addOverlay("coconut"); // this.CodeMirrorEditor.markText({line:0,ch:0},{line:0,ch:0}) this.CodeMirrorEditor.setBookmark({line:0,ch:0},{line:0,ch:1},{readOnly:true}); this.CodeMirrorEditor.setCursor(0) this.CodeMirrorEditor.setSize(600,600) } }
setting.less
.setting{ margin: 0; width: 1398px; height: 600px; background-color: rgb(248, 248, 248); h1{ margin: 0; } }