组件介绍

01 小程序中组件的分类

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

1.1 视图容器

• view

  • 普通视图区域
  • 类似于html中的div，是一个块级元素
  • 常用来实现页面的布局效果

• scroll-view

  • 可滚动的视图区域
  • 常用来实现滚动列表效果

• swiper和swiper-item

  • 轮播图容器组件和轮播图item组件

1.1.1 view

<!--! wxml-->
<view class="container1">
    <view>A</view>
    <view>B</view>
    <view>C</view>
</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-x 允许横向滚动 -->
<!-- scroll-y 允许纵向滚动 （使用时必须给scroll-view一个固定高度）-->
<scroll-view class="container2" scroll-y>
    <view>A</view>
    <view>B</view>
    <view>C</view>
</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

<!-- 轮播图 -->
<!-- indicator-dots 属性：显示面板指示点 -->
<swiper class="swiper-container" indicator-dots="true">
    <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>

• 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常用属性

1.1.4 text/ rich-text

• text

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

• wxml

<!-- text/ rich-text  -->
<view>
    不可选文字
</view>
<view>
    <!-- selectable 被user-select替代了，但还是能用  -->
    <text user-select="true">选中文字</text>
</view>

• rich-text

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

• wxml

<rich-text nodes="<h1 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

<!-- 按钮 button -->
<!-- 上图为老款样式，新款的默认button不是适应整个屏幕的，app.json中"style": "v2"加上, -->
<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属性如下

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回调函数接收数据