Vue's default v-text
is HTML-insensitive, while v-html
doesn't perform sanitization by default.
v-sanitize
is a Vue directive for HTML sanitization, powered by the flexible sanitize-html. The directive can receive either a string, that will undergo a partial sanitization if no modifier is present, or an array of two elements, the first being a sanitize-html
whitelist (know more here) and the second being the string to be sanitized.
<div v-sanitize="unsafe_html"></div>
Start getting it with NPM or Yarn (see package).
npm install vue-sanitize-directive
# Alternatively: yarn add vue-sanitize-directive
Then install it like any other Vue plugin. This will provide the v-sanitize
directive globally.
import VueSanitize from 'vue-sanitize-directive'
Vue.use(VueSanitize)
Usage (demos)
Removes all HTML tags, keeping just the text content.
<span v-sanitize.strip="unsafe_html"></span>
Allows some HTML tags, but remove unsafe content, like <script/>
and <iframe/>
tags.
<span v-sanitize.basic="unsafe_html"></span> = <span v-sanitize="unsafe_html"></span>
Removes most tags, keeping only inline formatting and <br/>
tags.
<span v-sanitize.inline="unsafe_html"></span>
Allows all HTML tags, not performing sanitization. For all effects, it's a replacement for v-html
.
<span v-sanitize.nothing="unsafe_html"></span>