@dans98/vue-prism-editor
v0.5.2
Published
A dead simple code editor with syntax highlighting and line numbers.
Downloads
523
Readme
Vue Prism Editor
A dead simple code editor with syntax highlighting and line numbers. 7kb/gz
Demo
Examples
- Codesandbox: https://codesandbox.io/s/61yrlnlnmn
- Codepen: https://codepen.io/koca/pen/QVgqyR
Features
- Code Editing ^^
- Syntax highlighting
- Undo / Redo
- Copy / Paste
- The spaces/tabs of the previous line is preserved when a new line is added
- Works on mobile (thanks to contenteditable)
- Resize to parent width and height new
- Support for line numbers new
- Support for autosizing the editor new
- Autostyling the linenumbers(optional) new
Use Case
The goal of this project is to have a simple code editor. You can use to make small changes of some content or you just need a textarea with syntax highlighting. That's what it's good for. If you need an advanced code editor use Codemirror or Monaco Editor.
Install
npm install vue-prism-editor
or
yarn add vue-prism-editor
Usage
Register the component locally and use it (recommended)
<template>
<prism-editor :code="code" language="js"></prism-editor>
</template>
<script>
import PrismEditor from 'vue-prism-editor'
export default {
components: {
PrismEditor
}
}
</script>
Or register the component globally in main.js
import VuePrismEditor from "vue-prism-editor";
import "vue-prism-editor/dist/VuePrismEditor.css"; // import the styles
Vue.component("prism-editor", VuePrismEditor);
Browser usage:
<!-- vue-prism-editor JavaScript -->
<script src="https://unpkg.com/vue-prism-editor"></script>
<!-- vue-prism-editor CSS -->
<link rel="stylesheet" href="https://unpkg.com/vue-prism-editor/dist/VuePrismEditor.css">
<!-- use -->
<script>
Vue.component('vue-prism-editor', VuePrismEditor)
new Vue({
el: '#app'
})
</script>
Prismjs
This package won't install Prismjs. If you use Prismjs already skip this step. If not you need to load Prismjs somewhere in your app:
// yarn add prismjs
import "prismjs";
import "prismjs/themes/prism.css";
OR:
<link rel="stylesheet" href="https://unpkg.com/prismjs/themes/prism.css" />
<script src="https://unpkg.com/prismjs"></script>
Props
| Name | Type | Default | Options | Description |
| -------------------- | --------- | ------- | ------------------------------------ | ----------------------------------------------------- |
| v-model | string
| - | - | for the code
prop below |
| code | string
| ""
| - | the code |
| language | String
| "js"
| vue,html,md,ts
+ Prismjs Languages | language of the code |
| lineNumbers | Boolean
| false
| - | Whether to show line numbers or not |
| readonly | Boolean
| false
| - | Indicates if the editor is read only or not. |
| emitEvents | Boolean
| false
| - | Indicates if the editor should emit events. |
| autoStyleLineNumbers | Boolean
| true
| - | Allow the line number to be styled by this component. |
Events
| Name | Parameters | Description |
| ------ | ---------- | ------------------------------- |
| change | (code)
| Fires when the code is changed. |
The events below won't be fired unless you set the emitEvents
prop to true
.
| Name | Parameters | Description |
| ------------ | ---------- | --------------------------------------------------------------------------- |
| keydown | (event)
| This event is emitted when a keydown event happens in editor |
| keyup | (event)
| This event is emitted when a keyup event happens in editor |
| editor-click | (event)
| This event is emitted when clicking anywhere in the contenteditable editor |
Thanks
inspired by react-live.
License
MIT