Render functions vs templates decision in Vue

Introduction

Render functions and templates both create the HTML you see on the page. Choosing between them helps you write clearer and easier-to-manage Vue components.

When you want simple and easy-to-read HTML structure, use templates.

When you need more control or dynamic logic in your HTML, use render functions.

When you want to write your component entirely in JavaScript, use render functions.

When you prefer a clear separation of HTML and JavaScript, use templates.

When you want to use JSX syntax inside Vue, use render functions.

Syntax

Vue

Template syntax:
<template>
  <div>Hello, {{ name }}!</div>
</template>

Render function syntax:
import { h } from 'vue'
export default {
  render() {
    return h('div', `Hello, ${this.name}!`)
  }
}

Templates look like regular HTML with special Vue tags.

Render functions use JavaScript to create HTML elements.

Examples

This template example shows a button that updates a counter when clicked.

Vue

<template>
  <button @click="count++">Clicked {{ count }} times</button>
</template>

<script setup>
import { ref } from 'vue'
const count = ref(0)
</script>

This render function example does the same as the template but uses JavaScript to create the button.

Vue

import { h, ref } from 'vue'

export default {
  setup() {
    const count = ref(0)
    return { count }
  },
  render() {
    return h('button', { onClick: () => this.count++ }, `Clicked ${this.count} times`)
  }
}

Sample Program

This simple Vue component uses a template to greet the user by name.

Vue

<template>
  <div>
    <p>Template says: Hello, {{ name }}!</p>
  </div>
</template>

<script setup>
import { ref } from 'vue'
const name = ref('Friend')
</script>

Important Notes

Templates are easier for beginners because they look like HTML.

Render functions give more power but need more JavaScript knowledge.

You can mix both in Vue, but usually pick one style per component.

Summary

Templates are simple and look like HTML.

Render functions use JavaScript for more control.

Choose based on your comfort and the complexity of your component.

Practice

1. Which statement best describes when to use Vue templates instead of render functions?

easy

A. When you want to write code that runs only on the server.

B. When you want simple, readable code that looks like HTML.

C. When you want to avoid using Vue's reactivity system.

D. When you need full JavaScript control over rendering.

Solution

1. Step 1: Understand Vue templates

   Templates are designed to be simple and look like HTML, making them easy to read and write.

2. Step 2: Compare with render functions

   Render functions use JavaScript and offer more control but are more complex to write.

3. Final Answer:

   When you want simple, readable code that looks like HTML. -> Option B

4. Quick Check:

   Templates = simple HTML-like code [OK]

Hint: Templates are HTML-like; render functions are JavaScript [OK]

Common Mistakes:

• Thinking templates can't handle complex logic
• Believing render functions are always better
• Confusing server-only rendering with templates

2. Which of the following is the correct syntax to define a render function in a Vue component?

easy

A. render: function(h) { return h('div', 'Hello') }

B. render() { return Hello }

C. template: 'Hello'

D. render() => { return 'Hello' }

Solution

1. Step 1: Recall render function syntax

   Vue render functions use the `h` helper to create elements, typically written as `render: function(h) { return h('tag', children) }`.

2. Step 2: Check each option

   render: function(h) { return h('div', 'Hello') } correctly uses `render: function(h) { return h('div', 'Hello') }`. render() { return
   Hello } uses JSX syntax which requires setup. template: '

   Hello

   ' is a template, not a render function. render() => { return '

   Hello

   ' } returns a string instead of VNode.

3. Final Answer:

   render: function(h) { return h('div', 'Hello') } -> Option A

4. Quick Check:

   Render function uses h() helper [OK]

Hint: Render functions use h() helper, templates use template string [OK]

Common Mistakes:

• Using JSX without proper setup
• Confusing template syntax with render function
• Incorrect arrow function syntax in render

3. Given this Vue render function, what will be displayed?

render(h) { return h('button', { onClick: () => alert('Clicked!') }, 'Click me') }

medium

A. A button labeled 'Click me' that shows an alert when clicked.

B. A button labeled 'Click me' with no click action.

C. An error because onClick should be onclick.

D. Nothing renders because render functions need templates.

Solution

1. Step 1: Analyze the render function

   The function returns a button element with a click event handler that triggers an alert with 'Clicked!'.

2. Step 2: Understand event naming in Vue render functions

   Vue uses camelCase event names like onClick in render functions, so the event will work correctly.

3. Final Answer:

   A button labeled 'Click me' that shows an alert when clicked. -> Option A

4. Quick Check:

   Render function with onClick triggers alert [OK]

Hint: onClick in render functions triggers events like in JSX [OK]

Common Mistakes:

• Thinking event names must be lowercase
• Assuming render functions require templates
• Believing no output renders without template

4. Identify the error in this Vue render function:

render(h) { return h('div', { onclick: () => console.log('Clicked') }, 'Test') }

medium

A. The render function must return a template string.

B. The h function cannot accept event handlers.

C. The 'div' tag is invalid in render functions.

D. The event name should be 'onClick' with capital C.

Solution

1. Step 1: Check event handler naming

   In Vue render functions, event handlers use camelCase like 'onClick', not lowercase 'onclick'.

2. Step 2: Validate other parts

   The h function accepts event handlers, and 'div' is a valid tag. Render functions return VNodes, not template strings.

3. Final Answer:

   The event name should be 'onClick' with capital C. -> Option D

4. Quick Check:

   Event names in render functions are camelCase [OK]

Hint: Use camelCase event names like onClick in render functions [OK]

Common Mistakes:

• Using lowercase event names
• Expecting templates inside render functions
• Thinking h() can't handle events

5. You want to create a Vue component that conditionally renders a list of items with complex logic and dynamic keys. Which approach is best and why?

Options:
A) Use templates with v-for and v-if.
B) Use render functions for full JavaScript control.
C) Use templates only, avoid render functions.
D) Use plain JavaScript without Vue features.

hard

A. Templates with v-for and v-if are simpler and sufficient for most cases.

B. Templates are always better for any complexity.

C. Render functions allow complex logic and dynamic keys more flexibly.

D. Avoid Vue features and write plain JavaScript for control.

Solution

1. Step 1: Understand complexity needs

   Complex logic and dynamic keys in lists can be hard to express cleanly in templates.

2. Step 2: Evaluate render functions benefits

   Render functions use JavaScript directly, allowing more flexible and dynamic rendering control.

3. Step 3: Compare options

   Templates are simpler but may be limited for complex dynamic keys. Plain JavaScript without Vue loses reactivity and benefits.

4. Final Answer:

   Render functions allow complex logic and dynamic keys more flexibly. -> Option C

5. Quick Check:

   Complex dynamic rendering = render functions [OK]

Hint: Use render functions for complex dynamic rendering needs [OK]

Common Mistakes:

• Assuming templates handle all complex logic easily
• Ignoring reactivity by avoiding Vue features
• Thinking plain JavaScript is better than Vue for UI