微信小程序基础-项目结构、app.json和视图层

一、微信小程序项目基本结构

微信提供了微信小程序专用的开发者工具

必须文件：app.js/ app.json(配置文件) /app.wxss(样式文件)

pages文件夹存放所有页面，每个页面的路径都要在app.json文件中配置，写在pages字段中

每个页面由四个文件构成.js/.json/.wxss/.wxml，放在pages中的一个文件夹下.wxml是页面结构文件

二、app.json文件

app.json配置项如下：

1.page：将所有页面的路径写在其中，不用写文件后缀名。第一条为首页

2.window：设置导航条、状态栏、标题、窗口背景色

navigationBarBackgroundColor 导航栏背景颜色

navigationBarTextStyle                  导航栏标题颜色

navigationBarTitleText             导航栏标题文字内容

backgroundColor                    窗口的背景色

backgroundTextStyle              下拉背景字体、loading 图的样式(dark/light)

enablePullDownRefresh       是否开启下拉刷新

3.tabBar：配置底部的tab栏

color                  tab上的文字默认颜色

selectedColor  tab上的文字选中时的颜色

backgroundColor      tab 的背景色

borderStyle              tabbar上边框的颜色(black/white)

list                            tab 的列表

重点的list，其中设置一个数组，数组每个项都是一个对象，对应着一个tab和其对应的页面，配置如下：

pagePathtab           对应的页面文件路径（必须在 pages 中先定义）

text                         tab 上按钮文字

iconPath                 tab上的icon路径

selectedIconPath   选中时的icon路径

一个tabBar示例：

"tabBar": {

"list": [{

  "pagePath": "pages/index/index",

  "text": "首页"

}, {

  "pagePath": "pages/logs/logs",

  "text": "日志"

}]

}

4.networkTimeout：设置各种微信请求的网络超时时间

request            wx.request的超时时间

connectSocket       wx.connectSocket的超时时间

uploadFile       wx.uploadFile的超时时间

downloadFile       wx.downloadFile的超时时间

微信小程序-视图层

1.数据绑定

使用{{}}即可完成数据绑定，{{}}内也可以进行计算、逻辑判断、字符串运算等

也可以为属性进行数据绑定，在引号内使用，如：

<view id="item-{{id}}"> </view>，在data中定义id＝1，就可以在这里绑定id为item-1

2.列表渲染

使用wx:for后面接需要渲染的数组，示例如下：

<!--wxml-->  
<view wx:for="{{array}}"> {{item}} </view>  
// page.js  
Page({  
  data: {  
    array: [1, 2, 3, 4, 5]  
  }  
})

使用列表渲染有默认值index，表示当前下标，如：{{index}}: {{item}}

使用wx:for-index和wx:for-item可以指定当前下标名和元素名：

<view wx:for="{{array}}" wx:for-index="idx" wx:for-item="itemName">  
  {{idx}}: {{itemName.message}}  
</view> 

3.条件渲染

使用wx:if/elif/else，示例：

<!--wxml-->  
<view wx:if="{{view == 'WEBVIEW'}}"> WEBVIEW </view>  
<view wx:elif="{{view == 'APP'}}"> APP </view>  
<view wx:else="{{view == 'MINA'}}"> MINA </view>  
// page.js  
Page({  
  data: {  
    view: 'MINA'  
  }  
}) 

上面的代码根据data中的view的值判断到底显示什么样的内容

可以使用<block>结构进行条件渲染多个组件，注意block只是一个包装元素没有实际样式：

<block wx:if="{{true}}">  
  <view> view1 </view>  
  <view> view2 </view>  
</block> 

4.使用模版

<template name="staffName">  
  <view>  
    FirstName: {{firstName}}, LastName: {{lastName}}  
  </view>  
</template>  
<template is="staffName" data="{{...staffA}}"></template>  
<template is="staffName" data="{{...staffB}}"></template>  
<template is="staffName" data="{{...staffC}}"></template>  
// page.js  
Page({  
  data: {  
    staffA: {firstName: 'Hulk', lastName: 'Hu'},  
    staffB: {firstName: 'Shang', lastName: 'You'},  
    staffC: {firstName: 'Gideon', lastName: 'Lin'}  
  }  
}) 

上面的例子首先使用template定义了一个模版，指定name属性，然后定义了模版的内容。下面就可以直接使用这个模版了，定义data属性为模版传递每个实例化的数据，is指定要使用的是哪个模版

5.事件

分为bind开头的事件属性和catch开头的事件属性，前者不会阻止冒泡，后者会阻止冒泡

每个事件对应一些属性，如果把一个event打印出来返回内容如下：

<pre name="code" class="javascript"><view id="tapTest" data-hi="MINA" bindtap="tapName"> Click me! </view> 

Page({  
  tapName: function(event) {  
    console.log(event)  
  }  
}) 

可以看到log出来的信息大致如下：

{  
"type": "tap",  //事件类型  
"timeStamp": 1252,  //事件生成的事件戳  
"target": {   //出发事件的源组件  
  "id": "tapTest",  
  "offsetLeft": 0,  
  "offsetTop": 0,  
  "dataset": {  //组件属性中以data-开头的属性集合  
  "hi": "MINA"  
  }  
},  
"currentTarget": {  //事件绑定的当前组件  
  "id": "tapTest",  
  "offsetLeft": 0,  
  "offsetTop": 0,  
  "dataset": {  
    "hi": "MINA"  
  }  
},  
"touches": [{  //触摸信息，分别是距离文档左上角、出去导航栏的左上角、整个屏幕左上角距离  
  "pageX": 30,  
  "pageY": 12,  
  "clientX": 30,  
  "clientY": 12,  
  "screenX": 112,  
  "screenY": 151  
}],  
"detail": {  
  "x": 30,  
  "y": 12  
}  
}