09 v-once指令 - 技术栈

概述

v-once主要用来实现一次渲染，有点类似于单例模式的概念。

使用v-once渲染的内容，无论后来如何发生变化，是否为响应式，在页面中显示的始终是第一次展示给用户的内容。

不过，这个指令使用的场景也非常少，作为了解即可。

注意事项

v-once无法直接渲染变量，而是要结合其他指令使用，比如：

html 复制代码

<div>通过v-once渲染：<span v-once v-text="count"></span></div>

基本用法

我们创建src/components/Demo09.vue，在这个组件中，我们要渲染一个响应式的变量count，然后定义一个addCount和subCount事件，并绑定"增加"和"减少"两个按钮。我们通过两个div标签分别用v-text和v-once渲染count的值，然后让用户点击两个按钮，可以观察v-text渲染的值和v-once渲染的值的变化。

html 复制代码

<script setup>
import {ref} from "vue";

const count = ref(0)
</script>
<template>
  <div>通过v-text渲染：<span v-text="count"></span></div>
  <div>通过v-once渲染：<span v-once v-text="count"></span></div>
  <div>
    <button @click="count++">增加</button>
    <button @click="count--">减少</button>
  </div>
</template>

接着，我们修改src/App.vue，引入Demo09.vue并进行渲染：

html 复制代码

<script setup>
import Demo from "./components/Demo09.vue"
</script>
<template>
  <h1>欢迎跟着Python私教一起学习Vue3入门课程</h1>
  <hr>
  <Demo/>
</template>

然后，我们浏览器访问：http://localhost:5173/

代码分析

我们来看一下核心代码：

html 复制代码

<div>通过v-once渲染：<span v-once v-text="count"></span></div>

可以看出来，v-once主要是配合其他指令一起使用的。

我们通过点击界面上的增加和减少两个按钮可以发现，v-text渲染的值会一直变化，但是v-once渲染的值则一直不发生变化。这就说明，通过v-once渲染的值，始终保留其第一次渲染给用户的值，而不会因为数据是响应式的而发生变化。

完整代码

package.json

json 复制代码

{
  "name": "hello",
  "private": true,
  "version": "0.1.0",
  "type": "module",
  "scripts": {
    "dev": "vite",
    "build": "vite build"
  },
  "dependencies": {
    "vue": "^3.3.8"
  },
  "devDependencies": {
    "@vitejs/plugin-vue": "^4.5.0",
    "vite": "^5.0.0"
  }
}

vite.config.js

js 复制代码

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

export default defineConfig({
  plugins: [vue()],
})

index.html

html 复制代码

<!doctype html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Vite + Vue</title>
  </head>
  <body>
    <div id="app"></div>
    <script type="module" src="/src/main.js"></script>
  </body>
</html>

src/main.js

js 复制代码

import { createApp } from 'vue'
import App from './App.vue'

createApp(App).mount('#app')

src/App.vue

html 复制代码

<script setup>
import Demo from "./components/Demo09.vue"
</script>
<template>
  <h1>欢迎跟着Python私教一起学习Vue3入门课程</h1>
  <hr>
  <Demo/>
</template>

src/components/Demo09.vue

html 复制代码

<script setup>
import {ref} from "vue";

const count = ref(0)
</script>
<template>
  <div>通过v-text渲染：<span v-text="count"></span></div>
  <div>通过v-once渲染：<span v-once v-text="count"></span></div>
  <div>
    <button @click="count++">增加</button>
    <button @click="count--">减少</button>
  </div>
</template>

启动方式

bash 复制代码

yarn
yarn dev

浏览器访问：http://localhost:5173/