Monaco Editor编辑器的使用

摘要:vscode是我们经常在用的编辑器,它的前身是微软的一个叫Monaco Workbench的项目,而Monaco Editor就是从这个项目中成长出来的一个web编辑器,他们很大一部分的代码都是共用的

什么是Monaco Editor

vscode是我们经常在用的编辑器,它的前身是微软的一个叫Monaco Workbench的项目,而Monaco Editor就是从这个项目中成长出来的一个web编辑器,他们很大一部分的代码都是共用的,所以Monaco Editor和VSCode在编辑代码,交互及UI上几乎是一摸一样的。不同的是,两者的平台不一样,Monaco Editor基于浏览器,而VSCode基于electron,所以功能上VSCode更加健全,性能比较强大。


用法

安装

npm install monaco-editor --save

使用

<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中以下面方式引入:

import * as monaco from 'monaco-editor/esm/vs/editor/editor.api';


实现自定义提示功能

查看了资料后,发现在monaco中有提供一个提示功能的方法registerCompletionItemProvider,具体实现如下:

this.monaco.languages.registerCompletionItemProvider('sql', { // 这里以sql语言为例
  provideCompletionItems () {
    return [{
      label: '${_DB',  // 显示的提示内容
      kind: this.monaco.languages.CompletionItemKind['Function'], // 用来显示提示内容后的不同的图标
      insertText: '{_DB', // 选择后粘贴到编辑器中的文字
      detail: '' // 提示内容后的说明
    }];
  },
  triggerCharacters: ['$'] // 触发提示的字符,可以写多个
});

以上的用法,我试了一下之后发现,虽然triggerCharacters的值是数组,可以有多个,但是里面的字符串只能识别一个字符。一开始的需求是输入${_之后提示${_DB,但是由于不能识别多个字符,只能做到出现$就提示。

还有一个问题就是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。


本文内容仅供个人学习、研究或参考使用,不构成任何形式的决策建议、专业指导或法律依据。未经授权,禁止任何单位或个人以商业售卖、虚假宣传、侵权传播等非学习研究目的使用本文内容。如需分享或转载,请保留原文来源信息,不得篡改、删减内容或侵犯相关权益。感谢您的理解与支持!

链接: https://shenqiku.cn/article/FLY_4033