此次接到一个需求,要在浏览器的IDE
中支持自定义提示功能,以下所示:php
能够看到,它能够根据用户输入的内容来一项一项排除,只显示彻底匹配的那一项。
项目的框架是Vue
,编辑器用的是Monaco Editor
。java
Monaco Editor
vscode
是咱们常常在用的编辑器,它的前身是微软的一个叫Monaco Workbench
的项目,而Monaco Editor
就是从这个项目中成长出来的一个web
编辑器,他们很大一部分的代码都是共用的,因此Monaco Editor
和VSCode
在编辑代码,交互及UI
上几乎是一摸同样的。不一样的是,二者的平台不同,Monaco Editor
基于浏览器,而VSCode
基于electron
,因此功能上VSCode
更加健全,性能比较强大。react
安装web
npm install monaco-editor --save
使用sql
<div id="monaco" class="monaco-editor"></div>
import * as monaco from 'monaco-editor'; this.fileEditor = this.monaco.editor.create(document.getElementById('monaco'), { value: null, language: 'sql' // 这里以sql为例 }) this.fileEditor.dispose(); // 使用完后销毁
这里引入monaco
要注意,在react
中如下面方式引入:npm
import * as monaco from 'monaco-editor/esm/vs/editor/editor.api';
查看了资料后,发如今monaco
中有提供一个提示功能的方法registerCompletionItemProvider
,具体实现以下:json
this.monaco.languages.registerCompletionItemProvider('sql', { // 这里以sql语言为例 provideCompletionItems () { return [{ label: '${_DB', // 显示的提示内容 kind: this.monaco.languages.CompletionItemKind['Function'], // 用来显示提示内容后的不一样的图标 insertText: '{_DB', // 选择后粘贴到编辑器中的文字 detail: '' // 提示内容后的说明 }]; }, triggerCharacters: ['$'] // 触发提示的字符,能够写多个 });
以上的用法,我试了一下以后发现,虽然triggerCharacters
的值是数组,能够有多个,可是里面的字符串只能识别一个字符。一开始的需求是输入${_
以后提示${_DB
,可是因为不能识别多个字符,只能作到出现$
就提示。api
还有一个问题就是registerCompletionItemProvider
的第一个参数只能是字符串,若是有多种语言只能叠加剧复写,恰巧个人需求是有多种语言,因此只能以下解决,也就是每种语言都写了一遍:数组
['json', 'yaml', 'php', 'go', 'sql', 'java', 'markdown', 'plaintext'].map(item => { this.monaco.languages.registerCompletionItemProvider(item, { provideCompletionItems () { return [{ label: '${_DB', kind: this.monaco.languages.CompletionItemKind['Function'], insertText: '{_DB', detail: '' }]; }, triggerCharacters: ['$'] }); });
需求是${_DB:key:value
,也就是说在输入${_DB
后,再输入一个:
提示出key
,在key
以后输入:
提示value
。浏览器
这里又碰到一个问题,须要知道当前输入的内容来判断是$
仍是:
,并且后面两个触发提示的符号同是:
,没法区分,只能经过识别:
的位置来判断是提示key
仍是value
,因此还要知道当前输入的:
以前的内容。
那么只有在provideCompletionItems
这一步判断,可是查遍了资料没有发现这样的参数,provideCompletionItems
只有model
、position
、token
这几个参数,后来发现model
中的getLineContent
方法能够获取指定行的全部内容,而position
能够获取当前输入行的行数和列数,因而就有了如下解决方法:
this.monaco.languages.registerCompletionItemProvider(item, { provideCompletionItems (model, position) { // 获取当前行数 const line = position.lineNumber // 获取当前列数 const column = position.column // 获取当前输入行的全部内容 const content = model.getLineContent(line) // 经过下标来获取当前光标后一个内容,即为刚输入的内容 const sym = content[column - 2] if (sym === '$') { return [{ label: '${_DB', kind: this.monaco.languages.CompletionItemKind['Function'], insertText: '{_DB', detail: '' }]; } return [{ label: ':abb', kind: this.monaco.languages.CompletionItemKind['Function'], insertText: 'abb', detail: '' }, { label: ':bc', kind: this.monaco.languages.CompletionItemKind['Function'], insertText: 'bc', detail: '' }]; }, triggerCharacters: ['$', ':'] });
能获取光标后的第一个内容,后面的内容就都能获取啦,若是识别到前面的内容是${_DB
就提示key
,不然提示value
。
最后总结下来就是必定要多看文档,勤于测试就能解决问题啦~
啦啦啦~ 交差去啦~