# image 图片

  1. 小程序规定,打包上线的大小不能超过 2M ,所以我们会把很多静态资源放在网上。我们可以通过以下方式上传本地图片到网络上,这样就可以得到网络图片了

    # 上传本地图片到网络上

    • KIENGIMAGE 上传网址戳这里
  2. 每张图片默认都有宽高。宽度 320px、高度 240px。

  3. 支持懒加载。

    属性类型默认值必填说明最低版本
    srcstring图片资源地址1.0.0
    modestringscaleToFill图片裁剪、缩放的模式1.0.0
    webpbooleanfalse默认不解析 webP 格式,只支持网络资源2.9.0
    lazy-loadbooleanfalse图片懒加载,在即将进入一定范围(上下三屏)时就会自己开始加载图片1.5.0
    show-menu-by-longpressbooleanfalse开启长按图片显示识别小程序码菜单2.7.0
    binderroreventhandle当错误发生时触发,event.detail =1.0.0
    bindloadeventhandle当图片载入完毕时触发,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 轮播组件

  1. 使用 swiper 轮播组件的时候,一定要搭配 swiper-item 组件配合使用,轮播使用 swiper 包裹起来。

    属性类型默认值必填说明最低版本
    indicator-dotsbooleanfalse是否显示面板指示点1.0.0
    indicator-colorcolorrgba(0, 0, 0, .3)指示点颜色1.1.0
    indicator-active-colorcolor#000000当前选中的指示点颜色1.1.0
    autoplaybooleanfalse是否自动切换1.0.0
    currentnumber0当前所在滑块的 index1.0.0
    intervalnumber5000自动切换时间间隔1.0.0
    durationnumber500滑动动画时长1.0.0
    circularbooleanfalse是否采用衔接滑动,最后一张图片的下一张是第一张。1.0.0
    verticalbooleanfalse滑动方向是否为纵向1.0.0
    previous-marginstring"0px"前边距,可用于露出前一项的一小部分,接受 px 和 rpx 值1.9.0
    next-marginstring"0px"后边距,可用于露出后一项的一小部分,接受 px 和 rpx 值1.9.0
    snap-to-edgeboolean"false"当 swiper-item 的个数大于等于 2,关闭 circular 并且开启 previous-margin 或 next-margin 的时候,可以指定这个边距是否应用到第一个、最后一个元素2.12.1
    display-multiple-itemsnumber1同时显示的滑块数量1.9.0
    easing-functionstring"default"指定 swiper 切换缓动动画类型2.6.5
    bindchangeeventhandlecurrent 改变时会触发 change 事件,event.detail =1.0.0
    bindtransitioneventhandleswiper-item 的位置发生改变时会触发 transition 事件,event.detail =2.4.3
    bindanimationfinisheventhandle动画结束时会触发 animationfinish 事件,event.detail 同上1.9.0

    easing-function 的合法值

    说明最低版本
    default默认缓动函数
    linear线性动画
    easeInCubic缓入动画
    easeOutCubic缓出动画
    easeInOutCubic缓入缓出动画