前往小程序,Get更优阅读体验!
立即前往
发布
社区首页 >专栏 >2019-面向小白的微信小程序-视频教学-基础

2019-面向小白的微信小程序-视频教学-基础

作者头像
万少
发布2025-02-08 10:00:00
发布2025-02-08 10:00:00
16600
代码可运行
举报
运行总次数:0
代码可运行

0. 学前准备

具有以下技术铺垫来学小程序效果最佳

  1. html
  2. css
  3. JavaScript
  4. es6
  5. vue
  6. 移动端布局能力 rem、vw、等

1. 微信小程序课程介绍

本章节B站视频链接

2. 微信小程序介绍

本章节B站视频链接

1553001003496
1553001003496

微信小程序,简称小程序,英文名Mini Program,是一种不需要下载安装即可使用的应用,它实现了应用“触手可及”的梦想,用户扫一扫或搜一下即可打开应用

2.1. 为什么是微信小程序?

  1. 微信有海量用户,而且粘性很高,在微信里开发产品更容易触达用户;
  2. 推广app 或公众号的成本太高。
  3. 开发适配成本低。
  4. 容易小规模试错,然后快速迭代。
  5. 跨平台。

2.2. 微信小程序历史

  • 2016年1月11日,微信之父张小龙时隔多年的公开亮相,解读了微信的四大价值观。张小龙指出,越来越多产品通过公众号来做,因为这里开发、获取用户和传播成本更低。拆分出来的服务号并没有提供更好的服务,所以微信内部正在研究新的形态,叫**「微信小程序」** 需要注意的是,之前是叫做 应用号
  • 2016年9月21日,微信小程序正式开启内测。在微信生态下,触手可及、用完即走的微信小程序引起广泛关注。腾讯云正式上线微信小程序解决方案,提供小程序在云端服务器的技术方案。
  • 2017年1月9日,微信推出的“小程序”正式上线。“小程序”是一种无需安装,即可使用的手机“应用”。不需要像往常一样下载App,用户在微信中“用完即走”。

2.3. 疯狂的微信小程序

  1. 微信月活已经达到10.82亿。其中55岁以上的用户也达到6300万
  2. 信息传达数达到450亿,较去年增长18%;视频通话4.1亿次,增长100%
  3. 小程序覆盖超过200+行业,交易额增长超过6倍,服务1000亿+人次,创造出了5000亿+的商业价值

2.4. 还有其他的小程序 不容忽视

  1. 支付宝小程序
  2. 百度小程序
  3. QQ小程序
  4. 今日头条 + 抖音小程序

2.5. 体验

2.5.1. 官方微信小程序体验

小程序示例源码

2.5.2. 其他优秀的第三方小程序

  • 拼多多
  • 滴滴出行
  • 欢乐斗地主
  • 智行火车票
  • 唯品会
  • 。。。

3. 小程序开发环境准备

本章节B站视频链接

开发微信小程序之前,必须要准备好相应的环境

3.1. 注册账号

建议使用全新的邮箱,没有注册过其他小程序或者公众号的。

访问注册页面,耐心完成注册即可。

3.2. 获取APPID

由于后期调用微信小程序的接口等功能,需要索取开发者的小程序中的APPID,所以在注册成功后,可登录,然后获取APPID。

登录,成功后可看到如下界面

然后复制你的APPID,悄悄的保存起来,不要给别人看到😄。

1553002664580
1553002664580
1553002677039
1553002677039

3.3. 开发工具

下载地址

1553003775186
1553003775186

微信小程序自带开发者工具,集 开发 预览 调试 发布 于一身的 完整环境。

但是由于编码的体验不算好,因此 建议使用 vs code + 微信小程序编辑工具 来实现编码

vs code 负责敲代码,微信编辑工具 负责预览

4. 第一个微信小程序

本章节B站视频链接

4.1. 打开微信开发者工具

注意 第一次登录的时候 需要扫码登录

4.2. 新建小程序项目

1553003617927
1553003617927

4.3. 填写项目信息

1553003731087
1553003731087

4.4. 成功

1553003764764
1553003764764

5. 微信开发者工具介绍

本章节B站视频链接

详细的使用,可以查看官网

1553007015501
1553007015501

6. 小程序结构目录

本章节B站视频链接

小程序框架的目标是通过尽可能简单、高效的方式让开发者可以在微信中开发具有原生 APP 体验的服务。

小程序框架提供了自己的视图层描述语言 WXMLWXSS,以及 JavaScript,并在视图层与逻辑层间提供了数据传输和事件系统,让开发者能够专注于数据与逻辑。

6.1. 小程序文件结构和传统web对比

结构

传统web

微信小程序

结构

HTML

WXML

样式

CSS

WXSS

逻辑

Javascript

Javascript

配置

JSON

通过以上对比得出,传统web 是三层结构。而微信小程序 是四层结构,多了一层 配置.json

6.2. 基本的项目目录

1563093965741
1563093965741

7. 小程序配置文件

本章节B站视频链接

一个小程序应用程序会包括最基本的两种配置文件。一种是全局的 app.json 和 页面自己的 page.json

注意:配置文件中不能出现注释

7.1. 全局配置 app.json

app.json 是当前小程序的全局配置,包括了小程序的所有页面路径、界面表现、网络超时时间、底部 tab 等。普通快速启动项目里边的 app.json 配置

代码语言:javascript
代码运行次数:0
复制
{
  "pages":[
    "pages/index/index",
    "pages/logs/logs"
  ],
  "window":{
    "backgroundTextStyle":"light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "WeChat",
    "navigationBarTextStyle":"black"
  }
}

字段的含义

  1. pages字段 —— 用于描述当前小程序所有页面路径,这是为了让微信客户端知道当前你的小程序页面定义在哪个目录。
  2. window字段 —— 定义小程序所有页面的顶部背景颜色,文字颜色定义等。
  3. 完整的配置信息请参考 app.json配置

7.1.1. tabbar

1556361902314
1556361902314

7.2. 页面配置 page.json

这里的 page.json 其实用来表示页面目录下的 page.json 这类和小程序页面相关的配置。

开发者可以独立定义每个页面的一些属性,如顶部颜色、是否允许下拉刷新等等。

页面的配置只能设置 app.json 中部分 window 配置项的内容,页面中配置项会覆盖 app.jsonwindow 中相同的配置项。

属性

类型

默认值

描述

navigationBarBackgroundColor

HexColor

#000000

导航栏背景颜色,如 #000000

navigationBarTextStyle

String

white

导航栏标题颜色,仅支持 black / white

navigationBarTitleText

String

导航栏标题文字内容

backgroundColor

HexColor

#ffffff

窗口的背景色

backgroundTextStyle

String

dark

下拉 loading 的样式,仅支持 dark / light

enablePullDownRefresh

Boolean

false

是否全局开启下拉刷新。 详见 Page.onPullDownRefresh

onReachBottomDistance

Number

50

页面上拉触底事件触发时距页面底部距离,单位为px。 详见 Page.onReachBottom

disableScroll

Boolean

false

设置为 true 则页面整体不能上下滚动;只在页面配置中有效,无法在 app.json 中设置该项

7.3. sitemap 配置-了解即可

小程序根目录下的 sitemap.json 文件用于配置小程序及其页面是否允许被微信索引。

8. 模板语法

本章节B站视频链接

WXML(WeiXin Markup Language)是框架设计的一套标签语言,结合基础组件事件系统,可以构建出页面的结构。

8.1. 数据绑定

8.1.1. 普通写法

代码语言:javascript
代码运行次数:0
复制
<view> {{ message }} </view>
代码语言:javascript
代码运行次数:0
复制
Page({
  data: {
    message: 'Hello MINA!'
  }
})

8.1.2. 组件属性

代码语言:javascript
代码运行次数:0
复制
<view id="item-{{id}}"> </view>
代码语言:javascript
代码运行次数:0
复制
Page({
  data: {
    id: 0
  }
})

8.1.3. bool类型

不要直接写 checked="false",其计算结果是一个字符串

代码语言:javascript
代码运行次数:0
复制
<checkbox checked="{{false}}"> </checkbox>

8.2. 运算

8.2.1. 三元运算

代码语言:javascript
代码运行次数:0
复制
<view hidden="{{flag ? true : false}}"> Hidden </view>

8.2.2. 算数运算

代码语言:javascript
代码运行次数:0
复制
<view> {{a + b}} + {{c}} + d </view>
代码语言:javascript
代码运行次数:0
复制
Page({
  data: {
    a: 1,
    b: 2,
    c: 3
  }
})

8.2.3. 逻辑判断

代码语言:javascript
代码运行次数:0
复制
<view wx:if="{{length > 5}}"> </view>

8.2.4. 字符串运算

代码语言:javascript
代码运行次数:0
复制
<view>{{"hello" + name}}</view>
代码语言:javascript
代码运行次数:0
复制
Page({
  data:{
    name: 'MINA'
  }
})

8.2.5. 注意

花括号和引号之间如果有空格,将最终被解析成为字符串

8.3. 列表渲染

8.3.1. wx:for

项的变量名默认为 item wx:for-item 可以指定数组当前元素的变量名

下标变量名默认为 index wx:for-index 可以指定数组当前下标的变量名

wx:key 用来提高数组渲染的性能

wx:key 绑定的值 有如下选择

string 类型,表示 循环项中的唯一属性 如

代码语言:javascript
代码运行次数:0
复制
list:[{id:0,name:"炒饭"},{id:1,name:"炒面"}]

wx:key="id"

保留字 *this ,它的意思是 item 本身 ,*this 代表的必须是 唯一的字符串和数组。

代码语言:javascript
代码运行次数:0
复制
list:[1,2,3,4,5]

wx:key="*this"

代码

代码语言:javascript
代码运行次数:0
复制
<view wx:for="{{array}}" wx:key="id">
  {{index}}: {{item.message}}
</view>
代码语言:javascript
代码运行次数:0
复制
Page({
  data: {
    array: [{
      id:0,
      message: 'foo',
    }, {
      id:1,
      message: 'bar'
    }]
  }
})

8.3.2. block

渲染一个包含多节点的结构块 block最终不会变成真正的dom元素

代码语言:javascript
代码运行次数:0
复制
<block wx:for="{{[1, 2, 3]}}" wx:key="*this" >
  <view> {{index}}: </view>
  <view> {{item}} </view>
</block>

8.4. 条件渲染

8.4.1. wx:if

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

代码语言:javascript
代码运行次数:0
复制
  <view wx:if="{{false}}">1</view>
  <view wx:elif="{{true}}">2</view>
  <view wx:else>3</view>

8.4.2. hidden

代码语言:javascript
代码运行次数:0
复制
<view hidden="{{condition}}"> True </view>

类似 wx:if

频繁切换 用 hidden

不常使用 用 wx:if

9. 小程序事件的绑定

本章节B站视频链接

小程序中绑定事件,通过bind关键字来实现。如 bindtap bindinput bindchange

不同的组件支持不同的事件,具体看组件的说明即可。

9.1. wxml

代码语言:javascript
代码运行次数:0
复制
<input bindinput="handleInput" />

9.2. page

代码语言:javascript
代码运行次数:0
复制
Page({
  // 绑定的事件
  handleInput: function(e) {
    console.log(e);
    console.log("值被改变了");
  }
})

9.3. 特别注意

绑定事件时不能带参数 不能带括号 以下为错误写法

代码语言:javascript
代码运行次数:0
复制
<input bindinput="handleInput(100)" />

事件传值 通过标签自定义属性的方式 和 value

代码语言:javascript
代码运行次数:0
复制
<input bindinput="handleInput" data-item="100" />

事件触发时获取数据

代码语言:javascript
代码运行次数:0
复制
  handleInput: function(e) {
    // {item:100}
   console.log(e.currentTarget.dataset)
      
    // 输入框的值
   console.log(e.detail.value);
  }

10. 样式 WXSS

本章节B站视频链接

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

CSS 相比,WXSS 扩展的特性有:

  • 响应式长度单位 rpx
  • 样式导入

10.1. 尺寸单位

rpx(responsive pixel): 可以根据屏幕宽度进行自适应。规定屏幕宽为750rpx。如在 iPhone6 上,屏幕宽度为375px,共有750个物理像素,则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 作为视觉稿的标准。

使用步骤:

  1. 确定设计稿宽度 pageWidth
  2. 计算比例 750rpx = pageWidth px ,因此 1px=750rpx/pageWidth
  3. 在less文件中,只要把设计稿中的 px => 750/pageWidth rpx 即可。

10.2. 样式导入

wxss中直接就支持,样式导入功能。

也可以和 less中的导入混用。

使用@import语句可以导入外联样式表,只支持相对路径

示例代码:

代码语言:javascript
代码运行次数:0
复制
/** common.wxss **/
.small-p {
  padding:5px;
}
代码语言:javascript
代码运行次数:0
复制
/** app.wxss **/
@import "common.wxss";
.middle-p {
  padding:15px;
}

10.3. 选择器

特别需要注意的是 小程序 不支持通配符 * 因此以下代码无效!

代码语言:javascript
代码运行次数:0
复制
*{
    margin:0;
    padding:0;
    box-sizing:border-box;
}

目前支持的选择器有:

选择器

样例

样例描述

.class

.intro

选择所有拥有 class="intro" 的组件

#id

#firstname

选择拥有 id="firstname" 的组件

element

view

选择所有 view 组件

element, element

view, checkbox

选择所有文档的 view 组件和所有的 checkbox 组件

nth-child(n)

view:nth-child(n)

选择某个索引的标签

::after

view::after

在 view 组件后边插入内容

::before

view::before

在 view 组件前边插入内容

10.4. 小程序中使用less

原生小程序不支持less,其他基于小程序的框架大体都支持,如wepympvuetaro等。但是仅仅因为一个less功能,而去引入一个框架,肯定是不可取的。因此可以用以下方式来实现

编辑器是vscode

安装插件 easy less

1554863554125
1554863554125

在vs code的设置中加入如下,配置

代码语言:javascript
代码运行次数:0
复制
    "less.compile": {
        "outExt":       ".wxss"
    }

在要编写样式的地方,新建 less文件,如 index.less,然后正常编辑即可。

11. 常见组件

本章节B站视频链接

重点讲解小程序中常用的布局组件

view,text,rich-text,button,image,navigator,icon,swiper,radio,checkbox。

11.1. view

代替 原来的 div 标签

代码语言:javascript
代码运行次数:0
复制
  <view hover-class="h-class">
  点击我试试
  </view>

11.2. text

  1. 文本标签
  2. 只能嵌套text
  3. 长按文字可以复制(只有该标签有这个功能)
  4. 可以对空格 回车 进行编码

属性名

类型

默认值

说明

selectable

Boolean

false

文本是否可选

decode

Boolean

false

是否解码

11.2.1. 代码

代码语言:javascript
代码运行次数:0
复制
  <text selectable="{{false}}" decode="{{false}}">
    普&nbsp;通
  </text>

11.3. image

  1. 图片标签,image组件默认宽度320px、高度240px
  2. 支持懒加载

属性名

类型

默认值

说明

src

String

图片资源地址

mode

String

'scaleToFill'

图片裁剪、缩放的模式

lazy-load

Boolean

false

图片懒加载

mode 有效值:

mode 有 13 种模式,其中 4 种是缩放模式,9 种是裁剪模式。

模式

说明

缩放

scaleToFill

不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素

缩放

aspectFit

保持纵横比缩放图片,使图片的长边能完全显示出来。

缩放

aspectFill

保持纵横比缩放图片,只保证图片的短边能完全显示出来。

缩放

widthFix

宽度不变,高度自动变化,保持原图宽高比不变

裁剪

top

不缩放图片,只显示图片的顶部区域

裁剪

bottom

不缩放图片,只显示图片的底部区域

裁剪

center

不缩放图片,只显示图片的中间区域

裁剪

left

不缩放图片,只显示图片的左边区域

裁剪

right

不缩放图片,只显示图片的右边区域

裁剪

top left

不缩放图片,只显示图片的左上边区域

裁剪

top right

不缩放图片,只显示图片的右上边区域

裁剪

bottom left

不缩放图片,只显示图片的左下边区域

裁剪

bottom right

不缩放图片,只显示图片的右下边区域

11.4. swiper

微信内置轮播图组件

1554967073133
1554967073133

默认宽度 100% 高度 150px

属性名

类型

默认值

说明

indicator-dots

Boolean

false

是否显示面板指示点

indicator-color

Color

rgba(0, 0, 0, .3)

指示点颜色

indicator-active-color

Color

#000000

当前选中的指示点颜色

autoplay

Boolean

false

是否自动切换

interval

Number

5000

自动切换时间间隔

circular

Boolean

false

s是否循环轮播

11.4.1. swiper

滑块视图容器。

11.4.2. swiper-item

滑块

默认宽度和高度都是100%

11.5. navigator

导航组件 类似超链接标签

属性名

类型

默认值

说明

target

String

self

在哪个目标上发生跳转,默认当前小程序,可选值self/miniProgram

url

String

当前小程序内的跳转链接

open-type

String

navigate

跳转方式

open-type 有效值:

说明

navigate

保留当前页面,跳转到应用内的某个页面,但是不能跳到 tabbar 页面

redirect

关闭当前页面,跳转到应用内的某个页面,但是不允许跳转到 tabbar 页面。

switchTab

跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面

reLaunch

关闭所有页面,打开到应用内的某个页面

navigateBack

关闭当前页面,返回上一页面或多级页面。可通过 getCurrentPages() 获取当前的页面栈,决定需要返回几层

exit

退出小程序,target="miniProgram"时生效

11.6. rich-text

富文本标签

可以将字符串解析成 对应标签,类似 vue中 v-html功能

1554967141890
1554967141890

代码

代码语言:javascript
代码运行次数:0
复制
// 1   index.wxml  加载 节点数组
<rich-text nodes="{{nodes}}" bindtap="tap"></rich-text>
// 2 加载 字符串
<rich-text nodes='<img src="https://developers.weixin.qq.com/miniprogram/assets/images/head_global_z_@all.png" alt="">'></rich-text> 
 
    
// index.js
    
Page({
  data: {
    nodes: [{
      name: 'div',
      attrs: {
        class: 'div_class',
        style: 'line-height: 60px; color: red;'
      },
      children: [{
        type: 'text',
        text: 'Hello&nbsp;World!'
      }]
    }]
  },
  tap() {
    console.log('tap')
  }
})

11.6.1. nodes属性

nodes属性支持 字符串标签节点数组

属性

说明

类型

必填

备注

name

标签名

string

支持部分受信任的 HTML 节点

attrs

属性

object

支持部分受信任的属性,遵循 Pascal 命名法

children

子节点列表

array

结构和 nodes 一致

文本节点:type = text

属性

说明

类型

必填

备注

text

文本

string

支持entities

  • nodes 不推荐使用 String 类型,性能会有所下降。
  • rich-text 组件内屏蔽所有节点的事件。
  • attrs 属性不支持 id ,支持 class 。
  • name 属性大小写不敏感。
  • 如果使用了不受信任的 HTML 节点,该节点及其所有子节点将会被移除。
  • img 标签仅支持网络图片。

11.7. button

1554896130231
1554896130231
代码语言:javascript
代码运行次数:0
复制
<button
  type="default"
  size="{{defaultSize}}"
  loading="{{loading}}"
  plain="{{plain}}"
>
  default
</button>

属性

类型

默认值

必填

说明

size

string

default

按钮的大小

type

string

default

按钮的样式类型

plain

boolean

false

按钮是否镂空,背景色透明

disabled

boolean

false

是否禁用

loading

boolean

false

名称前是否带 loading 图标

form-type

string

用于 ](https://developers.weixin.qq.com/miniprogram/dev/component/form.html) 组件,点击分别会触发 [ 组件的 submit/reset 事件

open-type

string

微信开放能力

size 的合法值

说明

default

默认大小

mini

小尺寸

type 的合法值

说明

primary

绿色

default

白色

warn

红色

form-type 的合法值

说明

submit

提交表单

reset

重置表单

open-type 的合法值

说明

contact

打开客服会话,如果用户在会话中点击消息卡片后返回小程序,可以从 bindcontact 回调中获得具体信息,具体说明

share

触发用户转发,使用前建议先阅读使用指引

getPhoneNumber

获取用户手机号,可以从bindgetphonenumber回调中获取到用户信息,具体说明

getUserInfo

获取用户信息,可以从bindgetuserinfo回调中获取到用户信息

launchApp

打开APP,可以通过app-parameter属性设定向APP传的参数具体说明

openSetting

打开授权设置页

feedback

打开“意见反馈”页面,用户可提交反馈内容并上传日志,开发者可以登录小程序管理后台后进入左侧菜单“客服反馈”页面获取到反馈内容

11.7.1. open-type 的 contact的实现流程

  1. 将小程序 的appid 由测试号改为 自己的appid
  2. 登录微信小程序官网,添加 客服 - 微信
  3. 为了方便演示,老师自己准备了两个账号
    1. 普通用户 A
    2. 客服-微信 B
  4. 就是干!

11.8. icon

属性

类型

默认值

必填

说明

type

string

icon的类型,有效值:success, success_no_circle, info, warn, waiting, cancel, download, search, clear

size

number/string

23

icon的大小

color

string

icon的颜色,同css的color

1554895930891
1554895930891

代码:

js

代码语言:javascript
代码运行次数:0
复制
Page({
  data: {
    iconSize: [20, 30, 40, 50, 60, 70],
    iconType: [
      'success', 'success_no_circle', 'info', 'warn', 'waiting', 'cancel', 'download', 'search', 'clear'
    ],
    iconColor: [
      'red', 'orange', 'yellow', 'green', 'rgb(0,255,255)', 'blue', 'purple'
    ],
  }
})

wxml

代码语言:javascript
代码运行次数:0
复制
<view class="group">
  <block wx:for="{{iconSize}}">
    <icon type="success" size="{{item}}"/>
  </block>
</view>

<view class="group">
  <block wx:for="{{iconType}}">
    <icon type="{{item}}" size="40"/>
  </block>
</view>

<view class="group">
  <block wx:for="{{iconColor}}">
    <icon type="success" size="40" color="{{item}}"/>
  </block>
</view>

11.9. radio

可以通过 color属性来修改颜色

1554967226776
1554967226776

需要搭配 radio-group 一起使用

11.10. checkbox

可以通过 color属性来修改颜色

1554967207864
1554967207864

需要搭配 checkbox-group 一起使用

12. 自定义组件

本章节B站视频链接

类似vue或者react中的自定义组件

小程序允许我们使用自定义组件的方式来构建页面。

12.1. 创建自定义组件

类似于页面,一个自定义组件由 json wxml wxss js 4个文件组成

可以在微信开发者工具中快速创建组件的文件结构

1554897412118
1554897412118

在文件夹内components/myHeader,创建组件 名为 myHeader

1554897785012
1554897785012

12.1.1. 声明组件

首先需要在组件的 json 文件中进行自定义组件声明

myHeader.json

代码语言:javascript
代码运行次数:0
复制
{
  "component": true
}

12.1.2. 编辑组件

同时,还要在组件的 wxml 文件中编写组件模板,在 wxss 文件中加入组件样式

slot表示插槽,类似vue中的slot

myHeader.wxml

代码语言:javascript
代码运行次数:0
复制
<!-- 这是自定义组件的内部WXML结构 -->
<view class="inner">
  {{innerText}}
    <slot></slot>
</view>

在组件的 wxss文件中编写样式

注意:在组件wxss中不应使用ID选择器、属性选择器和标签名选择器。

myHeader.wxss

代码语言:javascript
代码运行次数:0
复制
/* 这里的样式只应用于这个自定义组件 */
.inner {
  color: red;
}

12.1.3. 注册组件

在组件的 js 文件中,需要使用 Component() 来注册组件,并提供组件的属性定义、内部数据和自定义方法

myHeader.js

代码语言:javascript
代码运行次数:0
复制
Component({
  properties: {
    // 这里定义了innerText属性,属性值可以在组件使用时指定
    innerText: {
      // 期望要的数据是 string类型
      type: String,
      value: 'default value',
    }
  },
  data: {
    // 这里是一些组件内部数据
    someData: {}
  },
  methods: {
    // 这里是一个自定义方法
    customMethod: function(){}
  }
})

12.2. 声明引入自定义组件

首先要在页面的 json 文件中进行引用声明。还要提供对应的组件名和组件路径

index.wxml

代码语言:javascript
代码运行次数:0
复制
{
	// 引用声明
  "usingComponents": {
  	// 要使用的组件的名称     // 组件的路径
    "my-header":"/components/myHeader/myHeader"
  }
}

12.3. 页面中使用自定义组件

代码语言:javascript
代码运行次数:0
复制
<view>
  <!-- 以下是对一个自定义组件的引用 -->
  <my-header inner-text="Some text">
    <view>用来替代slot的</view>
    </my-header>
</view>

12.4. 其他属性

12.5. 定义段与示例方法

Component构造器可用于定义组件,调用Component构造器时可以指定组件的属性、数据、方法等。

定义段

类型

是否必填

描述

properties

Object Map

组件的对外属性,是属性名到属性设置的映射表,参见下文

data

Object

组件的内部数据,和 properties 一同用于组件的模板渲染

observers

Object

组件数据字段监听器,用于监听 properties 和 data 的变化,参见 数据监听器

methods

Object

组件的方法,包括事件响应函数和任意的自定义方法,关于事件响应函数的使用,参见 组件事件

created

Function

组件生命周期函数,在组件实例刚刚被创建时执行,注意此时不能调用 setData ,参见 组件生命周期

attached

Function

组件生命周期函数,在组件实例进入页面节点树时执行,参见 组件生命周期

ready

Function

组件生命周期函数,在组件布局完成后执行,参见 组件生命周期

moved

Function

组件生命周期函数,在组件实例被移动到节点树另一个位置时执行,参见 组件生命周期

detached

Function

组件生命周期函数,在组件实例被从页面节点树移除时执行,参见 组件生命周期

12.6. 组件-自定义组件传参

  1. 父组件通过属性的方式给子组件传递参数
  2. 子组件通过事件的方式向父组件传递参数

12.6.1. 过程

  1. 父组件 把数据 {{tabs}} 传递到 子组件的 tabItems 属性中
  2. 父组件监听 onMyTab 事件
  3. 子组件 触发 bindmytap 中的 mytap 事件
    1. 自定义组件触发事件时,需要使用 triggerEvent 方法,指定事件名detail对象
  4. 父 -> 子 动态传值 this.selectComponent("#tabs");

父组件代码

代码语言:javascript
代码运行次数:0
复制
// page.wxml 

<tabs tabItems="{{tabs}}" bindmytap="onMyTab" >
  内容-这里可以放插槽
</tabs>

// page.js
  data: {
    tabs:[
      {name:"体验问题"},
      {name:"商品、商家投诉"}
    ]
  },
  onMyTab(e){
    console.log(e.detail);
  },

子组件代码

代码语言:javascript
代码运行次数:0
复制
// com.wxml
<view class="tabs">
  <view class="tab_title"  >
    <block  wx:for="{{tabItems}}" wx:key="{{item}}">
      <view bindtap="handleItemActive" data-index="{{index}}">{{item.name}}</view>
    </block>
  </view>
  <view class="tab_content">
    <slot></slot>
  </view>
</view>

// com.js
Component({
  properties: {
    tabItems:{
      type:Array,
      value:[]
    }
  },
  /**
   * 组件的初始数据
   */
  data: {
  },

  /**
   * 组件的方法列表
   */
  methods: {
    handleItemActive(e){
      this.triggerEvent('mytap','haha');
    }
  }
})

12.7. 小结

  1. 标签名 是 中划线的方式
  2. 属性的方式 也是要中划线的方式
  3. 其他情况可以使用驼峰命名
    1. 组件的文件名如 myHeader.js 的等
    2. 组件内的要接收的属性名 如 innerText
  4. 更多。。

13. 小程序生命周期

本章节B站视频链接

分为应用生命周期页面生命周期

关于小程序前后台的定义和小程序的运行机制,请参考运行机制章节。

13.1. 应用生命周期

属性

类型

默认值

必填

说明

onLaunch

function

监听小程序初始化。

onShow

function

监听小程序启动或切前台。

onHide

function

监听小程序切后台。

onError

function

错误监听函数。

onPageNotFound

function

页面不存在监听函数。

13.2. 页面生命周期

属性

类型

说明

data

Object

页面的初始数据

onLoad

function

生命周期回调—监听页面加载

onShow

function

生命周期回调—监听页面显示

onReady

function

生命周期回调—监听页面初次渲染完成

onHide

function

生命周期回调—监听页面隐藏

onUnload

function

生命周期回调—监听页面卸载

onPullDownRefresh

function

监听用户下拉动作

onReachBottom

function

页面上拉触底事件的处理函数

onShareAppMessage

function

用户点击右上角转发

onPageScroll

function

页面滚动触发事件的处理函数

onResize

function

页面尺寸改变时触发,详见 响应显示区域变化

onTabItemTap

function

当前是 tab 页时,点击 tab 时触发

13.3. 页面生命周期图解

page-lifecycle
page-lifecycle
本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2025-02-08,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 0. 学前准备
  • 1. 微信小程序课程介绍
  • 2. 微信小程序介绍
    • 2.1. 为什么是微信小程序?
    • 2.2. 微信小程序历史
    • 2.3. 疯狂的微信小程序
    • 2.4. 还有其他的小程序 不容忽视
    • 2.5. 体验
      • 2.5.1. 官方微信小程序体验
      • 2.5.2. 其他优秀的第三方小程序
  • 3. 小程序开发环境准备
    • 3.1. 注册账号
    • 3.2. 获取APPID
    • 3.3. 开发工具
  • 4. 第一个微信小程序
    • 4.1. 打开微信开发者工具
    • 4.2. 新建小程序项目
    • 4.3. 填写项目信息
    • 4.4. 成功
  • 5. 微信开发者工具介绍
  • 6. 小程序结构目录
    • 6.1. 小程序文件结构和传统web对比
    • 6.2. 基本的项目目录
  • 7. 小程序配置文件
    • 7.1. 全局配置 app.json
      • 7.1.1. tabbar
    • 7.2. 页面配置 page.json
    • 7.3. sitemap 配置-了解即可
  • 8. 模板语法
    • 8.1. 数据绑定
      • 8.1.1. 普通写法
      • 8.1.2. 组件属性
      • 8.1.3. bool类型
    • 8.2. 运算
      • 8.2.1. 三元运算
      • 8.2.2. 算数运算
      • 8.2.3. 逻辑判断
      • 8.2.4. 字符串运算
      • 8.2.5. 注意
    • 8.3. 列表渲染
      • 8.3.1. wx:for
      • 8.3.2. block
    • 8.4. 条件渲染
      • 8.4.1. wx:if
      • 8.4.2. hidden
  • 9. 小程序事件的绑定
    • 9.1. wxml
    • 9.2. page
    • 9.3. 特别注意
  • 10. 样式 WXSS
    • 10.1. 尺寸单位
    • 10.2. 样式导入
    • 10.3. 选择器
    • 10.4. 小程序中使用less
  • 11. 常见组件
    • 11.1. view
    • 11.2. text
      • 11.2.1. 代码
    • 11.3. image
    • 11.4. swiper
      • 11.4.1. swiper
      • 11.4.2. swiper-item
    • 11.5. navigator
    • 11.6. rich-text
      • 11.6.1. nodes属性
    • 11.7. button
      • 11.7.1. open-type 的 contact的实现流程
    • 11.8. icon
    • 11.9. radio
    • 11.10. checkbox
  • 12. 自定义组件
    • 12.1. 创建自定义组件
      • 12.1.1. 声明组件
      • 12.1.2. 编辑组件
      • 12.1.3. 注册组件
    • 12.2. 声明引入自定义组件
    • 12.3. 页面中使用自定义组件
    • 12.4. 其他属性
    • 12.5. 定义段与示例方法
    • 12.6. 组件-自定义组件传参
      • 12.6.1. 过程
    • 12.7. 小结
  • 13. 小程序生命周期
    • 13.1. 应用生命周期
    • 13.2. 页面生命周期
    • 13.3. 页面生命周期图解
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档