W3cubDocs

/Vue.js 3

Inline Template Attribute
breaking

Overview

Support for the inline-template feature (opens new window) has been removed.

2.x Syntax

In 2.x, Vue provided the inline-template attribute on child components to use its inner content as its template instead of treating it as distributed content.

<my-component inline-template>
  <div>
    <p>These are compiled as the component's own template.</p>
    <p>Not parent's transclusion content.</p>
  </div>
</my-component>

3.x Syntax

This feature will no longer be supported.

Migration Strategy

Most of the use cases for inline-template assumes a no-build-tool setup, where all templates are written directly inside the HTML page.

Migration build flag: COMPILER_INLINE_TEMPLATE

Option #1: Use <script> tag

The most straightforward workaround in such cases is using <script> with an alternative type:

<script type="text/html" id="my-comp-template">
  <div>{{ hello }}</div>
</script>

And in the component, target the template using a selector:

const MyComp = {
  template: '#my-comp-template'
  // ...
}

This doesn't require any build setup, works in all browsers, is not subject to any in-DOM HTML parsing caveats (e.g. you can use camelCase prop names), and provides proper syntax highlighting in most IDEs. In traditional server-side frameworks, these templates can be split out into server template partials (included into the main HTML template) for better maintainability.

Option #2: Default Slot

A component previously using inline-template can also be refactored using the default slot - which makes the data scoping more explicit while preserving the convenience of writing child content inline:

<!-- 2.x Syntax -->
<my-comp inline-template :msg="parentMsg">
  {{ msg }} {{ childState }}
</my-comp>

<!-- Default Slot Version -->
<my-comp v-slot="{ childState }">
  {{ parentMsg }} {{ childState }}
</my-comp>

The child, instead of providing no template, should now render the default slot*:

<!--
  in child template, render default slot while passing
  in necessary private state of child.
-->
<template>
  <slot :childState="childState" />
</template>
  • Note: In 3.x, slots can be rendered as the root with native fragments support!

© 2013–present Yuxi Evan You
Licensed under the MIT License.
https://v3.vuejs.org/guide/migration/inline-template-attribute.html