微信小程序项目代码结构及说明

作者：龙鼎网络发布时间：2021-01-30 23:03:33浏览次数：15386文章出处：晋城自适应网站制作

4.1,项目代码结构

点击开发者工具上侧导航的“编辑器”，我们可以看到这个项目，已经初始化并包含了一些简单的代码文件。最关键也是必不可少的，是 app.js、app.json、app.wxss 这三个。其中，.js后缀的是脚本文件，.json后缀的文件是配置文件，.wxss后缀的是样式表文件。微信小程序会读取这些文件，并生成小程序实例。

下面我们简单了解这三个文件的功能，方便修改以及从头开发自己的微信小程序。

1、app.js是小程序的脚本代码。我们可以在这个文件中监听并处理小程序的生命周期函数、声明全局变量。调用框架提供的丰富的 API，如本例的同步存储及同步读取本地数据。

2、 app.json 是对整个小程序的全局配置。我们可以在这个文件中配置小程序是由哪些页面组成，配置小程序的窗口背景色，配置导航条样式，配置默认标题。注意该文件不可添加任何注释。

3、app.wxss 是整个小程序的公共样式表。我们可以在页面组件的 class 属性上直接使用 app.wxss 中声明的样式规则。

　　我们注意到，在实例程序的代码中还有2个文件夹，一个是pages,一个是style,其中style是放通用样式的一个文件夹，pages是存放所有页面的文件夹。我们着重讲一下这个pages.

4.2,小程序页面文件构成

　在这个示例中，我们有七个页面，index 页面，即欢迎页，他们都在 pages 目录下。微信小程序中的每一个页面的【路径+页面名】都需要写在 app.json 的 pages 中，且 pages 中的第一个页面是小程序的首页。

每一个小程序页面是由同路径下同名的四个不同后缀文件的组成，如：index.js、index.wxml、index.wxss、index.json。.js后缀的文件是脚本文件，.json后缀的文件是配置文件，.wxss后缀的是样式表文件，.wxml后缀的文件是页面结构文件。

index.wxml 是页面的结构文件：

 1 <!--index.wxml-->
 2 <view class="container">
 3 
 4   <!-- 用户 openid -->
 5   <view class="userinfo">
 6     <button 
 7       open-type="getUserInfo" 
 8       bindgetuserinfo="onGetUserInfo"
 9       class="userinfo-avatar"
10       style="background-image: url({{avatarUrl}})"
11     ></button>
12     <view>
13       <text>jackson影琪</text>
14 </view> 
15 </view> 
16 
17 <view class="text-title">
18       <text>Hello world</text>
19 </view>  
20 </view>

本例中使用了<view/>、<button/>、<text/>来搭建页面结构，绑定数据和交互处理函数。

index.js 是页面的脚本文件，在这个文件中我们可以监听并处理页面的生命周期函数、获取小程序实例，声明并处理数据，响应页面交互事件等。

  1 //index.js
  2 const app = getApp()
  3 
  4 Page({
  5   data: {
  6     avatarUrl: './user-unlogin.png',
  7     userInfo: {},
  8     logged: false,
  9     takeSession: false,
 10     requestResult: ''
 11   },
 12 
 13   onLoad: function() {
 14     if (!wx.cloud) {
 15       wx.redirectTo({
 16         url: '../chooseLib/chooseLib',
 17       })
 18       return
 19     }
 20 
 21     // 获取用户信息
 22     wx.getSetting({
 23       success: res => {
 24         if (res.authSetting['scope.userInfo']) {
 25           // 已经授权，可以直接调用 getUserInfo 获取头像昵称，不会弹框
 26           wx.getUserInfo({
 27             success: res => {
 28               this.setData({
 29                 avatarUrl: res.userInfo.avatarUrl,
 30                 userInfo: res.userInfo
 31               })
 32             }
 33           })
 34         }
 35       }
 36     })
 37   },
 38 
 39   onGetUserInfo: function(e) {
 40     if (!this.logged && e.detail.userInfo) {
 41       this.setData({
 42         logged: true,
 43         avatarUrl: e.detail.userInfo.avatarUrl,
 44         userInfo: e.detail.userInfo
 45       })
 46     }
 47   },
 48 
 49   onGetOpenid: function() {
 50     // 调用云函数
 51     wx.cloud.callFunction({
 52       name: 'login',
 53       data: {},
 54       success: res => {
 55         console.log('[云函数] [login] user openid: ', res.result.openid)
 56         app.globalData.openid = res.result.openid
 57         wx.navigateTo({
 58           url: '../userConsole/userConsole',
 59         })
 60       },
 61       fail: err => {
 62         console.error('[云函数] [login] 调用失败', err)
 63         wx.navigateTo({
 64           url: '../deployFunctions/deployFunctions',
 65         })
 66       }
 67     })
 68   },
 69 
 70   // 上传图片
 71   doUpload: function () {
 72     // 选择图片
 73     wx.chooseImage({
 74       count: 1,
 75       sizeType: ['compressed'],
 76       sourceType: ['album', 'camera'],
 77       success: function (res) {
 78 
 79         wx.showLoading({
 80           title: '上传中',
 81         })
 82 
 83         const filePath = res.tempFilePaths[0]
 84         
 85         // 上传图片
 86         const cloudPath = 'my-image' + filePath.match(/\.[^.]+?$/)[0]
 87         wx.cloud.uploadFile({
 88           cloudPath,
 89           filePath,
 90           success: res => {
 91             console.log('[上传文件] 成功：', res)
 92 
 93             app.globalData.fileID = res.fileID
 94             app.globalData.cloudPath = cloudPath
 95             app.globalData.imagePath = filePath
 96             
 97             wx.navigateTo({
 98               url: '../storageConsole/storageConsole'
 99             })
100           },
101           fail: e => {
102             console.error('[上传文件] 失败：', e)
103             wx.showToast({
104               icon: 'none',
105               title: '上传失败',
106             })
107           },
108           complete: () => {
109             wx.hideLoading()
110           }
111         })
112 
113       },
114       fail: e => {
115         console.error(e)
116       }
117     })
118   },
119 
120 })

index.wxss 是页面的样式表：

  1 /**index.wxss**/
  2 
  3 page {
  4   background: #f6f6f6;
  5   display: flex;
  6   flex-direction: column;
  7   justify-content: center;
  8 }
  9 .userinfo, .uploader, .tunnel {
 10   margin-top: 40rpx;
 11   height: 140rpx;
 12   width: 100%;
 13   background: #fff;
 14   border: 1px solid rgba(0, 0, 0, 0.1);
 15   border-left: none;
 16   border-right: none;
 17   display: flex;
 18   flex-direction: row;
 19   align-items: center;
 20   transition: all 300ms ease;
 21 }
 22 
 23 .userinfo-avatar {
 24   width: 100rpx;
 25   height: 100rpx;
 26   margin: 20rpx;
 27   border-radius: 50%;
 28   background-size: cover;
 29   background-color: white;
 30 }
 31 
 32 .userinfo-avatar:after {
 33   border: none;
 34 }
 35 
 36 .userinfo-nickname {
 37   font-size: 32rpx;
 38   color: #007aff;
 39   background-color: white;
 40   background-size: cover;
 41 }
 42 
 43 .userinfo-nickname::after {
 44   border: none;
 45 }
 46 
 47 .uploader, .tunnel {
 48   height: auto;
 49   padding: 0 0 0 40rpx;
 50   flex-direction: column;
 51   align-items: flex-start;
 52   box-sizing: border-box;
 53 }
 54 
 55 .uploader-text, .tunnel-text {
 56   width: 100%;
 57   line-height: 52px;
 58   font-size: 34rpx;
 59   color: #007aff;
 60 }
 61 
 62 .uploader-container {
 63   width: 100%;
 64   height: 400rpx;
 65   padding: 20rpx 20rpx 20rpx 0;
 66   display: flex;
 67   align-content: center;
 68   justify-content: center;
 69   box-sizing: border-box;
 70   border-top: 1px solid rgba(0, 0, 0, 0.1);
 71 }
 72 
 73 .uploader-image {
 74   width: 100%;
 75   height: 360rpx;
 76 }
 77 
 78 .tunnel {
 79   padding: 0 0 0 40rpx;
 80 }
 81 
 82 .tunnel-text {
 83   position: relative;
 84   color: #222;
 85   display: flex;
 86   flex-direction: row;
 87   align-content: center;
 88   justify-content: space-between;
 89   box-sizing: border-box;
 90   border-top: 1px solid rgba(0, 0, 0, 0.1);
 91 }
 92 
 93 .tunnel-text:first-child {
 94   border-top: none;
 95 }
 96 
 97 .tunnel-switch {
 98   position: absolute;
 99   right: 20rpx;
100   top: -2rpx;
101 }
102 
103 .disable {
104   color: #888;
105 }
106 
107 .service {
108   position: fixed;
109   right: 40rpx;
110   bottom: 40rpx;
111   width: 140rpx;
112   height: 140rpx;
113   border-radius: 50%;
114   background: linear-gradient(#007aff, #0063ce);
115   box-shadow: 0 5px 10px rgba(0, 0, 0, 0.3);
116   display: flex;
117   align-content: center;
118   justify-content: center;
119   transition: all 300ms ease;
120 }
121 
122 .service-button {
123   position: absolute;
124   top: 40rpx;
125 }
126 
127 .service:active {
128   box-shadow: none;
129 }
130 
131 .request-text {
132   padding: 20rpx 0;
133   font-size: 24rpx;
134   line-height: 36rpx;
135   word-break: break-all;
136 }
137 .text-title{
138 margin-top: 50%;
139 }
140 .text-title text{
141   font-size: 96rpx;
142   font-family: 'Franklin Gothic Medium', 'Arial Narrow', Arial, sans-serif;
143 }

页面的样式表是非必要的。当有页面样式表时，页面的样式表中的样式规则会层叠覆盖 app.wxss 中的样式规则。如果不指定页面的样式表，也可以在页面的结构文件中直接使用 app.wxss 中指定的样式规则。

index.json 是页面的配置文件：

页面的配置文件是非必要的。当有页面的配置文件时，配置项在该页面会覆盖 app.json 的 window 中相同的配置项。如果没有指定的页面配置文件，则在该页面直接使用 app.json 中的默认配置。

 1 {
 2   "pages": [
 3     "pages/index/index",
 4     "pages/userConsole/userConsole",
 5     "pages/storageConsole/storageConsole",
 6     "pages/databaseGuide/databaseGuide",
 7     "pages/addFunction/addFunction",
 8     "pages/deployFunctions/deployFunctions",
 9     "pages/chooseLib/chooseLib"
10   ],
11   "window": {
12     "backgroundColor": "#F6F6F6",
13     "backgroundTextStyle": "light",
14     "navigationBarBackgroundColor": "#F6F6F6",
15     "navigationBarTitleText": "jackson影琪",
16     "navigationBarTextStyle": "black"
17   }
18 }