文档章节

零基础开发『仿知乎』小程序具体步骤

第九程序
 第九程序
发布于 2017/04/19 14:55
字数 3154
阅读 114
收藏 0

有多少人想开发个小程序,结果发现自己的基础为0.

今天,给大家分享一个励志案例:一个读大气科学、自学前端开发的妹子,因为喜欢逛知乎,自己做出了一款「仿知乎」小程序。

希望她的开发经验,能帮大家轻松愉悦地迈出小程序开发的第一步。

作者 | Rebecca Han
WEB 前端/不靠谱天气预报员/想做代码小仙女

微信小程序开始内测到现在,我终于把自己的微信小程序 demo 完成了。

真的是墨迹完的,连我自己都佩服自己的拖延症了(懒癌少女已弃疗 ヾ(´A`)ノ゚) 总之,算是基本完成了(明明有很多组件啊、API 啊根本都没用好嘛 →_→)以及从来不写 blog 的我也出来码字啦 (ノ◕ヮ◕)ノ:・゚✧

之前有很长一段时间,我算是知乎重度依赖。所以,这次 demo 的模仿对象选择的是知乎(但是写到一半发现我这个决定坑了,这是后话)。

Demo 的界面设计以及交互设计,均来自于知乎 Android 版本。

  • 工具:使用的是微信 web 开发者工具,这个工具已经全面对非邀请内测用户开放,且在持续更新中(我码代码的过程中就更新了两版,所以开发时 IDE 版本不唯一)。其实,忍受了半个小时微信的开发者工具之后,我就改在 Webstorm 中编辑了,微信工具成了运行预览的工具。不过听说 IDE 中预览的效果,也不能保证与真机一样哦~
  • 设计和功能:参照的是知乎安卓版本非常之简易版,为了防止版权问题,Demo 中的 fake 数据使用的是我自己的回答。

文件构建

1. 基础文件

app.json:

{
  "pages": [
    "pages/index/index", 
    "pages/discovery/discovery",
    "pages/notify/notify",
    "pages/chat/chat",
    "pages/more/more",
    "pages/answer/answer",
    "pages/question/question"

  ], 
  "window": {
    "backgroundTextStyle": "light",
    "navigationBarBackgroundColor": "#0068C4",
    "navigationBarTitleText": "知乎",
    "navigationBarTextStyle": "white",
    "enablePullDownRefresh": true
  }, 
  "tabBar": {
    "color": "#626567",
    "selectedColor": "#2A8CE5",
    "backgroundColor": "#FBFBFB",
    "borderStyle": "white"
    "list": [{
      "pagePath": "pages/index/index",
      "text": "",
      "iconPath": "images/index.png",
      "selectedIconPath": "images/index_focus.png"
    }, {
      "pagePath": "pages/discovery/discovery",
      "text": "",
      "iconPath": "images/discovery.png",
      "selectedIconPath": "images/discovery_focus.png"
    }, {
      "pagePath": "pages/notify/notify",
      "text": "",
      "iconPath": "images/ring.png",
      "selectedIconPath": "images/ring_focus.png"
    }, {
      "pagePath": "pages/chat/chat",
      "text": "",
      "iconPath": "images/chat.png",
      "selectedIconPath": "images/chat_focus.png"
    }, {
      "pagePath": "pages/more/more"
      "text": ""
      "iconPath": "images/burger.png"
      "selectedIconPath": "images/burger_focus.png"
    }]
  }, 
  "networkTimeout": {
    "request": 10000,
    "downloadFile": 10000
  },
  "debug": true
}

app.json 文件中是对整个小程序的全局配置,主要用到的字段有pageswindowtabBarnetworkTimeout

  • pages 字段:所有小程序的页面都要在该字段中注册,该字段数组中的第一个 page 默认为小程序首页(设置 tab 除外),没有在 pages 字段注册过的页面貌似不能够进行有效的编译(之前版本的编辑器没有这个限制,只是会影响配置文件等的生效,编辑器更新后会报未注册的错误)。
  • window 字段:大多是关于小程序顶部 navigationbar 的一些设置。
  • tabBar 字段:如果你需要首页底部带 tabbar 的样式,那么就在 tabBar 字段中设置每个 tab 对应的页面,按顺序对应左至右,包括路径、tab 文字、tab 图标和选中状态图标。
  • networkTimeout:设置网络超时时间。
  • debug:开启 debug 模式。

app.wxss 文件中为全局样式,也就是说这个文件中的样式在所有的 pages 中均可使用。若其他页面文件的 WXSS 中定义了与该样式文件中相同的属性,则该文件中的样式被覆盖,规则与 CSS 优先规则大致相通。

app.js 用于调用 login 接口、回调、周期函数、本地存储等等逻辑代码。

2. 页面文件

zhihu-1

页面文件由四部分组成。

例如,我们有一个首页叫做 index,则需要在 pages 文件夹下创建文件名相同的三个必要文件:

  • index.wxml
  • index.wxss
  • index.js

另外 index.json 文件为可选,功能与 app.json 相同,为该页面的配置文件,但定义功能有限。

3. UI

跟平时开发一样,最开始当然是码 UI。

除了需要依照微信的一些新的标签和样式规则,其他与平时码 UI 并没有太大的不同。

而且需要强调的是,flex 布局在微信小程序中 hin~~~~好用

不过,同时作为女生和程序员,不挑刺可就不是我了,所以下面列举了一些我遇上的坑,其中有些也许不正确(多多包涵啦\(//∇//)\),有些也许已在 IDE 更新中修正:

  1. 有一些 CSS 样式在微信 IDE 中不支持,例如 font-weightletter-spacing(以及调整字间距的样式)等;
  2. <text/> 不支持嵌套,<text/> 两层嵌套的结构下,内层中的内容会连续显示两次(在 IDE 后续更新中已修正);
  3. 若 <view/> 与 <text/> 同级,则在实际使用中,<view /> 会遮住 <text />。为了防止内容相叠,必须使用 <view/> 相并列。所以并不像某些地方说的,可以完全地把 <view/> 当做 <div> 去使用!
  4. 元素之前有垂直相邻 margin 的时候,在微信小程序中会 double 显示,即两个元素的 margin 均摊开,不遵循 margin 折叠规则;
  5. 标签 hidden 属性无效(v0.10.101400 中已修正);
  6. 部分情况下,平级元素标签优先级会出现问题。比如, 平级标签 A 与 B,当 B 通过某些调整向 A 元素位置相叠的时候,微信 IDE 解析出的效果是 A 的内容和背景色会覆盖 B 元素与之重叠的部分(普通浏览器解析应该是 B 覆盖 A);
  7. 如果用模板+列表渲染的方式来渲染数据的话,在模板中使用列表渲染的{{item}} 是无效的,无法被正确识别。所以,列表渲染的时候,要把复用的部分写在列表渲染的代码块内(属于数据渲染部分,后面会提到)。

在后来,微信 IDE 的迭代中已经将上面清单中的一些问题修正了,所以这份清单有可能是过时的。大家也可以根据实际情况,自行尝试。

接下来,我将对于一些 demo 中写到用到的部分进行说明。

开始实战开发

1. 列表式的数据渲染

zhihu-2

类似于「首页」以及「发现页」这种标准列表式的数据展现方式,微信提供了很好的方案:列表渲染。

<block wx:for="{{feed}}" wx:for-index="idx" wx:for-item="item" data-idx="{{idx}}">
  <view class="feed-item">
    <view class="feed-source">
      <a class="">
        <view class="avatar">
          <image src="{{item.feed_source_img}}"> </image>
        </view>
        <text> {{item.feed_source_name}} {{item.feed_source_txt}} </text>
      </a>
      <image class="item-more" mode="aspectFit" src="../../images/more.png"></image>
    </view>
    <view class="feed-content">
      <view class="question" qid="{{question_id}}" bindtap="bindQueTap">
        <a class="question-link">
          <text>{{item.question}}</text>
        </a>
      </view>
      <view class="answer-body">
        <view bindtap="bindItemTap">
          <text class="answer-txt" aid="{{answer_id}}"> {{item.answer_ctnt}} </text>
        </view>
        <view class="answer-actions" bindtap="bindItemTap">
          <view class="like dot"> <a>{{item.good_num}} 赞同 </a> </view>
          <view class="comments dot"> <a>{{item.comment_num}} 评论 </a> </view>
          <view class="follow-it"> <a>关注问题</a> </view>
        </view>
      </view>
    </view>
  </view>
</block>

可以直观地看出,就是 for 循环用重复的结构渲染一组数据:

  • for="{{}}“中的内容是想要循环的一组数据,最外层为数组结构
  • for-item 指定数组中当前元素的变量名
  • for-index 指定数组中当前元素下标变量名

同样也使用了 for 渲染的,还有顶部的发现页和通知页等顶部的自定义 tabbar。

2. 顶部 Tabbar 实现

zhihu-4

微信只提供了底部 tabbar,所以顶部的要自己写喽~

顶部 tab bar 的实现在于 for 列表渲染以及 JS 配合。

实例 WXML 代码:

<view class="top-tab flex-wrp flex-tab ">
  <view class="toptab 
        flex-item {{currentNavtab==idx ? 'active' : ''}}" wx:for="{{navTab}}" wx:for-index="idx" wx:for-item="itemName" data-idx="{{idx}}" bindtap="switchTab"> {{itemName}} </view>
</view>
<scroll-view scroll-y="true" class="container discovery withtab" bindscrolltoupper="upper" bindscrolltolower="lower" scroll-into-view="{{toView}}" scroll-top="{{scrollTop}}">
  <view class="ctnt0" hidden="{{currentNavtab==0 ? '' : true}}"> </view>
  <view class="ctnt1 placehold" hidden="{{currentNavtab==1 ? '' : true}}">
    <text>圆桌</text>
  </view>
  <view class="ctnt2 placehold" hidden="{{currentNavtab==2 ? '' : true}}">
    <text>热门</text>
  </view>
  <view class="ctnt3 placehold" hidden="{{currentNavtab==3 ? '' : true}}">
    <text>收藏</text>
  </view>
</scroll-view>

JS 代码:

//discovery.js
Page({
  data: {
    navTab: ["推荐", "圆桌", "热门", "收藏"]
    , currentNavtab: "0"
  }
  , onLoad: function () {
    console.log('onLoad')
  }
  , switchTab: function (e) {
    this.setData({
      currentNavtab: e.currentTarget.dataset.idx
    });
  }
});

由于微信不支持使用 DOM 访问对象,也就是不支持 dom 和 window 对象,所以 tab bar 的实现依赖于微信提供的视图层的展示逻辑,以及视图与数据之间的绑定机制。

绑定点击事件,通过改变一个 data- 属性的值,来控制元素的类的改变(从而改变样式等)。

3. 轮播图

以下是实现的 WXML 代码:

<swiper class="activity" indicator-dots="{{indicatorDots}}" autoplay="{{autoplay}}" interval="{{interval}}" duration="{{duration}}">
  <block wx:for="{{imgUrls}}">
    <swiper-item>
      <image src="{{item}}" class="slide-image" width="355" height="155" /> 
    </swiper-item>
  </block>
</swiper>

JS 代码:

imgUrls: [
  '../../images/24213.jpg'
  , '../../images/24280.jpg'
  , '../../images/1444983318907-_DSC1826.jpg'
]
  , indicatorDots: false
  , autoplay: true
  , interval: 5000
  , duration: 1000
  , feed: []
  , feed_length: 0

轮播图的实现使用的是微信提供的 swiper 组件,该组件贴心的提供了各种属性选择,常用的包括 autoplay,interval 时间 duration 等

swiper-item 中包含的是所有轮播的图片,为了方便修改图片数据,同样采用 for 渲染绑定 data 的方式。

4. 下拉刷新,上拉加载,以及数据请求

刷新及继续加载的动作,依靠的是 scroll-view 标签,及配套的 upper 和 lower 事件。

标签的属性提供了 bindscrolltoupper 和 bindscrolltolower 来绑定滚动到顶部及底部所触发的事件,同时 upper-threshold 和 lower-threshold 能够调整触发时距边界的距离。

除上述之外,小程序的 API 还提供横向滚动、滚动触发事件、设置滚动条位置等接口

<scroll-view scroll-y="true" class="container" bindscrolltoupper="upper" upper-threshold="10" lower-threshold="5" bindscrolltolower="lower" scroll-into-view="{{toView}}" scroll-top="{{scrollTop}}">
  <block wx:for="{{feed}}" wx:for-index="idx" wx:for-item="item" data-idx="{{idx}}">
    <view class="feed-item">
      <view class="feed-source">
        <a class="">
          <view class="avatar">
            <image src="{{item.feed_source_img}}"> </image>
          </view>
          <text> {{item.feed_source_name}} {{item.feed_source_txt}} </text>
        </a>
        <image class="item-more" mode="aspectFit" src="../../images/more.png"> </image>
      </view>
      <view class="feed-content">
        <view class="question" qid="{{question_id}}" bindtap="bindQueTap">
          <a class="question-link">
            <text>{{item.question}}</text>
          </a>
        </view>
        <view class="answer-body">
          <view bindtap="bindItemTap">
            <text class="answer-txt" aid="{{answer_id}}"> {{item.answer_ctnt}} </text>
          </view>
          <view class="answer-actions" bindtap="bindItemTap">
            <view class="like dot"> <a>{{item.good_num}} 赞同 </a> </view>
            <view class="comments dot"> <a>{{item.comment_num}} 评论 </a> </view>
            <view class="follow-it"> <a>关注问题</a> </view>
          </view>
        </view>
      </view>
    </view>
  </block>
</scroll-view>

滚动至顶或至底时,触发的加载数据的事件,本应该调用微信提供的网络请求 API 来获取数据。

但是比较坑的是,我在选择写仿知乎 demo 的时候没有注意到知乎不提供开放 API,而微信的 API 不支持直接对 JSON 文件进行本地请求。

无奈之下,选择在 JS 文件中伪造一段数据,用 module.exports 抛出,来 fake 数据请求:


upper: function () {
  wx.showNavigationBarLoading()
  this.refresh();
  console.log("upper");
  setTimeout(function () {
    wx.hideNavigationBarLoading();
    wx.stopPullDownRefresh();
  }, 2000);
}, lower: function (e) {
  wx.showNavigationBarLoading();
  var that = this;
  setTimeout(function () {
    wx.hideNavigationBarLoading();
    that.nextLoad();
  }, 1000);
  console.log("lower")
}, //scroll: function (e) {
//  console.log("scroll")
//},
//网络请求数据, 实现刷新
refresh0: function () {
  var index_api = '';
  util.getData(index_api).then(function (data) {
    //this.setData({
    //
    //});
    console.log(data);
  });
}, //使用本地 fake 数据实现刷新效果
refresh: function () {
  var feed = util.getDiscovery();
  console.log("loaddata");
  var feed_data = feed.data;
  this.setData({
    feed: feed_data
    , feed_length: feed_data.length
  });
}, //使用本地 fake 数据实现继续加载效果
nextLoad: function () {
  var next = util.discoveryNext();
  console.log("continueload");
  var next_data = next.data;
  this.setData({
    feed: this.data.feed.concat(next_data)
    , feed_length: this.data.feed_length + next_data.length
  });
}

由于是 fake 的数据,所以这个 demo 并没有做真实的带参跳转,查询等功能。

加载数据的同时,使用微信提供的加载动画 wx.showNavigationBarLoading();

zhihu-5

5. 其他

  • 为了实现点击跳转页面,使用了 wx.navigateTo 进行页面跳转以及点击事件绑定;
  • 部分常用组件的模块化;
  • inputimage 组件等的使用。

6. 后续

其实还有大量的组件和 API 还没有用过,这个 demo 也许后续还会有更新呦,这取决于懒癌少女的病情严重程度了。

一点感受

其实作为一个小前端,由于工作中的原因,使用 MVVM 其实是非常少的。

不过,写了这个微信小程序 demo 之后,更加把这方面的思维理顺了。当然,写完之后回头看,还是有超多的不足,明明好些地方能再换一种写法的。

这毕竟是我第一次尝试用新鲜热乎的东西写小 demo,也是第一次尝试写教程……或者算是记录?whatever~~

Anyway~ 希望除了写代码之外,还能在码文字的道路上也多走走吧,毕竟我是要做代码小仙女的人呀\(≧∀≦)ゞ

© 著作权归作者所有

第九程序
粉丝 84
博文 142
码字总数 172691
作品 0
厦门
程序员
私信 提问
Android零基础入门第86节:探究Fragment生命周期

一个Activity可以同时组合多个Fragment,一个Fragment也可被多个Activity 复用。Fragment可以响应自己的输入事件,并拥有自己的生命周期,但它们的生命周期直接被其所属的Activity的生命周期...

鑫鱻
2017/10/30
29
0
Android零基础入门第82节:Activity数据回传

上一节学习了将简单的数据从MainActivity传递到SecondActivity,本节一起来学习数据如何从SecondActivity回传到MainActivity。 一、简介 前面己经提到,Activity 还提供了一个 startActivit...

鑫鱻
2017/10/24
24
0
Android零基础入门第79节:Intent 属性详解(上)

Android应用将会根据Intent来启动指定组件,至于到底启动哪个组件,则取决于Intent的各属性。本期将详细介绍Intent的各属性值,以及 Android如何根据不同属性值来启动相应的组件。 Intent 对...

鑫鱻
2017/10/19
10
0
Android零基础入门第78节:四大组件的纽带——Intent

前面学习Activity时己经多次使用了 Intent,当一个Activity需要启动另一个Activity时, 程序并没有直接告诉系统要启动哪个Activity,而是通过Intent来表达自己的意图:需要启动哪个Activity。...

鑫鱻
2017/10/18
29
0
Android零基础入门第81节:Activity数据传递

在Android开发中,经常要在Activity之间传递数据。前面也学习了Activity和Intent相关基础,接下来一起来学习Activity的数据传递。 一、简介 通过前面的学习知道,Intent可以用来开启Activit...

鑫鱻
2017/10/23
33
0

没有更多内容

加载失败,请刷新页面

加载更多

JS基础-该如何理解原型、原型链?

JS的原型、原型链一直是比较难理解的内容,不少初学者甚至有一定经验的老鸟都不一定能完全说清楚,更多的"很可能"是一知半解,而这部分内容又是JS的核心内容,想要技术进阶的话肯定不能对这个...

OBKoro1
今天
6
0
高防CDN的出现是为了解决网站的哪些问题?

高防CDN是为了更好的服务网络而出现的,是通过高防DNS来实现的。高防CDN是通过智能化的系统判断来路,再反馈给用户,可以减轻用户使用过程的复杂程度。通过智能DNS解析,能让网站访问者连接到...

云漫网络Ruan
今天
14
0
OSChina 周一乱弹 —— 熟悉的味道,难道这就是恋爱的感觉

Osc乱弹歌单(2019)请戳(这里) 【今日歌曲】 @xiaoshiyue :好久没分享歌了分享张碧晨的单曲《今后我与自己流浪》 《今后我与自己流浪》- 张碧晨 手机党少年们想听歌,请使劲儿戳(这里)...

小小编辑
今天
2.7K
24
SpringBoot中 集成 redisTemplate 对 Redis 的操作(二)

SpringBoot中 集成 redisTemplate 对 Redis 的操作(二) List 类型的操作 1、 向列表左侧添加数据 Long leftPush = redisTemplate.opsForList().leftPush("name", name); 2、 向列表右......

TcWong
今天
46
0
排序––快速排序(二)

根据排序––快速排序(一)的描述,现准备写一个快速排序的主体框架: 1、首先需要设置一个枢轴元素即setPivot(int i); 2、然后需要与枢轴元素进行比较即int comparePivot(int j); 3、最后...

FAT_mt
昨天
6
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部