Giter Club home page Giter Club logo

vue-diff's Introduction

vue-diff

Vue diff viewer plugin for Vue@3
demo

Table of Contents

Introduction

screenshot

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

npm install vue-diff

And install plugin in vue application

import VueDiff from 'vue-diff';

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

app.use(VueDiff);

Options

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.

Settings with default props

<template>
  <!-- If the changed componentName
  <VueDiff>
  -->
  <Diff
    :mode="mode"
    :theme="theme"
    :language="language"
    :prev="prev"
    :current="current"
  />
</template>

Settings with full props

<template>
  <Diff
    :mode="mode"
    :theme="theme"
    :language="language"
    :prev="prev"
    :current="current"
    :folding="folding"
    :input-delay="0"
    :virtual-scroll="{ height: 500, lineMinHeight: 24, delay: 100 }"
  />
</template>

Props

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
npm install highlight.js
<template>
  <Diff
    :mode="mode"
    <!-- Characters that begin with custom -->
    theme="custom"
    :language="language"
    :prev="prev"
    :current="current"
  />
</template>

<style lang="scss">
.vue-diff-theme-custom {
  @import 'highlight.js/scss/vs2015.scss'; // import theme

  background-color: #000; // Set background color
}
</style>

Extend languages

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

Default supported languages and values

  • 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
npm install highlight.js
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.

vue-diff's People

Contributors

hoiheart avatar semantic-release-bot avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.