# image 图片
小程序规定,打包上线的大小不能超过
2M
,所以我们会把很多静态资源放在网上。我们可以通过以下方式上传本地图片到网络上,这样就可以得到网络图片了# 上传本地图片到网络上
- KIENGIMAGE 上传网址戳这里
每张图片默认都有宽高。宽度 320px、高度 240px。
支持懒加载。
属性 类型 默认值 必填 说明 最低版本 src string 否 图片资源地址 1.0.0 mode string scaleToFill 否 图片裁剪、缩放的模式 1.0.0 webp boolean false 否 默认不解析 webP 格式,只支持网络资源 2.9.0 lazy-load boolean false 否 图片懒加载,在即将进入一定范围(上下三屏)时就会自己开始加载图片 1.5.0 show-menu-by-longpress boolean false 否 开启长按图片显示识别小程序码菜单 2.7.0 binderror eventhandle 否 当错误发生时触发,event.detail = 1.0.0 bindload eventhandle 否 当图片载入完毕时触发,event.detail = 1.0.0 mode 的合法值
值 说明 最低版本 scaleToFill 缩放模式,不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素 aspectFit 缩放模式,保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。 aspectFill 缩放模式,保持纵横比缩放图片,只保证图片的短边能完全显示出来。也就是说,图片通常只在水平或垂直方向是完整的,另一个方向将会发生截取。 常用于轮播图 widthFix 缩放模式,宽度不变,高度自动变化,保持原图宽高比不变 常用 heightFix 缩放模式,高度不变,宽度自动变化,保持原图宽高比不变 2.10.3 top 裁剪模式,不缩放图片,只显示图片的顶部区域 bottom 裁剪模式,不缩放图片,只显示图片的底部区域 center 裁剪模式,不缩放图片,只显示图片的中间区域 left 裁剪模式,不缩放图片,只显示图片的左边区域 right 裁剪模式,不缩放图片,只显示图片的右边区域 top left 裁剪模式,不缩放图片,只显示图片的左上边区域 top right 裁剪模式,不缩放图片,只显示图片的右上边区域 bottom left 裁剪模式,不缩放图片,只显示图片的左下边区域 bottom right 裁剪模式,不缩放图片,只显示图片的右下边区域
# swiper 轮播组件
使用 swiper 轮播组件的时候,一定要搭配 swiper-item 组件配合使用,轮播使用 swiper 包裹起来。
属性 类型 默认值 必填 说明 最低版本 indicator-dots
boolean false 否 是否显示面板指示点 1.0.0 indicator-color
color rgba(0, 0, 0, .3) 否 指示点颜色 1.1.0 indicator-active-color
color #000000 否 当前选中的指示点颜色 1.1.0 autoplay
boolean false 否 是否自动切换 1.0.0 current number 0 否 当前所在滑块的 index 1.0.0 interval
number 5000 否 自动切换时间间隔 1.0.0 duration
number 500 否 滑动动画时长 1.0.0 circular
boolean false 否 是否采用衔接滑动,最后一张图片的下一张是第一张。 1.0.0 vertical boolean false 否 滑动方向是否为纵向 1.0.0 previous-margin string "0px" 否 前边距,可用于露出前一项的一小部分,接受 px 和 rpx 值 1.9.0 next-margin string "0px" 否 后边距,可用于露出后一项的一小部分,接受 px 和 rpx 值 1.9.0 snap-to-edge boolean "false" 否 当 swiper-item 的个数大于等于 2,关闭 circular 并且开启 previous-margin 或 next-margin 的时候,可以指定这个边距是否应用到第一个、最后一个元素 2.12.1 display-multiple-items number 1 否 同时显示的滑块数量 1.9.0 easing-function string "default" 否 指定 swiper 切换缓动动画类型 2.6.5 bindchange eventhandle 否 current 改变时会触发 change 事件,event.detail = 1.0.0 bindtransition eventhandle 否 swiper-item 的位置发生改变时会触发 transition 事件,event.detail = 2.4.3 bindanimationfinish eventhandle 否 动画结束时会触发 animationfinish 事件,event.detail 同上 1.9.0 easing-function 的合法值
值 说明 最低版本 default 默认缓动函数 linear 线性动画 easeInCubic 缓入动画 easeOutCubic 缓出动画 easeInOutCubic 缓入缓出动画