vue-diff

Vue diff viewer plugin for Vue@3
demo

Table of Contents

- Table of Contents
- Introduction
- Features
- Install plugin
- Options
- Usage diff viewer
- Settings with default props
- Settings with full props
- Props
- Custom theme
- Extend languages
- Default supported languages and values
- Virtual scroll
- Object props

Introduction

You can see the difference between the two codes with the vue-diff plugin.
This plugin dependent on diff-match-patch and highlight.js, shows similar results to other diff viewers (e.g., Github Desktop).
Here is the demo

Features

- Support split / unified mode
- Support multiple languages and can be extended
- Support two themes (dark / light) and can be customized
- Virtual scroll for large text comparison
- Folding view (_Partial folding is not supported_)
- Support typescript

Install plugin

``bash
npm install vue-diff
`

And install plugin in vue application

`ts
import VueDiff from 'vue-diff';

import 'vue-diff/dist/index.css';

app.use(VueDiff);
`

$3

`ts
app.use(VueDiff, {
componentName: 'VueDiff',
});
`

| name | type | detault | description |
| ------------- | -------- | ------- | -------------------------- |
| componentName | string | Diff | Global diff component name |

Usage diff viewer

Insert the diff component with props.

$3

`vue

`

$3

`vue

`

$3

| name | type | detault | values | description |
| ------------- | ----------------- | ----------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| mode | string | split | split, unified |
| theme | string | dark | dark, light, custom${string} | See Custom theme |
| language | string | plaintext | | See Extend languages |
| prev | string | '' | | Prev code |
| current | string | '' | | Current Code |
| folding | boolean | false | | Folding not different |
| inputDelay | number | 0 | | Setting up rendering debounce for changes for performance benefit (mode, prev, curr) |
| virtualScroll | boolean\|object | false | | _Default value when setting true :_
{ height: 500, lineMinHeight: 24, delay: 100 }
See virtual scroll |

Custom theme

vue-diff uses the following highlight.js themes and can be customized.

- dark: highlight.js/scss/monokai.scss
- light: highlight.js/scss/vs.scss

`bash
npm install highlight.js
`

`vue



`

Extend languages

vue-diff supports the following languages and can be extended through highlight.js language registration.

$3

- css
- xml: xml, html, xhtml, rss, atom, xjb, xsd, xsl, plist, svg
- markdown: markdown, md, mkdown, mkd
- javascript: javascript, js, jsx
- json
- plaintext: plaintext, txt, text
- typescript: typescript, ts

`bash
npm install highlight.js
`

`ts
import VueDiff from 'vue-diff';
import 'vue-diff/dist/index.css';

// extend yaml language
import yaml from 'highlight.js/lib/languages/yaml';

VueDiff.hljs.registerLanguage('yaml', yaml);

app.use(VueDiff);
`

> Check supported languages of Highlight.js

Virtual scroll

Comparing text from many lines can slow down performance.

With virtualScroll props, virtualScroll applies. (Self-made for this plug-in.)

#### Object property value

When using virtual scroll, the css of all code lines is changed to the absolute position, which requires detailed settings.

- height (number): Diff box height (Applies only to px values)
- lineMinHeight (number): minimum height of line
> Minimum height value of line is required for visible area calculation.
The default is 24, but you can set it yourself if you need to adjust it according to the page's front-size, line-height, etc.
- delay (number`): re-rendering delay when scrolling or resizing
> Performance problems occur when too often a re-rendering function is invoked based on scrolling or resizing
This setting applies a delay using throttle.