如果你对 vue 的基础知识还很陌生,推荐先去学习一下 vue 基础
内容 | 参考链接 |
---|---|
Vue2.x全家桶 | Vue2.x全家桶参考链接 |
todoList 项目演示
备注:
该项目有 五个组件 构成:
(1)App.vue 父组件,以上四个子组件 最终归并的地方,并实现很多功能相关方法
(2)MyHeader.vue 子组件:头部,用于用户文本框 输入添加任务事项
(3)MyList.vue 子组件:躯干,用于 呈现任务的列表
(4)MyItem.vue 子中子组件,Mylist.vue 的子组件,用于 呈现每个任务及编辑删除
(5)MyFooter 子组件,用于 显示所选个数和总个数及删除已完成任务
App.vue 父组件
<template>
<!-- 最外层容器 -->
<div class="todo-container">
<div class="todo-wrap">
<!-- 头部子组件,子传父,自定义 addTodo事件,添加一个 todo对象 -->
<MyHeader @addTodo="addTodo" />
<!-- 任务列表子组件,父传子,动态绑定对应事件 -->
<MyList :updateTodo="updateTodo" :todos="todos" :checkTodo="checkTodo" :deleteTodo="deleteTodo" />
<!-- 底部子组件,子传父,全选和全清除 -->
<MyFooter
:todos="todos"
@checkAllTodo="checkAllTodo"
@clearAllTodo="clearAllTodo"
/>
</div>
</div>
</template>
<script>
// 引入所需组件
import MyHeader from "./components/MyHeader.vue";
import MyList from "./components/MyList.vue";
import MyFooter from "./components/MyFooter.vue";
export default {
name: "App",
components: { MyHeader, MyList, MyFooter },
data() {
return {
// 由于 todos 是 MyHeader 组件 和 MyFooter 组件都在用,所以放在APP中(状态提升)
// 解析 JSON字符串 第一次使用时 null 身上没有 length 属性会报错,所以添加||,前面不能用时,置为空数组
// localStorage.getItem("xxx") 用于从本地存储中读取 todos
todos: JSON.parse(localStorage.getItem("todos")) || [],
};
},
methods: {
// 添加一个 todo
addTodo(todoObj) {
this.todos.unshift(todoObj);
},
// 勾选 or 取消勾选一个todo
checkTodo(id) {
this.todos.forEach((todo) => {
if (todo.id === id) todo.done = !todo.done;
});
},
// 更新一个 todo
updateTodo(id, title) {
this.todos.forEach((todo) => {
if (todo.id === id) todo.title = title;
});
},
// 删除,todo.id !== id 就不会 push 该 todo,即删除
deleteTodo(id) {
this.todos = this.todos.filter((todo) => todo.id !== id);
},
// 全选 or 取消全选
checkAllTodo(done) {
this.todos.forEach((todo) => {
todo.done = done;
});
},
// 清除所有已经完成的todo
clearAllTodo() {
this.todos = this.todos.filter((todo) => {
return !todo.done;
});
},
},
watch: {
todos: {
// 深度监视 检测到是否被勾选
deep: true,
handler(value) {
// localStorage.setItem("xxx") 用来添加 todo
// 格式化为 JSON 字符串
localStorage.setItem("todos", JSON.stringify(value));
},
},
},
// 销毁前进行自定义事件的解绑
beforeDestroy() {
this.$off(['addTodo', 'checkAllTodo', 'clearAllTodo'])
}
};
</script>
<style>
body {
background: #fff;
}
.btn {
display: inline-block;
padding: 4px 12px;
margin-bottom: 0;
font-size: 14px;
line-height: 20px;
text-align: center;
vertical-align: middle;
cursor: pointer;
box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.2),
0 1px 2px rgba(0, 0, 0, 0.05);
border-radius: 4px;
}
.btn-danger {
color: #fff;
background-color: #da4f49;
border: 1px solid #bd362f;
}
.btn-edit {
margin-right: 5px;
background-color: skyblue;
border: 1px solid rgb(102, 158, 180);
}
.btn-danger:hover {
color: #fff;
background-color: #bd362f;
}
.btn:focus {
outline: none;
}
.todo-container {
width: 600px;
margin: 10px auto;
}
.todo-container .todo-wrap {
padding: 10px;
border: 1px solid #ddd;
border-radius: 5px;
}
</style>
MyHeader.vue 组件
npm i nanoid
,安装 nanoid
标签里的 scoped,表示里面定义的样式 仅在当前组件中生效<template>
<div class="todo-header">
<!-- 双向数据绑定 title,绑定键盘 enter 键,点击触发 add 事件,添加 title -->
<input
type="text"
placeholder="请输入你的任务名称,按回车键确认"
v-model="title"
@keyup.enter="add"
/>
</div>
</template>
<script>
import { nanoid } from "nanoid";
export default {
name: "MyHeader",
data() {
return {
// 要输入的任务事项
title: "",
};
},
methods: {
add() {
// 校验数据
if (!this.title.trim()) return alert("输入不能为空");
// 将用户的输入包装成为一个 todo 对象,nanoid() 是随机生成的唯一值,默认为未完成事件
const todoObj = { id: nanoid(), title: this.title, done: false };
// 通知 App 组件去添加一个 todo 对象
this.$emit("addTodo", todoObj);
// 清空输入
this.title = "";
},
},
};
</script>
<style scoped>
.todo-header input {
width: 578px;
height: 28px;
font-size: 14px;
border: 1px solid #ccc;
border-radius: 4px;
padding: 4px 7px;
margin-bottom: 10px;
}
.todo-header input:focus {
outline: none;
border-color: rgba(82, 168, 236, 0.8);
box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075),
0 0 8px rgba(82, 168, 236, 0.6);
}
</style>
MyList.vue 组件
<template>
<ul class="todo-main">
<!-- :todo,动态绑定,供 MyItem.vue 使用 -->
<!-- 自定义 updateTodo 事件,子传父,供子组件编辑更新数据 -->
<MyItem
v-for="todoObj in todos"
:key="todoObj.id"
:todo="todoObj"
:checkTodo="checkTodo"
:deleteTodo="deleteTodo"
@updateTodo="updateTodo"
/>
</ul>
</template>
<script>
import MyItem from "./MyItem.vue";
export default {
name: "MyList",
components: { MyItem },
props: ["todos", "checkTodo", "deleteTodo", "updateTodo"],
};
</script>
<style scoped>
.todo-main {
margin-left: 0px;
border: 1px solid #ddd;
border-radius: 2px;
padding: 0px;
}
.todo-empty {
height: 40px;
line-height: 40px;
border: 1px solid #ddd;
border-radius: 2px;
padding-left: 5px;
margin-top: 10px;
}
</style>
MyItem.vue 组件
$nextTick
(等 DOM 节点更新后执行),或者用 setTimeout 异步包裹也能达到同样的效果Vue.set()
和 vm.$set()
,否则是无法触发视图更新的。<template>
<li>
<label>
<!-- 复选框,:checked 单向绑定 todo 是否已完成,@change 检测复选框的变化 -->
<input
type="checkbox"
:checked="todo.done"
@change="handleCheck(todo.id)"
/>
<!-- 非编辑状态下,在 sapn 标签中展示 todo -->
<span v-show="!todo.isEdit">{{ todo.title }}</span>
<!-- 绑定失去焦点事件,更新内容。ref 打标识,用于自动获取焦点 -->
<input
type="text"
style="height: 22px"
v-show="todo.isEdit"
:value="todo.title"
@blur="handleBlur(todo, $event)"
ref="inputTitle"
/>
</label>
<!-- 删除 todo -->
<button class="btn btn-danger" @click="handleDelete(todo.id)">删除</button>
<!-- 编辑状态下,展示输入框,隐藏编辑按钮。 -->
<button v-show="!todo.isEdit" class="btn btn-edit" @click="handleEdit(todo)">编辑</button>
</li>
</template>
<script>
export default {
name: "MyItem",
// 声明接收 todo 对象,checkTodo 是否勾选,deleteTodo 删除该 todo
props: ["todo", "checkTodo", "deleteTodo"],
methods: {
// 勾选 or 取消勾选
handleCheck(id) {
// 通知 APP 组件 将对应的 todo 对象的 done 值取反
this.checkTodo(id);
},
// 删除 todo
handleDelete(id) {
if (confirm("确定删除当前任务吗?")) {
this.deleteTodo(id);
}
},
// 编辑
handleEdit(todo) {
// 如果 todo 身上有 isEdit,则直接修改 isEdit,否则再给 todo 添加新的 isEdit
// Reflect.has(todo, 'isEdit') 或 todo.hasOwnProperty.call(todo, "isEdit")
if (Reflect.has(todo, 'isEdit')) {
todo.isEdit = true;
} else {
this.$set(todo, "isEdit", true);
}
// DOM 节点更新后执行
this.$nextTick(() => {
this.$refs.inputTitle.focus()
})
},
// 失去焦点,编辑框隐藏,并判断编辑后的内容是否为空,再呈现编辑后的内容
handleBlur(todo, e) {
todo.isEdit = false;
if(!e.target.value.trim()) return alert('输入内容不能为空!')
this.$emit('updateTodo', todo.id, e.target.value)
},
},
};
</script>
<style scoped>
span {
color: orange;
}
li {
list-style: none;
height: 36px;
line-height: 36px;
padding: 0 5px;
border-bottom: 1px solid #ddd;
}
li label {
cursor: pointer;
}
input {
margin-right: 5px;
}
li label li input {
vertical-align: middle;
margin-right: 6px;
position: relative;
top: -1px;
}
li button {
float: right;
display: none;
margin-top: 3px;
}
li:before {
content: initial;
}
li:last-child {
border-bottom: none;
}
li:hover {
background-color: #ddd;
}
li:hover button {
display: block;
}
</style>
MyFooter.vue 组件
<template>
<!-- total 不为 0 则显示底部,否则隐藏 -->
<div class="todo-footer" v-show="total">
<label>
<!-- 是否全选,双向绑定 isAll -->
<input type="checkbox" v-model="isAll" />
</label>
<!-- 插值语法呈现数值 -->
<span class="done">已完成 {{ doneTotal }}</span> /
<span class="total">全部 {{ total }}</span>
<button class="btn btn-danger" @click="clearAll()">清除已完成任务</button>
</div>
</template>
<script>
export default {
name: "MyFooter",
props: ["todos"],
computed: {
// 返回 todos 的总长度
total() {
return this.todos.length;
},
// 统计任务已经完成的个数
doneTotal() {
// reduce() 方法接收一个函数作为累加器,数组中的每个值(从左到右)开始缩减,最终计算为一个值
// pre 必需:初始值;todo 必需:当前元素;0 可选:传递给函数的初始值
return this.todos.reduce((pre, todo) => pre + (todo.done ? 1 : 0), 0);
},
// 是否全选,当被选个数和总个数相同,且总个数大于 0 时,checked 选中
isAll: {
get() {
return this.doneTotal === this.total && this.total > 0;
},
set(value) {
this.$emit("checkAllTodo", value);
},
},
},
methods: {
// 清除所有已完成任务
clearAll() {
this.$emit("clearAllTodo");
},
},
};
</script>
<style scoped>
.done {
font-weight: bold;
color: skyblue;
}
.total {
font-weight: bold;
color: palevioletred;
}
.todo-footer {
height: 40px;
line-height: 40px;
padding-left: 6px;
margin-top: 5px;
}
.todo-footer label {
display: inline-block;
margin-right: 20px;
cursor: pointer;
}
.todo-footer label input {
position: relative;
top: -3px;
vertical-align: middle;
margin-right: -10px;
}
.todo-footer button {
float: right;
margin-top: 5px;
}
</style>
如果你是 看完全篇 阅读到了这里,我相信你一定是有收获的!
那么下面不妨打开自己的电脑,启动自己的编译器,来跟着做 / 自己做一遍吧!
好吧,我骗了你,真正学会它可能不止两个小时,但再多花点时间,你对 vue 的理解可能会有质的提升,加油~
如果这篇文章对你有些许帮助的话,不妨 三连 + 关注 支持一下~~
下一篇是 github 的搜索 demo,也是使用的 vue2.x 实现的,一起期待一下吧~