Skip to content

Configuration

Reference for the data-visor-vue DataVisor component. Extension-specific behavior is documented under Web extension.

The DataVisor component accepts several props for customization.

Props Reference

NameTypeDefaultDescription
datastring-Serialized document text (JSON, YAML, or XML) to display.
lang'json' | 'yaml' | 'xml''json'Format of the data string.
v-model:display-mode'tree' | 'minified' | 'fractured''tree'Optional two-way binding. tree shows the expandable tree; minified shows the whole document as compact highlighted source; fractured (JSON only) shows FracturedJson-formatted text with Shiki highlighting. The toolbar includes Tree | Minified and Fractured when lang is json. Without v-model, the mode is kept inside the component (e.g. docs examples). In minified and fractured, the main expand/collapse, depth, and search controls are disabled. In fractured, move the mouse over the source: the breadcrumb shows the path for the line under the cursor. Per-node copy/expand actions are only available in tree view (not in fractured). Search within stays disabled in fractured (no tree rows).
darkThemeShikiTheme'github-dark'Shiki theme for dark mode.
lightThemeShikiTheme'github-light'Shiki theme for light mode.
isDarkbooleanfalseWhether to use the dark theme.
maxHeightstring'600px'Maximum height of the viewer (e.g., '500px', 'none', 'auto').
minHeightstring-Minimum height of the viewer.
initialDepthnumber2Initial expansion depth.
showLineNumbersbooleantrueWhether to show line numbers.
showToolbarbooleantrueWhether to show the top toolbar.
showBreadcrumbbooleantrueWhether to show the breadcrumb at the bottom.

CSS variables

The viewer sets custom properties on the inner root (.dv-viewer) for theme colors and intrinsic list height:

VariablePurpose
--dv-bgBackground color (from the active Shiki theme).
--dv-fgForeground / text color.
--dv-list-min-heightUsed when max-height is intrinsic (none / auto / …) so the list matches content height.

All public class names use the dv- prefix (e.g. .dv-viewer-wrap, .dv-row).

Shortcuts

DataVisor supports several keyboard shortcuts for efficient navigation:

  • CTRL+F: Open search.
  • CTRL+] or CTRL+SHIFT++: Expand all (the + key on the main keyboard or numpad).
  • CTRL+[ or CTRL+SHIFT+-: Collapse all (the - key on the main keyboard or numpad).
  • CTRL+SHIFT+* followed by 0-9: Expand to specific level (Keyboard chord).
  • F3 / SHIFT+F3: Next / Previous search match.
  • ESC: Close search or cancel keyboard chord.