微信小程序入门之构建一个简单TODOS应用

    xiaoxiao2021-03-25  61

    最近,由于工作需要开始了解微信小程序,虽然小程序已经出了很久了,刚出的那段时间很火,看到很多关于小程序的技术文章,不过现在似乎没那么火了,anyway,我们还是可以学习下的。

    一、了解微信小程序

    1.理念:小程序开发框架的目标是通过尽可能简单、高效的方式让开发者可以在微信中开发具有原生 APP 体验的服务。 2.框架:框架的核心是一个响应的数据绑定系统。整个系统分为两块视图层(View)和逻辑层(App Service),框架可以让数据与视图非常简单地保持同步。当做数据修改的时候,只需要在逻辑层修改数据,视图层就会做相应的更新。 3.相关资料:调试工具下载,简易教程

    初步了解这些基本信息后,我们先来看下TODOS这个应用做出来的最终效果

    二、TODOS应用功能演示及目录结构

    功能演示:

    目录结构:

    主要功能模块为:

    index页面,新建任务,可完成增删等操作 los页面,记录在index页面的操作

    下面我们详细介绍下

    三、代码详解

    1.简单配置app.json文件:

    { "pages":[ "pages/index/index", // 设置页面路径,项目打开后找到这个路径下的文件 "pages/logs/logs" ], "window":{ // 设置默认页面的窗口表现 "backgroundTextStyle":"light", "navigationBarBackgroundColor": "#fff", "navigationBarTitleText": "TODOS", "navigationBarTextStyle":"black" }, "tabBar": { // 设置底部tab的表现 "borderStyle": "white", "backgroundColor": "#f5f5f5", "selectedColor": "#222", "list": [ // 对应底部下面两个菜单项;TODOS和LOGS { "pagePath": "pages/index/index", "text": "TODOS", "iconPath": "images/home.png", "selectedIconPath": "images/home-actived.png" }, { "pagePath": "pages/logs/logs", "text": "LOGS", "iconPath": "images/note.png", "selectedIconPath": "images/note-actived.png" } ] } }

    2.app.js和app.wxss文件

    App() 函数用来注册一个小程序。接受一个 object 参数,其指定小程序的生命周期函数等。App() 必须在 app.js 中注册,且不能注册多个。 示例代码

    App({ onLaunch: function() { // Do something initial when launch. }, onShow: function() { // Do something when show. }, onHide: function() { // Do something when hide. }, onError: function(msg) { console.log(msg) }, globalData: 'I am global data' })

    在这个项目中不需要加什么代码在App({})中,所以文件中只有一个App({}) app.wxss文件主要可以设置一些全局样式

    page { height: 100%; font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; }

    3.注册页面Page

    Page() 函数用来注册一个页面。接受一个 object 参数,其指定页面的初始数据、生命周期函数、事件处理函数等。

    一.初始化数据

    // ===== 页面数据对象 ===== data: { input: '', todos: [], leftCount: 0, allCompleted: false, logs: [], addOneLoading: false, loadingHidden: true, loadingText: '', toastHidden: true, toastText: '', clearAllLoading: false },

    初始化数据作为页面的第一次渲染。data将会以JSON的形式由逻辑层传至渲染层,其数据可以是:字符串,数字,布尔值,对象,数组。 渲染层可以通过WXML对数据进行绑定。

    <input class="new-todo" value="{{ input }}" placeholder="Anything here..." auto-focus bindinput="inputChangeHandle" bindchange="addTodoHandle"/>

    如上述代码中的input.

    二.生命周期函数

    // ===== 页面生命周期方法 ===== onLoad: function () { // 从缓存获取任务列表数据,并用setData设置 var todos = wx.getStorageSync('todo_list') // 调用 WX API 从本地缓存中获取数据 if (todos) { var leftCount = todos.filter(function (item) { return !item.completed }).length this.setData({ todos: todos, leftCount: leftCount }) } // 设置logs数据 var logs = wx.getStorageSync('todo_logs') if (logs) { this.setData({ logs: logs }) } }, onLoad: 页面加载 一个页面只会调用一次。接收页面参数可以获取wx.navigateTo和wx.redirectTo及中的 query。 setData: 接受一个对象,以 key,value 的形式表示将 this.data 中的 key 对应的值改变成 value。

    三.事件处理函数

    新增任务处理函数: addTodoHandle: function (e) { if (!this.data.input || !this.data.input.trim()) return this.setData( { addOneLoading: true }); //open loading this.setData( { loadingHidden: false, loadingText: 'Waiting...' }); var todos = this.data.todos todos.push({ name: this.data.input, completed: false }) var logs = this.data.logs logs.push({ timestamp: new Date().toLocaleString(), action: '新增', name: this.data.input }) this.setData({ input: '', todos: todos, leftCount: this.data.leftCount + 1, logs: logs }) this.save() }, save: function () { wx.setStorageSync('todo_list', this.data.todos) wx.setStorageSync('todo_logs', this.data.logs) //close loading and toggle button loading status var self = this; setTimeout( function() { self.setData( { loadingHidden: true, addOneLoading: false, loadingText: '' }); }, 100); },

    主要把时间new Date().toLocaleString(), action:'新增',事件名 name: this.data.input这三个字段push到todos这个data数据中;然后在save()中通过wx.setStorageSync('todo_list', this.data.todos)设置缓存。

    任务项点击状态切换函数: toggleTodoHandle: function (e) { var index = e.currentTarget.dataset.index var todos = this.data.todos todos[index].completed = !todos[index].completed var logs = this.data.logs logs.push({ timestamp: new Date().toLocaleString(), action: todos[index].completed ? '标记完成' : '标记未完成', name: todos[index].name }) this.setData({ todos: todos, leftCount: this.data.leftCount + (todos[index].completed ? -1 : 1), logs: logs }) this.save() },

    var index = e.currentTarget.dataset.index 获取当前索引,对应的wxml代码为:

    <view class="item{{ item.completed ? ' completed' : '' }}" wx:for="{{ todos }}" wx:key="{{ index }}" bindtap="toggleTodoHandle" data-index="{{ index }}"> <!-- completed: success, todo: circle --> <icon class="checkbox" type="{{ item.completed ? 'success' : 'circle' }}"/> <text class="name">{{ item.name }}</text> <icon class="remove" type="clear" size="16" catchtap="removeTodoHandle" data-index="{{ index }}"/> </view>

    bindtap: 当用户点击该组件的时候会在该页面对应的Page中找到相应的事件处理函数

    最后考虑到了loading的效果,要利用button组件的loading属性来实现。但是loading仅仅是一个样式的控制,它不会控制这个按钮是否能重复点击。所以还要利用button的disabled属性,防止重复点击。

    <button type="primary" size="mini" bindtap="addTodoHandle" loading="{{addOneLoading}}" disabled="{{addOneLoading}}"> + Add </button>

    js:

    loadingChange: function() { this.setData({ loadingHidden: true, loadingText: '' }); }, toastChange: function() { this.setData( { toastHidden: true, toastText: '' }); }

    LOGS页面比较简单,主要通过var logs = wx.getStorageSync('todo_logs') 获取logs列表,然后在页面渲染,这里就不贴代码了。

    至此,基本了解了TODOS应用的构建过程,通过代码详解、参考微信小程序官方文档了解了微信自家开发的视图层描述语言WXML和WXSS,以及基于 JavaScript 的逻辑层框架;与HTML页面结构相似,对应HTML,CSS,JAVASCRIPT; 所以学习起来比较容易。不过仅仅通过这个TODOS应用,还只是了解小程序这个平台的一些基本用法。复杂一点,页面跳转,网络请求等都需要我们去实践,才能对小程序了解得更多。

    完整代码: 源代码

    参考资料: 1.https://github.com/zce/weapp-todos 2.http://www.cnblogs.com/lyzg/p/5906496.html

    转载请注明原文地址: https://ju.6miu.com/read-34847.html

    最新回复(0)