做个开源博客学习Vite2 + Vue3 (三)博客设计和代码设计

1,899 阅读3分钟

项目搭建好了之后是不是可以编码了呢? 等等不要着急,我们是不是应该先设计一下?比如博客的功能等?

博客设计

先做个简单的个人博客,因为是个人版,所以可以省略注册、登录这些功能,表结构也可以简单一点。 基础功能:添加博文、显示博文、博文列表+查询+分页、讨论列表和添加讨论。 虽然功能弱了一点,但是麻雀虽小五脏俱全,vite2 和 vue3 的基础用法也可以体现一些。

功能设计

001博客功能

是不是做成图更明显一些?

代码设计

002代码结构.png

model设计

003model设计.png

model代码

先来看看 model 的代码。 /src/model/blogModel.js

/**
 * 显示博文用,建表用
 * @returns 博文的全部的属性
 */
export const blog = () => {
  return {
    // id: 0,
    title: '', // 这是一个博客标题
    groupId: 0, // 分组ID
    addTime: new Date(), // 添加时间
    introduction: '', // 这是博客的简介
    concent: '', // 这是博客的详细内容
    state: 1, // 1:草稿;2:发布;3:删除
    viewCount: 0, // 浏览量
    agreeCount: 0, // 点赞数量
    discussCount: 0 // 讨论数量
  }
}

/**
 * 表单用的博文,绑定表单用。
 * * title:文章标题
 * @returns 添加博文需要的属性
 */
 export const blogForm = () => {
  return {
    // id: new Date().valueOf(),
    title: '', // 这是一个博客标题
    addTime: new Date(), // 添加时间
    introduction: '', // 这是博客的简介
    concent: '', // 这是博客的详细内容
    state: 1 // 1:草稿;2:发布;3:删除
  }
}

/**
 * 首页用的博文列表,按需设置字段
 * @returns 博文列表
 */
 export const blogList = () => {
  return {
    id: 0,
    title: '', // 这是一个博客标题
    addTime: '', // 添加时间
    introduction: '', // 这是博客的简介
    viewCount: 0, // 浏览量
    agreeCount: 0, // 点赞数量
    discussCount: 0 // 讨论数量
  }
}

/**
 * 编辑博文用的列表
 * @returns 文章标题列表
 */
 export const articleList = () => {
  return {
    id: 0,
    title: '', // 这是一个博客标题
    addTime: '', // 添加时间
    viewCount: 0, // 浏览量
    agreeCount: 0, // 点赞数量
    discussCount: 0 // 讨论数量
  }
}

/**
 * 建表用的讨论
 * @returns 讨论表
 */
 export const discuss = () => { 
  return {
    // id: 0,
    blogId: 0,
    discusser: '' , // 昵称
    addTime: new Date(), // 时间
    concent: '', // 内容
    agreeCount: 0
  }
}

/**
 * @returns 讨论的model
 */
export const discussList = () => { 
  return {
    id: 0,
    discusser: '' , // 昵称
    addTime: '', // 时间
    concent: '', // 内容
    agreeCount: 0
  }
}

原生js是不需要先定义对象的,只是我感觉把需要的对象放在一起集中管理一下,还是比较方便的,虽然这么做用处不大,因为不是ts,没有任何强制性也没有检查机制,但是还是想集中管理一下。

状态设计

004状态设计.png

状态嘛,简单地说就是多个组件共享的数据,当然这么说不够严谨。

/src/model/blogState.js

import { inject } from "vue"

export const blogState = {
  currentGroupId: 0, // 选择的分组ID。0:没选择
  currentArticleId: 0, // 选择的文章ID。
  editArticleId: 0, // 当前修改的文章ID
  findQuery: { }, // 查询条件
  page: { // 分页参数
    pageTotal: 100,
    pageSize: 2,
    pageIndex: 1,
    orderBy: { id: false }
  }, 
  isReloadDiussList: false
}

/**
* 状态的管理
* * 获取状态
* * 设置当前选择的分组
* * 设置当前选择的文章
* * 设置当前编辑的文章
*/
export default function blogStateManage() {
  // 先把状态取出来,否则在 function 里面无法读取。
  const state = inject('blogState')

  // 子组件里面获取状态
  const getBlogState = (id) => {
    return state 
  }

  // 设置当前选择的分组   
  const setCurrentGroupId = (id) => {
    state.currentGroupId = id
  }

  // 设置当前编辑的文章  
  const setEditArticleId = (id) => {
    state.editArticleId = id
  }

  // 设置更新讨论列表
  const setReloadDiussList = () => {
    state.isReloadDiussList = !state.isReloadDiussList
  }

  return {
    setReloadDiussList, // 设置更新讨论列表
    getBlogState, // 获取状态
    setEditArticleId, // 设置当前编辑的文章
    setCurrentGroupId // 设置当前选择的分组
  }
}

算是一个简易的状态管理吧,先定义一下需要的状态,在main里面注入状态,然后用 inject 提取状态,再写几个设置状态的函数,基本就可以搞定了。

后续想写成插件的形式,当然会完善一些功能,不会这么单薄。

感觉 Vuex 有点太厚重了,这里也不需要那么强大的功能,所以就自己实现了一个简单的。

未完待续,后面更精彩。

源码

gitee.com/naturefw/vu…

在线演示

naturefw.gitee.io/vue3-blog