更新记录

1.0.1(2024-06-06) 下载此版本

更新使用示例代码

1.0.0(2024-06-06) 下载此版本

新增


平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.1.0 × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × ×

hbxw-image组件

介绍

原生image组件扩展,支持显示占位loading/错误占位图,同时支持大图预览

使用示例


<template>
    <view class="img-test">
        <hbxw-image 
            width="300rpx" 
            height="150rpx"
            style="margin-bottom: 10px;"
            src="https://placeholderror.jp/999999/ff4400/300x300.png?text=EXAMPLE0"
        />
        <hbxw-image 
            width="300rpx" 
            height="300rpx"
            isNeedPriview
            style="margin-bottom: 10px;"
            src="https://placehold.jp/999999/ff4400/300x300.png?text=EXAMPLE1"
        />
        <hbxw-image 
            width="300rpx" 
            height="300rpx"
            isNeedPriview
            :previewIndex="1"
            :priviewList="['https://placehold.jp/999999/ff4400/300x300.png?text=1','https://placehold.jp/999999/ff4400/300x300.png?text=2','https://placehold.jp/999999/ff4400/300x300.png?text=3']"
            src="https://placehold.jp/999999/ff4400/300x300.png?text=2"
        />
    </view>
</template>

<script>
    export default {
        data() {
            return {

            }
        },
        methods: {

        }
    }
</script>

<style lang="scss" scoped>
.img-test{
    display: flex;
    flex-direction: column;
    align-items: center;
    image{
        margin-bottom: 20rpx;
    }
}
</style>

API

Props

属性名 类型 默认值 必填 说明
src String '' 图片url
width String,Number 128rpx 地址选择器的显示与隐藏
height String,Number 128rpx 地址选择器标题,如果不需要传空即可
mode String 'scaleToFill' 图片填充模式,可以设置的值,见image官方文挡mode有效值:参数说明
radius Number 0 图片是否有圆角
isNeedPriview Boolean false 是否开启图片预览功能
previewIndex Number 0 预览图片定位索引
priviewList Array null 预览图片url数组
isNeedLoading Boolean false 是否要显示loading占位
isNeedError Boolean false 是否要显示图片加载错误占位

Events

事件名 说明 返回值
error 当错误发生时触发的事件 事件对象event.detail = {errMsg: 'something wrong'}
loaded 当图片载入完毕时触发的事件 事件对象event.detail = {height:'图片高度px', width:'图片宽度px'}

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问