小程序常用组件

一、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
    })
  }
})

相关推荐
Myli_ing15 分钟前
HTML的自动定义倒计时,这个配色存一下
前端·javascript·html
dr李四维33 分钟前
iOS构建版本以及Hbuilder打iOS的ipa包全流程
前端·笔记·ios·产品运营·产品经理·xcode
雯0609~1 小时前
网页F12:缓存的使用(设值、取值、删除)
前端·缓存
℘团子এ1 小时前
vue3中如何上传文件到腾讯云的桶(cosbrowser)
前端·javascript·腾讯云
学习前端的小z1 小时前
【前端】深入理解 JavaScript 逻辑运算符的优先级与短路求值机制
开发语言·前端·javascript
彭世瑜1 小时前
ts: TypeScript跳过检查/忽略类型检查
前端·javascript·typescript
FØund4041 小时前
antd form.setFieldsValue问题总结
前端·react.js·typescript·html
Backstroke fish1 小时前
Token刷新机制
前端·javascript·vue.js·typescript·vue
小五Five1 小时前
TypeScript项目中Axios的封装
开发语言·前端·javascript
小曲程序1 小时前
vue3 封装request请求
java·前端·typescript·vue