AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

微信小程序框架(一)-全面详解（学习总结---从入门到深化）

2024-02-02 285
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 微信小程序框架(一)-全面详解（学习总结---从入门到深化）


小程序与普通网页开发的区别

小程序的主要开发语言是 JavaScript ，小程序的开发同普通的网页 开发相比有很大的相似性。对于前端开发者而言，从网页开发迁移 到小程序的开发成本并不高，但是二者还是多少有些许区别的，例如：

体验小程序

开发者可使用微信客户端(6.7.2 及以上版本)扫码下方小程序码，体验小程序


微信小程序账号申请

开发小程序的第一步，你需要拥有一个小程序帐号，通过这个帐号 你就可以管理你的小程序

申请帐号

进入小程序注册页根据指引填写信息和提交相应的资料，就可以拥 有自己的小程序帐号

注册地址：https://mp.weixin.qq.com/cgi-bin/wx?token=&lan g=zh_CN

第一步：添加账号信息

第二步：激活邮箱

第三步：信息登记

温馨提示

这里我们能选择的是个人和企业，如果是个人注册选择个人 （我们这里选择个人），如果是企业注册选择企业

第四步：主体信息登录

温馨提示

用户信息与微信注册用户信息保持一致

第五步：进入控制台

单独进入管理平台地址:https://mp.weixin.qq.com/

 

第六步：获取AppID

注意：目前对我们有用的是“开发管理 - 开发设置 - AppID”

小程序的 AppID 相当于小程序平台的一个身份证，后续你会在很多 地方要用到 AppID

微信小程序开发者工具

为了帮助开发者简单和高效地开发和调试微信小程序，我们推出了 微信开发者工具 使用小程序开发者工具，开发者可以完成小程序开发调试、代码查 看和编辑、小程序预览和发布等功能。

下载安装

开发者工具下载地址

https://developers.weixin.qq.com/miniprogram/dev/devtoo ls/download.html

安装如一般软件一样，并没有特别之处

创建项目

基础开发，我们要选择“JavaScript-基础模板”


开发者工具说明

在微信开发者工具中，我们可以编写代码的同时查看运行结果和调试问题

小程序目录结构

小程序包含一个描述整体程序的 app 和多个描述各自页面的 page

描述整体的 app

描述各自页面的 page

一个小程序页面由四个文件组成，分别是

温馨提示

为了方便开发者减少配置项，描述页面的四个文件必须具有相同的路径与文件名

1. 在微信小程序项目结构中， app.json 的作用是：小程序公共配置

全局配置_Pages

用于指定小程序由哪些页面组成，每一项都对应一个页面的路径 （含文件名） 信息。文件名不需要写文件后缀，框架会自动去寻找 对应位置的 .json , .js , .wxml , .wxss 四个文件进行处理

温馨提示

未指定 entryPagePath 时，数组的第一项代表小程序的初始页面 （首页）

Pages配置

小程序中新增/减少页面，都需要对 app.json 文件中 pages 数组进行修改

默认项目存在两个页面: index 和 logs ,对应的 app.json 中 pages 属性的配置：

"pages": [
    "pages/index/index",
    "pages/logs/logs"
]

增加页面 news 之后,修改 app.json 文件中的 pages 属性（其实页面创建出来，也会自动加载）

"pages": [
     "pages/news/news",
     "pages/index/index",
     "pages/logs/logs"
],

修改 pages/news/news.wxml 文件为： 

<text>news页面</text>

entryPagePath

指定小程序的默认启动路径（首页），在 app.json 配置文件中增加 entryPagePath

{
    "entryPagePath": "pages/index/index",
    "pages": [
        "pages/news/news",
        "pages/index/index",
        "pages/logs/logs"
   ],
}

快捷生成页面方案

在 app.json 文件中的 pages 中直接添加路径，可以自动生成页面 例如：我们增加 about 页面路由，可以自动生成 about 页面

{
    "entryPagePath": "pages/index/index",
    "pages": [
        "pages/news/news",
        "pages/index/index",
        "pages/logs/logs",
        "pages/about/about"  
   ],
}

1. 在微信小程序的 app.json 文件配置中 entryPagePath 的作用是：

指定小程序的默认启动路径（首页）

全局配置_window

window 用于设置小程序的状态栏、导航条、标题、窗口背景色等等

常用属性

修改 app.json 文件中的 window 属性配置

"window": {
    "navigationBarBackgroundColor": "#000000",
    "navigationBarTextStyle": "white",
    "navigationBarTitleText": "第一个小程序",
    "backgroundColor": "#000000",
    "backgroundTextStyle": "light",
    "enablePullDownRefresh":true,
    "onReachBottomDistance":50
},

1. 在小程序的 window 配置中，那个是开启下拉刷新的属性：enablePullDownRefresh

全局配置_tabBar

如果小程序是一个多 tab 应用（客户端窗口的底部或顶部有 tab 栏 可以切换页面），可以通过 tabBar 配置 tab 切换时显示的对应页面

常用属性

温馨提示

其中 list 接受一个数组，只能配置最少 2 个、最多 5 个 tab

List属性说明

属性 类型 必 填 说明
pagePath string 是 页面路径，必须在 pages 中先定义
text string 是 tab 上按钮文字
iconPath string 否 图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，不支持网络图片。 当 position 为 top 时，不显 示 icon。
selectedIconPath string 否 选中时的图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，不支持网络图片。 当 position 为 top 时，不显示 icon。

修改 app.json 配置文件，增加 tabBar 属性配置

"tabBar": {
    "list": [{
        "pagePath": "pages/index/index",
        "text": "首页",
        "iconPath":"./images/home.png",
        "selectedIconPath":"./images/home_select.png"
   }, {
        "pagePath": "pages/news/news",
        "text": "新闻",
        "iconPath": "./images/news.png",
        "selectedIconPath": "./images/news_select.png"
   }]
},

1. 在小程序的 tabbar 配置中，那个属性可以配置页面路径：pagePath

全局配置_tabBar属性

如果小程序是一个多 tab 应用（客户端窗口的底部或顶部有 tab 栏 可以切换页面），可以通过 tabBar 配置项指定 tab 栏的表现，以 及 tab 切换时显示的对应页面。

配置 app.json 文件中的 tabBar 的属性

"tabBar": {
    "color":"#999999",
    "selectedColor":"#ff0000",
    "backgroundColor":"#fff",
    "borderStyle":"black",
    "position":"bottom",
    "list": [{
        "pagePath": "pages/index/index",
        "text": "首页",
        "iconPath":"./images/home.png",
        "selectedIconPath":"./images/home_select.png"
   }, {
        "pagePath": "pages/news/news",
        "text": "新闻",
        "iconPath": "./images/news.png",
        "selectedIconPath": "./images/news_select.png"
   }]
},

1. 小程序的 tabbar 配置中，那个属性可以配置 tabbar 显示在顶部还是底部：position

全局配置_常用其他配置

小程序根目录下的 app.json 文件用来对微信小程序进行其他全局配 置。文件内容为一个 JSON 对象

style

微信客户端 7.0 开始，UI 界面进行了大改版。小程序也进行了基础 组件的样式升级。app.json 中配置 "style": "v2" 可表明启用新版的组件样式

sitemapLocation

指明 sitemap.json的位置；默认为 'sitemap.json' 即在 app.json 同 级目录下名字的 sitemap.json 文件

networkTimeout

各类网络请求的超时时间，单位均为毫秒

debug

可以在开发者工具中开启 debug 模式，在开发者工具的控制台面 板，调试信息以 info 的形式给出，其信息有 Page 的注册，页面路 由，数据更新，事件触发等。可以帮助开发者快速定位一些常见的 问题

debugOptions

小程序调试相关配置项

FPS 面板

为了便于开发者调试渲染层的交互性能，小程序基础库提供了选项 开启 FPS 面板，开发者可以实时查看渲染层帧率

开启方式

"debugOptions": {
    "enableFPSPanel": true
}

温馨提示

必须在真机上才能看到

permission

小程序接口权限相关设置

例如：小程序定位设置，配置如下

"permission": {
    "scope.userLocation": {
        "desc": "你的位置信息将用于小程序位置接口的效果展示"
   }
}

app.json 文件配置如下

{
    "entryPagePath": "pages/index/index",
    "pages": [
        "pages/news/news",
        "pages/index/index",
        "pages/logs/logs",
        "pages/about/about"
   ],
    "window": {
        "navigationBarBackgroundColor": "#000000",
        "navigationBarTextStyle": "white",
        "navigationBarTitleText": "第一个小程序",
        "backgroundColor": "#000000",
        "backgroundTextStyle": "light",
        "enablePullDownRefresh": true,
        "onReachBottomDistance": 50
   },
    "tabBar": {
        "color": "#999999",
        "selectedColor": "#ff0000",
        "backgroundColor": "#fff",
        "borderStyle": "black",
        "position": "bottom",
        "list": [{
            "pagePath": "pages/index/index",
            "text": "首页",
            "iconPath": "./images/home.png",
            "selectedIconPath": "./images/home_select.png"
       }, {
            "pagePath": "pages/news/news",
            "text": "新闻",
            "iconPath": "./images/news.png",
            "selectedIconPath": "./images/news_select.png"
       }]
   },
    "style": "v2",
    "sitemapLocation": "sitemap.json",
    "networkTimeout": {
        "request": 10000,
        "downloadFile": 10000
   },
    "debug": true,
    "permission": {
        "scope.userLocation": {
        "enablePullDownRefresh": true,
        "onReachBottomDistance": 50
   },
    "tabBar": {
        "color": "#999999",
        "selectedColor": "#ff0000",
        "backgroundColor": "#fff",
        "borderStyle": "black",
        "position": "bottom",
        "list": [{
            "pagePath": "pages/index/index",
            "text": "首页",
            "iconPath": "./images/home.png",
            "selectedIconPath": "./images/home_select.png"
       }, {
            "pagePath": "pages/news/news",
            "text": "新闻",
            "iconPath": "./images/news.png",
            "selectedIconPath": "./images/news_select.png"
       }]
   },
    "style": "v2",
    "sitemapLocation": "sitemap.json",
    "networkTimeout": {
        "request": 10000,
        "downloadFile": 10000
   },
    "debug": true,
    "permission": {
        "scope.userLocation": {
            "desc": "你的位置信息将用于小程序位置接口的效果展示"
       }
   },
    "debugOptions": {
        "enableFPSPanel": true
   }
}

1. 小程序全局配置中，那个属性可以开启 debug 调试模式：debug

单页面配置

app.json 中的部分配置，也支持对单个页面进行配置 可以在页面对应的 文件.json 文件来对本页面的表现进行配置

配置项

页面 文件.json 文件配置

虽然配置与 app.json 基本一致，但是注意，不在需要添加 window 作为父级

{
    "usingComponents": {},
    "navigationBarBackgroundColor": "#ffffff",
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "第二个页面",
    "backgroundColor": "#ffffff",
    "backgroundTextStyle": "light",
    "enablePullDownRefresh": true,
    "onReachBottomDistance": 50,
    "style":"v2"
}

1. 小程序中，单个文件的配置中，那个是可以修改导航栏文本：navigationBarTitleText

全局配置_公共样式

在项目根目录的 app.wxss 文件为小程序公的共样式表，相当与CSS初始化文件配置

WXSS (WeiXin Style Sheets)是一套样式语言，用于描述 WXML 的 组件样式

WXSS 用来决定 WXML 的组件应该怎么显示

为了适应广大的前端开发者，WXSS 具有 CSS 大部分特性。同时为 了更适合开发微信小程序，WXSS 对 CSS 进行了扩充以及修改。

与 CSS 相比，WXSS 扩展的特性有

公共样式

在 app.wxss 文件中添加样式

text{
    color:red;
}

项目中所有的页面的 text 文本都会呈现红色

尺寸单位

rpx（responsive pixel）: 可以根据屏幕宽度进行自适应。规定屏幕宽为750rpx。如在 iPhone6 上，屏幕宽度为375px，共有750个物理像素，则750rpx = 375px = 750物理像素，1rpx = 0.5px = 1物理像素

在 news 页面的 wxml 文件中增加下列代码 

<view class="box"></view>

在 app.wxss 文件中，增加 box 盒子的样式

.box{
    width: 200rpx;
    height: 200rpx;
    background: red;
}

在iphone5上的效果，元素的宽高是85px

在iphone6上的效果，元素的宽高是100px

样式导入  

使用 @import 语句可以导入外联样式表， @import 后跟需要导入的外联 样式表的相对路径，用 ; 表示语句结束 在项目根目录下创建 common 文件夹，并创建 common.wxss 文件，增加 box 的样式

.box{
    margin: 50px;
}

在 app.wxss 文件中引入 common.wxss 文件

@import "./common/common.wxss";

此时，刚刚所创建的 box 也加载了引入文件的样式

1. 在微信小程序中，可以根据屏幕宽度进行自适应大小的单位是：rpx

全局配置_注册小程序

每个小程序都需要在 app.js 中调用 App 方法注册小程序实例，绑定 生命周期回调函数、错误监听和页面不存在监听函数等

生命周期

通俗地理解为“从摇篮到坟墓”（Cradle-to-Grave）的整个过程

方法说明

属性 类型 必填 说明
onLaunch function 否 生命周期回调——监听小程序初始化。
onShow function 否 生命周期回调——监听小程序启动或切前台。
onHide function 否 生命周期回调——监听小程序切后台。
onError function 否 错误监听函数
onPageNotFound function 否 页面不存在监听函数
onThemeChange function 否 监听系统主题变化

我们来修改初始 app.js 文件，代码如下 

// app.js
App({
  onLaunch(options) {
      console.log("监听小程序初始化",options);
 },
  onShow (options) {
    console.log("监听小程序启动",options);
 },
  onHide () {
    console.log("监听小程序切后台");
 },
  onError (msg) {
    // 小程序发生脚本错误或 API 调用报错时触发
    console.log("错误监听函数",msg)
 },
  onPageNotFound(res){
    console.log("页面不存在监听函数");
 },
  onThemeChange(){
      console.log("系统切换主题时触发");
 }
})

1. 在微信小程序中，监听项目启动的函数是：onShow

onShow

整个小程序只有一个 App 实例，是全部页面共享的。开发者可以通 过getApp 方法获取到全局唯一的 App 实例，获取 App 上的数据或 调用开发者注册在App上的函数。

在 app.js 文件中增加全局属性 

// app.js
App({
  globalData: {
    userInfo: "我是全局属性"
 }
})

我们在 news.js 文件中读取全局属性

Page({
    onLoad(options) {
        const appInstance = getApp()
        console.log(appInstance.globalData.userInfo)
        // 我是全局属性
   }
})

当然，我们也可以在页面中显示，首先修改 news.js 文件

Page({
    data:{
        message:""
   },
    onLoad(options) {
        const appInstance = getApp()
        // 关于this.setData({}),后续会详细讲解，目前我们知道可以给message赋值即可
        this.setData({
          message:appInstance.globalData.userInfo
       })
   }
})

修改 news.wxml 文件显示内容

1. 在小程序中，页面里可以读取全局属性的方案正确的是：appInstance.globalData

页面的生命周期函数

注册小程序中的一个页面。指定页面的生命周期函数

页面的生命周期函数

我们在 news页面中的 news.js 文件中去增加这些生命周期函数 

Page({
    data:{
        message:""
   },
    onLoad(options) {
        console.log("页面加载");
        const appInstance = getApp()
        this.setData({
           message:appInstance.globalData.userInfo
       })
   },
    onShow() {
        console.log("页面显示");
   },
    onReady() {
        console.log("页面初次渲染完成");
   },
    onHide() {
        console.log("页面隐藏");
   },
    onUnload() {
        console.log("页面卸载");
   }
})

生命周期函数的作用

在不同的生命周期函数，根据业务需求，可以增加业务。例如：我 们可以在 onShow 函数中修改 data 中的数据

Page({
    data:{
        hello:"hello"
   },
    onShow() {
        this.setData({
            hello:"大家好"
       })
   }
})

温馨提示

目前我们需要记忆这些生命周期函数，在后续的学习中，我们 会不间断的使用。大家自然了解他了

1. 在小程序中，页面隐藏会触发的生命周期函数是：onHide

页面中的Data对象

data 是页面第一次渲染使用的初始数据

页面加载时， data 中的数据将会以 JSON 字符串的形式由逻辑层传至渲染层，因此 data 中的数据必须是可以转成 JSON 的类型：字符串， 数字，布尔值，对象，数组

我们在 news.js 文件中增加 data 对象，并增加相应的数据,显示在页面中

// news.js文件
Page({
    data:{
        hello:"hello",
        num:10,
        flag:true,
        user:{
            name:"iwen",
            age:20
       },
        names:["iwen","ime","frank"]
   }
})
<!-- news.wxml文件 -->
<text>{{ hello }}</text>
<text>{{ num }}</text>
<text>{{ user.name }}</text>
<text>{{ names[1] }}</text>

setData函数

setData 函数用于将 data 中的数据进行修改，并发送到视图层

我们在 news.js 文件中修改 data 中的数据，我们可以尝试在 onLoad 中修改 num 的属性值

Page({
    data:{
        message:"",
        hello:"hello",
        num:10,
        flag:true,
        user:{
            name:"iwen",
            age:20
       },
        names:["iwen","ime","frank"]
   },
    onLoad(options) {
        this.setData({
            num:20
       })
   }
})

我们可以观察到页面中的 num 数字发生了变化为20

文章标签：
小程序
开发者
前端开发
数据格式
JSON
关键词：
微信小程序入门
微信小程序学习
微信框架
微信小程序框架
微信小程序框架学习入门深化
童小纯
目录
相关文章
Codelinghu
|
3月前
|
存储 JSON 小程序
微信小程序入门之新建并认识小程序结构
微信小程序入门之新建并认识小程序结构
Codelinghu
63 1
小暖的遇见
|
1天前
|
开发框架 小程序 前端开发
圈子社交app前端+后端源码，uniapp社交兴趣圈子开发，框架php圈子小程序安装搭建
本文介绍了圈子社交APP的源码获取、分析与定制，PHP实现的圈子框架设计及代码编写，以及圈子小程序的安装搭建。涵盖环境配置、数据库设计、前后端开发与接口对接等内容，确保平台的安全性、性能和功能完整性。通过详细指导，帮助开发者快速搭建稳定可靠的圈子社交平台。
小暖的遇见
20 5
dufadayang
|
4月前
|
小程序 JavaScript 前端开发
小程序常见的UI框架
小程序常见的UI框架
dufadayang
330 60
CamilleKing
|
3月前
|
开发框架 人工智能 小程序
小程序常见的 UI 框架
【10月更文挑战第17天】小程序 UI 框架为开发者提供了便捷的工具和资源，帮助他们快速构建高质量的小程序界面。在选择框架时，需要综合考虑各种因素，以找到最适合项目的解决方案。随着技术的不断进步，UI 框架也将不断发展和创新，为小程序开发带来更多的便利和可能性。
CamilleKing
107 2
yuanzhengme
|
5月前
|
移动开发 小程序 JavaScript
开源的微信小程序框架
【8月更文挑战第22天】开源的微信小程序框架
yuanzhengme
232 65
Codelinghu
|
3月前
|
XML 小程序 JavaScript
小程序入门之项目配置说明和数据绑定
小程序入门之项目配置说明和数据绑定
Codelinghu
48 1
杀死一只知更鸟debug
|
4月前
|
小程序 JavaScript API
微信小程序开发学习之页面导航（声明式导航和编程式导航）
这篇文章介绍了微信小程序中页面导航的两种方式：声明式导航和编程式导航，包括如何导航到tabBar页面、非tabBar页面、后退导航，以及如何在导航过程中传递参数和获取传递的参数。
杀死一只知更鸟debug
188 0
微信小程序开发学习之页面导航（声明式导航和编程式导航）
杀死一只知更鸟debug
|
4月前
|
小程序 JavaScript
微信小程序学习之数据绑定，事件绑定，事件传参与数据同步的学习记录
本文介绍了微信小程序中的数据绑定、事件绑定、事件传参与数据同步的基本概念和使用方法，包括如何在data对象中定义数据、使用mustache语法在wxml中渲染数据、绑定和处理事件、事件对象属性、事件传参以及实现输入框与data数据的同步。
杀死一只知更鸟debug
50 0
微信小程序学习之数据绑定，事件绑定，事件传参与数据同步的学习记录
胡东旭
|
5月前
|
小程序 前端开发 Java
SpringBoot+uniapp+uview打造H5+小程序+APP入门学习的聊天小项目
JavaDog Chat v1.0.0 是一款基于 SpringBoot、MybatisPlus 和 uniapp 的简易聊天软件，兼容 H5、小程序和 APP，提供丰富的注释和简洁代码，适合初学者。主要功能包括登录注册、消息发送、好友管理及群组交流。
胡东旭
120 0
SpringBoot+uniapp+uview打造H5+小程序+APP入门学习的聊天小项目
Codelinghu
|
3月前
|
小程序 前端开发 JavaScript
小程序入门之认识view和text组件
小程序入门之认识view和text组件
Codelinghu
102 0

热门文章

最新文章

  • 1
    【一步步开发AI运动小程序】十五、AI运动识别中，如何判断人体站位的远近？
  • 2
    【一步步开发AI运动小程序】十六、AI运动识别中，如何判断人体站位？
  • 3
    uni-vue3-wetrip自创跨三端(H5+小程序+App)酒店预订app系统模板
  • 4
    【一步步开发AI运动小程序】十七、如何识别用户上传视频中的人体、运动、动作、姿态？
  • 5
    【一步步开发AI运动小程序】九、姿态辅助调试桌面工具的使用
  • 6
    为什么不加盟线下陪玩APP小程序平台，而是自建平台？
  • 7
    【一步步开发AI运动小程序】十二、自定义一个运动分析器，实现计时计数01
  • 8
    【一步步开发AI运动小程序】十、姿态动作相似度比较
  • 9
    uni-app开发AI康复锻炼小程序，帮助肢体受伤患者康复！
  • 1
    微信小程序用户登陆和获取用户信息功能实现
    141
  • 2
    uniapp-微信小程序-上拉和下拉触底刷新
    159
  • 3
    微信小程序和springboot实现微信支付
    266
  • 4
    微信小程序-微信支付
    84
  • 5
    微信小程序调试、断点调试
    210
  • 6
    微信小程序-分包
    77
  • 7
    开发uniapp过程中对app、微信小程序与h5的webview调试
    1239
  • 8
    微信小程序echart图片不显示 问题解决
    76
  • 9
    UniApp与微信小程序介绍及区别
    625
  • 10
    微信小程序开发工具的使用，各个配置文件详解，小程序开发快速入门（二）
    617

    • 相关课程

    更多
  • IoT小程序框架课程
  • 场景实践- 新手玩转云计算-创建炫酷的简历网页
  • 移动Web前端开发
  • 前端开发框架Bootstrap使用教程
  • 面向开发者的LLM入门课程
  • C++ 入门教程开发文档

    • 相关电子书

    更多
  • 微信广告引擎与播放节奏算法实践
  • 微信H5视频播放器在海量业务下的实践
  • 微信高效运维之路

    • 相关实验场景

    更多
  • 搭建微信小程序
  • 每个IT人都想学的“Web应用上云经典架构”实战
  • 1分钟SAE部署PHP商城小程序
  • 语言入门-1：环境构建
  • 前端开发基础1：前端开发环境的安装和配置
  • 阿里云IoT小程序应用开发和组件实践
    • 下一篇
    手把手教你白嫖阿里云服务器(免费领服务器)