实战丨Web云开发项目—TodoList待办事项

背景

TodoList 应用，是面向零基础同学的快速入门应用。你可以一行代码完成 TodoList 的本地化搭建，如果你想要网络同步你的 Todo 数据，在多个设备之间实时同步共享，云开发构建仅需 100 行。

体验地址：https://acc.cloudbase.vip/todo/

此项目适用于零基础用户体验使用，通过一定的模块手段集约了整体编码。如果想要深入学习请掌握 js、html、css 等编程技术，自主解析模块中的代码（均为入门原生代码）

如果你不想执行以下步骤翻看代码，可以直接点击下方按钮一键部署

一、构建本地化 TodoList

在本地任意地方新建文本文件，在文件中填入如下内容：

<script
  src="https://acc.cloudbase.vip/todo/src/todo.js"
  charset="utf-8"
></script>

保存，并将后缀改为 html，命名为 index.html【注意：mac 用户推荐使用无格式文本编辑】

使用浏览器打开此 html 文件，浏览器显示如下，即为正常。

如此，你就通过一行代码完成了本地化 Todo 应用的构建。通过此应用，你可以回车新增一条待办，也可以以勾选已完成，修改事项内容，删除事项；当页面关闭再次加载时仍然保留待办事项。

二、将本地 TodoList 发布，给其他人使用

我们只在本地构建了这个应用网站，如何将这个应用分享给其他人呢？

我们需要将这个应用网站发布到云开发静态网站托管中

打开云开发控制台，新建一个按量计费环境（如果已有按量计费环境则直接使用，跳过此步）

按量计费环境创建完毕后，一般自动开通静态网站托管服务，如果未开通点击开通即可。

点击上传文件，将上一步的 index.html 选择上传

上传完毕后，点击上图配置信息中的【默认域名】，即可在公网环境下访问 Todo 应用网站。

默认域名可供您快速验证业务，如您需要对外正式提供网站服务，请绑定您已备案的自定义域名。

三、为 Todo 应用构建后台服务

以上一行代码实现的单一应用网站只能做到在本地进行 Todo 记录，当更换设备时，无法做到同步，接下来，我们来构建后台服务，实现同步需求。

打开云开发控制台，找到上一步操作的环境，打开数据库，新建 todo 集合，如下图所示：

打开环境-登录授权，开启邮箱登录，如下图所示：

开启后点击右边【配置发件人】，参考配置 QQ 邮箱进行配置。

随后，点击右边【应用配置】，填写一下应用名称，如下图所示

配置完成后，将你的云环境 ID 复制保存，填入下步骤代码中

打开之前本地构建的 index.html，填充内容如下所示

<script src="https://acc.cloudbase.vip/todo/src/todo.js" charset="utf-8"></script>
<script src="https://acc.cloudbase.vip/todo/src/login_util.js" charset="utf-8"></script>
<script src="https://imgcache.qq.com/qcloud/tcbjs/1.10.8/tcb.js"></script>
<script>
  let uid = null;
  const app = tcb.init({
    env: "替换自己的云开发环境ID"
  })
  const auth = app.auth({
    persistence: "local"
  });
  const db = app.database();
  window.onload = function () {
    LO.init();
    TODO.init();
  }
  LO.Done = function () {
    uid = app.auth().hasLoginState().user.uid;
    db.collection('todo').doc(uid).get().then(res => {
      if (res.data.length == 0) {
        db.collection('todo').add({
          _id: uid,
          list: TODO.todo,
          time: new Date()
        }).then(res => {
          console.log(res);
          watchtodo();
        })
      }
      else {
        console.log(res);
        TODO.todo = res.data[0].list;
        TODO.todoinit();
        watchtodo();
      }
    })
    app.callFunction({
      name:'todo_getNumber'
    }).then(res=>{
      document.getElementById('model').innerHTML+=`<p class='bottom-des'>共${res.result}人使用云开发TODO</p>`
    })
  }
  TODO.itemChange = function (id, type, des) {
    if (type === 'add') {
      if (des != null) {
        app.uploadFile({
          cloudPath: `todo/${uid}/${TODO.todo[id].file}`,
          filePath: des
        }).then((result) => {
          console.log(result)
          TODO.todo[id].file = result.fileID
          updatetodo()
        });
      } else {
        updatetodo()
      }
    } else if (type === 'delete') {
      if (TODO.todo[id].file != null) {
        app.deleteFile({
          fileList: [TODO.todo[id].file]
        }).then((result) => {
          delete TODO.todo[id]
          console.log(result)
          updatetodo()
        });
      } else {
        delete TODO.todo[id]
        updatetodo()
      }
    } else {
      updatetodo()
    }
  }
  TODO.downLoadfile = function (file) {
    app.downloadFile({
      fileID: file
    })
  }
  function updatetodo() {
    db.collection('todo').doc(uid).update({
      list: db.command.set(TODO.todo),
      time: new Date()
    }).then(res => {
    }).catch(e => {
      console.log(e);
    })
  }
  function watchtodo() {
    db.collection('todo').where({ _id: uid }).watch({
      onChange: (snapshot) => {
        if (snapshot.msgType != "INIT_EVENT") {
          TODO.todo = snapshot.docs[0].list;
          TODO.todoinit();
        }
      },
      onError: (error) => {
        alert('远端数据库监听失败！');
      }
    });
  }
</script>

保存文件，重新上传至静态网站托管中，如此一个有后台服务的 Todo 应用便构建完成了，仍然打开配置信息中的【默认域名】（如果有缓存，可以在链接后加 ?123 等随机数），打开后如下图所示：

应用中引入的登录模块自动展示登录框，输入邮件地址和密码，如果未注册会直接发送注册邮件。

此时，前往邮箱中查看注册邮件，如下图所示：

点击验证链接，将跳转到云开发验证页，验证成功后，显示如下：

此时，返回应用网站，10s 后按钮变为可点击状态，直接点击登录，即可登录成功，登录框消失。

之后，通过邮箱地址和密码即可完成之后登录。

如果你想展示多少人使用 TODO 应用，可以将项目目录 functions 里 todo_getNumber 文件夹上传为云函数

写在最后

本实战项目通过模块化方式构建，直接突出云开发的开发步骤，更加直观。如果你想探寻 Todo 模块的内容，可以自行解压缩读代码。

login_util 模块，是作者构建的一个简易登录插件，可以实现简单的登录操作，提供自定义方法，默认是云开发的邮件登录方式，所以在无自定义时请保证邮件登录配置正确并打开。

todo.js 暴露接口：

TODO.todo; //待办事项内容json，可按照规则直接改变
TODO.todoinit(); //刷新显示待办事项
TODO.itemChange(id, type, des); //监听待办列表变化[id，类型，描述]
TODO.downLoadfile(file); //下载文件触发，可以在上传时修改todo列表file的值

login_util 简易登录窗口插件，默认邮件登录，暴漏接口：

LO.custom; //是否自定义登录方法，默认为false为邮件登录
LO.init(); //初始化方法调用打开登录框，默认邮件登录时则会自动判断，如果登录则触发LO.done(),不会初始化登录框
LO.done(); //当登录完毕时触发，默认登录时可用，自定义无效
LO.close(); //关闭登录框
LO.onClose(); //监听关闭
LO.onLogin(obj); //监听登录按钮，需LO.custom=true才可生效
LO.setBtn(text, disable); //设置登录按钮
LO.setDes(text, style); //设置描述

产品介绍

云开发（Tencent CloudBase，TCB）是腾讯云提供的云原生一体化开发环境和工具平台，为开发者提供高可用、自动弹性扩缩的后端云服务，包含计算、存储、托管等 serverless 化能力，可用于云端一体化开发多种端应用（小程序，公众号，Web 应用，Flutter 客户端等），帮助开发者统一构建和管理后端服务和云资源，避免了应用开发过程中繁琐的服务器搭建及运维，开发者可以专注于业务逻辑的实现，开发门槛更低，效率更高。
开通云开发：https://console.cloud.tencent.com/tcb?tdl_anchor=techsite
产品文档：https://cloud.tencent.com/product/tcb?from=12763
技术文档：https://cloudbase.net?from=10004
技术交流加 Q 群：601134960
最新资讯关注微信公众号【腾讯云云开发】