使用 Vuex 实现一个笔记应用
最近开始着手学习 Vue，先大略的过了一遍官方文档，跟着敲过一部分官方文档中的 DEMO，然而还是不甚了了。在网上找到了一个入门的笔记应用，即便是入门级的应用，在学习途中依旧困难重重。特将学习作此笔记，方便今后回看，也希望能够帮到刚开始学习 Vue 的女同学
附原作者 Github 链接：https://github.com/lichenbuliren/vuex-notes-app2
预期目标
笔记具备如下基本功能
1.新增
2.删除
3.收藏
4.在全部笔记和收藏笔记间切换
5.在当前列表中进行搜索
卖家秀
买家秀
准备工作
1.新建项目
选个文件夹存放项目，这里我用的是 Git Bush 执行语句（$ 符号是 Git Bush 中自带的），你也可以使用命令行，一样的
选择项目存放位置
2.查看模块（爱看不看）
查看一下全局安装的模块 npm list --depth=0 -global
查看全局安装的模块
3.创建项目
在命令行输入 vue init webpack vuex-note 并做好设置，创建一个项目
这都什么鬼
4.简单解释一下各个配置都是干嘛的
vue init webpack vuex-note：初始化（init）一个使用webpack构建工具构建的vue项目，项目名为vuex-noteProject name：项目名Project description：项目描述Author：朕Vue build：构建方式，分为独立构建和运行时构建，具体说明见如下链接，这里选择独立构建standalonehttps://vuejs.org/v2/guide/installation.html#Runtime-Compiler-vs-Runtime-only
Install vue-router：是否需要安装vue-router，跳转页面用的，这里用不着，我过会学Use ESLint to lint your code：ESLint规范与法用的，可能你熟悉的写法都是不标准的，如果采用ESLint则可能报错，这里选择 n剩下的都是测试用的，一路 n
Should we run 'npm install' for you after the project has been created：是否需要直接替你安装（npm install）相关的依赖，回车就行，之后会替你安装各种玩意
5.安装完后会有提示，我们接着按照提示走
先是
cd vuex-note进入刚刚创建的vue项目文件夹
安装完成
再通过
npm run dev跑起项目后续操作
6.访问页面
此时通过浏览器访问 localhost:8080 就可以打开一个新的 vue 页面
崭新的 vue 页面
7.项目结构
截止目前的项目结构如图
项目结构
由于是初学，为了先搞个东西出来，所以暂时先不管一些乱七八糟的配置，只挑跟这次相关的说（其实多了我也没学到...）
8.查看 Vuex
既然是使用 Vuex 来实现笔记应用，我们就应该先查看一下构建的项目是否包含 Vuex 模块。node_modules 文件夹包含了现有的模块，然而里面并没有我们想要的 Vuex，不信自己去看package.json 文件描述了项目包含的文件，项目如何运行等信息
package.json
9.安装 Vuex
在命令行中输入 npm install vuex --save：--save 就是将安装信息写入 package.json
已安装了 Vuex
至此，所有前期工作已经准备完成，遗漏的部分将在实现过程中逐一解释
搞起
零、思路
整个应用可拆分为三个组件
拆
每条笔记包括 编号（ID），标题（title），内容（content），是否已收藏（fav） 四种信息
Vuex 中的 state 得有个地方存放 所有的笔记（notes）
而 收藏，删除 操作只能对 当前的笔记 进行操作，因此我还需要一个标识用来记录 当前的笔记（activeNote） 是哪个
包含 全部 和 收藏 两种切换方式，因此还需要有一个标识来进行区分，就叫 show 吧，all 代表 全部，fav 就代表 已收藏
组件 ==> actions.js ==> mutations.js = > state：通过组件调用 actions 中的方法（dispatch），通过 actions 中的方法调用 mutations 中的方法（commit），通过 mutations 中的方法去操作 state 中的笔记列表（notes），当前笔记（activeNote）等等
一、index.html
<!DOCTYPE html><html> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width,initial-scale=1.0"> <title>vuex-note</title> </head> <body> <div id="app"></div> <!-- built files will be auto injected --> </body></html>
这个没什么说的，注意 div 的 ID 就行
二、main.js
import Vue from 'vue'import App from './App'import store from './store' Vue.config.productionTip = falsenew Vue({ el: '#app',
store,
components: { App }, template: '<App/>'})1.在 import 时什么时候需要 ' ./ '？
从项目模块中导出，引入时不需要 ./，而从自己写的组件中引入时需要 ./
2.什么时候需要 import {aaa} from abc 这种加大括号的引入？什么时候不需要？
当 abc 中被导出的部分是 export aaa 时
当 import 的是被 export default 导出的部分时不加 {}，并且可以起个别名
3.项目结构中并没有 store 文件，只有 store 文件夹，那 import store from './store' 是什么意思？
不知道，求指教
4. new Vue 中单独的 store 是什么意思？
ES6 的一种简写方式，缩写之前是 store:store，这句话的意思是为全局注入 Vuex，这样在各个组件中都可以通过 this.$store 去调用状态库，如果不在全局注入，则需要在每个组件中单独引入，多了会很麻烦
三、app.vue
没什么说的，引入三个组件
<template>
<div id="app">
<tool></tool>
<list></list>
<edit></edit>
</div></template><script>import tool from './components/tool'import edit from './components/edit'import list from './components/list'export default { name: 'App', components: {
tool,
edit,
list
}
}</script><style>#app { font-family: 'Avenir', Helvetica, Arial, sans-serif; -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; text-align: center; color: #2c3e50; margin-top: 60px;
}</style>四、store 下的 index.js
import Vue from 'vue'import Vuex from 'vuex'import getters from './getters'import mutations from './mutations'import actions from './actions'Vue.use(Vuex)
const defaultNote = { id: +new Date(),
title: '新建笔记' + new Date().getMilliseconds(), // 加时间是为了做一下区分
content: '笔记内容', fav: false}// 可以理解为一个状态的仓库 const state = { notes: [defaultNote], // 以数组方式存放所有的笔记
activeNote: defaultNote, // 用来记录当前笔记
show: 'all' // 用于切换 全部 / 已收藏 两种不同列表的标识}export default new Vuex.Store({
state,
getters,
mutations,
actions
})1. Vue.use(Vuex) 是什么意思？
使用 Vuex，今后用 Vue-router 时也得来这么一出，只是得写在 route 文件夹下的 index.js 文件中
2. +new Date() 是什么意思？
获取时间戳的另一种写法，等同于 new Date().getTime()
3.state，getters，mutations，actions 之间的关系？
state：如上所言状态仓库
getters：state 的修饰，比如 state 中有 str:"abc" 这么个属性，而在很多组件中需要进行 str + "def" 的操作，如果在每个组件都进行 str + "def" 的操作未免太麻烦，于是可以在 getters 中增加：
strAdd(){ return this.str + "abc"}
今后在组件中使用 strAdd 就可以了
mutations：简单讲就是用来修改 state 的，同步方法.常规调用 this.$store.commit
actions：简单讲用来调用 mutations 的，异步方法.常规调用 this.$store.dispatch
五、tool.vue
<template>
<div id="tool">
<button class="add" @click="add_note">新增</button>
<button class="fav" @click="fav_note">收藏</button>
<button class="del" @click="del_note">删除</button>
</div></template><script type="text/javascript">
import { mapState, mapGetter, mapActions } from 'vuex'
export default { name: 'tool', methods:{
...mapActions(['add_note','del_note','fav_note'])
}
}</script><style type="text/css" scoped>
#tool { width: 200px; height: 600px; border: 2px solid #ccc; float: left;
}
button { width: 100%; height: calc(100% / 3);
font-size: 60px;
}</style>1.mapState, mapGetter, mapActions 都是什么？
这里有个非常好的解释 http://www.imooc.com/article/14741
此外，当 methods 和 Vuex 的 actions 中具有同名的属性 A 时，可使用 mapActions(['A']) 这种方式简写
注意：1、中括号不能省略；2、中括号内是字符串；3、展开运算符...不能省略
也可以取个别名，写法如下，注意 [] 变成了 {}：
...map({
本组件的属性 : Vuex 中 actions 中的属性
})需要传入参数时，前提是 actions 中的属性（方法）能接收参数：
methods:{
...mapActions(['abc']) // 自定义一个方法，通过触发这个方法调用之前重名的方法并传入参数
tragger_abc(参数){ this.abc(参数)
}
}2.scoped
对当前组件生效的 CSS
3.calc
使用时记得在运算符前后各加一个空格
六、list.vue
<template>
<div id="list">
<div class="switch">
<button class="all" @click='get_switch_note("all")'>全部</button><button class="fav" @click='get_switch_note("fav")'>已收藏</button>
</div>
<div class="search">
<input type="text" placeholder="在这里搜索" v-model="search" />
</div>
<div class="noteList">
<div class="note" v-for="note in search_filteredNote" :class="{favColor:note.fav===true,active:note.id===activeNote.id}" @click='get_select_note(note)'>
<div class="title">
<p>{{note.title}}</p>
</div>
<div class="content">
<p>{{note.content}}</p>
</div>
</div>
</div>
</div></template><script type="text/javascript">
import { mapState, mapGetters, mapActions } from 'vuex'
export default { name: 'list', data: function() { return { search: ""
}
}, computed: {
...mapState(['notes', 'activeNote']),
...mapGetters(['filteredNote']), // 二次过滤：在当前列表(全部 或 已收藏)中进行筛选,返回值被用在组件的 v-for 中
search_filteredNote() { if(this.search.length > 0) { // 如果输入框有值,返回二次过滤的结果并加载
return this.filteredNote.filter(note => { if(note.title.indexOf(this.search) > 0) { return note
}
})
} else { // 输入框没值,不过滤,直接拿来加载
return this.filteredNote
}
}
}, methods: {
...mapActions(['select_note', 'switch_note']),
get_select_note(note) { this.select_note(note)
},
get_switch_note(type) { this.switch_note(type)
}
}
}</script><style type="text/css" scoped="scoped">
#list { width: 300px; height: 600px; border: 2px solid #ccc; float: left; margin-left: 10px; display: flex; flex-direction: column;
}
p { margin: 0;
}
.switch {}
.switch button { height: 60px; width: 50%; font-size: 40px;
}
.search { border: 1px solid #CCCCCC
}
input { width: 100%; box-sizing: border-box; height: 50px; line-height: 50px; padding: 10px; outline: none; font-size: 20px; border: none;
}
.noteList { flex-grow: 1; overflow: auto;
}
.note { border: 1px solid #CCCCCC;
}
.favColor { background: pink;
}
.active { background: lightblue
}</style>1.data 中的 search 是干嘛的？可不可以写在 computed 中？
用来与搜索框进行关联。可以写在 computed 中，但 computed 中的属性默认都是 getter ，就是只能获取值，如果想修改，需要设置 setter ，详见官方文档
七、edit.vue
<template>
<div id="edit">
<div class="title">
<input type="text" placeholder="在这里输入标题" v-model="activeNote.title"/>
</div>
<div class="content">
<textarea name="" placeholder="在这里吐槽" v-model="activeNote.content"></textarea>
</div>
</div></template><script type="text/javascript">
import { mapState, mapGetter, mapActions } from 'vuex'
export default { name: 'edit', computed:{
...mapState(['activeNote']) // 当本组件中 computed 中的属性名与 Vuex 中的 state 属性名相同时,就可以在 mapState() 中简写
}
}</script><style type="text/css" scoped="scoped">
#edit { width: 300px; height: 600px; border: 2px solid #ccc; float: left; margin-left: 10px; display: flex; flex-direction: column;
}
.title { border: 1px solid #CCCCCC;
}
input { width: 100%; box-sizing: border-box; height: 50px; line-height: 50px; padding: 10px; outline: none; font-size: 20px; border: none;
}
.content { flex-grow: 1; background: orange; display: flex; flex-direction: column;
}
textarea { width: 100%; box-sizing: border-box; flex-grow: 1; resize: none; padding: 10px; font-size: 20px; outline: none; font-family: inherit;
}</style>八、actions.js
export default {
add_note({commit}) {
commit('ADD_NOTE')
},
select_note({commit}, note) {
commit("SELECT_NOTE", note)
},
del_note({commit}) {
commit("DEL_NOTE")
},
fav_note({commit}) {
commit("FAV_NOTE")
},
switch_note({commit}, type) {
commit("SWITCH_NOTE", type)
}
}1.这是干什么？
这里的每个方法实际上是通过 commit 调用 mutations.js 中的方法；
举个栗子：tool.vue 的 新增 按钮上绑了一个 add_note 自定义方法，在 actions.js 中也定义一个同名的方法，这样就可以在 tool.vue 中的 mapActions 中简写，就是下面这句：
# tool.vue...mapActions(['add_note','del_note','fav_note'])
而 actions.js 中的 add_note 去调用 mutations.js 中写好的 ADD_NOTE 方法，而实际的添加操作也是在 ADD_NOTE 中，组件也好，actions 也好，最终只是调用 ADD_NOTE 。之所以这么做是因为 mutations 中的方法都是同步的，而 actions 中的方法是异步的，不过在本例里没啥区别
九、getters.js
export default { filteredNote: (state) => { if(state.show === 'all') { return state.notes
} else { return state.notes.filter((note) => { if(note.fav === true) { return note
}
})
}
}
}实现一个过滤，根据 show 来判断展示 全部笔记 还是 已收藏笔记
十、mutations.js
import { SWITCH_NOTE, ADD_NOTE, SELECT_NOTE, DEL_NOTE, FAV_NOTE } from './mutation-types'export default {
[ADD_NOTE](state, note = { id: +new Date(), title: '新建笔记' + new Date().getMilliseconds(), content: '笔记内容', fav: false
}) {
state.notes.push(note)
state.activeNote = note
},
[SELECT_NOTE](state, note) {
state.activeNote = note
},
[DEL_NOTE](state) { for(let i = 0; i < state.notes.length; i++) { if(state.notes[i].id === state.activeNote.id) {
state.notes.splice(i, 1)
state.activeNote = state.notes[i] || state.notes[i - 1] || {} return
}
}
},
[FAV_NOTE](state) {
state.activeNote.fav = !state.activeNote.fav
},
[SWITCH_NOTE](state, type) {
state.show = type
}
}1.export default 那里看着好熟悉
ES6 函数的一种写法，中括号 + 常量 作为函数名，这里常量从其它文件引入
十一、mutation-types.js
export const ADD_NOTE = "ADD_NOTE"export const SELECT_NOTE = "SELECT_NOTE"export const DEL_NOTE = "DEL_NOTE"export const FAV_NOTE = "FAV_NOTE"export const SWITCH_NOTE = "SWITCH_NOTE"
抛出常量，mutations.js 中的函数常量就是这里抛出的，查资料说是这么做便于一目了然都有那些方法。
当然，根据个人习惯，你也可以不这么写
以上就是我学习 Vuex 实现笔记应用的一点心得，应用简单，但受益匪浅。然而其中很多名词运用不准确，所以还望各路大神不吝赐教
作者：_我亦飘零
链接：https://www.jianshu.com/p/179fe917297a
共同学习，写下你的评论
评论加载中...
作者其他优质文章
