0
点赞
收藏
分享

微信扫一扫

【小程序从0到1】小程序常用组件一览

上篇文章中,我们了解到,小程序的组件也是由宿主环境提供的。开发者可以基于组件快速搭建出漂亮的页面结构。官方把小程序的组件分为9大类,分别是:

本篇文章,我们将学习小程序常用组件view|scroll-view|swiper|swiper-item|text|rich-text|button|image等组件的基本用法以及API的三大分类。

常用的视图容器组件

  1. view
  1. scroll-view
  1. swiper和swiper-item

view组件的基本使用

需求:实现如图的flex横向布局效果

在这里插入图片描述

  1. 编写WXML页面代码(牢记div ⇒ view)
<!--pages/list/list.wxml-->
<view class="container1">
  <view>A</view>
  <view>B</view>
  <view>C</view>
</view>
  1. 编写WXSS样式代码(使用CSS3选择器以及flex布局)
/* pages/list/list.wxss */
.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: lightskyblue;
}
.container1 view:nth-child(3) {
  background-color: lightpink;
}
.container1 {
  display: flex;
  justify-content: space-around;
}
  1. 刷新模拟器查看效果

scroll-view组件的基本使用

需求:实现如图的纵向滚动效果

在这里插入图片描述

  1. 编写WXML中的scroll-view标签,并给其一个scroll-y属性代表垂直滚动
<scroll-view class="container1" scroll-y>
  <view>A</view>
  <view>B</view>
  <view>C</view>
</scroll-view>
  1. 编写WXSS样式,在之前讲解view的样式的基础上,为container1类增加一个最大高度为120px即可。

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

需求:实现如图的轮播图效果

在这里插入图片描述

  1. 编写WXML页面代码
<!-- 轮播图区域 -->
<!-- indicator-dots:显示面板指示点 -->
<swiper class="swiper-container" indicator-dots>
  <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. 编写WXSS样式代码
/* pages/list/list.wxss */
.swiper-container {
  height: 150px; /* 轮播图容器的高度 */
}
.item {
  height: 100%;
  line-height: 150px;
  text-align: center;
}
swiper-item:nth-child(1) {
  background-color: lightgreen;
}
swiper-item:nth-child(2) {
  background-color: lightskyblue;
}
swiper-item:nth-child(3) {
  background-color: lightpink;
}

swiper 组件的常用属性

属性类型默认值说明
indicator-dotsbooleanfalse是否显示面板指示点
indicator-colorcolorrgba(0, 0, 0, .3)指示点颜色
indicator-active-colorcolor#000000当前选中的指示点颜色
autoplaybooleanfalse是否自动切换
intervalnumber5000是否切换时间间隔
circularbooleanfalse是否采用衔接滑动

常用的基础内容组件

  1. text
  1. rich-text

text组件的基本使用

需求:通过 text 组件的user-select属性,实现长按选中文本内容的效果

在这里插入图片描述

rich-text组件的基本使用

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

在这里插入图片描述
rich-text组件提供了一个nodes属性,可以在nodes属性中放置html标签内容(有点类似JSX,只不过JSX是在JS文件中放置html标签)。

值得注意的是:nodes内容使用了双引号,那么内部的行内样式,就不能使用双引号,必须使用单引号。

其他常用组件

  1. button
  1. image
  1. navigator

button按钮的基本使用

在这里插入图片描述
除了图中的一些api之外,还支持我们网页开发中的WebView属性。

包括但不限于:

disabled / loading / form-type(submit / reset) 等等……

按钮组件的使用中,还可以依赖于微信开放的官方API。

合法值说明最低版本
contact打开客服会话,如果用户在会话中点击消息卡片后返回小程序,可以从 bindcontact 回调中获得具体信息 (小程序插件中不能使用1.1.0
share触发用户转发1.2.0
getPhoneNumber获取用户手机号,可以从 bindgetphonenumber 回调中获取到用户信息(小程序插件中不能使用1.2.0
getUserInfo获取用户信息,可以从 bindgetuserinfo 回调中获取到用户信息 (小程序插件中不能使用1.3.0
launchApp打开APP,可以通过 app-parameter 属性设定向 APP 传的参数具体说明1.9.5
openSetting打开授权设置页2.0.7
feedback打开“意见反馈”页面,用户可提交反馈内容并上传日志,开发者可以登录小程序管理后台后进入左侧菜单“客服反馈”页面获取到反馈内容2.1.0
chooseAvatar获取用户头像,可以从 bindchooseavatar 回调中获取到头像信息2.21.2

image组件的基本使用

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

属性类型默认值必填说明最低版本
modestringscaleToFill图片裁剪、缩放的模式1.0.0
合法值说明最低版本
scaleToFill缩放模式,不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素
aspectFit缩放模式,保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。
aspectFill缩放模式,保持纵横比缩放图片,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取。
widthFix缩放模式,宽度不变,高度自动变化,保持原图宽高比不变
heightFix缩放模式,高度不变,宽度自动变化,保持原图宽高比不变2.10.3
top裁剪模式,不缩放图片,只显示图片的顶部区域
bottom裁剪模式,不缩放图片,只显示图片的底部区域
center裁剪模式,不缩放图片,只显示图片的中间区域
left裁剪模式,不缩放图片,只显示图片的左边区域
right裁剪模式,不缩放图片,只显示图片的右边区域
top left裁剪模式,不缩放图片,只显示图片的左上边区域
top right裁剪模式,不缩放图片,只显示图片的右上边区域
bottom left裁剪模式,不缩放图片,只显示图片的左下边区域
bottom right裁剪模式,不缩放图片,只显示图片的右下边区域

在这里插入图片描述
WXSS样式:

/* pages/list/list.wxss */
image {
  border: 1px red solid;
}

小程序 API 三大分类

  1. 事件监听API
  1. 同步API
  1. 异步API
举报

相关推荐

0 条评论