# vue-json-pretty

> A JSON tree view component that is easy to use and also supports data selection.

Latest version **2.6.0** (published 2025-10-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install vue-json-pretty
pnpm add vue-json-pretty
yarn add vue-json-pretty
bun add vue-json-pretty
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 2.6.0 |
| Published | 2025-10-28 |
| First published | 2017-10-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >= 10.0.0 |
| Dependencies | 0 |
| Unpacked size | 130.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1471 |
| Author | leezng |
| Maintainers | leezng |
| Keywords | vue, json, format, pretty, vue-component |

## Links

- npm: https://www.npmjs.com/package/vue-json-pretty
- Repository: https://github.com/leezng/vue-json-pretty
- Homepage: https://leezng.github.io/vue-json-pretty
- Issues: https://github.com/leezng/vue-json-pretty/issues
- npm.io page: https://npm.io/package/vue-json-pretty

## Alternatives

- [@mapbox/jsonlint-lines-primitives](https://npm.io/package/@mapbox/jsonlint-lines-primitives.md) — 5.3M weekly downloads
- [reftools](https://npm.io/package/reftools.md) — 3.5M weekly downloads
- [@hey-api/openapi-ts](https://npm.io/package/@hey-api/openapi-ts.md) — 3.5M weekly downloads
- [@mapbox/geojson-rewind](https://npm.io/package/@mapbox/geojson-rewind.md) — 2.4M weekly downloads
- [turbo-stream](https://npm.io/package/turbo-stream.md) — 1.7M weekly downloads

## Recent versions

- 2.6.0 (latest) — 2025-10-28
- 1.9.5 (v1-latest) — 2023-12-12
- 2.5.0 — 2025-06-22
- 2.4.0 — 2024-03-20
- 2.4.0-beta.1 — 2024-03-05
- 2.3.0 — 2023-12-12
- 2.2.4 — 2023-03-22
- 1.9.4 — 2023-03-18
- 2.2.3 — 2022-11-02
- 1.9.3 — 2022-11-02
- 2.2.2 — 2022-08-28
- 1.9.2 — 2022-08-28
- 2.2.1 — 2022-08-26
- 1.9.1 — 2022-08-19
- 2.2.0 — 2022-08-16
- … 44 more at https://npm.io/package/vue-json-pretty/versions

## README

<p align="center">
  <a href="https://github.com/leezng/vue-json-pretty">
    <img width="200" src="./static/logo.svg">
  </a>
</p>

<h1 align="center">
  <a href="https://github.com/leezng/vue-json-pretty" target="_blank">Vue Json Pretty</a>
</h1>

<div align="center">

<p>A Vue component for rendering JSON data as a tree structure.</p>
<p>Now it supports Vue3 at least. If you still use Vue2, see <a href="https://github.com/leezng/vue-json-pretty/tree/1.x">1.x</a>.</p>

[![Build Status](https://travis-ci.org/leezng/vue-json-pretty.svg?branch=master)](https://travis-ci.org/leezng/vue-json-pretty)
[![npm package](https://img.shields.io/npm/v/vue-json-pretty.svg)](https://www.npmjs.org/package/vue-json-pretty)
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/leezng/vue-json-pretty/blob/master/LICENSE)
[![Sizes](https://img.shields.io/bundlephobia/min/vue-json-pretty)](https://bundlephobia.com/result?p=vue-json-pretty)
[![NPM downloads](http://img.shields.io/npm/dm/vue-json-pretty.svg?style=flat-square)](https://www.npmtrends.com/vue-json-pretty)
[![Issues](https://img.shields.io/github/issues-raw/leezng/vue-json-pretty)](https://github.com/leezng/vue-json-pretty/issues)

</div>

[![](./static/screenshot.png)](https://github.com/leezng/vue-json-pretty)

English | [简体中文](./README.zh_CN.md)

## Features

- As a JSON Formatter.
- Written in TypeScript, support `d.ts`.
- Support get item data from JSON.
- Support big data.
- Support editable.

## Environment Support

- Modern browsers, Electron and Internet Explorer 11 (with polyfills)
- Server-side Rendering

| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="IE / Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE / Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/electron/electron_48x48.png" alt="Electron" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Electron |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| IE11, Edge                                                                                                                                                                                                      | last 10 versions                                                                                                                                                                                                  | last 10 versions                                                                                                                                                                                              | last 10 versions                                                                                                                                                                                              | last 2 versions                                                                                                                                                                                                       |

## Using NPM or Yarn

```bash
$ npm install vue-json-pretty --save
```

```bash
$ yarn add vue-json-pretty
```

## Use Vue2

```bash
$ npm install vue-json-pretty@v1-latest --save
```

## Usage

The CSS file is included separately and needs to be imported manually. You can either import CSS globally in your app (if supported by your framework) or directly from the component.

```vue
<template>
  <div>
    <vue-json-pretty :data="{ key: 'value' }" />
  </div>
</template>

<script>
import VueJsonPretty from 'vue-json-pretty';
import 'vue-json-pretty/lib/styles.css';

export default {
  components: {
    VueJsonPretty,
  },
};
</script>
```

## Use Nuxt.js

1. In `plugins/vue-json-pretty.js`

```
import Vue from 'vue'
import VueJsonPretty from 'vue-json-pretty'

Vue.component("vue-json-pretty", VueJsonPretty)
```

2. In `nuxt.config.js`

```js
css: [
  'vue-json-pretty/lib/styles.css'
],
plugins: [
  '@/plugins/vue-json-pretty'
],
```

## Props

| Property                 | Description                                                                                                             | Type                                           | Default |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | ------- |
| data(v-model)            | JSON data, support v-model when use editable                                                                            | JSON object                                    | -       |
| indent                   | JSON indent                                                                                                             | number                                         | 2       |
| collapsedNodeLength      | Objects or arrays which length is greater than this threshold will be collapsed                                         | number                                         | -       |
| deep                     | Paths greater than this depth will be collapsed                                                                         | number                                         | -       |
| showLength               | Show the length when collapsed                                                                                          | boolean                                        | false   |
| showLine                 | Show the line                                                                                                           | boolean                                        | true    |
| showLineNumber           | Show the line number                                                                                                    | boolean                                        | false   |
| showIcon                 | Show the icon                                                                                                           | boolean                                        | false   |
| showDoubleQuotes         | Show doublequotes on key                                                                                                | boolean                                        | true    |
| virtual                  | Use virtual scroll                                                                                                      | boolean                                        | false   |
| height                   | The height of list when using virtual                                                                                   | number                                         | 400     |
| itemHeight               | Fixed row height when using virtual (Estimated row height used before measurement when `dynamicHeight` is true)         | number                                         | 20      |
| dynamicHeight            | Enable dynamic row heights (measured per row)                                                                           | boolean                                        | true    |
| selectedValue(v-model)   | Selected data path                                                                                                      | string, array                                  | -       |
| rootPath                 | Root data path                                                                                                          | string                                         | `root`  |
| nodeSelectable           | Defines whether a node supports selection                                                                               | (node) => boolean                              | -       |
| selectableType           | Support path select, default none                                                                                       | `multiple` \| `single`                         | -       |
| showSelectController     | Show the select controller                                                                                              | boolean                                        | false   |
| selectOnClickNode        | Trigger select when click node                                                                                          | boolean                                        | true    |
| highlightSelectedNode    | Support highlighting selected nodes                                                                                     | boolean                                        | true    |
| collapsedOnClickBrackets | Support click brackets to collapse                                                                                      | boolean                                        | true    |
| renderNodeKey            | render node key, or use slot #renderNodeKey                                                                             | ({ node, defaultKey }) => vNode                | -       |
| renderNodeValue          | render node value, or use slot #renderNodeValue                                                                         | ({ node, defaultValue }) => vNode              | -       |
| renderNodeActions        | render node actions, or use slot #renderNodeActions                                                                     | boolean \| ({ node, defaultActions }) => vNode | false   |
| editable                 | Support editable                                                                                                        | boolean                                        | false   |
| editableTrigger          | Trigger                                                                                                                 | `click` \| `dblclick`                          | `click` |
| theme                    | Sets the theme of the component. Options are 'light' or 'dark', with dark mode enhancing visibility on dark backgrounds | `'light' \| 'dark'`                            | `light` |

## Events

| Event Name     | Description                              | Parameters                           |
| -------------- | ---------------------------------------- | ------------------------------------ |
| nodeClick      | triggers when click node                 | (node: NodeData)                     |
| nodeMouseover  | triggers when mouseover node             | (node: NodeData)                     |
| bracketsClick  | triggers when click brackets             | (collapsed: boolean, node: NodeData) |
| iconClick      | triggers when click icon                 | (collapsed: boolean, node: NodeData) |
| selectedChange | triggers when the selected value changed | (newVal, oldVal)                     |

## Slots

| Slot Name         | Description         | Parameters                                     |       |
| ----------------- | ------------------- | ---------------------------------------------- | ----- |
| renderNodeKey     | render node key     | { node, defaultKey }                           |       |
| renderNodeValue   | render node value   | { node, defaultValue }                         |       |
| renderNodeActions | render node actions | boolean \| ({ node, defaultActions }) => vNode | false |

## Contributors

<a href="https://github.com/leezng/vue-json-pretty/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=leezng/vue-json-pretty" />
</a>

---
_Source: https://npm.io/package/vue-json-pretty · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._