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.