# 12.10 拖拽列表
国内美居 可拖拽排序组件
APP内置组件,可直接在template中使用,不需要import导入和注册, 该组件从8.17版本开始生效。
使用规则
1、通过列表前的“+”“-”按钮,实现两个不同列表模块的增减。
2、通过拖拽手势,实现列表项增减:
拖拽开始时效果:点击内容项进入选中状态,区域背景发现颜色变化
过程中的效果:长按拖动内容项可支持垂直移动
结束的效果:手指移开内容项时,取消选中区域背景,背景颜色恢复初始颜色
2、通过拖拽手势,实现列表项增减:
拖拽开始时效果:点击内容项进入选中状态,区域背景发现颜色变化
过程中的效果:长按拖动内容项可支持垂直移动
结束的效果:手指移开内容项时,取消选中区域背景,背景颜色恢复初始颜色
# 实例 :
拖拽列表
扫码预览

# 基础用法
<template>
<div class="wrapper">
<dof-minibar
:title="title"
backgroundColor="transparent"
textColor="#000000"
:middle-text-style="headerStyle"
@dofMinibarLeftButtonClicked="minibarLeftButtonClick"
@dofMinibarRightButtonClicked="minibarRightButtonClick"
>
<div slot="left">
<image :src="leftButton" style="height: 55px;width: 55px;transform:translateX(-10px);"></image>
</div>
<div slot="right" class="right-img-wrapper">
<image :src="rightButton" style="height: 32px;width: 32px;"></image>
</div>
</dof-minibar>
<dof-button
class="center margin-top-80"
text="切换编辑状态"
type="primary"
size="big"
@dofButtonClicked="siwtchEdit"
></dof-button>
<drag-vertical-list-view
class="seekbar"
:data="listData"
@onDeleteEvent="onDeleteEvent"
@onDragEndEvent="onDragEndEvent"
@onClickEvent="onClickEvent"
>
</drag-vertical-list-view>
</div>
</template>
<script>
import { DofMinibar, DofButton } from 'dolphin-weex-ui'
/*
onDeleteEvent 删除给删除的id, 排序后点击完成给list所有的数据
onDragEndEvent 排序后给list数据
onClickEvent 给当前item数据
*/
export default {
components: {
DofMinibar,
DofButton
},
data() {
return {
leftButton: './assets/image/header/back_black@2x.png',
rightButton: './assets/image/header/refresh.png',
headerStyle: {
fontFamily: 'PingFangSC-Regular',
fontWeight: '900',
fontSize: '28px',
letterSpacing: 0
},
// editing: true,
// src: 'https://dsdcp.smartmidea.net/mcsp/prod/20230315/0f4fea7232b34be4a123b93e97a87278.pdf',
title: '拖拽tableview',
listData: {
backgroundColor: '#F9F9F9', //组件背景色 默认为 #F9F9F9
isEditing: false, //是否编辑
rowHeight: 60, //行高 默认为52,建议大于等于52,参考UI
rowSpace: 10, //行间距 默认为10
itemTextColor: '#333333', //默认字体颜色#333333
itemBgColor: '#FFFFFF', //行背景色 #FFFFFF
itemFont: 16, //字体大小 默认为16
itemCornerRadius: 16, //默认为16,参考UI(注意:android系统0-rowHeight/2才有效果)
iconCornerRadius: 0, //默认为0
iconHeight: 32, //图片高度,默认32, 图片宽度等于高度,参考UI
deleteIconHeight: 32, //图片高度,默认32, 图片宽度等于高度,参考UI
sortIconHeight: 32, //图片高度,默认32, 图片宽度等于高度,参考UI
deleteIcon: '', //默认用切图 删除图片
sortIcon: '', //默认用切图 排序图片
list: [
{
itemId: '0',
name: '全屋照明', //名称
icon: 'https://pic.5tu.cn/uploads/allimg/1708/pic_5tu_big_201708111325384841.jpg' //icon,必传
},
{
itemId: '1',
name: '全屋用水',
icon: 'https://img1.baidu.com/it/u=413643897,2296924942&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=500'
},
{
itemId: '2',
name: '全屋空气',
icon: ''
},
{
itemId: '3',
name: '全屋环境文字很长很长最多一行点点...',
icon: ''
},
{
itemId: '4',
name: '洗衣机',
icon: ''
},
{
itemId: '5',
name: '郑二',
icon: ''
},
{
itemId: '6',
name: '张三',
icon: ''
},
{
itemId: '7',
name: '王四',
icon: ''
},
{
itemId: '8',
name: '蛋黄酱'
},
{
itemId: '9',
name: '番茄酱',
icon: ''
},
{
itemId: '10',
name: '大冬瓜',
icon: ''
},
{
itemId: '11',
name: '大狮子', //名称
icon: 'https://pic.5tu.cn/uploads/allimg/1708/pic_5tu_big_201708111325384841.jpg' //icon,必传
},
{
itemId: '12',
name: '大象',
icon: 'https://img1.baidu.com/it/u=413643897,2296924942&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=500'
},
{
itemId: '13',
name: '水牛',
icon: ''
},
{
itemId: '14',
name: '香蕉', //名称
icon: 'https://pic.5tu.cn/uploads/allimg/1708/pic_5tu_big_201708111325384841.jpg' //icon,必传
},
{
itemId: '15',
name: '苹果',
icon: 'https://img1.baidu.com/it/u=413643897,2296924942&fm=253&fmt=auto&app=138&f=JPEG?w=800&h=500'
},
{
itemId: '16',
name: '香梨',
icon: ''
}
]
}
}
},
computed: {},
methods: {
onDeleteEvent(event) {
this.$alert(event)
},
onDragEndEvent(event) {
this.$alert(event)
},
onClickEvent(event) {
this.$alert(event)
},
minibarLeftButtonClick() {},
minibarRightButtonClick() {
this.$reload()
},
siwtchEdit() {
this.listData.isEditing = !this.listData.isEditing
this.$toast('啦啦啦')
this.listData = {
...this.listData
}
}
}
}
</script>
<style scoped>
.wrapper {
width: 750px;
background-color: aliceblue;
}
.margin-top-80 {
margin-top: 40px;
}
.seekbar {
/* width: 600px; */
margin-left: 40px;
margin-right: 40px;
height: 1000px;
/* right: 200px; */
margin-top: 20px;
}
</style>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
# Attributes: data
| Prop | Type | Required | Default | Description |
|---|---|---|---|---|
backgroundColor | String | N | #F9F9F9 | 组件背景色 默认为 #F9F9F9 |
isEditing | Boolean | N | false | 是否编辑 |
rowHeight | Number | N | 52 | 行高 默认为52,建议大于等于52,参考UI |
rowSpace | Number | N | 10 | 行间距 默认为10 |
itemTextColor | String | N | #333333 | 默认字体颜色#333333 |
itemBgColor | String | N | #FFFFFF | 行背景色 #FFFFFF |
itemFont | Number | N | 16 | 字体大小 默认为16 |
itemCornerRadius | Number | N | 25 | 默认为16,参考UI 行圆角 |
iconCornerRadius | Number | N | 5 | 默认为0 图片圆角 |
deleteIconHeight | Number | N | 32 | 删除图片高度,默认32,图片宽度等于高度,参考UI |
sortIconHeight | Number | N | 32 | 排序图片高度,默认32, 图片宽度等于高度,参考UI |
deleteIcon | String | N | - | 默认用切图 删除图片 |
sortIcon | String | N | - | 默认用切图 排序图片 |
list | Array | Y | [] | 列表数据 |
iconBgColor | String | Y | #0000ff | 图片背景色 8.23新增 |
style | Number | N | 0 | 8.19新增 第一种样式 1 第二种样式,默认为0 0 是删除按钮在最左侧,为1时,删除按钮在右下角,8.26新增第三种样式 为2时,新增了标签、箭头、Switch开关、副标题为图标列表等元素 |
subTitleFont | Number | N | 12 | 8.19新增 默认为 12 副标题 |
subTitleTextColor | String | N | #8A8A8F | 8.19新增 默认为#8A8A8F 副标题 |
selectBtnSize | Number | N | 20 | 8.19新增 默认为20 |
selectBtnFont | Number | N | 12 | 8.19新增 默认12 |
selectBtnTextColor | String | N | #8A8A8F | 8.19新增 默认为#8A8A8F 选中按钮的字体颜色 |
selectBtnIcon | String | N | - | 8.19新增 选择按钮图片 |
selectedBtnIcon | String | N | - | 8.19新增 被选中时的按钮图片 |
separateLineColor | String | N | #F2F2F2 | 8.19新增,默认为F2F2F2 |
separateLineHeight | Number | N | 0.5 | 新增,分割线高度默认为0.5 |
bottomAreaHeight | Number | N | 0 | 8.19新增 默认0 ,代表没有底部区域 rowHeight - bottomAreaHeight 为顶部的高度 |
isLongPressEdit | Boolean | N | false | 8.19是否长按进入可编辑 |
isMultiSelect | Boolean | N | false | 8.19新增 是否多选。默认为单选 |
titleImageSize | Number | N | 20 | 8.26新增 标题右边标签图标大小 |
labelBgColor | String | N | - | 8.26新增 标题右边标签背景色 |
labelBgCorner | Number | N | 12 | 8.26新增 标题右边标签背景圆角大小 |
labelTextColor | String | N | `` | 8.26新增 标题右边标签文字颜色 |
labelTextSize | Number | N | 12 | 8.26新增 标题右边标签文字大小 |
labelPaddingHorizontal | Number | N | 10 | 8.26新增 标题右边标签文字与边框的水平距离 |
labelHeight | Number | N | 24 | 8.26新增 标题右边标签标签高度 |
labelBoardWidth | Number | N | 0 | 8.26新增 标题右边标签边框大小 |
labelBoardColor | String | N | - | 8.26新增 标题右边标签边框颜色border |
subTitleMaxLines | Number | N | 1 | 8.26新增 副标题最大显示行数,默认是1 |
arrowSize | Number | N | 10 | 8.26新增 列表右侧箭头大小 |
arrowTextColor | String | N | - | 8.26新增 列表右侧箭头的左边文字的颜色 |
arrowTextSize | Number | N | 14 | 8.26新增 列表右侧箭头的左边文字大小 |
arrowTextMarginRight | Number | N | 8 | 8.26新增 箭头文字和箭头的间距 |
switchBtnCorner | Number | N | 12 | 8.26新增 切换按钮圆角大小 |
switchBtnWidth | Number | N | 48 | 8.26新增 切换按钮的宽度 |
switchBtnHeight | Number | N | 24 | 8.26新增 切换按钮的高度 |
switchBtnCircleCloseSize | Number | N | 10 | 8.26新增 切换按钮关闭时圆圈的大小 |
switchBtnCircleOpenSize | Number | N | 18 | 8.26新增 切换按钮开启时圆圈的大小 |
switchBtnOpenBgColor | String | N | - | 8.26新增 切换按钮开启状态的背景色 |
switchBtnOpenCircleColor | String | N | - | 8.26新增 切换按钮开启状态的圆圈颜色 |
switchBtnCloseBgColor | String | N | - | 8.26新增 切换按钮关闭状态的背景色 |
switchBtnCloseCircleColor | String | N | - | 8.26新增 切换按钮关闭状态的圆圈颜色 |
switchBtnCloseStrokeWidth | Number | N | 1 | 8.26新增 切换按钮关闭状态的边框大小 |
switchBtnCloseStrokeColor | String | N | - | 8.26新增 切换按钮关闭状态的边框颜色 |
contentPaddingLeft | Number | Y | `` | 8.26新增 内容区域的左间距 |
contentPaddingRight | Number | Y | `` | 8.26新增 内容区域的右间距 |
contentPaddingTop | Number | Y | `` | 8.26新增 内容区域的顶部间距 |
contentPaddingBottom | Number | Y | `` | 8.26新增 内容区域的底部间距 |
dragHotRegionType | Number | N | 0 | 8.26新增 拖拽热区类型(0-拖拽图标,1-整个列表项) |
descImageWidth | Number | N | 20 | 8.26新增 图片列表(标题下方的图片列表,场景需求):列表图片宽度 |
descImageHeight | Number | N | 20 | 8.26新增 图片列表(标题下方的图片列表,场景需求):列表图片高度 |
descImageRightMargin | Number | N | 4 | 8.26新增 图片列表(标题下方的图片列表,场景需求):列表图片的右间距 |
superscriptIconSize | Number | N | 28 | 8.26新增 图片列表(标题下方的图片列表,场景需求):角标大小 |
isSupportSwipe | Boolean | N | false | 8.26新增 图片列表(标题下方的图片列表,场景需求):是否支持侧滑删除 |
iconLeftMargin | Number | N | 0 | 8.27新增 icon与左侧删除按钮的间距 |
rowSpaceColor | String | N | - | 8.27新增 行间距颜色 |
rowSpaceLeftMargin | Number | Y | - | 8.27新增 行间距分割线左边间距 |
rowSpaceRightMargin | Number | Y | - | 8.27新增 行间距分割线右边间距 |
bottomPadding | Number | Y | 0 | 9.0新增 列表底部和容器的边距,contentInsets.bottom |
isUseDragPriority | Boolean | N | false | 9.0新增 标记拖拽排序结束之后是否根据优先级重新进行排序 |
disableDragBgColor | String | N | - | 9.0新增 不允许拖动的行的背景颜色 |
groupSpaceColor | String | N | - | 9.0新增 组间间距颜色,默认为透明或空 |
groupSpaceHeight | Number | N | 0 | 9.0新增 组间间距高度,默认为0 |
groupLineHeight | Number | N | 0 | 9.0新增 组间间距分割线高度,默认为0 |
groupLineColor | String | N | - | 9.0新增 组间间距分割线颜色,默认为空 |
itemTextBold | Number | N | 0 | 9.3新增 标题是否加粗。0-不加粗; 1-加粗. 默认为0 |
# Events
| 事件名称 | 说明 | 回调参数 |
|---|---|---|
onClickEvent | 点击事件通知 返回当前点击的item数据 | {"itemId": '', "name": '', "icon": ''} |
onDeleteEvent | 删除事件通知 返回当前点击的itemId | {"itemId": ''} |
onDragEndEvent | 拖拽结束 返回当前list数据 | list数据返回 |
← 12.9 拖拽 12.11 毛玻璃组件 →