0.0.1 • Published 4 years ago

@boldarialblack/code-editor v0.0.1

Weekly downloads
1
License
MIT
Repository
github
Last release
4 years ago

code-editor

一个默认支持美化、高亮、报错、格式化、注释、补全、缩放的代码编辑器(sql为默认语言),主体基于Vue和CodeMirror等。

Install

npm install code-editor -S

Quick Start

import Vue from 'vue'
import CodeEditor from 'code-editor'
# Vue.component('code-editor', CodeEditor) # 可以指定组件名称
Vue.use(CodeEditor) # 组件名称 `code-editor`

For more information, please refer to CodeEditor in our documentation.

Build Setup

# install dependencies
npm install

# serve with hot reload at localhost:8080
npm run dev

# build for demo with minification
npm run demo:build

# build for gh-pages with minification
npm run demo:prepublish

# build for production with minification
npm run build

# generate gh-pages
npm run deploy

LICENSE

MIT

截图

截图

基本用法

<template>
  <div class="vd-demo__block vd-demo__block-2">
    <div style="display: flex">
      <el-button @click="addHintList">
        添加补全内容
      </el-button>
      <el-button @click="getSelection">
        获取选中文本
      </el-button>
      <span>选中: {{ selection || '-' }}</span>
    </div>
    <code-editor
      ref="editor"
      v-model="value"
      :context-options="[{label: 'test', method: test}]"
      :events="['contextmenu', 'blur']"
      :hint-list="hintList"
      context-append-to-body
      @blur="blur"
      @ready="ready"
    />
  </div>
</template>
<script>
// 可单独引入外部sqlLint语法检查插件
/* import { Parser } from 'node-sql-parser';
window.sqlLint = new Parser();  */
/* 也支持dt-sql-parser
import { parser } from 'dt-sql-parser';
window.sqlLint = parser;
*/

  export default {
    data () {
      return {
        value: 'SELECT * FRO \'test_table\'',
        hintList: {},
        selection: ''
      }
    },
    methods: {
      test() {
        console.log('test');
      },
      ready() {
        console.log('ready');
      },
      blur() {
        console.log('blur');
      },
      addHintList() {
        this.hintList[`hint${Object.keys(this.hintList).length + 1}`] = [];
      },
      getSelection() {
        this.selection = this.$refs.editor.getSelection();
      }
    }
  }
</script>

CodeEditor props

参数说明类型可选值默认值
value绑定值String/Array--
optionscodemirror options选项,具体可以参考codemirror 的文档Object-见下文
events除默认监听事件外(changes,beforeChange,scroll),额外监听的事件,具体可以参考vue-codemirrorcodemirror的文档Array-'contextmenu'
hint-list补全内容的数据源Object--
sizeable是否可以进行编辑区放大缩小Boolean-true
context-menu是否开启右键菜单自定义Boolean-true
context-options未选中文本时右键菜单选项Array--
selected-context-options选中文本时右键菜单选项Array--
formatable右键菜单选项是否有格式化/格式化选中选项Boolean-true
commentable右键菜单选项是否有切换注释/切换注释选中选项,如未引入codemirror/addon/comment/comment则自动隐藏Boolean-true
format-text右键菜单格式化/格式化选中选项文案String-格式化
comment-text右键菜单切换注释/切换注释选中选项文案String-切换注释
z-index右键菜单的z-index属性Number-30000
context-append-to-body右键菜单是否挂载在body上Boolean-false
line-comment注释的前缀符号String---
sql-lint是否对输入内容进行sql语法检查,sqlLint插件支持外部引入(如node-sql-parser/dt-sql-parser)Boolean-true
propscodemirror配置选项,具体可以参考code-mirror 的文档Object--
mask-propsmask配置选项,具体可以参考 gs-mask 的文档Object--
hint-propscodemirror中showHint函数传参选项,具体可以参考 codemirror 的文档Object--

CodeEditor Methods

方法名说明参数
refresh刷新编辑器-
getSelection获取编辑器选中文本-

CodeEditor events(除编辑器监听事件外)

事件名称说明回调参数
ready编辑框初始化完成事件codemirror
visible-changemask遮罩(放大/缩小)变化事件true/false
on-context-menu编辑框内点击右键事件instance, event, gutter, line
menu-content-click非浏览器默认右键菜单选中事件method, selection

CodeEditor slot

名称说明
-右键菜单

CodeEditor options 默认值

  tabSize: 4,
  styleActiveLine: true,
  lineNumbers: true,
  line: true,
  extraKeys: {
    'Tab': 'autocomplete',
    'Ctrl-/': this.toggleComment
  },
  mode: 'text/x-mysql',
  addOverlay: 'text/x-mysql',
  gutters: ['CodeMirror-lint-markers'],
  lint: this.sqlLint,
  matchBrackets: true,
  hintOptions: {
    completeSingle: false,
    tables: this.hintList
  },
  delay: 700

CodeEditor 语法检查(实验)

目前要对输入进行语法检查有两种方法:

外部插件检查

用法: 1. 引入报错js:import 'codemirror/addon/lint/lint';import 'code-editor/lint/sql-lint';2. 安装选择的语法检查插件(目前明确支持的有node-sql-parserdt-sql-parser`插件),并且引入后将window.sqlLint配置

Demo:

import 'codemirror/addon/lint/lint';
import 'code-editor/lint/sql';

// 按需引入sqlLint语法检查插件
import { Parser } from 'node-sql-parser';
window.sqlLint = new Parser();
/* 也支持dt-sql-parser
import { parser } from 'dt-sql-parser';
window.sqlLint = parser;
*/
内部工具检查(Deprecated)

已修改为默认检查,无需单独 1. 引入语法检查js:import 'code-editor/parser/sql';import 'code-editor/parser/hive'; 2. 引入报错js:import 'codemirror/addon/lint/lint';import 'code-editor/lint/sql';