<template>
<view class="u-index-list">
<!-- #ifdef APP-NVUE -->
<list
:scrollTop="scrollTop"
enable-back-to-top
:offset-accuracy="1"
:style="{
maxHeight: $u.addUnit(scrollViewHeight)
}"
@scroll="scrollHandler"
ref="uList"
>
<cell
v-if="$slots.header"
ref="header"
>
<slot name="header" />
</cell>
<slot />
<cell v-if="$slots.footer">
<slot name="footer" />
</cell>
</list>
<!-- #endif -->
<!-- #ifndef APP-NVUE -->
<scroll-view
:scrollTop="scrollTop"
:scrollIntoView="scrollIntoView"
:offset-accuracy="1"
:style="{
maxHeight: $u.addUnit(scrollViewHeight)
}"
scroll-y
@scroll="scrollHandler"
ref="uList"
>
<view v-if="$slots.header">
<slot name="header" />
</view>
<slot />
<view v-if="$slots.footer">
<slot name="footer" />
</view>
</scroll-view>
<!-- #endif -->
<view
class="u-index-list__letter"
ref="u-index-list__letter"
:style="{ top: $u.addUnit(letterInfo.top || 100) }"
@touchstart="touchStart"
@touchmove.stop.prevent="touchMove"
@touchend.stop.prevent="touchEnd"
@touchcancel.stop.prevent="touchEnd"
>
<view
class="u-index-list__letter__item"
v-for="(item, index) in uIndexList"
:key="index"
:style="{
backgroundColor: activeIndex === index ? activeColor : 'transparent'
}"
>
<text
class="u-index-list__letter__item__index"
:style="{color: activeIndex === index ? '#fff' : inactiveColor}"
>{{ item }}</text>
</view>
</view>
<u-transition
mode="fade"
:show="touching"
:customStyle="{
position: 'fixed',
right: '50px',
top: $u.addUnit(indicatorTop),
zIndex: 2
}"
>
<view
class="u-index-list__indicator"
:class="['u-index-list__indicator--show']"
:style="{
height: $u.addUnit(indicatorHeight),
width: $u.addUnit(indicatorHeight)
}"
>
<text class="u-index-list__indicator__text">{{ uIndexList[activeIndex] }}</text>
</view>
</u-transition>
</view>
</template>
<script>
const indexList = () => {
const indexList = [];
const charCodeOfA = 'A'.charCodeAt(0);
for (let i = 0; i < 26; i++) {
indexList.push(String.fromCharCode(charCodeOfA + i));
}
return indexList;
}
import props from './props.js';
// #ifdef APP-NVUE
// 由于weex为阿里的KPI业绩考核的产物，所以不支持百分比单位，这里需要通过dom查询组件的宽度
const dom = uni.requireNativePlugin('dom')
// #endif
/**
* IndexList 索引列表
* @description 通过折叠面板收纳内容区域
* @tutorial https://uviewui.com/components/indexList.html
* @property {String} inactiveColor 右边锚点非激活的颜色 ( 默认 '#606266' )
* @property {String} activeColor 右边锚点激活的颜色 ( 默认 '#5677fc' )
* @property {Array} indexList 索引字符列表，数组形式
* @property {Boolean} sticky 是否开启锚点自动吸顶 ( 默认 true )
* @property {String | Number} customNavHeight 自定义导航栏的高度 ( 默认 0 )
* */
export default {
name: 'u-index-list',
mixins: [uni.$u.mpMixin, uni.$u.mixin, props],
// #ifdef MP-WEIXIN
// 将自定义节点设置成虚拟的，更加接近Vue组件的表现，能更好的使用flex属性
options: {
virtualHost: true
},
// #endif
data() {
return {
// 当前正在被选中的字母索引
activeIndex: -1,
touchmoveIndex: 1,
// 索引字母的信息
letterInfo: {
height: 0,
itemHeight: 0,
top: 0
},
// 设置字母指示器的高度，后面为了让指示器跟随字母，并将尖角部分指向字母的中部，需要依赖此值
indicatorHeight: 50,
// 字母放大指示器的top值，为了让其指向当前激活的字母
// indicatorTop: 0
// 当前是否正在被触摸状态
touching: false,
// 滚动条顶部top值
scrollTop: 0,
// scroll-view的高度
scrollViewHeight: 0,
// 系统信息
sys: uni.$u.sys(),
scrolling: false,
scrollIntoView: '',
}
},
computed: {
// 如果有传入外部的indexList锚点数组则使用，否则使用内部生成A-Z字母
uIndexList() {
return this.indexList.length ? this.indexList : indexList()
},
// 字母放大指示器的top值，为了让其指向当前激活的字母
indicatorTop() {
const {
top,
itemHeight
} = this.letterInfo
return Math.floor(top + itemHeight * this.activeIndex + itemHeight / 2 - this.indicatorHeight / 2)
}
},
watch: {
// 监听字母索引的变化，重新设置尺寸
uIndexList: {
immediate: true,
handler() {
uni.$u.sleep().then(() => {
this.setIndexListLetterInfo()
})
}
}
},
created() {
this.children = []
this.anchors = []
this.init()
},
mounted() {
this.setIndexListLetterInfo()
},
methods: {
init() {
// 设置列表的高度为整个屏幕的高度
//减去this.customNavHeight，并将this.scrollViewHeight设置为maxHeight
//解决当u-index-list组件放在tabbar页面时,scroll-view内容较少时，还能滚动
this.scrollViewHeight = this.sys.windowHeight - this.customNavHeight
},
// 索引列表被触摸
touchStart(e) {
// 获取触摸点信息
const touchStart = e.changedTouches[0]
if (!touchStart) return
this.touching = true
const {
pageY
} = touchStart
// 根据当前触摸点的坐标，获取当前触摸的为第几个字母
const currentIndex = this.getIndexListLetter(pageY)
this.setValueForTouch(currentIndex)
},
// 索引字母列表被触摸滑动中
touchMove(e) {
// 获取触摸点信息
let touchMove = e.changedTouches[0]
if (!touchMove) return;
// 滑动结束后迅速开始第二次滑动时候 touching 为 false 造成不显示 indicator 问题
if (!this.touching) {
this.touching = true
}
const {
pageY
} = touchMove
const currentIndex = this.getIndexListLetter(pageY)
this.setValueForTouch(currentIndex)
},
// 触摸结束
touchEnd(e) {
// 延时一定时间后再隐藏指示器，为了让用户看的更直观，同时也是为了消除快速切换u-transition的show带来的影响
uni.$u.sleep(300).then(() => {
this.touching = false
})
},
// 获取索引列表的尺寸以及单个字符的尺寸信息
getIndexListLetterRect() {
return new Promise(resolve => {
// 延时一定时间，以获取dom尺寸
// #ifndef APP-NVUE
this.$uGetRect('.u-index-list__letter').then(size => {
resolve(size)
})
// #endif
// #ifdef APP-NVUE
const ref = this.$refs['u-index-list__letter']
dom.getComponentRect(ref, res => {
resolve(res.size)
})
// #endif
})
},
// 设置indexList索引的尺寸信息
setIndexListLetterInfo() {
this.getIndexListLetterRect().then(size => {
const {
height
} = size
const sys = uni.$u.sys()
const windowHeight = sys.windowHeight
let customNavHeight = 0
// 消除各端导航栏非原生和原生导致的差异，让索引列表字母对屏幕垂直居中
if (this.customNavHeight == 0) {
// #ifdef H5
customNavHeight = sys.windowTop
// #endif
// #ifndef H5
// 在非H5中，为原生导航栏，其高度不算在windowHeight内，这里设置为负值，后面相加时变成减去其高度的一半
customNavHeight = -(sys.statusBarHeight + 44)
// #endif
} else {
customNavHeight = uni.$u.getPx(this.customNavHeight)
}
this.letterInfo = {
height,
// 为了让字母列表对屏幕绝对居中，让其对导航栏进行修正，也即往上偏移导航栏的一半高度
top: (windowHeight - height) / 2 + customNavHeight / 2,
itemHeight: Math.floor(height / this.uIndexList.length)
}
})
},
// 获取当前被触摸的索引字母
getIndexListLetter(pageY) {
const {
top,
height,
itemHeight
} = this.letterInfo
// 对H5的pageY进行修正，这是由于uni-app自作多情在H5中将触摸点的坐标跟H5的导航栏结合导致的问题
// #ifdef H5
pageY += uni.$u.sys().windowTop
// #endif
// 对第一和最后一个字母做边界处理，因为用户可能在字母列表上触摸到两端的尽头后依然继续滑动
if (pageY < top) {
return 0
} else if (pageY >= top + height) {
// 如果超出了，取最后一个字母
return this.uIndexList.length - 1
} else {
// 将触摸点的Y轴偏移值，减去索引字母的top值，除以每个字母的高度，即可得到当前触摸点落在哪个字母上
return Math.floor((pageY - top) / itemHeight);
}
},
// 设置各项由触摸而导致变化的值
setValueForTouch(currentIndex) {
// 如果偏移量太小，前后得出的会是同一个索引字母，为了防抖，进行返回
if (currentIndex === this.activeIndex) return
this.activeIndex = currentIndex
// #ifndef APP-NVUE || MP-WEIXIN
// 在非nvue中，由于anchor和item都在u-index-item中，所以需要对index-item进行偏移
this.scrollIntoView = `u-index-item-${this.uIndexList[currentIndex].charCodeAt(0)}`
// #endif
// #ifdef MP-WEIXIN
// 微信小程序下，scroll-view的scroll-into-view属性无法对slot中的内容的id生效，只能通过设置scrollTop的形式去移动滚动条
this.scrollTop = this.children[currentIndex].top
// #endif
// #ifdef APP-NVUE
// 在nvue中，由于cell和header为同级元素，所以实际是需要对header(anchor)进行偏移
const anchor = `u-index-anchor-${this.uIndexList[currentIndex]}`
dom.scrollToElement(this.anchors[currentIndex].$refs[anchor], {
offset: 0,
animated: false
})
// #endif
},
getHeaderRect() {
// 获取header slot的高度，因为list组件中获取元素的尺寸是没有top值的
return new Promise(resolve => {
dom.getComponentRect(this.$refs.header, res => {
resolve(res.size)
})
})
},
// scroll-view的滚动事件
async scrollHandler(e) {
if (this.touching || this.scrolling) return
// 每过一定时间取样一次，减少资源损耗以及可能带来的卡顿
this.scrolling = true
uni.$u.sleep(10).then(() => {
this.scrolling = false
})
let scrollTop = 0
const len = this.children.length
let children = this.children
const anchors = this.anchors
// #ifdef APP-NVUE
// nvue下获取的滚动条偏移为负数，需要转为正数
scrollTop = Math.abs(e.contentOffset.y)
// 获取header slot的尺寸信息
const header = await this.getHeaderRect()
// item的top值，在nvue下，模拟出的anchor的top，类似非nvue下的index-item的top
let top = header.height
// 由于list组件无法获取cell的top值，这里通过header slot和各个item之间的height，模拟出类似非nvue下的位置信息
children = this.children.map((item, index) => {
const child = {
height: item.height,
top
}
// 进行累加，给下一个item提供计算依据
top += item.height + anchors[index].height
return child
})
// #endif
// #ifndef APP-NVUE
// 非nvue通过detail获取滚动条位移
scrollTop = e.detail.scrollTop
// #endif
for (let i = 0; i < len; i++) {
const item = children[i],
nextItem = children[i + 1]
// 如果滚动条高度小于第一个item的top值，此时无需设置任意字母为高亮
if (scrollTop <= children[0].top || scrollTop >= children[len - 1].top + children[len -
1].height) {
this.activeIndex = -1
break
} else if (!nextItem) {
// 当不存在下一个item时，意味着历遍到了最后一个
this.activeIndex = len - 1
break
} else if (scrollTop > item.top && scrollTop < nextItem.top) {
this.activeIndex = i
break
}
}
},
},
}
</script>
<style lang="scss" scoped>
@import "../../libs/css/components.scss";
.u-index-list {
&__letter {
position: fixed;
right: 0;
text-align: center;
z-index: 3;
padding: 0 6px;
&__item {
width: 16px;
height: 16px;
border-radius: 100px;
margin: 1px 0;
@include flex;
align-items: center;
justify-content: center;
&--active {
background-color: $u-primary;
}
&__index {
font-size: 12px;
text-align: center;
line-height: 12px;
}
}
}
&__indicator {
width: 50px;
height: 50px;
border-radius: 100px 100px 0 100px;
text-align: center;
color: #ffffff;
background-color: #c9c9c9;
transform: rotate(-45deg);
@include flex;
justify-content: center;
align-items: center;
&__text {
font-size: 28px;
line-height: 28px;
font-weight: bold;
color: #fff;
transform: rotate(45deg);
text-align: center;
}
}
}
</style>