@vue/compiler-dom

What is @vue/compiler-dom?

The @vue/compiler-dom package is part of the Vue.js ecosystem, specifically designed for compiling Vue template syntax into render functions directly in the browser or on the server. It is a core utility for Vue's template compilation, enabling developers to pre-compile templates or compile them on the fly, optimizing performance and enhancing the development experience with Vue.js applications.

What are @vue/compiler-dom's main functionalities?

Compiling Template Strings

This feature allows developers to compile Vue template strings into render functions. The compiled code can then be used to render Vue components dynamically. This is particularly useful for applications that need to compile templates on the fly, such as those that receive template code from a server.

import { compile } from '@vue/compiler-dom';
const { code } = compile('<div>{{ message }}</div>');
console.log(code);

Parsing Template Options

The package provides functionality to parse template strings into Abstract Syntax Trees (ASTs). This is useful for tools and libraries that need to analyze or manipulate Vue templates at a syntactic level, enabling advanced use cases like static analysis, linting, and custom transformations.

import { parse, baseParse } from '@vue/compiler-dom';
const ast = baseParse('<div>{{ message }}</div>');
console.log(ast);

Transforming AST Nodes

After parsing a template into an AST, @vue/compiler-dom allows developers to apply transformations to the AST nodes. This feature is powerful for creating custom directives or modifying the behavior of existing ones, enabling a high degree of customization and optimization for Vue applications.

import { transform } from '@vue/compiler-dom';
transform(ast, {
  nodeTransforms: [/* array of node transform functions */]
});

Other packages similar to @vue/compiler-dom

babel-plugin-transform-vue-jsx

This package is a Babel plugin that transforms JSX syntax into Vue render functions. While it serves a similar purpose to @vue/compiler-dom by enabling developers to write Vue components using JSX, it operates within the Babel ecosystem and requires a build step, unlike @vue/compiler-dom which can compile templates on the fly.

vue-template-compiler

Part of the Vue 2 ecosystem, this package compiles Vue 2 templates into render functions. It is similar to @vue/compiler-dom but is specifically tailored for Vue 2, whereas @vue/compiler-dom is designed for Vue 3. The vue-template-compiler package is essential for Vue 2 development, offering compatibility with Vue 2's reactivity system and component structure.

README

@vue/compiler-dom

Changelog

3.5.18 (2025-07-23)

Bug Fixes

• compiler-core: avoid cached text vnodes retaining detached DOM nodes (#13662) (00695a5), closes #13661
• compiler-core: avoid self updates of v-pre (#12556) (21b685a)
• compiler-core: identifiers in function parameters should not be inferred as references (#13548) (9b02923)
• compiler-core: recognize empty string as non-identifier (#12553) (ce93339)
• compiler-core: transform empty v-bind dynamic argument content correctly (#12554) (d3af67e)
• compiler-sfc: transform empty srcset w/ includeAbsolute: true (#13639) (d8e40ef), closes vitejs/vite-plugin-vue#631
• css-vars: nullish v-bind in style should not lead to unexpected inheritance (#12461) (c85f1b5), closes #12434 #12439 #7474 #7475
• custom-element: ensure exposed methods are accessible from custom elements by making them enumerable (#13634) (90573b0), closes #13632
• hydration: prevent lazy hydration for updated components (#13511) (a9269c6), closes #13510
• runtime-core: ensure correct anchor el for unresolved async components (#13560) (7f29943), closes #13559
• slots: refine internal key checking to support slot names starting with an underscore (#13612) (c5f7db1), closes #13611
• ssr: ensure empty slots render as a comment node in Transition (#13396) (8cfc10a), closes #13394