# 字母检索表 alphabet

# 描述

字母索引器

# 使用效果

# 使用方法

.ux文件中引入组件

<import name="q-alphabet" src="qaui/src/components/alphabet/index"></import>
1

# 示例

<template>
  <div class="qaui-wrap">
    <q-alphabet
      id="alphabet"
      data="{{ data }}"
      active-color="#fff"
      active-background="#456FFF"
      is-shake="{{ true }}"
      onitemtap="itemtap"
    >
    </q-alphabet>
  </div>
</template>
1
2
3
4
5
6
7
8
9
10
11
12
13
<style lang="less">
.qaui-wrap{
  flex-direction: column;
}
</style>
1
2
3
4
5
<script>
export default {
  data() {
    return {
      id: 'alphabetId',
      data: [
        {
          index: 'A',
          child: [
            { id: '111213', text: '澳门' },
            { id: '111214', text: '安庆' },
            { id: '111215', text: '鞍山' },
          ],
        },
        {
          index: 'B',
          child: [
            { id: '111216', text: '北海' },
            { id: '111217', text: '北京' },
          ],
        },
        {
          index: 'C',
          child: [
            { id: '111218', text: '长春' },
            { id: '111218', text: '长沙' },
            { id: '111218', text: '重庆' },
          ],
        },
        { index: 'D', child: [{ id: '111218', text: '大理' }] },
        {
          index: 'E',
          child: [
            { id: '111218', text: '鄂尔多斯' },
            { id: '111218', text: '恩施' },
          ],
        },
        {
          index: 'F',
          child: [
            { id: '111218', text: '阜阳' },
            { id: '111218', text: '福州' },
            { id: '111218', text: '佛山' },
          ],
        },
        {
          index: 'G',
          child: [
            { id: '111218', text: '广州' },
            { id: '111218', text: '贵阳' },
            { id: '111218', text: '桂林' },
          ],
        },
        {
          index: 'H',
          child: [
            { id: '111218', text: '哈尔滨' },
            { id: '111218', text: '海口' },
          ],
        },
        {
          index: 'J',
          child: [
            { id: '111218', text: '济南' },
            { id: '111218', text: '井冈山' },
            { id: '111218', text: '九寨沟' },
          ],
        },
        {
          index: 'K',
          child: [
            { id: '111218', text: '康定' },
            { id: '111218', text: '昆明' },
          ],
        },
        {
          index: 'L',
          child: [
            { id: '111218', text: '拉萨' },
            { id: '111218', text: '丽江' },
          ],
        },
        { index: 'M', child: [{ id: '111218', text: '牡丹江' }] },
        {
          index: 'N',
          child: [
            { id: '111218', text: '南昌' },
            { id: '111218', text: '南京' },
            { id: '111218', text: '宁波' },
          ],
        },
        { index: 'P', child: [{ id: '111218', text: '澎湖列岛' }] },
        {
          index: 'Q',
          child: [
            { id: '111218', text: '青岛' },
            { id: '111218', text: '泉州' },
          ],
        },
        {
          index: 'S',
          child: [
            { id: '111218', text: '三亚' },
            { id: '111218', text: '上海' },
            { id: '111218', text: '深圳' },
          ],
        },
        {
          index: 'T',
          child: [
            { id: '111218', text: '台州' },
            { id: '111218', text: '唐山' },
          ],
        },
        {
          index: 'W',
          child: [
            { id: '111218', text: '武汉' },
            { id: '111218', text: '武夷山' },
            { id: '111218', text: '无锡' },
          ],
        },
        {
          index: 'X',
          child: [
            { id: '111218', text: '西安' },
            { id: '111218', text: '厦门' },
            { id: '111218', text: '香港' },
            { id: '111218', text: '香港' },
            { id: '111218', text: '香港' },
            { id: '111218', text: '香港' },
            { id: '111218', text: '香港' },
            { id: '111218', text: '香港' },
            { id: '111218', text: '香港' },
            { id: '111218', text: '香港' },
          ],
        },
        {
          index: 'Y',
          child: [
            { id: '111218', text: '伊春' },
            { id: '111218', text: '扬州' },
            { id: '111218', text: '岳阳' },
            { id: '111218', text: '岳阳' },
            { id: '111218', text: '岳阳' },
            { id: '111218', text: '岳阳' },
            { id: '111218', text: '岳阳' },
            { id: '111218', text: '岳阳' },
            { id: '111218', text: '岳阳' },
            { id: '111218', text: '岳阳' },
            { id: '111218', text: '岳阳' },
          ],
        },
        {
          index: 'Z',
          child: [
            { id: '111218', text: '湛江' },
            { id: '111218', text: '湛江' },
            { id: '111218', text: '湛江' },
            { id: '111218', text: '湛江' },
            { id: '111218', text: '湛江' },
            { id: '111218', text: '张家界' },
            { id: '111218', text: '张家界' },
            { id: '111218', text: '张家界' },
          ],
        },
      ],
    }
  },
  itemtap(evt) {
    console.log(evt.detail)
  },
}
</script>

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

# API

# 组件属性

属性 类型 默认值 说明
id String '' 组件的 id,必须
activeColor String '#fff' 激活状态下字母的颜色
activeBackground String '#2878ff' 激活状态下字母的背景颜色
isShake Boolean true 是否开启震动,点击字母时,调用原生的震动效果
data Array [ ] data 数据对象数组,对象数据结构见下表

data 内对象的属性说明

属性 类型 默认值 说明
index String '' 字母,必填
child [] '' 对应字母索引的二级列表,如child: [{ id: '111218', text: '北京' }]
text String '' 二级列表中的正文内容,必填,child 中除 text 字段外,其余字段皆可自定义

# 组件事件

事件名称 事件描述 返回值
itemtap 点击事件,点击索引表关联的正文时触发 evt:回调对象,通过evt.detail可以获取到回传过来的对象