最近微信小程序被炒得很火热,本人也抱着试一试的态度下载了微信web开发者工具,开发工具比较简洁,功能相对比较少,个性化设置也没有。了解完开发工具之后,顺便看了一下小程序的官方开发文档,大概了解了小程序的开发流程和一些常用的API。

了解了小程序之后,自己就有了想要做一个小demo的冲动,虽然自己对小程序还没有做过很多实践,只是在官方例子上徘徊,但是还是想做出点小东西。既然要做一个demo,自然需要到数据,自己有又不想独自搭建服务端,所以在网上搜索可以用来提供测试数据的免费api,最后我选择了豆瓣图书。豆瓣图书提供的api功能比较少,加上不开放appkey申请,所以无法操作用户数据。只能做点简单的图书查询和图书详细信息展示,这个demo只有两个页面,非常之简单。

豆瓣图书API

demo中用到的豆瓣图书api只有两个,一个是图书搜索,另一个是获取图书详情。

搜索图书

GET https://api.douban.com/v2/book/search

参数 意义 备注
q 查询关键字 q和tag必传其一
tag 查询的tag q和tag必传其一
start 取结果的offset 默认为0
count 取结果的条数 默认为20,最大为100

返回status=200

  1. {
  2. "start": 0,
  3. "count": 10,
  4. "total": 30,
  5. "books" : [Book, ...]
  6. }

获取图书详情

GET https://api.douban.com/v2/book/:id

参数 意义
:id 图书id

以下是具体图书的详情信息,部分demo中用不到的信息省略

  1. {
  2. "id":"1003078",
  3. "title":"小王子",
  4. "alt":"https:\/\/book.douban.com\/subject\/1003078\/",
  5. "image":"https://img3.doubanio.com\/mpic\/s1001902.jpg",
  6. "author":[
  7. "(法)圣埃克苏佩里"
  8. ],
  9. "publisher":"中国友谊出版公司",
  10. "pubdate":"2000-9-1",
  11. "rating":{"max":10,"numRaters":9438,"average":"9.1","min":0},
  12. "author_intro":"圣埃克苏佩里(1900-1944)1900年,玛雅·戴斯特莱姆......",
  13. "catalog":"序言:法兰西玫瑰\n小王子\n圣埃克苏佩里年表\n"
  14. }

Demo编写

创建项目

项目取名为DouBanBookApp,项目的结构小程序默认的结构一样

  1. DouBanBookApp
  2. pages
  3. index 首页
  4. index.js
  5. index.wxml
  6. index.wxss
  7. detail 详情页
  8. detail.js
  9. detail.wxml
  10. detail.wxss
  11. requests
  12. api.js API地址
  13. request.js 网络请求
  14. utils
  15. util.js 工具
  16. app.js
  17. app.json
  18. app.wxss

应用的主调色参考了豆瓣app的色调,采用了偏绿色。

首页

首页顶部展示搜索输入框,用户输入图书名称,点击搜索按钮,展示图书列表。图书可能会很多,不能一下子全部展示,需要用到分页,app上最常见的列表分页就是上拉加载模式,根据小程序提供的组件中,找到了一个比较符合场景的scroll-view组件,这个组件有一个下拉到底部自动触发的bindscrolltolower事件。

先制作出界面的静态效果,之后再整合API,由于本人对界面设计不敏感,所以随便弄了一个粗糙的布局,看得过去就行了,嘿嘿~~

index.wxml

  1. <view class="search-container">
  2. <input type="text" placeholder="输入书名搜索"></input><icon type="search" size="20"/>
  3. </view>
  4. <scroll-view scroll-y="true" style="width:100%;position:relative;top:40px;height:200px">
  5. <view style="text-align:center;padding-top:50rpx;">
  6. <icon type="cancel" color="red" size="40" />
  7. <view><text>没有找到相关图书</text></view>
  8. </view>
  9. <view style="text-align:center;padding-top:50rpx;">
  10. <icon type="search" size="60" />
  11. <view><text>豆瓣图书</text></view>
  12. </view>
  13. <view class="header">
  14. <text>图书 10本图书</text>
  15. </view>
  16. <view class="common-list">
  17. <view class="list-item">
  18. <view class="index-list-item">
  19. <view class="cover">
  20. <image class="cover-img" src="data:images/demo.png"></image>
  21. </view>
  22. <view class="content">
  23. <view class="title">图书标图</view>
  24. <text class="desc">9.0/oopsguy/2016-07-08</text>
  25. </view>
  26. </view>
  27. </view>
  28. </view>
  29. <view class="refresh-footer">
  30. <icon type="waiting" size="30" color="reed" />
  31. </view>
  32. </scroll-view>

index.wxss

  1. page {
  2. background: #F2F1EE;
  3. }
  4. /*seach*/
  5. .search-container {
  6. position: fixed;
  7. top: 0;
  8. right: 0;
  9. left: 0;
  10. background-color: #42BD56;
  11. color: #FFF;
  12. height: 40px;
  13. padding: 0 10rpx;
  14. z-index: 100;
  15. }
  16. .search-container input {
  17. background: #FFF;
  18. color: #AAA;
  19. margin-top: 5px;
  20. padding: 5px 10rpx;
  21. height: 20px;
  22. border-radius: 8rpx;
  23. }
  24. .search-container icon {
  25. position: absolute;
  26. top: 10px;
  27. right: 20rpx;
  28. }
  29. /*header*/
  30. .header {
  31. padding: 20rpx 30rpx;
  32. }
  33. .header text {
  34. color: #A6A6A6;
  35. }
  36. /*common list*/
  37. .list-item {
  38. position: relative;
  39. overflow: hidden
  40. }
  41. /*index list*/
  42. .index-list-item {
  43. background: #FFF;
  44. padding: 15rpx 30rpx;
  45. overflow: hidden;
  46. }
  47. .index-list-item::active {
  48. background: #EEE;
  49. }
  50. .index-list-item .cover {
  51. float: left;
  52. width: 120rpx;
  53. height: 160rpx;
  54. overflow: hidden
  55. }
  56. .index-list-item .cover image.cover-img {
  57. width: 120rpx;
  58. height: 160rpx;
  59. }
  60. .index-list-item .content {
  61. margin-left: 140rpx;
  62. }
  63. .index-list-item .title {
  64. display: inline-block;
  65. height: 90rpx;
  66. padding-top: 20rpx;
  67. overflow: hidden;
  68. }
  69. .index-list-item .desc {
  70. display: block;
  71. font-size: 30rpx;
  72. padding-top: 10rpx;
  73. color: #AAA;
  74. white-space:nowrap;
  75. overflow: hidden;
  76. text-overflow: ellipsis;
  77. }
  78. .refresh-footer {
  79. text-align: center;
  80. padding: 10rpx 0;
  81. }

图书详细页面

图书详细页面就是展示具体的图书信息,通用首页穿过了的图书id来获取图书信息之后在展示出来,获取的过程中可能有延迟,需要一个加载效果来过渡。

detail.wxml

  1. <view>
  2. <view class="cover-container">
  3. <image src="data:images/demo.png"></image>
  4. </view>
  5. <view class="book-meta">
  6. <view class="meta-info">
  7. <text class="book-title">图书标题</text>
  8. <text class="other-meta">作者:作者名称</text>
  9. <text class="other-meta">出版社:xxx出版社</text>
  10. <text class="other-meta">出版日期:2010-05-07</text>
  11. </view>
  12. <view class="range">
  13. <text class="score">0</text>
  14. <text class="viewers">0</text>
  15. </view>
  16. </view>
  17. <view class="book-intro">
  18. <view class="intro-header"><text>简介</text></view>
  19. <text class="intro-content">
  20. 这是图书简介
  21. </text>
  22. </view>
  23. <view class="book-intro">
  24. <view class="intro-header"><text>作者</text></view>
  25. <text class="intro-content">
  26. 这是作者简介
  27. </text>
  28. </view>
  29. </view>
  30. <loading>
  31. 加载中...
  32. </loading>

detail.wxss

  1. page {
  2. background: #EEE;
  3. }
  4. .cover-container {
  5. background: #42BD56;
  6. text-align: center;
  7. padding: 50rpx 0;
  8. }
  9. .cover-container image {
  10. display: inline-block;
  11. width: 300rpx;
  12. height: 400rpx;
  13. }
  14. .book-meta {
  15. position: relative;
  16. padding: 20rpx;
  17. overflow: hidden;
  18. }
  19. .book-meta .range {
  20. position: absolute;
  21. top: 30rpx;
  22. right: 20rpx;
  23. width: 180rpx;
  24. background: #FFF;
  25. padding: 20rpx 10rpx;
  26. text-align: center;
  27. box-shadow: 2px 2px 10px #CCC;
  28. }
  29. .book-meta .meta-info {
  30. margin-right: 200rpx;
  31. }
  32. .meta-info text {
  33. display: block
  34. }
  35. .book-title {
  36. font-weight: bold;
  37. font-size: 50rpx;
  38. }
  39. .other-meta {
  40. padding-top: 10rpx;
  41. color: #888;
  42. font-size: 30rpx;
  43. }
  44. .range text {
  45. display: block;
  46. }
  47. .range .score {
  48. font-size: 50rpx;
  49. font-weight: bold;
  50. }
  51. .range .starts {
  52. font-size: 40rpx;
  53. }
  54. .range .viewers {
  55. font-size: 30rpx;
  56. }
  57. .book-intro {
  58. padding: 20rpx;
  59. font-size: 40rpx;
  60. }
  61. .book-intro .intro-header {
  62. color: #888
  63. }
  64. .book-intro .intro-content {
  65. font-size: 35rpx;
  66. line-height: 45rpx;
  67. }

做好了首页和详细页的静态页面,接下来就是通过网络请求api来获取数据,并显示到页面上来。

网络请求和数据处理

为了更好的管理api,我把api专门放到了一个单独的api.js文件中

api.js

  1. const API_BASE = "https://api.douban.com/v2/book";
  2. module.exports = {
  3. API_BOOK_SEARCH: API_BASE + "/search",
  4. API_BOOK_DETAIL: API_BASE + "/:id"
  5. }

有些经常用到的工具函数放到了util.js中

util.js

  1. function isFunction( obj ) {
  2. return typeof obj === 'function';
  3. }
  4. module.exports = {
  5. isFunction: isFunction
  6. }

微信小程序提供了一个用于网络请求的api:wx.request(OBJECT),具体的参数跟jquery的ajax方法差不多,为了方便调用,我把网络请求放到了request.js中

request.js

  1. var api = require('./api.js');
  2. var utils = require('../utils/util.js');
  3. /**
  4. * 网路请求
  5. */
  6. function request(url, data, successCb, errorCb, completeCb) {
  7. wx.request({
  8. url: url,
  9. method: 'GET',
  10. data: data,
  11. success: function(res) {
  12. utils.isFunction(successCb) && successCb(res.data);
  13. },
  14. error: function() {
  15. utils.isFunction(errorCb) && errorCb();
  16. },
  17. complete: function() {
  18. utils.isFunction(completeCb) && completeCb();
  19. }
  20. });
  21. }
  22. /**
  23. * 搜索图书
  24. */
  25. function requestSearchBook(data, successCb, errorCb, completeCb) {
  26. request(api.API_BOOK_SEARCH, data, successCb, errorCb, completeCb);
  27. }
  28. /**
  29. * 获取图书详细信息
  30. */
  31. function requestBookDokDetail(id, data, successCb, errorCb, completeCb) {
  32. request(api.API_BOOK_DETAIL.replace(':id', id), data, successCb, errorCb, completeCb);
  33. }
  34. module.exports = {
  35. requestSearchBook: requestSearchBook,
  36. requestBookDokDetail: requestBookDokDetail
  37. }

首页有图书搜索和列表展示,上拉加载的效果。微信小程序中没有了DOM操作的概念,一切的界面元素的改变都要通过数据变化来改变,所以需要在js中的Page中的data中声明很多数据成员。

用户在输入数据时,输入框的input绑定了searchInputEvent事件,就回捕获到输入的数据,把输入的数据更新的data中的searchKey中。

  1. searchInputEvent: function( e ) {
  2. this.setData( { searchKey: e.detail.value });
  3. }

当点击搜索按钮是,触发tap事件,其绑定了searchClickEvent

  1. searchClickEvent: function( e ) {
  2. if( !this.data.searchKey )
  3. return;
  4. this.setData( { pageIndex: 0, pageData: [] });
  5. requestData.call( this );
  6. }

requestData中封装了请求图书列表的方法

  1. /**
  2. * 请求图书信息
  3. */
  4. function requestData() {
  5. var _this = this;
  6. var q = this.data.searchKey;
  7. var start = this.data.pageIndex;
  8. this.setData( { loadingMore: true, isInit: false });
  9. updateRefreshBall.call( this );
  10. requests.requestSearchBook( { q: q, start: start }, ( data ) => {
  11. if( data.total == 0 ) {
  12. //没有记录
  13. _this.setData( { totalRecord: 0 });
  14. } else {
  15. _this.setData( {
  16. pageData: _this.data.pageData.concat( data.books ),
  17. pageIndex: start + 1,
  18. totalRecord: data.total
  19. });
  20. }
  21. }, () => {
  22. _this.setData( { totalRecord: 0 });
  23. }, () => {
  24. _this.setData( { loadingMore: false });
  25. });
  26. }

上拉加载的效果是一个小球不停的变换颜色,需要一个颜色列表

  1. //刷新动态球颜色
  2. var iconColor = [
  3. '#353535', '#888888'
  4. ];

然后用一个定时器来动态改变小球图标的颜色

  1. /**
  2. * 刷新上拉加载效果变色球
  3. */
  4. function updateRefreshBall() {
  5. var cIndex = 0;
  6. var _this = this;
  7. var timer = setInterval( function() {
  8. if( !_this.data[ 'loadingMore' ] ) {
  9. clearInterval( timer );
  10. }
  11. if( cIndex >= iconColor.length )
  12. cIndex = 0;
  13. _this.setData( { footerIconColor: iconColor[ cIndex++ ] });
  14. }, 100 );
  15. }

详细页面的显示需要到首页点击了具体图书的id,所以需要首页传值过来,这里用到了小程序的wx.navigateTo方法,给其指定的url参数后面带以查询字符串格式形式的参数,被跳转的页面就会在onLoad方法中得到值。

  1. //跳转到详细页面
  2. toDetailPage: function( e ) {
  3. var bid = e.currentTarget.dataset.bid; //图书id [data-bid]
  4. wx.navigateTo( {
  5. url: '../detail/detail?id=' + bid
  6. });
  7. }

detail.js中接受参数

  1. onLoad: function( option ) {
  2. this.setData({
  3. id: option.id
  4. });
  5. }

其实小程序的页面制作跟平时的html和css差不多,只是页面中不能用传统的html标签,而是改用了小程序提供的自定义标签,小程序对css的支持也有限制,注意哪些写法不兼容也差不多懂了。操作页面变化是通过数据变化来表现出来的,这点有点像react和vue。以上的demo用到的知识点并不多,主要是页面的数据绑定、事件绑定、模版知识和网络请求等相关api。仔细看看文档也差不多可以做出一个小例子。
qi

微信小程序demo豆瓣图书的更多相关文章

  1. 近期热门微信小程序demo源码下载汇总

    近期微信小程序demo源码下载汇总,乃小程序学习分析必备素材!点击标题即可下载: 即速应用首发!原创!电商商场Demo 优质微信小程序推荐 -秀人美女图 图片下载.滑动翻页 微信小程序 - 新词 GE ...

  2. 微信小程序demo

    微信小程序demo github地址 去年小程序刚发布时特别火,赶潮流做了个demo.感觉小程序开发还是比较简单的,主要是官方文档写得比较好,遗憾的是很多API需要微信认证才能使用. 由于小程序包大小 ...

  3. 微信小程序demo-环球小镇

    微信小程序-环球小镇说明:实现了环球小镇(huanqiuxiaozhen.com)移动端商城客户端部分功能,包括首页,分类,购物车,帐户,品牌列表,商品详情等功能.    项目下载:http://bb ...

  4. 微信小程序访问豆瓣api403问题解决方发法

    微信小程序访问豆瓣api403问题解决方法一览:通过豆瓣api可以获取很多电影.书籍等的数据信息.昨晚上用微信小程序请求豆瓣api,竟然被豆瓣拒绝了.(豆瓣设置了小程序的访问权限):下面就跟着小编一起 ...

  5. 微信小程序访问豆瓣电影api400错误解决方法

    最近在跟着demo学习微信小程序,却卡在了第一步请求豆瓣电影api上,折腾了很久,代码如下: wx.request({ url : "https://api.douban.com/v2/mo ...

  6. 微信小程序demo理解

    p.p1 { margin: 0.0px 0.0px 0.0px 0.0px; font: 14.0px Verdana } p.p2 { margin: 0.0px 0.0px 0.0px 0.0p ...

  7. 微信小程序DEMO初体验

    小程序虽然被炒的很热,但是绝大部分人却从未亲自体验过,在2017年的上班第一天,献上一个小程序DEMO,您可以体验! 注意:由于微信限制,只能使用扫一扫来体验下方小程序DEMO. DEMO首页截图如下 ...

  8. 微信小程序——demo合集及简单的文档解读【五】

    官方Demo https://github.com/wechat-miniprogram/miniprogram-demo 其他Demo https://www.cnblogs.com/ytkah/p ...

  9. 微信小程序之豆瓣电影

    此文是学习小程序第二天做出的一个小demo,调用了豆瓣电影的api,但是需要填上自己appId,现在项目的 目录如下图: 效果图如下: 在这个demo里面,我更改了小程序的navigationBar, ...

随机推荐

  1. C#语法糖: 扩展方法(常用)

    今天继续分享C#4.0语法糖的扩展方法,这个方法也是我本人比较喜欢的方法.大家先想想比如我们以前写的原始类型不能满足现在的需求,而需要在该类型中添加新的方法来实现时大家会怎么做.我先说一下我没有学习到 ...

  2. WebAPI中Message Handler与Filter的区别

    两者最主要的区别是关注点不同.Message Handlers应用到HTTP Request,Filters仅应用到controller/action上. 如果某种行为应用到大多数的Request时, ...

  3. Java中书写要注意的地方

    Java的命名规则:以字母.下划线(_)或$符号开头,其后跟任意数目的字母.数字.下划线和$符号.  注意: 数字不能作为标识符的开头: 除了下划线与$符号以外,其余的符号不能使用: 不能使用关键字作 ...

  4. NSLog设置不打印

    在调试应用程序的时候经常需要进行打印需要的信息,但是当打印的地方多了之后在真机上跑应用程序就会相应的慢很多,输出语句多了之后会在很大程序上影响应用程序的性能.这里我们可以定义一个宏来控制是否输出调试信 ...

  5. Spring dbcp连接池简单配置 示例

    一.配置db.properties属性文件 #database connection config connection.username=sa connection.password=sa conn ...

  6. redis基础操作

    /** * redis的Java客户端Jedis测试验证 * * @author */ public class Test { /** * 非切片客户端链接 */ private Jedis jedi ...

  7. 一个经试用效果非常不错的数据库连接池--JAVA

    前言: 虽说现在许多企业级的应用服务器均自己带有数据库连接池功能,就连 Tomcat 也支持了这种功能.然而在许多时候,我们还是要使用数据库连接池,如:访问数据库的 Java 桌面应用程序等.这个数据 ...

  8. Java学习笔记——可视化Swing中JTable控件绑定SQL数据源的两种方法

    在 MyEclipse 的可视化 Swing 中,有 JTable 控件. JTable 用来显示和编辑常规二维单元表. 那么,如何将 数据库SQL中的数据绑定至JTable中呢? 在这里,提供两种方 ...

  9. phpwind 去除init.phpwind.net统计功能

    修改的文件如下:global.phplib/staticpage.class.phprequire/template.phpsimple/index.php

  10. ecshop安全方面的一些参考建议

    一,ecshop安装,其实很简单,只要一直下一步下一步点击即可,这样总是没有错的,因为官方不可能给我们一个有问题的程序,尽量从简即可. 请注意一下两点 A:在安装ecshop的时候,不要将所有文件都设 ...