← Back to all posts

微信小程序

微信开发者工具

设置外观和代理

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配置内容如下:

    代码 (23 行)
    json
    {
      "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中新增页面的存放路径,小程序开发者工具即可帮我们自动创建对应的页面文件

    json
    "pages": [
        "pages/index/index",
        "pages/studyone/index"
      ],

    修改项目首页

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

    json
    "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. 属性节点不同

  • `超链接`
  • ``
  • 3. 提供了类似于Vue中的模板语法

  • 数据绑定
  • 列表渲染
  • 条件渲染
  • WXSS

    什么是WXSS

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

    WXSS和CSS的区别

    1. 新增了rpx尺寸单位

  • CSS中需要手动进行像素单位换算,例如rem
  • WXSS在底层支持新的尺寸单位rpx,在不同大小的屏幕上小程序会自动进行换算
  • 2. 提供了全局的样式和局部样式

  • 项目根目录中的app.wxss会作用于所有的小程序页面
  • 局部页面的.wxss样式仅对当前页面生效
  • 3. 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就会被使用,造成对应的纵向滚动

    html
    <!--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>

    代码 (18 行)
    css
    .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组件的基本使用

    html
    <!--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>

    代码 (23 行)
    css
    .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-dotsbooleanfalse是否显示面板指示点 indicator-colorcolorrgba(0,0,0,0.3)指示点颜色 indicator-active-colorcolor#000000当前选中的指示点颜色 autoplaybooleanfalse是否自动切换 intervalnumber5000自动切换时间间隔 circularbooleanfalse是否采用衔接滑动

    html
    <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组件是不支持长按选中效果的

    html
    <view>
      <text user-select="true">6667</text>
    </view>

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

    rich-text的基本使用:

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

    html
    <!-- 这里需要单引号和双引号的问题 -->
    <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按钮的基本使用

    代码 (19 行)
    html
    <!-- 默认按钮 -->
    <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组件的基本使用

    html
    <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模版语法

    数据绑定

    html
    <!-- 动态绑定属性值 -->
    <view>{{info}}</view> 
    <image src="{{images}}" mode="widthFix"></image>
    <view>{{randomNum}}</view>
    <view>{{randomNum >= 5 ? '随机数字大于等于5' : '随机数字小于5'}}</view>

    js
    // index.js
    Page({
      data:{
        info:"hello world",
        images:"../../images/bug.png",
        randomNum:Math.random() * 10,  // 生成10以内的随机数
        twoRandomNum:Math.random().toFixed(2) // 生成一个带两位小数的随机数
      }
    })

    事件绑定

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

    小程序中的常用事件

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

    事件对象的属性列表

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

    属性类型说明 typeString事件类型 timeStampInteger页面打开触发事件所经过的毫秒数 targetObject触发事件的组件的一些属性值集合 currentTargetObject当前组件的一些属性值集合 detailObject额外的信息 touchesArray触摸事件,当前停留在屏幕中的触摸点信息的数组 changedTouchesArray触摸事件,当前变化的触摸点信息的数组

    bindtap的语法格式

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

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

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

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

    js
    	// index.js
    	Page({
    	  outerHandler(e){
    	    console.log(e)
    	  }
    	})

    target和currentTarget的区别

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

    html
    <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中的数据重新赋值,示例如下:

    html
    <view style="background-color: red;" bindtap="outerHandler">
     <view style="font-size: 18px;">{{count}}</view>
      <button type="primary">按钮</button>
    </view>

    js
    Page({
      data:{
        count: 0
      },
      outerHandler(e){
        this.setData({
          count: this.data.count + 1
        })
      }
    })

    事件传参

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

    html
    <button type="primary" bindtap="btnTest(123)">按钮</button>

    js
    // index.js
    Page({
      btnTest(a){
        console.log(a)
      }
    })

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

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

    html
    <button type="primary" bindtap="btnTest"
    data-info="{{2}}"
    >按钮</button>

    js
    Page({
      btnTest(e){
        // 获得标签中的数据集合对象
        console.log(e.target.dataset)
        // 获取指定数据的值
        console.log(e.target.dataset.info)
      }
    })

    bindinput的语法格式

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

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

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

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

    js
    // index.js
    Page({
      inputHandler(e){
        // 检测输入框中的value
        console.log(e.detail.value)
      }
    })

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

    实现步骤:

    1. 定义数据

    2. 渲染结构

    3. 美化样式

    4. 绑定input事件处理函数

    js
    data:{
        msg:"你好"
      },

    html
    <input value="{{msg}}" bindinput="inputHandler"></input>

    css
    input{
      border: 1px solid #eee;
      padding: 5px;
      margin: 5px;
      border-radius: 3px;
    }

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

    js
    inputHandler(e){
        this.setData({
          msg:e.detail.value
        })
        // 检测输入框中的value
        console.log(this.data.msg)
      }

    条件渲染

    wx:if

    在小程序中,使用wx:if="{{condition}}"来判断是否需要渲染该代码块:

    html
    <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判断

    js
    // index.js
    Page({
      data:{
        condition:false,
        type:3,
      },
    })

    结合``使用wx:if

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

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

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

    js
    Page({
      data:{
        condition:false,  
      },
      ClickToUse(){
        // 设置对应condition的值
        this.setData({
          condition:!this.data.condition
        })
      }
    })

    注意:``并不是一个组件,它只是一个包裹性质的容器,不会在页面中做任何渲染。

    hidden

    在小程序中,直接使用hidden="{{condition}}"也能控制元素的显示与隐藏:

    html
    <!-- 条件为true隐藏,为false显示 -->
    <view hidden="{{condition}}">
    <view> view1</view>
    <view> view2</view>
    </view>

    js
    // 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可以根据指定的数组,循环渲染重复的组件结构,语法示例如下:

    html
    <view wx:for="{{array}}">
      索引是:{{index}} 当前项是:{{item}}
    </view>

    js
    Page({
     data:{
       array:["a","b","c"]
     }
    })

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

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

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

    html
    <view wx:for="{{array}}" wx:for-index="idx" wx:for-item="itemName">
      索引是:{{idx}} 当前项是:{{itemName}}
    </view>

    js
    Page({
     data:{
       array:["a","b","c"]
     }
    })

    wx:key的使用

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

    html
    <view wx:for="{{array}}" wx:key="id">
      索引是:{{idx}} id是:{{itemName.id}},name is a {{itemName.name}}
    </view>

    js
    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/屏幕宽度) iPhone51rpx=0.42px1px=2.34rpx iPhone61rpx=0.5px1px=2rpx iPhone6 Plus1rpx=0.552px1px=1.81rpx

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

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

    样式导入

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

    @import的语法格式

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

    css
    /* common.wxss */
    .small-p{
      margin: 100px;
    }

    css
    /* index.wxss */
    @import "common.wxss";
    .integrate-p{
      color: red;
    }

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

    html
    <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节点常用的配置项

    属性名类型默认值说明 navigationBarTitleTextString字符串导航栏标题文字内容 navigationBarBackgroundColorHexColor#000000导航栏背景颜色,如#000000 navigationBarTextStyleStringwhite导航栏标题颜色,仅支持black/white backgroundColorHexColor#ffffff窗口的背景色 backgroundTextStyleStringdark下拉loading的样式,仅支持dark/light enablePullDownRefreshBooleanfalse是否全局开启下拉刷新 onReachBottomDistanceNumber50页面上拉触底事件触发时页面底部距离,单位为px

    设置导航栏的标题

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

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

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

    json
    {
      "usingComponents": {
        "navigation-bar": "/components/navigation-bar/navigation-bar"
      }
    }

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

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

    设置导航栏的背景色

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

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

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

    修改对应的background即可

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

    设置导航栏的标题颜色

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

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

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

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

    全局开启下拉刷新功能

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

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

    json
    "window": {
        "navigationBarTextStyle": "black",
        "navigationStyle": "default",
        "navigationBarTitleText": "My phone",
        "enablePullDownRefresh": true
      },

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

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

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

    json
    "window": {
        "navigationBarTextStyle": "black",
        "navigationStyle": "default",
        "navigationBarTitleText": "My phone",
        "enablePullDownRefresh": true,
        "backgroundColor": "#efefef"
      },

    设置下拉刷新时loading的样式

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

    这里的loading样式指的是:

    image-20240307223528110

    json
    "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节点的配置项

    属性类型必填默认值描述 positionString否bottomtabBar的位置,仅支持bottom/top borderStyleString否blacktabBar上边框的颜色,仅支持black/white colorHexColor否tab上文字的默认(未选中)颜色 selectedColorHexColor否tab上的文字选中时的颜色 backgroundColorHexColor否tabBar的背景色 listArray是tab页签的列表,最少2个、最多5个tab

    每个tab项的配置选项

    属性类型必填描述 pagePathString是页面路径,页面必须在pages中预先定义 textString是tab上显示的文字 iconPathString否未选中时的图标路径;当position为top时,不显示icon selectedIconPathString否选中时的图标路径;当position为top时,不显示icon

    配置tabBar

    1. 拷贝图标资源

    2. 新建3个对应的tab页面

    3. 配置tabBar选项

    拷贝资源

    1. 将资料中的images文件夹,拷贝到小程序项目根目录中

    2. 将需要用到的小图标分为3组,每组2个,其中:

  • 图片名称中包含 -active的是选中之后的图标
  • 图片名称中不包含 -active的是默认图标
  • 新建页面

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

    json
    "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被选中后高亮的图片路径【可选】
  • 代码 (19 行)
    json
    "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配置文件就可以实现这种需求。

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

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

    属性类型默认值描述 navigationBarBackgroundColorHexColor#000000当前页面导航栏背景颜色,如#000000 navigationBarTextStyleStringwhite当前页码导航栏标题颜色,仅支持black/white navigationBarTitleTextString当前页码导航栏标题文字内容 backgroundColorHexColor#ffffff当前页面窗口的背景色 backgroundTextStyleStringdark当前页面下拉loading的样式,仅支持dark/light enablePullDownRefreshBooleanfalse是否为当前页码开启下拉刷新的效果 onReachBottomDistanceNumber50页面上拉触底事件触发时距页面底部距离,单位为px

    网络数据请求

    网络数据请求的限制

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

    1. 只能请求https类型的接口

    2. 必须将接口的域名添加到信任列表中

    配置request合法域名

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

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

    注意事项:

    1. 域名只支持https协议

    2. 域名不能使用IP地址或localhost

    3. 域名必须经过ICP备案

    4. 服务器域名一个月内最多可申请5次修改

    发起GET请求

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

    html
    <button bind:tap="getDetail">get</button>

    代码 (25 行)
    js
    // 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请求

    html
    <button bind:tap="getDetailForPost">post</button>

    js
    getDetailForPost(){
       wx.request({
        url: 'https://api-hmugo-web.itheima.net/api/get',
        method:'POST',
        data:{
          name:'ls',
          gender:'男'
        },
        success:(res) => {
          // 请求成功之后的回调函数
          console.log(res)
        }
       })
     }

    在页面刚加载时请求数据

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

    js
     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中配置对应的页面

    json
     "pages": [
        "pages/home/index",
        "pages/message/index",
        "pages/contract/index"
      ],

    配置导航栏

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

    © 2025 EastWind. All rights reserved.