---
url: "https://vueda.dev/v3/reference/api/vue/WidgetPreviewableTemplate.md"
title: "WidgetPreviewableTemplate"
---

# WidgetPreviewableTemplate

## Overview

A widget that combines an editable input (HTML editor, plain input, or textarea) with a live
preview pane that substitutes `$variable` placeholders using dependency data.

Theme entry: [WidgetPreviewableTemplate](/v3/reference/theming/keys/WidgetPreviewableTemplate.md)

## Props

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| <span id="prop-themeOverride">themeOverride</span> | `Object` |  | `null` | A partial ThemeObject keyed by component name, merged over this component's theme and provided to descendants. |
| <span id="prop-type">type</span> | `string` |  | `"editor"` | The editor variant to render: `"editor"` (rich HTML), `"input"` (single-line), or `"textarea"`. |
| <span id="prop-modelValue">modelValue</span> | `string\|number\|array` |  | `undefined` | The current value of the template text. |
| <span id="prop-displayDependencies">displayDependencies</span> | `array` |  | `[]` | Additional widget dependency keys whose values are made available for placeholder substitution. |
| <span id="prop-tagsKey">tagsKey</span> | `string` |  | `"preview_tag_data"` | The dependency key whose value supplies the tag substitution data for the preview. |

## Slots

### `extra-legend` {#slot-extra-legend}

Scoped slot.

#### Bindings

| Name | Description |
| --- | --- |
| <span id="slot-extra-legend-param-displayDependencies">displayDependencies</span> |  |

## Events

| Name | Description |
| --- | --- |
| `update:modelValue` | Emitted when the widget value changes. |

[Full event reference](/v3/reference/api/vue/WidgetPreviewableTemplate/events.md)

## Source

`client/lib/widgets/WidgetPreviewableTemplate.vue`