微信小程序 - 02_常用组件（view/scroll-view、swiper/swiper-item、text/rich-text、button、image、小程序三大类API）

欢迎访问笔者个人技术博客： http://rukihuang.xyz/

组件介绍

01 小程序中组件的分类

• 视图容器
• 基础内容
• 表单组件
• 导航组件
• 媒体组件
• map地图组件
• canvas画布组件
• 开放能力
• 无障碍访问

1.1 视图容器

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

1.1.1 view

<view class="container1">
    <view>Aview>
    <view>Bview>
    <view>Cview>
view>

/* view */

/* 设置子元素样式 */
.container1 view{
    width: 100px;
    height: 100px;
    text-align: center;
    line-height: 100px;
}

.container1 view:nth-child(1) {
    background-color: lightgreen;
}

.container1 view:nth-child(2) {
    background-color: lightyellow;
}

.container1 view:nth-child(3) {
    background-color: lightpink;
}

/* 设置父元素样式 */
.container1 {
    display: flex;/* 弹性布局*/
    justify-content: space-around;/* 空间环绕*/
}

1.1.2 scroll-view

• wxml

<scroll-view class="container2" scroll-y>
    <view>Aview>
    <view>Bview>
    <view>Cview>
scroll-view>

• wxss

/* scroll-view */

/* 设置父元素样式，给scroll-view一个固定高度 */
.container2{
    border: 1px solid red;
    width: 100px;
    height: 120px;
}

.container2 view{
    width: 100px;
    height: 100px;
    text-align: center;
    line-height: 100px;
}

.container2 view:nth-child(1) {
    background-color: lightgreen;
}

.container2 view:nth-child(2) {
    background-color: lightyellow;
}

.container2 view:nth-child(3) {
    background-color: lightpink;
}

1.1.3 swiper/swiper-item

• wxml

<swiper class="swiper-container" indicator-dots="true">
    <swiper-item>
        <view class="item">Aview>
    swiper-item>
    <swiper-item>
        <view class="item">Bview>
    swiper-item>
    <swiper-item>
        <view class="item">Cview>
    swiper-item>
swiper>

• wxss

/* swiper */
.swiper-container {
    height: 150px;
}

.item {
    height: 100%;
    text-align: center;
    line-height: 150px; /*行高*/
}


/* 直接标签选择器进行选择 */
/* swiper-item:nth-child(1) .item{
    background-color: lightgreen;
}

swiper-item:nth-child(2) .item{
    background-color: lightskyblue;
}

swiper-item:nth-child(3) .item{
    background-color: lightcoral;
} */

/* 类选择器下 再选标签选择器 */
.swiper-container swiper-item:nth-child(1) .item{
    background-color: lightgreen;
}

.swiper-container swiper-item:nth-child(2) .item{
    background-color: lightskyblue;
}

.swiper-container swiper-item:nth-child(3) .item{
    background-color: lightcoral;
}

• swiper常用属性

属性	类型	默认值	说明
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	是否采用衔接滑动

1.1.4 text/ rich-text

• text
  • 文本组件
  • 类似于HTML中的span标签，是一个行内元素

• wxml

<view>
    不可选文字
view>
<view>
    
    <text user-select="true">选中文字text>
view>

• rich-text
  • 富文本组件
  • 支持把html字符串渲染为wxml结构

• wxml

<rich-text nodes=" style='color:red'>标题</h1>">rich-text>

1.2 其他常用组件

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

1.2.1 button

• wxml

<view class="button">-------通过type指定按钮类型-------view>
<button>默认按钮button>
<button type="primary">主要按钮button>
<button type="warn">警告按钮button>

<view class="button">-------size="mini"小尺寸按钮-------view>
<button size="mini">默认按钮button>
<button type="primary" size="mini">主要按钮button>
<button type="warn" size="mini">警告按钮button>

<view class="button">-------plain镂空按钮-------view>
<button size="mini" plain>默认按钮button>
<button type="primary" size="mini" plain>主要按钮button>
<button type="warn" size="mini" plain>警告按钮button>

1.2.2 image

<image src="" mode="widthFix">image>

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

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

02 API

2.1 小程序API概述

• 小程序中的API是由宿主环境提供的，通过这些丰富的小程序API，开发者可以方便地调用微信提供的能力，例如：获取用户信息、本地存储、支付功能。

2.2 小程序的3大分类

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