refactor: 确立独立子工程架构 (backend, admin, mpuniapp) 并同步更新 AGENTS.md 规范
这个提交包含在:
@@ -0,0 +1,110 @@
|
||||
const PAGE_PATH = '/pages/template/banner-tabs-feed-nested-scroll/banner-tabs-feed-nested-scroll'
|
||||
const ACTIVE_COLORS = ['rgb(0, 122, 255)', '#007AFF', '#007AFFFF']
|
||||
const INACTIVE_COLORS = ['rgb(85, 85, 85)', '#555555', '#555555FF']
|
||||
|
||||
describe('template-banner-tabs-feed-nested-scroll', () => {
|
||||
let page
|
||||
|
||||
async function waitForSwiperCurrent(target, timeout = 4000) {
|
||||
const start = Date.now()
|
||||
await page.waitFor(async () => {
|
||||
const state = await page.callMethod('jest_getState')
|
||||
return state != null && state.swiperIndex == target && state.animationFinishIndex == target || Date.now() - start > timeout
|
||||
})
|
||||
|
||||
const state = await page.callMethod('jest_getState')
|
||||
expect(state.swiperIndex).toBe(target)
|
||||
expect(state.animationFinishIndex).toBe(target)
|
||||
}
|
||||
|
||||
async function waitForListState(index, matcher, timeout = 5000) {
|
||||
const start = Date.now()
|
||||
await page.waitFor(async () => {
|
||||
const state = await page.callMethod('jest_getListState', index)
|
||||
return matcher(state) || Date.now() - start > timeout
|
||||
})
|
||||
|
||||
return await page.callMethod('jest_getListState', index)
|
||||
}
|
||||
|
||||
async function waitForIndicatorChange(indicator, beforeTransform, beforeWidth, timeout = 4000) {
|
||||
const start = Date.now()
|
||||
await page.waitFor(async () => {
|
||||
const transform = await indicator.style('transform')
|
||||
const width = (await indicator.size()).width
|
||||
return transform !== beforeTransform || width !== beforeWidth || Date.now() - start > timeout
|
||||
})
|
||||
|
||||
const transform = await indicator.style('transform')
|
||||
const width = (await indicator.size()).width
|
||||
expect(transform !== beforeTransform || width !== beforeWidth).toBe(true)
|
||||
}
|
||||
|
||||
beforeAll(async () => {
|
||||
page = await program.reLaunch(PAGE_PATH)
|
||||
await page.waitFor('view')
|
||||
await page.waitFor('scroll-view')
|
||||
await page.waitFor('swiper')
|
||||
await page.waitFor(800)
|
||||
})
|
||||
|
||||
beforeEach(async () => {
|
||||
await page.callMethod('jest_setSwiperCurrent', 0)
|
||||
await page.callMethod('jest_prepareMockData')
|
||||
await waitForListState(0, (state) => state != null && state.renderedCount > 0)
|
||||
await page.waitFor(200)
|
||||
})
|
||||
|
||||
it('renders banner tabs and initial mocked feed list', async () => {
|
||||
const swipers = await page.$$('swiper')
|
||||
const tabs = await page.$$('.swiper-tabs-item')
|
||||
const firstListState = await page.callMethod('jest_getListState', 0)
|
||||
const secondListState = await page.callMethod('jest_getListState', 1)
|
||||
const pageState = await page.callMethod('jest_getState')
|
||||
|
||||
expect(swipers.length).toBe(2)
|
||||
expect(tabs.length).toBe(4)
|
||||
expect(await tabs[0].text()).toBe('最新上架')
|
||||
expect(await tabs[2].text()).toBe('付费热榜')
|
||||
expect(pageState.currentType).toBe('UpdatedDate')
|
||||
expect(pageState.nestedScrollChildId).toBe('list-id-1')
|
||||
expect(firstListState.renderedCount).toBe(10)
|
||||
expect(firstListState.firstTitle).toBe('UpdatedDate mock 1')
|
||||
expect(secondListState.renderedCount).toBe(0)
|
||||
expect(ACTIVE_COLORS).toContain(await tabs[0].style('color'))
|
||||
expect(INACTIVE_COLORS).toContain(await tabs[1].style('color'))
|
||||
})
|
||||
|
||||
it('updates nested child id and indicator after tapping another tab', async () => {
|
||||
const tabs = await page.$$('.swiper-tabs-item')
|
||||
const indicator = await page.$('.swiper-tabs-indicator')
|
||||
const beforeTransform = await indicator.style('transform')
|
||||
const beforeWidth = (await indicator.size()).width
|
||||
|
||||
await tabs[1].tap()
|
||||
await waitForSwiperCurrent(1)
|
||||
const secondListState = await waitForListState(1, (state) => state != null && state.renderedCount > 0)
|
||||
const pageState = await page.callMethod('jest_getState')
|
||||
|
||||
expect(pageState.currentType).toBe('FreeHot')
|
||||
expect(pageState.nestedScrollChildId).toBe('list-id-2')
|
||||
expect(secondListState.firstTitle).toBe('FreeHot mock 1')
|
||||
expect(ACTIVE_COLORS).toContain(await tabs[1].style('color'))
|
||||
expect(INACTIVE_COLORS).toContain(await tabs[0].style('color'))
|
||||
|
||||
await waitForIndicatorChange(indicator, beforeTransform, beforeWidth)
|
||||
})
|
||||
|
||||
it('supports programmatic switch to later feed tabs', async () => {
|
||||
const changed = await page.callMethod('jest_setSwiperCurrent', 2)
|
||||
expect(changed).toBe(true)
|
||||
await waitForSwiperCurrent(2)
|
||||
|
||||
const thirdListState = await waitForListState(2, (state) => state != null && state.renderedCount > 0)
|
||||
const pageState = await page.callMethod('jest_getState')
|
||||
|
||||
expect(pageState.currentType).toBe('PaymentHot')
|
||||
expect(pageState.nestedScrollChildId).toBe('list-id-3')
|
||||
expect(thirdListState.firstTitle).toBe('PaymentHot mock 1')
|
||||
})
|
||||
})
|
||||
@@ -0,0 +1,398 @@
|
||||
<template>
|
||||
<scroll-view ref="pageScrollView" class="page" :bounces="false"
|
||||
<!-- #ifndef VUE3-VAPOR -->
|
||||
@startnestedscroll="onStartNestedScroll" @nestedprescroll="onNestedPreScroll"
|
||||
:nested-scroll-child="nestedScrollChildId"
|
||||
<!-- #endif -->
|
||||
:refresher-triggered="refresherTriggered" refresher-enabled="true" @refresherrefresh="onRefresherrefresh"
|
||||
>
|
||||
<swiper ref="header" indicator-dots="true" circular="true">
|
||||
<swiper-item v-for="i in 3" :item-id="'' + i">
|
||||
<image src="/static/shuijiao.jpg" style="width:100% ;height: 240px;"></image>
|
||||
</swiper-item>
|
||||
</swiper>
|
||||
<view class="swiper-list">
|
||||
<scroll-view ref="tabScroll" class="swiper-tabs" direction="horizontal" :show-scrollbar="false">
|
||||
<view class="flex-row" style="align-self: flex-start;">
|
||||
<text ref="swipertab" class="swiper-tabs-item" :class="swiperIndex==index ? 'swiper-tabs-item-active' : ''"
|
||||
v-for="(item, index) in swiperList" :key="index" @click="onTabClick(index)">
|
||||
{{item.name}}
|
||||
</text>
|
||||
</view>
|
||||
<view ref="indicator" class="swiper-tabs-indicator"></view>
|
||||
</scroll-view>
|
||||
<swiper ref="swiper" class="swiper-view" :current="swiperIndex" @transition="onSwiperTransition"
|
||||
@animationfinish="onSwiperAnimationfinish">
|
||||
<swiper-item class="swiper-item" v-for="(item, index) in swiperList" :key="index">
|
||||
<long-page ref="longPageRef" :id="item.id" :type="item.type" :preload="item.preload"></long-page>
|
||||
</swiper-item>
|
||||
</swiper>
|
||||
</view>
|
||||
</scroll-view>
|
||||
</template>
|
||||
|
||||
<script setup lang="uts">
|
||||
/**
|
||||
* @description: 支持顶部 Banner、横滑分页标签栏和长列表内容联动的嵌套滚动页面。
|
||||
* @logic: 页面顶部先展示 Banner 轮播图,再通过横向标签切换不同信息流列表;父级 scroll-view 与子级长列表通过嵌套滚动衔接滚动手势。
|
||||
* @optimization: 首屏只预加载当前标签页的数据,切换到其他标签页时再按需触发对应长列表加载,减少初始化内容和滚动联动时的开销。
|
||||
*/
|
||||
import longPage from '../search-header-long-list/long-list-page.uvue';
|
||||
|
||||
type SwiperTabsItem = {
|
||||
x : number,
|
||||
w : number
|
||||
}
|
||||
|
||||
type SwiperViewItem = {
|
||||
type : string,
|
||||
name : string,
|
||||
id: string,
|
||||
preload : boolean,
|
||||
}
|
||||
|
||||
type JestTabsPageState = {
|
||||
swiperIndex : number,
|
||||
animationFinishIndex : number,
|
||||
tabCount : number,
|
||||
currentType : string,
|
||||
currentName : string,
|
||||
currentPreload : boolean,
|
||||
nestedScrollChildId : string,
|
||||
}
|
||||
|
||||
/**
|
||||
* 根据权重在两个值之间执行线性插值.
|
||||
* @constructor
|
||||
* @param {number} value1 - 第一个值,该值应为下限.
|
||||
* @param {number} value2 - 第二个值,该值应为上限.
|
||||
* @param {number} amount - 应介于 0 和 1 之间,指示内插的权重.
|
||||
* @returns {number} 内插值
|
||||
*/
|
||||
function lerpNumber(value1 : number, value2 : number, amount : number) : number {
|
||||
return (value1 + (value2 - value1) * amount)
|
||||
}
|
||||
|
||||
const swiperList = ref<SwiperViewItem[]>([
|
||||
{
|
||||
type: 'UpdatedDate',
|
||||
name: '最新上架',
|
||||
id: "list-id-1",
|
||||
preload: true
|
||||
},
|
||||
{
|
||||
type: 'FreeHot',
|
||||
name: '免费热榜',
|
||||
id: "list-id-2",
|
||||
preload: false
|
||||
},
|
||||
{
|
||||
type: 'PaymentHot',
|
||||
name: '付费热榜',
|
||||
id: "list-id-3",
|
||||
preload: false
|
||||
},
|
||||
{
|
||||
type: 'HotList',
|
||||
name: '热门总榜',
|
||||
id: "list-id-4",
|
||||
preload: false
|
||||
}
|
||||
])
|
||||
|
||||
const swiperIndex = ref(0)
|
||||
const pageScrollView = ref<UniScrollViewElement|null>(null)
|
||||
const header = ref<UniElement|null>(null)
|
||||
let headerHeight = 0
|
||||
let animationFinishIndex = 0
|
||||
const tabScroll = ref<UniScrollViewElement|null>(null)
|
||||
const indicator = ref<UniElement|null>(null)
|
||||
const swiper = ref<UniSwiperElement|null>(null)
|
||||
let swiperWidth = 0
|
||||
let swiperTabsRect: SwiperTabsItem[] = []
|
||||
const nestedScrollChildId = ref("")
|
||||
const longPageRef = ref<ComponentPublicInstance[]|null>(null)
|
||||
const swipertab = ref<UniTextElement[]|null>(null)
|
||||
// 仅在自动化测试程序化切页时启用,避免晚到的旧 animationfinish 把目标索引回写成旧值。
|
||||
let isTestFinishGuardEnabled = false
|
||||
|
||||
function onStartNestedScroll() : boolean {
|
||||
return true
|
||||
}
|
||||
|
||||
function onNestedPreScroll(event : NestedPreScrollEvent) {
|
||||
const deltaY = event.deltaY
|
||||
const scrollTop = pageScrollView.value!.scrollTop
|
||||
|
||||
if (deltaY > 0) {
|
||||
// 向上滚动,如果父容器 header scrollTop < offsetHeight,先滚动父容器
|
||||
if (scrollTop < headerHeight) {
|
||||
const difference = headerHeight - scrollTop - deltaY
|
||||
if (difference > 0) {
|
||||
pageScrollView.value!.scrollBy(event.deltaX, deltaY)
|
||||
event.consumed(event.deltaX, deltaY)
|
||||
} else {
|
||||
const top : number = deltaY + difference
|
||||
event.consumed(event.deltaX, top.toFloat())
|
||||
pageScrollView.value!.scrollBy(event.deltaX, top.toFloat())
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function initSwiperItemData(index : number) {
|
||||
if (!swiperList.value[index].preload) {
|
||||
swiperList.value[index].preload = true;
|
||||
(longPageRef.value! as ComponentPublicInstance[])[index].$callMethod('loadData', null)
|
||||
}
|
||||
//swiper页面切换需要重新赋值嵌套滚动子元素的id
|
||||
nestedScrollChildId.value = swiperList.value[index].id
|
||||
}
|
||||
|
||||
function updateTabIndicator(current_index : number, move_to_index : number, percentage : number) {
|
||||
const current_size = swiperTabsRect[current_index]
|
||||
const move_to_size = swiperTabsRect[move_to_index]
|
||||
|
||||
// 计算指示线 左边距 和 宽度 在移动过程中的线性值
|
||||
const indicator_line_x = lerpNumber(current_size.x, move_to_size.x, percentage)
|
||||
const indicator_line_w = lerpNumber(current_size.w, move_to_size.w, percentage)
|
||||
|
||||
// 更新指示线
|
||||
// #ifdef APP
|
||||
const x = indicator_line_x + indicator_line_w / 2
|
||||
indicator.value?.style?.setProperty('transform', `translateX(${x}px) scaleX(${indicator_line_w})`)
|
||||
// #endif
|
||||
// #ifdef WEB || MP
|
||||
// TODO chrome windows系统 transform scaleX渲染bug
|
||||
const x = indicator_line_x
|
||||
indicator.value?.style?.setProperty('width', `${indicator_line_w}px`)
|
||||
indicator.value?.style?.setProperty('transform', `translateX(${x}px)`)
|
||||
// #endif
|
||||
|
||||
// 滚动到水平中心位置
|
||||
const scroll_x = x - swiperWidth / 2
|
||||
// app 平台后续支持 scrollTo()
|
||||
// #ifndef MP-WEIXIN
|
||||
tabScroll.value!.scrollLeft = scroll_x
|
||||
// #endif
|
||||
// #ifdef MP-WEIXIN
|
||||
tabScroll.value!.scrollTo({
|
||||
left: scroll_x
|
||||
})
|
||||
// #endif
|
||||
}
|
||||
|
||||
function setSwiperIndex(index : number, updateIndicator : boolean) {
|
||||
if (swiperIndex.value === index) {
|
||||
return
|
||||
}
|
||||
|
||||
swiperIndex.value = index
|
||||
|
||||
initSwiperItemData(index)
|
||||
|
||||
if (updateIndicator) {
|
||||
updateTabIndicator(index, index, 1)
|
||||
}
|
||||
}
|
||||
|
||||
function onTabClick(index : number) {
|
||||
isTestFinishGuardEnabled = false
|
||||
setSwiperIndex(index, false)
|
||||
}
|
||||
|
||||
function onSwiperTransition(e : SwiperTransitionEvent) {
|
||||
// 微信 skyline 每项完成触发 Animationfinish,偏移值重置
|
||||
// 微信 webview 全部完成触发 Animationfinish,偏移值累加
|
||||
// 在滑动到下一个项的过程中,再次反向滑动,偏移值递减
|
||||
// uni-app-x 和微信 webview 行为一致
|
||||
|
||||
const offset_x = e.detail.dx
|
||||
|
||||
// 计算当前索引并重置差异
|
||||
const current_offset_x = offset_x % swiperWidth
|
||||
const current_offset_i = offset_x / swiperWidth
|
||||
const current_index = animationFinishIndex + parseInt(current_offset_i + '')
|
||||
|
||||
// 计算目标索引及边界检查
|
||||
let move_to_index = current_index
|
||||
if (current_offset_x > 0 && move_to_index < swiperList.value.length - 1) {
|
||||
move_to_index += 1
|
||||
} else if (current_offset_x < 0 && move_to_index > 0) {
|
||||
move_to_index -= 1
|
||||
}
|
||||
|
||||
// 计算偏移百分比
|
||||
const percentage = Math.abs(current_offset_x) / swiperWidth
|
||||
|
||||
// 通知更新指示线
|
||||
if (current_index != move_to_index) {
|
||||
updateTabIndicator(current_index, move_to_index, percentage)
|
||||
// 首次可见时初始化数据
|
||||
initSwiperItemData(move_to_index)
|
||||
}
|
||||
}
|
||||
|
||||
function onSwiperAnimationfinish(e : SwiperAnimationFinishEvent) {
|
||||
// 程序化切页时忽略晚到的旧完成事件。
|
||||
if (isTestFinishGuardEnabled && e.detail.current != swiperIndex.value) {
|
||||
return
|
||||
}
|
||||
isTestFinishGuardEnabled = false
|
||||
setSwiperIndex(e.detail.current, true)
|
||||
animationFinishIndex = e.detail.current
|
||||
}
|
||||
|
||||
async function cacheTabItemsSize() {
|
||||
swiperTabsRect.length = 0;
|
||||
const tabs = swipertab.value as UniElement[]
|
||||
for (let i = 0; i < tabs.length; i++) {
|
||||
const element = tabs[i];
|
||||
// #ifdef MP
|
||||
const rect = await element.getBoundingClientRectAsync()!
|
||||
const x = rect.left
|
||||
const w = rect.width
|
||||
// #endif
|
||||
// #ifndef MP
|
||||
const x = element.offsetLeft
|
||||
const w = element.offsetWidth
|
||||
// #endif
|
||||
swiperTabsRect.push({
|
||||
x,
|
||||
w
|
||||
} as SwiperTabsItem)
|
||||
}
|
||||
}
|
||||
|
||||
const refresherTriggered = ref(false);
|
||||
function onRefresherrefresh(e : UniRefresherEvent) {
|
||||
refresherTriggered.value = true;
|
||||
(longPageRef.value! as ComponentPublicInstance[])[swiperIndex.value].$callMethod('refreshData', () => {
|
||||
refresherTriggered.value = false;
|
||||
})
|
||||
}
|
||||
|
||||
onReady(() => {
|
||||
headerHeight = (header.value as UniElement).offsetHeight
|
||||
swiper.value?.getBoundingClientRectAsync()!.then((res : DOMRect) : Promise<void> => {
|
||||
swiperWidth = res.width
|
||||
return cacheTabItemsSize()
|
||||
}).then(() => {
|
||||
updateTabIndicator(swiperIndex.value, swiperIndex.value, 1)
|
||||
});
|
||||
})
|
||||
|
||||
// 自动化测试辅助
|
||||
function jest_prepareMockData() : boolean {
|
||||
const pageRefs = longPageRef.value
|
||||
if (pageRefs == null || pageRefs.length == 0) {
|
||||
return false
|
||||
}
|
||||
|
||||
for (let i = 0; i < pageRefs.length; i++) {
|
||||
pageRefs[i].$callMethod('jest_useMockData', i == swiperIndex.value)
|
||||
swiperList.value[i].preload = i == swiperIndex.value
|
||||
}
|
||||
nestedScrollChildId.value = swiperList.value[swiperIndex.value].id
|
||||
return true
|
||||
}
|
||||
|
||||
function jest_setSwiperCurrent(index : number) : boolean {
|
||||
if (index < 0 || index >= swiperList.value.length) {
|
||||
return false
|
||||
}
|
||||
isTestFinishGuardEnabled = true
|
||||
swiperIndex.value = index
|
||||
initSwiperItemData(index)
|
||||
updateTabIndicator(index, index, 1)
|
||||
animationFinishIndex = index
|
||||
nestedScrollChildId.value = swiperList.value[index].id
|
||||
return true
|
||||
}
|
||||
|
||||
function jest_getState() : JestTabsPageState {
|
||||
const currentItem = swiperList.value[swiperIndex.value]
|
||||
return {
|
||||
swiperIndex: swiperIndex.value,
|
||||
animationFinishIndex: animationFinishIndex,
|
||||
tabCount: swiperList.value.length,
|
||||
currentType: currentItem.type,
|
||||
currentName: currentItem.name,
|
||||
currentPreload: currentItem.preload,
|
||||
nestedScrollChildId: currentItem.id,
|
||||
} as JestTabsPageState
|
||||
}
|
||||
|
||||
function jest_getListState(index : number) : UTSJSONObject | null {
|
||||
if (index < 0 || index >= swiperList.value.length || longPageRef.value == null) {
|
||||
return null
|
||||
}
|
||||
return longPageRef.value[index].$callMethod('jest_getState', null) as UTSJSONObject | null
|
||||
}
|
||||
|
||||
defineExpose({
|
||||
jest_prepareMockData,
|
||||
jest_setSwiperCurrent,
|
||||
jest_getState,
|
||||
jest_getListState,
|
||||
})
|
||||
|
||||
</script>
|
||||
|
||||
<style>
|
||||
.flex-row {
|
||||
flex-direction: row;
|
||||
}
|
||||
|
||||
.page {
|
||||
flex: 1;
|
||||
}
|
||||
|
||||
.search-bar {
|
||||
padding: 10px;
|
||||
}
|
||||
|
||||
.swiper-list {
|
||||
height: 100%;
|
||||
/* #ifdef WEB */
|
||||
flex: 1;
|
||||
/* #endif */
|
||||
}
|
||||
|
||||
.swiper-tabs {
|
||||
background-color: #ffffff;
|
||||
flex-direction: column;
|
||||
}
|
||||
|
||||
.swiper-tabs-item {
|
||||
color: #555;
|
||||
font-size: 16px;
|
||||
padding: 12px 25px;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.swiper-tabs-item-active {
|
||||
color: #007AFF;
|
||||
}
|
||||
|
||||
.swiper-tabs-indicator {
|
||||
width: 1px;
|
||||
height: 2px;
|
||||
background-color: #007AFF;
|
||||
}
|
||||
|
||||
.swiper-view {
|
||||
flex: 1;
|
||||
}
|
||||
|
||||
.swiper-item {
|
||||
/* #ifndef APP-HARMONY */
|
||||
flex: 1;
|
||||
/* #endif */
|
||||
|
||||
/* #ifdef APP-HARMONY */
|
||||
/* 临时兼容,非蒸汽,harmony 高度异常 */
|
||||
height: 100%;
|
||||
/* #endif */
|
||||
}
|
||||
</style>
|
||||
在新工单中引用
屏蔽一个用户