更新记录
1.0.1(2024-06-24)
下载此版本
更新使用示例
1.0.0(2024-06-24)
下载此版本
新增
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
HBuilderX 3.1.0 |
× |
√ |
× |
× |
× |
√ |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
× |
× |
× |
× |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
× |
× |
× |
× |
× |
hbxw-scroll-list组件
介绍
滚播列表组件,用于文字滚动播放,或者一些列表信息(如中奖信息)的滚播
使用示例
推荐先直接复制示例代码到工程中看效果了解下使用方法再投入项目使用。
<template>
<view class="test-container">
<text class="test-title">无缝滚动</text>
<hbxw-scroll-list :list="list" @change="scrollPlaying"></hbxw-scroll-list>
<view class="separate"></view>
<text class="test-title">无缝滚动,一屏显示多个,具体显示多少个根据你定的wrapHeight确定</text>
<hbxw-scroll-list :list="list" wrapHeight="288rpx" itemHeight="96rpx"></hbxw-scroll-list>
<view class="separate"></view>
<text class="test-title">非元缝滚动</text>
<hbxw-scroll-list :list="list" :loop="false"></hbxw-scroll-list>
<view class="separate"></view>
<text class="test-title">动态修改list0数据</text>
<hbxw-scroll-list :list="list0" :loop="false"></hbxw-scroll-list>
<button @click="resetData">动态获取list0数据</button>
<view class="separate"></view>
<text class="test-title">自定义slot</text>
<hbxw-scroll-list :list="list" wrapHeight="168rpx" itemHeight="168rpx">
<template #default="{item, height}">
<view class="scroll-item">
<text>{{item.text}}</text>
<text>{{item.name}}:{{height}}</text>
</view>
</template>
</hbxw-scroll-list>
</view>
</template>
<script>
export default {
data() {
return {
list: [
{
name: '天使',
text: '获得了某某奖品'
},
{
name: '恶魔',
text: '获得了大奖品'
},
{
name: '受难者',
text: '获得了安慰奖'
},
{
name: '路过者',
text: '获得了某某奖品'
},
{
name: '第三者第三者',
text: '获得了安慰奖'
},
],
list0: []
}
},
methods: {
resetData() {
this.list0 = [
{
name: '天使',
text: '获得了某某奖品'
},
{
name: '恶魔',
text: '获得了大奖品'
},
{
name: '受难者',
text: '获得了安慰奖'
},
{
name: '路过者',
text: '获得了某某奖品'
},
{
name: '第三者第三者',
text: '获得了安慰奖'
}
]
},
scrollPlaying(index) {
console.log('---- scrollPlaying ----:', index)
}
}
}
</script>
<style lang="scss" scoped>
.scroll-item{
width: 100%;
display: flex;
align-items: center;
justify-content: space-between;
height: 168rpx;
background-color: green;
}
.separate{
width: 100%;
height: 2rpx;
margin: 20rpx 0;
background-color: #ccc;
}
</style>
注:默认是左右结构的滚播条,左name值左text值,如果对滚动内容有特殊要求可通过slot来自定义
API
Props
属性名 |
类型 |
默认值 |
必填 |
说明 |
list |
Array |
null |
是 |
滚播数据列表 |
wrapHeight |
Number/String |
'96rpx' |
否 |
滚播容器高度 |
itemHeight |
Number/String |
'96rpx' |
否 |
滚播项高度 |
delay |
Number |
3 |
否 |
滚播时间间隔 |
duration |
Number |
.4 |
否 |
完成一次滚播的缓冲时间 |
loop |
Boolean |
true |
否 |
是否无缝滚动 |
Events
事件名 |
说明 |
返回值 |
change |
滚动完成一次触发的方法 |
返回当前在哪一项 |