微信开发者工具

设置外观和代理

image-20240301125444549

点开设置后，就可以进行配置了

编译与预览

image-20240301130343885

小程序基本结构

image-20240301131310683

  1. pages用来存放所有小程序页面
  2. app.js小程序项目的入口文件
  3. app.json小程序项目的全局配置文件
  4. app.wxss小程序项目的全局样式文件
  5. project.config.json项目的配置文件
  6. sitemap.jso用来配置小程序及其页面是否允许被微信索引

小程序官方建议把所有的小程序页面，都存放在pages目录中，以单独的文件夹存在

其中，每个页面由4个基本文件组成，它们分别是：

  • .js文件（页面的脚本文件，存放页面的数据、事件处理函数等）
  • .json文件（当前页码的配置文件，配置窗口的外观、表现等）
  • .wxml文件（页面的模板结构文件）
  • .wxss文件（当前页码的样式表文件）

image-20240301132111923

刚创建的项目里自带一个index文件夹，里面存放了对应的基本文件

Json配置文件的作用

Json是一种数据格式，在实际开发中，Json总是以配置文件的形式出现。小程序项目中也不例外：通过不同的.json配置文件，可以对小程序项目进行不同级别的配置

小程序项目中有4种json配置文件，分别是：

  1. 项目根目录中的app.json配置文件
  2. 项目根目录中的project.config.json配置文件
  3. 项目根目录中的sitemap.json配置文件
  4. 每个页面文件夹中的.json配置文件

app.json

app.json是当前小程序的全局配置，包括了小程序的所有页面路径、窗口外观、页面表现、底部tab等

Demo项目里的app.json配置内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "pages": [
    "pages/index/index"
  ],
  "window": {
    "navigationBarTextStyle": "black",
    "navigationStyle": "custom"
  },
  "style": "v2",
  "renderer": "skyline",
  "rendererOptions": {
    "skyline": {
      "defaultDisplayBlock": true,
      "disableABTest": true,
      "sdkVersionBegin": "3.0.0",
      "sdkVersionEnd": "15.255.255"
    }
  },
  "componentFramework": "glass-easel",
  "sitemapLocation": "sitemap.json",
  "lazyCodeLoading": "requiredComponents"
}
  1. page：用来记录当前小程序所有页面的路径
  2. window：全局定义小程序所有页面的背景色、文字颜色等
  3. style：全局定义小程序组件所使用的样式版本

project.config.json

project.config.json是项目配置文件，用来记录我们对小程序开发工具所做的个性化配置，例如：

  • setting中保存了编译相关的配置
  • projectname中保存的项目名称
  • appid中保存的是小程序的账号ID

如果想要运行其他人的小程序，需要将appid改成他人的appid，这样就不会报出奇怪的错误了

sitemap.json

微信现已开放小程序内搜索，效果类似于PC页面的SEO。sitemap.json文件用来配置小程序页面是否运行微信索引。

当开发者允许微信索引时，微信会通过爬虫的形式，为小程序的页面内容建立索引。当用户的搜索关键字和页面的索引匹配成功的时候，小程序的页面将可能展示在搜索结果中。

注意：sitemap的索引提示是默认开启的，如需关闭sitemap的索引提示，可在小程序项目配置文件project.config.json的setting中配置字段checkSiteMap为false

页面的.json配置文件

小程序的每一个页面，可以使用.json文件来对本页面的窗口外观进行配置，页面中的配置项会覆盖app.json的window中相同的配置项

小程序基本功能

新增小程序页面

在app.json -> pages中新增页面的存放路径，小程序开发者工具即可帮我们自动创建对应的页面文件

1
2
3
4
"pages": [
    "pages/index/index",
    "pages/studyone/index"
  ],

修改项目首页

调整app.json -> pages 数组中页面路径的前后顺序，即可修改项目的首页。小程序会把排在第一位的页面，当作项目首页进行渲染

1
2
3
4
"pages": [
    "pages/studyone/index",
    "pages/index/index"
  ],

可以通过alt+上切换到上面，作为第一页面渲染

小程序基础语法

WXML

什么是WXML

WXML（WeiXin Markup Language）是小程序框架设计的一套标签语言，用来构建小程序页面的结构，其作用类似于网页开发中的HTML

WXML和HTML的区别

  1. 标签名称不同
    • HTML(div，span，img，a)
    • WXML(view，text，image，navigator)
  2. 属性节点不同
    • <a href='#'>超链接</a>
    • <navigator url="/pages/home/home"></navigator>
  3. 提供了类似于Vue中的模板语法
    • 数据绑定
    • 列表渲染
    • 条件渲染

WXSS

什么是WXSS

WXSS（WeiXin Style Sheets）是一套样式语言，用于描述WXML的组件样式，类似于网页开发中的CSS

WXSS和CSS的区别

  1. 新增了rpx尺寸单位
  • CSS中需要手动进行像素单位换算，例如rem
  • WXSS在底层支持新的尺寸单位rpx，在不同大小的屏幕上小程序会自动进行换算
  1. 提供了全局的样式和局部样式
  • 项目根目录中的app.wxss会作用于所有的小程序页面
  • 局部页面的.wxss样式仅对当前页面生效
  1. WXSS仅支持部分CSS选择器
  • .class和#id
  • element
  • 并集选择器、后代选择器
  • ::after和::before等伪类选择器

小程序中的.js文件

一个项目仅仅提供页面展示是不够的，在小程序中，我们通过.js文件来处理用户的操作。例如：响应用户的点击、获取用户的位置等等

.js文件的分类

  1. app.js
    • 是整个小程序项目的入口文件，通过调用App()函数来启动整个小程序
  2. 页面的.js文件
    • 是页面的入口文件，通过调用Page()函数来创建并运行页面
  3. 普通的.js文件
    • 是普通的功能模块文件，用来封装公共的函数或属性供页面使用

小程序的宿主环境

宿主环境(host environment)指的是程序运行所必须的依赖环境。例如：

Android系统和ios系统是两个不同的宿主环境。安卓版的微信App是不能在ios环境下运行的，所以Android是安卓软件的宿主环境，脱离了宿主环境的软件是没有任何意义的！

image-20240302192349701

手机微信是小程序的宿主环境

小程序借助宿主环境提供的功能，可以完成许多普通网页无法完成的功能，例如：微信扫码、微信支付、微信登录、地理定位等等

小程序宿主环境包含的内容：

  1. 通信模型
  2. 运行机制
  3. 组件
  4. API

通信模型

小程序中通信的主题是渲染层和逻辑层，其中：

  1. WXML模板和WXSS样式工作在渲染层
  2. JS脚本工作在逻辑层

小程序中的通信模型分为两部分：

  1. 渲染层和逻辑层之间的通信
    • 由微信客户端进行转发
  2. 逻辑层和第三方服务器之间的通信
    • 由微信客户端进行转发

运行机制

  1. 把小程序的代码包下载到本地
  2. 解析app.json全局配置文件
  3. 执行app.js小程序入口文件，调用App()创建小程序实例
  4. 渲染小程序首页
  5. 小程序启动完成

页面的渲染过程：

  1. 加载解析页面的.json配置文件
  2. 加载页面的.wxml模板和.wxss样式
  3. 执行页面的.js文件，调用Page()创建页面实例
  4. 页面渲染完成

组件

小程序中的组件也是由宿主环境提供的，开发者可以基于组件快速搭建出漂亮的页面结构。官方把小程序的组件分为了9大类，分别是：

  1. 视图容器
  2. 基础内容
  3. 表单组件
  4. 导航组件
  5. 媒体组件
  6. map地图组件
  7. canvas画布组件
  8. 开放能力
  9. 无障碍访问

常用的视图容器类组件

  1. vie
    • 普通视图区域
    • 类似于HTML中的div，是一个块级元素
    • 常用来实现页面的布局效果
  2. scroll-view
    • 可滚动的视图区域
    • 常用来实现滚动列表效果
  3. swiper和swiper-item
    • 轮播图容器组件和轮播图item组件

scroll-view的基本使用

当规定的盒子高度被超出了，scroll-y就会被使用，造成对应的纵向滚动

1
2
3
4
5
6
7
8
<!--index.wxml-->
<navigation-bar title="Weixin" back="{{false}}" color="black" background="#FFF"></navigation-bar>
<!-- 滚动条组件,scroll-y表示y轴滚动 -->
<scroll-view class="container" scroll-y>
  <view>A</view>
  <view>B</view>
  <view>C</view>
</scroll-view>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
.container{
  border: 1px solid red;
  width: 100px;
  height: 50px;
}
.container  view:nth-child(1){
  background-color: red;
  height: 30px;
}
.container  view:nth-child(2){
  background-color: blue;
  height: 30px;
}
.container  view:nth-child(3){
  background-color: yellow;
  height: 30px;
}

swiper和swiper-item组件的基本使用

1
2
3
4
5
6
7
8
9
10
11
12
13
<!--index.wxml-->
<navigation-bar title="Weixin" back="{{false}}" color="black" background="#FFF"></navigation-bar>
<!-- 轮播图的结构 -->
<swiper class="swiper-container">
  <swiper-item>
    <view class="item">A</view>
  </swiper-item>
  <swiper-item>
    <view class="item">B</view></swiper-item>
  <swiper-item>
    <view class="item">C</view>
  </swiper-item>
</swiper>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
.swiper-container{
  height: 150px;
}
.item{
  height: 100%;
  line-height: 150px;
  text-align: center;
}
/* :nth-child()作用为item，
  child(n)就是作用到第n个值
  1就是作用到第1个值
  选中了第n个item
*/
swiper-item:nth-child(1) .item{
  background-color: red;
}
swiper-item:nth-child(2) .item{
  background-color: blue;
}
swiper-item:nth-child(3) .item{
  background-color: yellow;
}
swiper组件的常用属性
属性 类型 默认值 说明
indicator-dots boolean false 是否显示面板指示点
indicator-color color rgba(0,0,0,0.3) 指示点颜色
indicator-active-color color #000000 当前选中的指示点颜色
autoplay boolean false 是否自动切换
interval number 5000 自动切换时间间隔
circular boolean false 是否采用衔接滑动 
1
2
3
4
<swiper class="swiper-container" indicator-dots="true" 
indicator-color="white" indicator-active-color="gray"
autoplay="true" interval="1000" circular="true"
>

在标签中编写对应的参数即可

circular：可以从最后一张回到第一张或从第一张回到最后一张，称为衔接滑动

text和rich-text组件的基本用法

  1. text
    • 文本组件
    • 类似于HTML中的span标签，是一个行内元素
  2. rich-text
    • 富文本组件
    • 支持把HTML字符串渲染为WXML结构

通过text组件的selectable属性，实现长按选中文本内容的效果：

普通的view组件是不支持长按选中效果的

1
2
3
<view>
  <text user-select="true">6667</text>
</view>

这里采用了user-select是因为selectable在一些新版手机上不可用了，改为user-select才可使用

rich-text的基本使用：

通过rich-text组件的nodes属性节点，把HTML字符串渲染为对应的UI结构

1
2
3
<!-- 这里需要单引号和双引号的问题 -->
<rich-text 
nodes="<h1 style='color:red'>测试标题</h1>"></rich-text>

其他常用组件

  1. button
    • 按钮组件
    • 功能比HTML中的button按钮丰富
    • 通过open-type属性可以调用微信提供的各种功能(客户、转发、获取用户授权、获取用户信息等)
  2. image
    • 图片组件
    • image组件默认宽度约300px、高度约240px
  3. navigator
    • 页面导航组件
    • 类似于HTML的a链接

button按钮的基本使用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
<!-- 默认按钮 -->
<view>
<button>默认按钮</button>
<button type="primary">主色调按钮</button>
<button type="warn">警告按钮</button>
</view>
<!-- 小尺寸按钮 -->
<view>
<button size="mini">小尺寸按钮</button>
<button type="primary" size="mini">主色调按钮</button>
<button type="warn" size="mini">警告按钮</button>
</view>
<!-- plain,镂空按钮 -->
<view>
<button size="mini" plain="true">小尺寸按钮</button>
<button type="primary" plain="true" size="mini">主色调按钮</button>
<button type="warn" plain="true" size="mini">警告按钮</button>
</view>

image组件的基本使用

1
2
<image style="border:1px solid red"></image>
<image src="../../images/Blog二维码.png" style="border:1px solid red"></image>

image组件的mode属性用来指定图片的裁剪和缩放模式，常用的mode属性值如下：

mode值 说明
scaleToFill (默认值)缩放模式，不保持纵横比缩放图片，使图片的宽高完全拉伸至填满image元素
aspectFit 缩放模式，保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来
aspectFill 缩放模式，保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。
widthFix 缩放模式，宽度不变，高度自动变化，保持原图宽高比不变
heightFix 缩放模式，高度不变，宽度自动变化，保持原图宽高比不变

小程序API

小程序API三大分类

小程序官方把API分为了如下3大类：

  1. 事件监听API
    • 特点：以on开头，用来监听某些事件的触发
    • 举例，wx.onWindowsResize(function callback)监听窗口尺寸变化的事件
  2. 同步API
    • 特点1：以Sync结尾的API都是同步API
    • 特点2：同步API的执行结果，可以通过函数值返回值直接获取，如果执行出错会抛出异常
    • 举例：wx.setStorageSync(‘key’，’value’)向本地存储写入内容
  3. 异步API
    • 特点：类似于jQuery中的$.ajax(options)函数。需要通过success、fail、complete接收调用的结果
    • 举例：wx.request()发起网络网络请求，通过success回调函数接收数据

小程序的发布上线

一个小程序的发布上线，一般要经过上传代码 -> 提交审核 -> 发布这三个步骤

上传代码：

  1. 点击开发者工具顶部工具栏中的上传按钮
  2. 填写版本号以及项目备注

image-20240306190331129

上传完成后，在版本控制中可以进行审核及提交

WXML模版语法

数据绑定

1
2
3
4
5
<!-- 动态绑定属性值 -->
<view>{{info}}</view> 
<image src="{{images}}" mode="widthFix"></image>
<view>{{randomNum}}</view>
<view>{{randomNum >= 5 ? '随机数字大于等于5' : '随机数字小于5'}}</view>
1
2
3
4
5
6
7
8
9
// index.js
Page({
  data:{
    info:"hello world",
    images:"../../images/bug.png",
    randomNum:Math.random() * 10,  // 生成10以内的随机数
    twoRandomNum:Math.random().toFixed(2) // 生成一个带两位小数的随机数
  }
})

事件绑定

事件是渲染层到逻辑层的通讯方式。通过事件可以将用户在渲染层产生的行为，反馈到逻辑层进行业务的处理

小程序中的常用事件

类型 绑定方式 事件描述
tap bindtap或bind:tap 手指触摸后马上离开，类似于HTML中的click事件
input bindinput或bind:input 文本框的输入事件
change bindchange或bind:change 状态改变时触发

事件对象的属性列表

当事件回调触发的时候，会收到一个事件对象event，它的详细属性如下表所示：

属性 类型 说明
type String 事件类型
timeStamp Integer 页面打开触发事件所经过的毫秒数
target Object 触发事件的组件的一些属性值集合
currentTarget Object 当前组件的一些属性值集合
detail Object 额外的信息
touches Array 触摸事件，当前停留在屏幕中的触摸点信息的数组
changedTouches Array 触摸事件，当前变化的触摸点信息的数组

bindtap的语法格式

在小程序中，不存在html中的onClick鼠标点击事件，而是通过tap事件来响应用户的触摸行为。

  1. 通过bindtap，可以为组件绑定tap触摸事件，语法如下：

    1
    2
    3
    <view style="background-color: red;" bindtap="outerHandler">
      <button type="primary">按钮</button>
    </view>

  2. 在页面的.js文件中可以定义对应的事件处理函数，事件参数通过形参event（一般简写成e）来接收：

    1
    2
    3
    4
    5
    6
    // index.js
    Page({
      outerHandler(e){
        console.log(e)
      }
    })

target和currentTarget的区别

target是触发该事件的源头组件，而currentTarget则是当前事件所绑定的组件。举例如下：

1
2
3
<view bindtap="outerHandler">
  <button type="primary">按钮</button>
</view>

点击内部的按钮时，点击事件以冒泡的方式向外扩散，也会触发外层view的tap事件处理函数。

  • 冒泡：从内向外

也就是点击后，从当前按钮开始扩散

此时，对于外层的view来说：

  • e.target指向的是触发事件的源头组件，因此，e.target是内部的按钮组件
  • e.currentTarget指向的是当前正在触发事件的那个组件，因此，e.currentTarget是当前的view组件

在事件处理函数中为data中的数据赋值

通过调用this.setData(dataObject)方法，可以给页面data中的数据重新赋值，示例如下：

1
2
3
4
<view style="background-color: red;" bindtap="outerHandler">
 <view style="font-size: 18px;">{{count}}</view>
  <button type="primary">按钮</button>
</view>
1
2
3
4
5
6
7
8
9
10
Page({
  data:{
    count: 0
  },
  outerHandler(e){
    this.setData({
      count: this.data.count + 1
    })
  }
})

事件传参

小程序中的事件传参比较特殊，不能在绑定事件的同时为事件处理函数传递参数。例如，下面的代码将不能正常工作：

1
<button type="primary" bindtap="btnTest(123)">按钮</button>
1
2
3
4
5
6
// index.js
Page({
  btnTest(a){
    console.log(a)
  }
})

因为小程序会把bindtap的属性值，统一当作事件名称来处理，相当于要调用一个名称为btnTest(123)的事件处理函数

可以为组件提供data-自定义属性传参，其中代表的是参数的名字。示例代码如下：

1
2
3
<button type="primary" bindtap="btnTest"
data-info="{{2}}"
>按钮</button>
1
2
3
4
5
6
7
8
Page({
  btnTest(e){
    // 获得标签中的数据集合对象
    console.log(e.target.dataset)
    // 获取指定数据的值
    console.log(e.target.dataset.info)
  }
})

bindinput的语法格式

在小程序中，通过input事件来响应文本框的输入事件，语法格式如下：

1、通过bindinput，可以为文本框绑定输入事件

1
<input bindinput="inputHandler"></input>

2、在页面的.js文件中定义事件处理函数

1
2
3
4
5
6
7
// index.js
Page({
  inputHandler(e){
    // 检测输入框中的value
    console.log(e.detail.value)
  }
})

实现文本框和data之间的数据同步

实现步骤：

  1. 定义数据
  2. 渲染结构
  3. 美化样式
  4. 绑定input事件处理函数
1
2
3
data:{
    msg:"你好"
  },
1
<input value="{{msg}}" bindinput="inputHandler"></input>
1
2
3
4
5
6
input{
  border: 1px solid #eee;
  padding: 5px;
  margin: 5px;
  border-radius: 3px;
}

将输入框中的值设置为对应msg的值，以及输出输入框中的值

1
2
3
4
5
6
7
inputHandler(e){
    this.setData({
      msg:e.detail.value
    })
    // 检测输入框中的value
    console.log(this.data.msg)
  }

条件渲染

wx:if

在小程序中，使用wx:if=”“来判断是否需要渲染该代码块：

1
2
3
4
<view wx:if="{{condition}}"> True </view>
<view wx:elif="{{type===1}}">男1</view>
<view wx:elif="{{type===2}}">女2</view>
<view wx:else>保密</view>

也可以用wx:elif和wx:else来添加else判断

1
2
3
4
5
6
7
// index.js
Page({
  data:{
    condition:false,
    type:3,
  },
})

结合<block>使用wx:if

如果要一次性控制多个组件的展示与隐藏，可以使用一个<block><block>标签将多个组件包装起来，并在<block>标签上使用wx:if控制属性，示例如下：

1
2
3
4
<block wx:if="{{condition}}">
<view> view1</view>
<view> view2</view>
</block>

点击按钮后，会将对应内容隐藏

1
2
3
4
5
6
7
8
9
10
11
Page({
  data:{
    condition:false,  
  },
  ClickToUse(){
    // 设置对应condition的值
    this.setData({
      condition:!this.data.condition
    })
  }
})

注意：<block>并不是一个组件，它只是一个包裹性质的容器，不会在页面中做任何渲染。

hidden

在小程序中，直接使用hidden=”“也能控制元素的显示与隐藏：

1
2
3
4
5
<!-- 条件为true隐藏,为false显示 -->
<view hidden="{{condition}}">
<view> view1</view>
<view> view2</view>
</view>
1
2
3
4
5
6
7
8
9
10
11
12
// index.js
Page({
  data:{
    condition:false,  
  },
  ClickToUse(){
    // 设置对应condition的值
    this.setData({
      condition:!this.data.condition
    })
  }
})

wx:if与hidden的对比

  1. 运行方式不同
    • wx:if 以动态创建和移除元素的方式，控制元素的展示与隐藏
    • hidden以切换样式的方式(display:none/block;)，控制元素的显示与隐藏
  2. 使用建议
    • 频繁切换时，建议使用hidden
    • 控制条件复杂时，建议使用wx:if搭配wx:elif、wx:else进行展示与隐藏的切换

wx:for

通过wx:for可以根据指定的数组，循环渲染重复的组件结构，语法示例如下：

1
2
3
<view wx:for="{{array}}">
  索引是:{{index}} 当前项是:{{item}}
</view>
1
2
3
4
5
Page({
 data:{
   array:["a","b","c"]
 }
})

默认情况下，当前循环项的索引用index表示；当前循环项用item表示。

手动指定索引和当前项的变量名

  • 使用wx:for-index可以指定当前循环项的索引的变量名
  • 使用wx:for-item可以指定当前项的变量名

示例代码如下：

1
2
3
<view wx:for="{{array}}" wx:for-index="idx" wx:for-item="itemName">
  索引是:{{idx}} 当前项是:{{itemName}}
</view>
1
2
3
4
5
Page({
 data:{
   array:["a","b","c"]
 }
})

wx:key的使用

类似于Vue列表渲染中的:key，小程序在实现列表渲染中时，也建议为渲染出来的列表项指定唯一的key值，从而提高渲染的效率，示例代码如下：

1
2
3
<view wx:for="{{array}}" wx:key="id">
  索引是:{{idx}} id是:{{itemName.id}},name is a {{itemName.name}}
</view>
1
2
3
4
5
6
7
8
9
Page({
 data:{
   array:[
     {id:1,name:'red'},
     {id:2,name:'blue'},
     {id:3,name:'green'}
   ]
 }
})

WXSS模板样式

WXSS(WeiXin Style Sheets)是一套样式语言，用于美化WXML的组件样式，类似于网页开发中的CSS

WXSS和CSS的关系

WXSS具有CSS大部分特性，同时，WXSS还对CSS进行了扩充以及修改，以适应微信小程序的开发

与CSS相比，WXSS拓展的特性有：

  • rpx尺寸单位
  • @import样式导入

rpx尺寸单位

rpx（responsive pixel）是微信小程序独有的，用来解决屏适配的尺寸单位。

rpx的实现原理

rpx的实现原理非常简单：鉴于不同设备屏幕的大小不同，为了实现屏幕的自动适配，rpx把所有设备的屏幕，在宽度上等分为750份（即：当前屏幕的总宽度为750rpx）。

  • 在较小的设备上，1rpx所代表的宽度较小
  • 在较大的设备上，1rpx所代表的宽度较大

小程序在不同设备上运行的时候，会自动把rpx的样式单位换算成对应的像素单位来渲染，从而实现屏幕适配。

rpx与px之间的单位换算

在iPhone6上，屏幕宽度为375px，共有750个物理像素，等分为750rpx。则：

750rpx = 375px = 750物理像素

1rpx = 0.5px = 1物理像素

设备 rpx换算px(屏幕宽度/750) px换算rpx(750/屏幕宽度)
iPhone5 1rpx=0.42px 1px=2.34rpx
iPhone6 1rpx=0.5px 1px=2rpx
iPhone6 Plus 1rpx=0.552px 1px=1.81rpx

官方建议：开发微信小程序时，设计师可以用iphone6作为视觉稿的标准

开发举例：在iPhone6上如果要绘制宽100px，高20px的盒子，换算成rpx单位就是两倍的rpx

样式导入

使用WXSS提供的@import语法，可以导入外联的样式表

@import的语法格式

@import后需要跟导入的外联样式表的相对路径，用；表示语句结束。示例如下：

1
2
3
4
/* common.wxss */
.small-p{
  margin: 100px;
}
1
2
3
4
5
/* index.wxss */
@import "common.wxss";
.integrate-p{
  color: red;
}

当使用import导入后，就可以使用common.wxss里的样式了，否则无法使用

1
2
3
<view class="small-p">
aa
</view>

全局和局部样式

全局样式：定义在app.wxss中的样式为全局样式，作用于每一个页面

局部样式：在页面的.wxss文件中定义的样式为局部样式，只作用于当前页面。

注意：

  1. 当局部样式和全局样式冲突时，根据就近原则，局部样式会覆盖全局样式
  2. 当局部样式的权重大于或等于全局样式的权重时，才会覆盖全局的样式

全局配置

全局配置文件及常用的配置项

小程序根目录下的app.json文件是小程序的全局配置文件。常用的配置项如下：

  1. pages
    • 记录当前小程序所有页面的存放路径
  2. window
    • 全局设置小程序窗口的外观
  3. tabBar
    • 设置小程序底部的tabBar效果
  4. style
    • 是否启用新版的组件样式
image-20240307214404784

了解window节点常用的配置项

属性名 类型 默认值 说明
navigationBarTitleText String 字符串 导航栏标题文字内容
navigationBarBackgroundColor HexColor #000000 导航栏背景颜色，如#000000
navigationBarTextStyle String white 导航栏标题颜色，仅支持black/white
backgroundColor HexColor #ffffff 窗口的背景色
backgroundTextStyle String dark 下拉loading的样式，仅支持dark/light
enablePullDownRefresh Boolean false 是否全局开启下拉刷新
onReachBottomDistance Number 50 页面上拉触底事件触发时页面底部距离，单位为px

设置导航栏的标题

设置步骤：app.json -> window -> navigationBarTitleText

需求：把导航栏上的标题，从默认的WeChat修改为My phone

由于就近原则，所以配置会在/pages/index/index.json这个文件中

1
2
3
4
5
{
  "usingComponents": {
    "navigation-bar": "/components/navigation-bar/navigation-bar"
  }
}

而json文件指向了其他的文件夹，说明navigation-bar在此文件夹中，而回到index.wxml中就存在着该组件，已经封装好了一些信息

title="Weixin"对应着导航栏的标题，修改该页面的title就可以使得对应的标题发生改变

设置导航栏的背景色

设置步骤：app.json -> window -> navigationBarBackgroundColor

需求：把导航栏标题的背景色，从默认的#fff修改为#2b4b6b

在旧版微信小程序中，操作步骤如上，而新版如下：

修改对应的background即可

1
<navigation-bar title="My phone" back="{{false}}" color="black" background="#2b4b6b"></navigation-bar>

设置导航栏的标题颜色

设置步骤：app.json -> window -> navigationBarTextStyle

需求：把导航栏上的标题颜色，从默认的black修改为white

在旧版微信小程序中，操作步骤如上，而新版如下：

1
<navigation-bar title="My phone" back="{{false}}" color="white" background="#000000"></navigation-bar>

全局开启下拉刷新功能

概念：下拉刷新是移动端的专有名词，指的是通过手指在屏幕上的下拉滑动操作，从而重新加载页面数据的行为。

设置步骤：app.json -> window -> 把enablePullDownRefresh的值设置为true

1
2
3
4
5
6
"window": {
    "navigationBarTextStyle": "black",
    "navigationStyle": "default",
    "navigationBarTitleText": "My phone",
    "enablePullDownRefresh": true
  },

注意：在app.json中启用下拉刷新功能，会作用于每个小程序页面！

设置下拉刷新时窗口的背景色

当全局开启下拉刷新功能之后，默认的窗口背景为白色。如果自定义下拉刷新窗口背景色，设置步骤为：app.json -> window -> 为backgroundColor指定16进制的颜色值#efefef

1
2
3
4
5
6
7
"window": {
    "navigationBarTextStyle": "black",
    "navigationStyle": "default",
    "navigationBarTitleText": "My phone",
    "enablePullDownRefresh": true,
    "backgroundColor": "#efefef"
  },

设置下拉刷新时loading的样式

当全局开启下拉刷新功能之后，默认窗口的loading样式为白色，如果要更改loading样式的效果，设置步骤为app.json -> window -> 为backgroundTextStyle指定为dark值。

这里的loading样式指的是：

image-20240307223528110

1
2
3
4
5
6
7
8
"window": {
    "navigationBarTextStyle": "black",
    "navigationStyle": "default",
    "navigationBarTitleText": "My phone",
    "enablePullDownRefresh": true,
    "backgroundColor": "#efefef",
    "backgroundTextStyle":"light"
  },

设置上拉触底的距离

概念：上拉触底是移动端的专有名词，通过手指在屏幕上的上拉滑动操作，从而加载更多数据的行为

设置步骤：app.json -> window -> 为onReachBottomDistance设置新的数值

注意：默认距离为50px，如果没有特殊需求，建议使用默认值即可

使用方法同上

tabBar

什么是tabBar

tabBar是移动端应用常见的页面效果，用于实现多页面的快速切换。小程序中通常将其分为：

  • 底部tabBar
  • 顶部tabBar

注意：

  • tabBar中只能配置最少2个、最多5个tab页签
  • 当渲染顶部tabBar时，不显示icon，只显示文本
image-20240308183224775

tabBar的6个组成部分

  1. backgroundColor：tabBar的背景色
  2. selectedIconPath：选中时的图片路径
  3. borderStyle：tabBar上边框的颜色
  4. iconPath：未选中时的图片路径
  5. selectedColor：tab上的文字选中时的颜色
  6. color：tab上文字的默认（未选中）颜色

tabBar节点的配置项

属性 类型 必填 默认值 描述
position String 否 bottom tabBar的位置，仅支持bottom/top
borderStyle String 否 black tabBar上边框的颜色，仅支持black/white
color HexColor 否 tab上文字的默认（未选中）颜色
selectedColor HexColor 否 tab上的文字选中时的颜色
backgroundColor HexColor 否 tabBar的背景色
list Array 是 tab页签的列表，最少2个、最多5个tab

每个tab项的配置选项

属性 类型 必填 描述
pagePath String 是 页面路径，页面必须在pages中预先定义
text String 是 tab上显示的文字
iconPath String 否 未选中时的图标路径；当position为top时，不显示icon
selectedIconPath String 否 选中时的图标路径；当position为top时，不显示icon

配置tabBar

  1. 拷贝图标资源
  2. 新建3个对应的tab页面
  3. 配置tabBar选项

拷贝资源

  1. 将资料中的images文件夹，拷贝到小程序项目根目录中
  2. 将需要用到的小图标分为3组，每组2个，其中：
    • 图片名称中包含 -active的是选中之后的图标
    • 图片名称中不包含 -active的是默认图标

新建页面

通过app.json文件的pages节点，快速新建3个对应的tab页面

1
2
3
4
5
"pages": [
    "pages/home/home",
    "pages/message/message",
    "pages/contact/contact"
  ],

其中home是首页，messsage是消息页面，contact是联系我们页面

配置tabBar选项

  1. 打开app.json配置文件，和pages、window平级，新增tabBar节点
  2. tabBar节点中，新增list数组，这个数组中存放的，是每个tab项的配置对象
  3. 在list数组中，新增每一个tab项的配置对象。对象中包含的属性如下：
    • pagePath指定当前tab对应的页面路径【必填】
    • text指定当前tab上按钮的文字【必填】
    • iconPath指定当前tab未选中时候的图片路径【可选】
    • selectedIconPath指定当前tab被选中后高亮的图片路径【可选】
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
"tabBar": {
    "list": [{
      "pagePath": "pages/home/home",
      "text": "首页",
      "iconPath": "/images/tabs/home.png",
      "selectedIconPath": "/images/tabs/home-active.png"
    },{
      "pagePath": "pages/message/message",
      "text": "消息",
      "iconPath": "/images/tabs/message.png",
      "selectedIconPath": "/images/tabs/message-active.png"
    },{
      "pagePath": "pages/contact/contact",
      "text": "联系我们",
      "iconPath": "/images/tabs/contact.png",
      "selectedIconPath": "/images/tabs/contact-active.png"
    }]
  },

页面配置

页面配置文件的作用

小程序中，每个页面都有自己的.json配置文件，用来对当前页码的窗口外观、页面效果等进行配置。

页面配置和全局配置的关系

小程序中，app.json中的window节点，可以全局配置小程序中每个页面的窗口表现。

如果某些小程序页面想要拥有特殊的窗口表现，此时，页面级别的.json配置文件就可以实现这种需求。

注意：当页面配置与全局配置冲突时，根据就近原则，最终的效果以页面配置为准

页面配置中的常用的配置项

属性 类型 默认值 描述
navigationBarBackgroundColor HexColor #000000 当前页面导航栏背景颜色，如#000000
navigationBarTextStyle String white 当前页码导航栏标题颜色，仅支持black/white
navigationBarTitleText String 当前页码导航栏标题文字内容
backgroundColor HexColor #ffffff 当前页面窗口的背景色
backgroundTextStyle String dark 当前页面下拉loading的样式，仅支持dark/light
enablePullDownRefresh Boolean false 是否为当前页码开启下拉刷新的效果
onReachBottomDistance Number 50 页面上拉触底事件触发时距页面底部距离，单位为px

网络数据请求

网络数据请求的限制

出于安全性方面的考虑。小程序官方对数据接口的请求做出了如下两个限制：

  1. 只能请求https类型的接口
  2. 必须将接口的域名添加到信任列表中

配置request合法域名

需求描述：假设在自己的微信小程序中，希望请求https://www.escook.cn/域名下的接口

配置步骤：登录微信小程序管理后台 -> 开发 -> 开发设置 -> 服务器域名 -> 修改request合法域名

注意事项：

  1. 域名只支持https协议
  2. 域名不能使用IP地址或localhost
  3. 域名必须经过ICP备案
  4. 服务器域名一个月内最多可申请5次修改

发起GET请求

调用微信小程序提供的wx.request()方法，可以发起GET数据请求，示例代码如下：

1
<button bind:tap="getDetail">get</button>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// index.js
Page({
 data:{
   array:[
     {id:1,name:'red'},
     {id:2,name:'blue'},
     {id:3,name:'green'}
   ]
 },
 getDetail(){
   wx.request({
     url: 'https://api-hmugo-web.itheima.net/api/get',
     method:'GET',
     data:{
       name:'zs',
       age:22
     },
     success:(res) => {
       // 请求成功之后的回调函数
       console.log(res)
     }
   })
 }
})

发起POST请求

1
<button bind:tap="getDetailForPost">post</button>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
getDetailForPost(){
   wx.request({
    url: 'https://api-hmugo-web.itheima.net/api/get',
    method:'POST',
    data:{
      name:'ls',
      gender:'男'
    },
    success:(res) => {
      // 请求成功之后的回调函数
      console.log(res)
    }
   })
 }

在页面刚加载时请求数据

在很多情况下，我们需要在页面刚加载时，自动请求一些初始化数据，此时需要在页面的onLoad事件中调用获取数据的函数，示例代码如下：

1
2
3
4
onLoad:function(options){
   this.getDetailForGet();
   this.getDetailForPost();
},

跳过request合法域名校验

如果后端程序员仅仅提供了http协议的接口、暂时没有提供https协议的接口。此时为了不耽误开发的进度，我们可以在微信开发者工具中，临时开启[开发环境不校验请求域名、TLS版本及HTTPS证书]选项，跳过request合法域名的校验

image-20240308223358790

注意：

跳过request合法域名校验的选项，仅限在开发与调试阶段使用！

关于跨域和Ajax的说明

跨域问题只存在于基于浏览器的Web开发中。由于小程序的宿主环境不是浏览器，而是微信客户端，所以小程序中不存在跨域问题。

Ajax技术的核心是依赖浏览器中的XMLHttpRequest这个对象，由于小程序的宿主环境是微信客户端，所以小程序中不能叫做“发起Ajax请求”，而是叫做“发起网络数据请求”。

案例：本地生活

image-20240308223930391
  1. 新建项目并梳理项目结构
  2. 配置导航栏效果
  3. 配置tabBar效果
  4. 实现轮播图效果
  5. 实现九宫格效果
  6. 实现图片布局

新建项目

正常新建一个项目，在里面创建对应的文件

在app.json中配置对应的页面

1
2
3
4
5
"pages": [
   "pages/home/index",
   "pages/message/index",
   "pages/contract/index"
 ],

配置导航栏

这里的导航栏直接在全局里配置就行