小程序常用组件

一、tabBar

tabBar的相关设置要设置在app.json中(全局配置)。

注意:tabBar中的list是数组形式,每一项都是以对象形式存在;

list中对象的数量最多5个,最少2个;

list中的对象的pagePath和text是必填项;

list中的对象设置图片时,图片必须是本地图片。

更多配置请参考tabBar官方配置文档

以下为简单示例:

javascript 复制代码
{
  "entryPagePath": "pages/index/index",
  "pages": [
    "pages/index/index",
    "pages/logs/logs"
  ],
  "window": {
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "Weixin",
    "navigationBarBackgroundColor": "#ffffff"
  },
  "tabBar": {
    "color": "#333",
    "selectedColor": "#ff5123",
    "backgroundColor": "#eeeeee",
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首页",
      "iconPath": "/static/tabbar/logs-default.png",
      "selectedIconPath": "/static/tabbar/logs-active.png"
    },{
        "pagePath": "pages/logs/logs",
        "text": "日志",
        "iconPath": "/static/tabbar/home-default.png",
        "selectedIconPath": "/static/tabbar/home-active.png"
    }]
  },
  "style": "v2",
  "componentFramework": "glass-easel",
  "sitemapLocation": "sitemap.json",
  "lazyCodeLoading": "requiredComponents"
}

二、navigator

navigator是小程序中实现路由跳转的组件,常用属性为:

url:跳转路径(支持绝对和相对路径,但不支持空);

open-type:跳转方式(switchTab代表跳转的是tabBar的页面);

hover-class:点击态的样式。

更多属性参考navigator官方文档

html 复制代码
<!-- 页面跳转,url 相对路径 -->
<navigator open-type="switchTab" url="../logs/logs">跳转log</navigator>
<!-- 页面跳转,url 绝对路径 -->
<!-- open-type switchTab:跳转到页面是tabBar的页面 -->
<navigator open-type="switchTab" url="/pages/logs/logs">跳转log</navigator>
<!-- hover-class none为禁用;也可直接设置为class类名,设置点击时样式 -->
<navigator url="/pages/demo/demo">跳转demo</navigator>
<navigator hover-class="none" url="/pages/demo/demo">跳转demo</navigator>
<navigator hover-class="active" url="/pages/demo/demo">跳转demo</navigator>

三、image

image 组件是一个有**默认大小(320*240)**的盒子。

给image设置mode属性的值,可设置图片的缩放格式。

mode默认值是scaleFill ,图片拉伸填满容器;

mode设置值为aspectFit 保证缩放比,使图片长边显示出来;

mode设置值为aspectFill 保证缩放比,使图片短边显示出来。

使用原则:指定容器的大小(根据设计稿,设置image的宽高尺寸)。

更多属性参考image官方文档

html 复制代码
<!-- image src支持绝对路径和相对路径 -->
<image src="../../static/uploads/goods_1.jpg"></image>
<image src="/static/uploads/goods_1.jpg"></image>
<!-- image mode 缩放模式 -->
<image class="pic" src="/static/uploads/goods_1.jpg"></image>
<image class="pic" mode="aspectFit" src="/static/uploads/goods_1.jpg"></image>
<image class="pic" mode="aspectFill" src="/static/uploads/goods_1.jpg"></image>

.pic {
  width: 200rpx;
  height: 200rpx;
  background-color: pink;
}

四、swiper

swiper:滑块容器,只能嵌套swiper-item

swiper-item:滑块单元,可以嵌套任何内容

注意:swiper必须和swiper-item搭配使用;

swiper有默认高度150px。

更多属性查看swiper官方文档

html 复制代码
<swiper indicator-dots indicator-active-color="red">
  <swiper-item><image src="/static/uploads/slide_1.jpg"></image></swiper-item>
  <swiper-item><image src="/static/uploads/slide_2.jpg"></image></swiper-item>
  <swiper-item><image src="/static/uploads/slide_3.jpg"></image></swiper-item>
  <swiper-item><image src="/static/uploads/slide_4.jpg"></image></swiper-item>
</swiper>

swiper {
  width: 750rpx;
  height: 320rpx;
}
swiper image {
  width: 750rpx;
  height: 320rpx;
}

五、表单组件

1、input

基本与html的input输入框相同,通过password属性设置密码样式。

更多属性参考input官方文档

html 复制代码
  <view class="form-field">
    <label for="">姓名:</label>
    <view class="field">
      <input type="text" placeholder="请输入姓名"/>
    </view>
  </view>
  <view class="form-field">
    <label for="">密码:</label>
    <view class="field">
      <input type="text" password placeholder="请输入密码"/>
    </view>
  </view>

input的type设置为nickname,可快捷使用微信昵称。

html 复制代码
<input type="nickname" placeholder="请输入姓名"/></view>

若本地调试不显示微信昵称框,查看本地调试库版本,选择大于nickname的版本。

2、 单选框

与html的radio基本相同;

不同情况是:在有多个选项,但只能选择一个的时候,要用radio-group包裹住radio。

更多属性参考radio官方文档radio-group官方文档

html 复制代码
  <view class="form-field">
    <label for="">性别:</label>
    <view class="field">
      <radio-group bindchange="changeRadio">
        <label><radio value="1"/>男  </label>
        <label><radio value="0"/>女  </label>
      </radio-group>
    </view>
  </view>
javascript 复制代码
Page({
  changeRadio(e) {
    console.log(e.detail.value)
  }
})

3、复选框

复选框同单选框。

更多属性参考checkbox官方文档checkbox-group官方文档

html 复制代码
  <view class="form-field">
    <label for="">爱好:</label>
    <view class="field">
      <checkbox-group bindchange="changeCheckBox">
        <label><checkbox value="1"/>旅游  </label>
        <label><checkbox value="2"/>阅读  </label>
        <label><checkbox value="3"/>听歌  </label>
      </checkbox-group>
    </view>
  </view>
javascript 复制代码
Page({
  changeCheckBox(e) {
    console.log(e.detail.value)
  }
})

4、picker--省市区

通过设置picker的mode属性为region,即可使用省市区选择器。

注意:使用时,必须给picker中设置值,否则无法显示,也不能点击。

需要通过bindchange更新页面的数据值。

更多属性参考picker官方文档

html 复制代码
  <view class="form-field">
    <label for="">籍贯:</label>
    <view class="field">
      <picker mode="region" bindchange="changeRegion">
        {{ regionText || '请选择省市区'}}
      </picker>
    </view>
  </view>
javascript 复制代码
Page({
  data: {
    regionText: '请选择省市区'
  },
  changeRegion(e) {
    const text = e.detail.value.join(' ')
    this.setData({
      regionText: text
    })
  }
})

5、picker--日期选择

通过设置picker的mode属性为region,即可使用省市区选择器。

更多属性参考picker官方文档

html 复制代码
  <view class="form-field">
    <label for="">生日:</label>
    <view class="field">
      <picker mode="date" start="1960-01-01" bindchange="changeDate">
        {{dateText || '请选择生日'}}
      </picker>
    </view>
  </view>
javascript 复制代码
Page({
  data: {
    dateText: '请选择生日'
  },
  changeDate(e) {
    this.setData({
      dateText: e.detail.value
    })
  }
})

相关推荐
说私域2 分钟前
基于开源 AI 智能名片 S2B2C 商城小程序的视频号交易小程序优化研究
人工智能·小程序·零售
qq_390161772 分钟前
防抖函数--应用场景及示例
前端·javascript
John.liu_Test32 分钟前
js下载excel示例demo
前端·javascript·excel
Yaml41 小时前
智能化健身房管理:Spring Boot与Vue的创新解决方案
前端·spring boot·后端·mysql·vue·健身房管理
PleaSure乐事1 小时前
【React.js】AntDesignPro左侧菜单栏栏目名称不显示的解决方案
前端·javascript·react.js·前端框架·webstorm·antdesignpro
哟哟耶耶1 小时前
js-将JavaScript对象或值转换为JSON字符串 JSON.stringify(this.SelectDataListCourse)
前端·javascript·json
getaxiosluo1 小时前
react jsx基本语法,脚手架,父子传参,refs等详解
前端·vue.js·react.js·前端框架·hook·jsx
理想不理想v1 小时前
vue种ref跟reactive的区别?
前端·javascript·vue.js·webpack·前端框架·node.js·ecmascript
知孤云出岫1 小时前
web 渗透学习指南——初学者防入狱篇
前端·网络安全·渗透·web
贩卖纯净水.1 小时前
Chrome调试工具(查看CSS属性)
前端·chrome