Vue-TodoList 项目详解

Vue 3 Todo List 项目详解

1.图片展示

2. 核心数据结构

项目使用 ref 定义了核心的响应式数据 todos。数组中的每一项是一个对象,包含三个关键属性:

  • id: 唯一标识符(用于 Diff 算法优化)
  • context: 任务文本内容
  • done: 完成状态 (true/false)
JavaScript 复制代码
const todos = ref([
  { id: 1, context: '打王者', done: false },
  { id: 2, context: '吃饭', done: true },
  // ...
])

3. 功能实现细节

A. 添加任务 (Add Todo)

逻辑:

  1. 双向绑定 :使用 v-model 绑定输入框与 newTodoText 变量。
  2. 事件监听 :监听键盘的 Enter 键 (@keydown.enter)。
  3. 数据变更 :校验非空后,向 todos 数组 push 新对象,并重置输入框。

亮点 :使用了 nextId 自增变量,确保每个新任务都有独立的 ID,避免渲染时的 Key 冲突。

B. 列表渲染与性能优化

逻辑:

使用 v-for 指令循环渲染列表。

关键点:

必须绑定 :key="todo.id"。Vue 的虚拟 DOM 机制依赖这个 Key 来进行高效的 Diff 对比。如果数据项顺序改变,Vue 可以直接复用 DOM 元素,而不是销毁重建,从而提升性能。

C. 智能状态计算 (Computed)

项目中大量使用了 computed 计算属性,它的优势在于缓存------只有依赖的数据变化时才会重新计算。

  1. 剩余任务统计 (active):

    实时计算 !todo.done 的数量,用于底部显示 "X items left"。

    JavaScript 复制代码
    const active = computed(() => todos.value.filter(todo => !todo.done).length)
  2. 全选/反选 (allDone) - 高级用法:

    这是一个可写计算属性 (Writable Computed),它巧妙地实现了双向逻辑:

    • 读 (Get) :如果所有任务都完成了,全选框自动勾选。
    • 写 (Set) :当你点击全选框时,它触发 set 方法,将所有任务的 done 状态同步为当前全选框的状态。

D. 删除与清理

  • 删除单项 :通过 filter 过滤掉指定 ID 的任务。

  • 清除已完成:通过 filter 过滤掉所有 done 为 true 的任务。

    这里的操作都是生成新数组替换旧数组,Vue 的响应式系统会自动检测到引用变化并更新视图。


4. Computed 讲解

计算属性 (Computed Properties):形式上是函数,结果是属性。

核心特性:
  1. 依赖追踪 :自动感知它所使用的响应式数据(如 ref 或 reactive)。
  2. 缓存机制 (Caching) :这是它与普通函数(Methods)最大的区别。如果依赖的数据没变,多次访问 computed 会直接返回上一次计算的结果,不会重复执行函数体。
高级用法:可写的计算属性(Getter & Setter)

在 Vue 3 中,计算属性(computed)通常默认为"只读"的(即只传入一个 getter 函数)。但在需要实现双向绑定 的场景下(例如"全选/反选"复选框),我们需要使用它的高级写法 :传入一个包含 get 和 set 的对象。

js 复制代码
// 引入 computed
import { computed } from 'vue';

// 定义可写的计算属性
const allDone = computed({
  // getter: 读取值(决定全选框是否勾选)
  // 当依赖的 todos 数据变化时,会自动重新计算
  get() {
    // 逻辑:如果列表不为空,且每一项都已完成 (done === true),则返回 true
    return todos.value.length > 0 && todos.value.every(todo => todo.done)
  },

  // setter: 写入值(当用户点击全选框时触发)
  // val 是用户操作后的新值(true 或 false)
  set(val) {
    // 逻辑:遍历所有 todos,将它们的完成状态强制改为当前全选框的状态
    todos.value.forEach(todo => todo.done = val)
  }
})

在 Vue 中:

  • 使用 Methods (函数) : function getActive() { ... }。每次页面重新渲染(哪怕是无关的 DOM 更新),这个函数都会被执行一遍。如果计算量大,会浪费性能。
  • 使用 Computed (计算属性) : 只有依赖变了才算。对于像"过滤列表"、"遍历大数组"这种操作,computed 是性能优化的关键。

5. 项目源码 (src/App.vue)

HTML 复制代码
<script setup>
  import { ref, computed } from 'vue';
  
  // 1. 响应式数据定义
  const title = ref("todos");
  const newTodoText = ref("");
  const todos = ref([
    { id: 1, context: '打王者', done: false },
    { id: 2, context: '吃饭', done: true }, 
    { id: 3, context: '睡觉', done: false },
    { id: 4, context: '学习Vue', done: false }
  ])

  let nextId = 5;

  // 2. 计算属性:统计未完成数量
  // 优势:computed 有缓存,性能优于 method
  const active = computed(() => {
    return todos.value.filter(todo => !todo.done).length
  })

  // 计算属性:统计已完成数量(用于控制清除按钮显示)
  const completedCount = computed(() => {
    return todos.value.filter(todo => todo.done).length
  })

  // 3. 核心业务:添加任务
  const addTodo = () => {
    const text = newTodoText.value.trim();
    if (!text) return;
    todos.value.push({
      id: nextId++, // 确保 ID 唯一
      context: text,
      done: false
    });
    newTodoText.value = "";
  }

  // 4. 核心业务:全选/反选 (可写计算属性)
  const allDone = computed({
    get() {
      return todos.value.length > 0 && todos.value.every(todo => todo.done)
    },
    set(val) {
      todos.value.forEach(todo => todo.done =val)
    }
  })

  // 5. 核心业务:删除任务
  const removeTodo = (id) => {
    todos.value = todos.value.filter(item => item.id !== id)
  }

  // 6. 核心业务:清除已完成
  const clearCompleted = () => {
    todos.value = todos.value.filter(todo => !todo.done)
  }
</script>

<template>
  <div class="todoapp">
    
    <header class="header">
      <h1>{{ title }}</h1>
      <input 
        class="new-todo" 
        type="text" 
        v-model="newTodoText" 
        @keydown.enter="addTodo" 
        placeholder="What needs to be done?"
        autofocus
      >
    </header>

    <section class="main" v-if="todos.length">
      <input id="toggle-all" class="toggle-all" type="checkbox" v-model="allDone">
      <label for="toggle-all">Mark all as complete</label>

      <ul class="todo-list">
        <li v-for="todo in todos" :key="todo.id" :class="{ completed: todo.done }">
          <div class="view">
            <input class="toggle" type="checkbox" v-model="todo.done">
            <label>{{ todo.context }}</label>
            <button class="destroy" @click="removeTodo(todo.id)"></button>
          </div>
        </li>
      </ul>
    </section>

    <footer class="footer" v-if="todos.length">
      <span class="todo-count">
        <strong>{{ active }}</strong> items left
      </span>
      
      <button class="clear-completed" @click="clearCompleted" v-show="completedCount > 0">
        Clear completed
      </button>
    </footer>

  </div>
</template>
相关推荐
deli00722 分钟前
TCP 为什么会粘包?4 种拆包方案 49 字节实测对比
前端
deli0071 小时前
32K 上下文塞满后,AI 最先忘掉什么?120 轮对话实测
前端
deli0072 小时前
手机拍灯为什么有一条条黑纹?PWM 240Hz 实测
前端
wangruofeng7 小时前
AI Models 1.1.0 发布,查大模型价格、对比模型和找 API 地址
前端·aigc·ai编程
wangruofeng7 小时前
给前端开发者的 100 个设计参考网站
前端·设计
M--Y10 小时前
LangGraph 工作流模式
开发语言·javascript·python·langchain·大模型·llm·langgraph
星栈10 小时前
视频即代码,Remotion 能做什么、不能做什么
前端·音视频开发
广州华水科技10 小时前
单北斗GNSS位移监测系统的应用与技术解析
前端
用户479492835691511 小时前
从一句话或代码仓到可交互 HTML:开源 Agent 画图技能 Archify v3.2 实测与选型边界
前端·后端·面试
风骏时光牛马13 小时前
生成一个AI多模态标题,仅输出一条标题,无额外文字、问句、备选、配图、文案等任何附加内容,不需要其他的任务服务 只要标题。
前端