更新记录
1.0.2(2024-11-11) 下载此版本
修复文挡上的方案错误
1.0.1(2024-06-06) 下载此版本
更新使用示例代码
1.0.0(2024-06-06) 下载此版本
新增
查看更多平台兼容性
uni-app
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | - | - | - | - | - |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
√ | - | - | - | - | - | - | √ | - | - | - |
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'} |