小程序开发系列(二)九宫格

时间:2022-10-29 03:27:50

小程序是长在微信上的,是移动端的界面,为了能够更方便的使用,我们常常希望使用九宫格界面的方式作为导航,那要如何实现呢?

基于一个简单的思考,九宫格就是三行三列,如果把行作为一个单位,再将每一行分成三列,那是不是就可以了?我们实践一下。

首先来考虑九宫格数据的生成,每一个格子需要有一个图标、一个标题、一个便于跳转的路由,那天现在我们有九个页面,所以定义一个一维数组即可。为了更好的进行后续的配置,我们将这个数组独立到一个文件中routes.js,然后将其在index.js页面中引用,routes放到index的目录下。

var PageItems =
[
{
text: '格子1',
icon: '../../images/c1.png',
route: '../c1/c1',
},
{
text: '格子2',
icon: '../../images/c2.png',
route: '../c2/c2',
},
{
text: '格子3',
icon: '../../images/c3.png',
route: '../c3/c3',
},
{
text: '格子4',
icon: '../../images/c4.png',
route: '../c4/c4',
},
{
text: '格子5',
icon: '../../images/c5',
route: '../c5/c5',
},
{
text: '格子6',
icon: '../../images/c6.png',
route: '../c6/c6',
},
{
text: '格子7',
icon: '../../images/c7.png',
route: '../c7/c7',
},
{
text: '格子8',
icon: '../../images/c8',
route: '../c8/c8',
},
{
text: '格子9',
icon: '../../images/c9.png',
route: '../c9/c9',
}
];
module.exports = {
PageItems: PageItems
}

其中c1/c1的第1个c1是文件夹名称,第二个c1是js的名称,一般的一个页面是一个文件夹,文件夹内是同名的具体文件(即c1.js,c1.wxml,c1.wxss,c1.json),有点类似于java的文件结构。

在index.js页面中我们引用routes.js,然后得到数据PageItems,但PageItems是一维数组,而我们前面思考是要用一行三列为一个组的,所以需要将这一维数组进行重新组合,最直接的方法就是生成一个数组,每个数组的元素又包含了一个只有三个元素的一维数组,代码如下

//index.js
//获取应用实例
var app = getApp()
var routes = require('routes');
Page({
data: {
userInfo: {},
cellHeight: '120px',
pageItems: []
},
//事件处理函数
onLoad: function () {
var that = this
console.log(app);
//调用应用实例的方法获取全局数据
app.getUserInfo(function (userInfo) {
wx.setNavigationBarTitle({
        title: '全新测试追踪系统-' + userInfo.nickName,
        success: function (res) {
          // success
        }
      })
that.setData({
userInfo: userInfo
})
var pageItems = [];
var row = [];
var len = routes.PageItems.length;//重组PageItems
len = Math.floor((len + 2) / 3) * 3;
for (var i = 0; i < len; i++) {
if ((i + 1) % 3 == 0) {
row.push(routes.PageItems[i]);
pageItems.push(row);
row = [];
continue;
}
else {
row.push(routes.PageItems[i]);
}
}
wx.getSystemInfo({
success: function (res) {
var windowWidth = res.windowWidth;
that.setData({
cellHeight: (windowWidth / 3) + 'px'
})
},
complete: function () {
that.setData({
pageItems: pageItems
})
}
})
})
}
})
在index.wxml中,我们来布局界面,由于每一个格子都是一样的,只是数据不一样,所以想到用模板来呈现。为此,我们先做一个单元格的模板面cell.wxml.

<template name="cell">
<navigator url="{{route}}" class="pages-item" style="height:{{cellHeight}}">
<view class="{{text==null||text.length==0?'pages-icon-wrapper-no-bg':'pages-icon-wrapper'}}" >
<image src="{{icon}}" class="pages-icon"></image>
</view>
<view class="pages-text-wrapper">
<text class="pages-text">{{text}}</text>
</view>
</navigator>
</template>
这里看到两个大括号内套的是从外面传入的数据,然后在里面可以进行简单的逻辑判断,以便于更好的呈现。比如text==null的时候,我们希望呈现的是一个空背景的格子,在有数据的时候我们希望呈现一个含背景的格子,所以"{{text==null||text.length==0?'pages-icon-wrapper-no-bg':'pages-icon-wrapper'}}".

另外一点,由于我们是将该界面文件作为模板的,所以必须要用template标记来包住,同时命一个名字name,这样在引用模板的地方才可以识别调用。

现在我们在index.wxml中引用这个模板

<!--index.wxml-->
<import src="cell.wxml" />
<view class="pages-container">
<scroll-view scroll-y="true" class="pages-wrapper">
<view wx:for="{{pageItems}}" wx:key="{{text}}">
<view class="pages-row">
<template is="cell" data="{{...item[0],cellHeight}}" />
<template is="cell" data="{{...item[1],cellHeight}}" />
<template is="cell" data="{{...item[2],cellHeight}}" />
</view>
</view>
</scroll-view>
</view>

模板的引用使用import来引用,在调用的地方使用template和is,其中is指定的是cell.wxml中的name。item[0]、item[1]、item[2]是循环传入的数据,cellHeight是在index.js的data中存放的数据。在将数据传入到模板内部时,框架会将其展开在字段的形式,即key-value对,所以再看cell.wxml文件,就会发现内部是直接使用key来作为数据的。

将数据呈现到界面之后,我们需要相当的样式来配合,index.wxss代码如下。

/**index.wxss**/

.pages-container {
height: 100%;
display: flex;
flex-direction: column;
box-sizing: border-box;
padding-top: 10rpx;
padding-bottom: 10rpx;
}

.pages-title-bg {
width: 100%;
}

.pages-wrapper {

}


.pages-row {
width: 100%;
display: flex;
flex-direction: row;
justify-content: space-around;
}

.pages-item {
position: relative;
padding: 10rpx;
width: 33%;
background-color: #fff;
border: #ddd solid 1px;
}

.pages-icon-wrapper {
display: flex;
justify-content: space-around;
align-items: center;
margin: 10rpx;
border-radius: 30%;
height: 75%;
background:#00CD0D;
}

.pages-icon-wrapper-no-bg {
display: flex;
justify-content: space-around;
align-items: center;
margin: 10rpx;
height: 75%;
}

.pages-icon {
width: 100rpx;
height: 100rpx;
}

.pages-text-wrapper {
text-align: center;
}

.pages-text {
font-weight: bolder;
}
效果如下图

小程序开发系列(二)九宫格
我们模板中使用navigator元素来呈现格子,所以每个格子自然就可以导航了。

转载请注明出处。