refactor: 确立独立子工程架构 (backend, admin, mpuniapp) 并同步更新 AGENTS.md 规范

这个提交包含在:
wikiboss
2026-09-20 17:05:22 +08:00
父节点 de3cf8b870
当前提交 9fa1d1fbd0
共有 1679 个文件被更改,包括 204798 次插入 和 16817 次删除

查看文件

@@ -0,0 +1,252 @@
const PAGE_PATH = '/pages/component/scroll-view/scroll-view-custom-refresher-props'
const platformInfo = process.env.uniTestPlatformInfo.toLocaleLowerCase()
const isWeb = platformInfo.startsWith('web')
const isMP = platformInfo.startsWith('mp')
const isAppWebView = process.env.UNI_AUTOMATOR_APP_WEBVIEW == 'true'
const isIos = platformInfo.startsWith('ios')
const isAndroid = platformInfo.startsWith('android')
const isHarmony = platformInfo.startsWith('harmony')
describe('scroll-view-custom-refresher-props-test', () => {
//TODO:临时方案
if (isWeb || isMP) {
// 不支持program.swipe
it('skip', () => {
expect(1).toBe(1)
})
return
}
let page
beforeAll(async () => {
page = await program.reLaunch(PAGE_PATH)
await page.waitFor('view')
await page.waitFor(500)
});
async function getPageData(dataKey) {
return await page.data('data.' + dataKey)
}
/**
* 等待刷新完成(通过轮询状态)
* @param {string} refreshingKey - refreshing 状态的 key(如 'refreshing1')
* @param {string} listCountKey - listCount 的 key(如 'listCount1')
* @param {number} expectedIncrement - 预期增加的数量(默认 5)
* @param {number} timeout - 超时时间(默认 6000ms)
* @returns {Promise<boolean>} 返回是否刷新成功
*/
async function waitForRefreshComplete(refreshingKey, listCountKey, expectedIncrement = 5, timeout = 6000) {
const initialCount = await getPageData(listCountKey)
const startTime = Date.now()
let hasStarted = false
let lastRefreshing = null
let lastCount = initialCount
let pollCount = 0
// 轮询间隔(指数退避,避免高频 IPC)
let interval = 200
console.log(`[waitForRefreshComplete] 开始等待刷新完成: ${refreshingKey}, 初始数量: ${initialCount}`)
while (Date.now() - startTime < timeout) {
pollCount++
const refreshing = await getPageData(refreshingKey)
const currentCount = await getPageData(listCountKey)
console.log(`[waitForRefreshComplete] 第 ${pollCount} 次轮询 - refreshing: ${refreshing}, count: ${currentCount}, hasStarted: ${hasStarted}, interval: ${interval}ms`)
lastRefreshing = refreshing
lastCount = currentCount
if (refreshing) {
hasStarted = true
}
if (hasStarted && !refreshing && currentCount >= initialCount + expectedIncrement) {
const elapsedTime = Date.now() - startTime
console.log(`[waitForRefreshComplete] 刷新成功!共轮询 ${pollCount} 次,耗时 ${elapsedTime}ms`)
return true
}
await page.waitFor(interval)
interval = Math.min(interval * 1.5, 800)
}
// 超时后返回 false
const elapsedTime = Date.now() - startTime
console.log(`[waitForRefreshComplete] 刷新超时!共轮询 ${pollCount} 次,耗时 ${elapsedTime}ms,最终状态: refreshing=${lastRefreshing}, count=${lastCount}`)
return false
}
/**
* 执行下拉刷新操作
* @param {string} elementId - scroll-view 的id
* @param {number} pullDistance - 下拉距离
* @param {number} offsetY - 在scroll-view内部的Y偏移量(默认10,从顶部稍微往下一点开始滑动)
*/
async function performPullRefresh(elementId, pullDistance = 150, offsetY = 10) {
const rect = await page.callMethod('getBoundingClientRectForRefreshing', elementId);
console.log(`Refresher [${elementId}] rect:`, JSON.stringify(rect));
const windowInfo = await program.callUniMethod('getWindowInfo')
// 确保坐标为整数(IDB 要求整数坐标)
const startX = Math.round(rect.left + rect.width / 2);
const startY = Math.round(rect.top + offsetY + windowInfo.safeAreaInsets.top + 44);
const endY = Math.round(startY + pullDistance);
console.log(`Refresher [${elementId}] swipe from (${startX}, ${startY}) to (${startX}, ${endY})`);
await program.swipe({
startPoint: {
x: startX,
y: startY
},
endPoint: {
x: startX,
y: endY
},
duration: 500
})
await page.waitFor(300)
}
async function screenshot() {
const windowInfo = await program.callUniMethod('getWindowInfo')
let topSafeArea = windowInfo.safeAreaInsets.top;
if (isAppWebView) {
if (isIos) {
topSafeArea = 59
if (platformInfo.includes('26')) {
topSafeArea = 62
}
} else if (isAndroid) {
topSafeArea = 24
windowInfo.safeArea.bottom = 867
if (platformInfo.startsWith('android 5')) {
topSafeArea = 25
}if (platformInfo.startsWith('android 6')) {
windowInfo.safeArea.bottom = 592
}if (platformInfo.startsWith('android 8')) {
windowInfo.safeArea.bottom = 534
} else if (platformInfo.startsWith('android 11')) {
topSafeArea = 52
} else if (platformInfo.startsWith('android 12')) {
topSafeArea = 24
windowInfo.safeArea.bottom = 716
} else if (platformInfo.startsWith('android 13') || platformInfo.startsWith('android 15')) {
topSafeArea = 49
windowInfo.safeArea.bottom = 891
} else if (platformInfo.startsWith('android 14')) {
windowInfo.safeArea.bottom = 891
}
} else if (isHarmony) {
topSafeArea = 39
if (platformInfo.includes('nova_12')) {
topSafeArea = 35
}
}
}
const top = topSafeArea + 44
const bottom = Math.min(top + windowInfo.windowHeight, windowInfo.safeArea.bottom)
const left = windowInfo.safeArea.left
const right = windowInfo.safeArea.right
const screenShotOptions = {
deviceShot: true,
area: {
x: left,
y: top,
width: right - left,
height: bottom - top
},
}
const image = await program.screenshot(screenShotOptions)
expect(image).toSaveImageSnapshot()
}
it('test-initial-screenshot', async () => {
await screenshot()
})
if (!isAppWebView) {
// ==================== 第1个下拉刷新功能测试 ====================
it('test-refresher-1-pull-to-refresh', async () => {
const initialCount = await getPageData('listCount1')
await performPullRefresh('refreshing1', 180)
// 使用轮询等待刷新完成
const refreshSuccess = await waitForRefreshComplete('refreshing1', 'listCount1', 5, 6000)
expect(refreshSuccess).toBe(true)
// 验证列表数量增加了5个
const finalCount = await getPageData('listCount1')
expect(finalCount).toBe(initialCount + 5)
})
// ==================== 第2个下拉刷新功能测试 ====================
it('test-refresher-2-pull-to-refresh', async () => {
const initialCount = await getPageData('listCount2')
await performPullRefresh('refreshing2', 180)
const refreshSuccess = await waitForRefreshComplete('refreshing2', 'listCount2', 5, 6000)
expect(refreshSuccess).toBe(true)
const finalCount = await getPageData('listCount2')
expect(finalCount).toBe(initialCount + 5)
})
// ==================== 第3个下拉刷新功能测试 ====================
it('test-refresher-3-pull-to-refresh', async () => {
const initialCount = await getPageData('listCount3')
await performPullRefresh('refreshing3', 180)
const refreshSuccess = await waitForRefreshComplete('refreshing3', 'listCount3', 5, 6000)
expect(refreshSuccess).toBe(true)
const finalCount = await getPageData('listCount3')
expect(finalCount).toBe(initialCount + 5)
})
// ==================== 第4个下拉刷新功能测试 ====================
it('test-refresher-4-pull-to-refresh', async () => {
const initialCount = await getPageData('listCount4')
await performPullRefresh('refreshing4', 180)
const refreshSuccess = await waitForRefreshComplete('refreshing4', 'listCount4', 5, 6000)
expect(refreshSuccess).toBe(true)
const finalCount = await getPageData('listCount4')
expect(finalCount).toBe(initialCount + 5)
})
// ==================== 测试部分下拉(不触发刷新)====================
it('test-partial-pull-not-trigger-refresh', async () => {
// 记录初始列表数量
const initialCount = await getPageData('listCount1')
// 验证初始pullingDistance为0
const initialDistance = await getPageData('pullingDistance1')
expect(initialDistance).toBe(0)
// 执行部分下拉 (只下拉30px,小于threshold 45,不应触发刷新)
await performPullRefresh('refreshing1', 30)
await page.waitFor(1000)
// 验证列表数量没有变化(因为没有触发刷新)
const finalCount = await getPageData('listCount1')
expect(finalCount).toBe(initialCount) // 数量应该保持不变
// 验证pullingDistance已重置为0
const finalDistance = await getPageData('pullingDistance1')
expect(finalDistance).toBe(0)
})
}
})

查看文件

@@ -0,0 +1,286 @@
<template>
<view style="flex: 1;">
<page-intro content="本页演示 scroll-view 自定义下拉刷新属性:refresher 插槽、pulling/refresh/restore/abort 事件、竖排暗黑样式。"></page-intro>
<scroll-view id="refreshing1"
style="flex: 1;"
:refresher-enabled="true"
:refresher-triggered="data.refreshing1"
refresher-default-style="none"
:refresher-threshold="45"
refresher-max-drag-distance="200px"
@refresherpulling="onRefresherpulling1"
@refresherrefresh="onRefresherrefresh1"
@refresherrestore="onRefresherrestore1"
@refresherabort="onRefresherabort1"
> <!-- TODO Android不支持bool属性,:refresher-enabled="true" 不能简写为 refresher-enabled -->
<!-- 列表内容 -->
<view v-for="i in data.listCount1" :key="i" class="content-item">
<text class="text">item-{{ i }}</text>
</view>
<!-- refresher 插槽使用 uni-refresh-box 组件 -->
<uni-refresh-box
slot="refresher"
:pulling-distance="data.pullingDistance1"
:refreshing="data.refreshing1"
></uni-refresh-box> <!-- TODO web只认在组件外层使用slot="refresher",不支持组件内根元素使用-->
</scroll-view>
<text style="margin: 5px;">竖排暗黑自定义文字的下拉设置</text>
<scroll-view id="refreshing2"
style="flex: 1;background-color: black;"
:refresher-enabled="true"
:refresher-triggered="data.refreshing2"
refresher-default-style="none"
:refresher-threshold="45"
refresher-max-drag-distance="200px"
@refresherpulling="onRefresherpulling2"
@refresherrefresh="onRefresherrefresh2"
@refresherrestore="onRefresherrestore2"
@refresherabort="onRefresherabort2"
> <!-- TODO Android不支持bool属性,:refresher-enabled="true" 不能简写为 refresher-enabled -->
<!-- 列表内容 -->
<view v-for="i in data.listCount2" :key="i" class="content-item">
<text class="text">item-{{ i }}</text>
</view>
<!-- refresher 插槽使用 uni-refresh-box 组件 -->
<uni-refresh-box
slot="refresher"
:pulling-distance="data.pullingDistance2"
:refreshing="data.refreshing2"
loading-class="loading-dark"
text-class="text-dark"
style="flex-direction: column;height: 46px;padding-top: 6px;"
pulling-text="继续下拉可刷新"
loosing-text="释放后会刷新"
loading-text="奋力加载中..."
></uni-refresh-box> <!-- TODO web只认在组件外层使用slot="refresher",不支持组件内根元素使用-->
</scroll-view>
<text style="margin: 5px;">slot自定义下拉图标</text>
<scroll-view id="refreshing3"
style="flex: 1;"
:refresher-enabled="true"
:refresher-triggered="data.refreshing3"
refresher-default-style="none"
:refresher-threshold="45"
refresher-max-drag-distance="200px"
@refresherpulling="onRefresherpulling3"
@refresherrefresh="onRefresherrefresh3"
@refresherrestore="onRefresherrestore3"
@refresherabort="onRefresherabort3"
> <!-- TODO Android不支持bool属性,:refresher-enabled="true" 不能简写为 refresher-enabled -->
<!-- 列表内容 -->
<view v-for="i in data.listCount3" :key="i" class="content-item">
<text class="text">item-{{ i }}</text>
</view>
<!-- refresher 插槽使用 uni-refresh-box 组件 -->
<uni-refresh-box
slot="refresher"
:pulling-distance="data.pullingDistance3"
:refreshing="data.refreshing3"
>
<template #loading="{ state }">
<image
v-if="state == 2"
src="https://web-ext-storage.dcloud.net.cn/hello-uni-app-x/refresh-box-run.gif"
style="width: 20px; height: 20px;"
/> <!-- 刷新中的动图-->
<image
v-else
src="https://web-ext-storage.dcloud.net.cn/hello-uni-app-x/refresh-box-run.gif"
style="width: 20px; height: 20px;"
/> <!-- 非刷新中的图,可以和刷新中的图是一张,也可以分开-->
</template>
<!-- <image src="https://web-ext-storage.dcloud.net.cn/hello-uni-app-x/refresh-box-run.gif" style="width:20px;height:20px;"></image> -->
</uni-refresh-box> <!-- TODO web只认在组件外层使用slot="refresher",不支持组件内根元素使用-->
</scroll-view>
<text style="margin: 5px;">无文字,纯loading</text>
<scroll-view id="refreshing4"
style="flex: 1;"
:refresher-enabled="true"
:refresher-triggered="data.refreshing4"
refresher-default-style="none"
:refresher-threshold="45"
refresher-max-drag-distance="200px"
@refresherpulling="onRefresherpulling4"
@refresherrefresh="onRefresherrefresh4"
@refresherrestore="onRefresherrestore4"
@refresherabort="onRefresherabort4"
> <!-- TODO Android不支持bool属性,:refresher-enabled="true" 不能简写为 refresher-enabled -->
<!-- 列表内容 -->
<view v-for="i in data.listCount4" :key="i" class="content-item">
<text class="text">item-{{ i }}</text>
</view>
<!-- refresher 插槽使用 uni-refresh-box 组件 -->
<uni-refresh-box
slot="refresher"
:pulling-distance="data.pullingDistance4"
:refreshing="data.refreshing4"
pulling-text=""
loosing-text=""
loading-text=""
loading-class="loading-big-font"
></uni-refresh-box> <!-- TODO web只认在组件外层使用slot="refresher",不支持组件内根元素使用-->
</scroll-view>
</view>
</template>
<script setup lang="uts">
type DataType = {
listCount1: number,
refreshing1: boolean,
pullingDistance1: number,
listCount2: number,
refreshing2: boolean,
pullingDistance2: number,
listCount3: number,
refreshing3: boolean,
pullingDistance3: number,
listCount4: number,
refreshing4: boolean,
pullingDistance4: number
}
// 用于自动化测试的数据暴露 - 使用 reactive 将所有 ref 状态集中暴露
const data = reactive({
listCount1: 3,
refreshing1: false,
pullingDistance1: 0,
listCount2: 3,
refreshing2: false,
pullingDistance2: 0,
listCount3: 3,
refreshing3: false,
pullingDistance3: 0,
listCount4: 3,
refreshing4: false,
pullingDistance4: 0
} as DataType)
function onRefresherpulling1(e: RefresherEvent) {
data.pullingDistance1 = e.detail.dy
}
function onRefresherrefresh1() {
data.refreshing1 = true
console.log('列表1 触发刷新')
setTimeout(() => {
data.listCount1 += 5
data.refreshing1 = false
console.log('列表1 刷新完成')
}, 1500)
}
function onRefresherrestore1() {
data.pullingDistance1 = 0
}
function onRefresherabort1() {
data.pullingDistance1 = 0
}
// 第2个 scroll-view 的事件处理
function onRefresherpulling2(e: RefresherEvent) {
data.pullingDistance2 = e.detail.dy
}
function onRefresherrefresh2() {
data.refreshing2 = true
console.log('列表2 触发刷新')
setTimeout(() => {
data.listCount2 += 5
data.refreshing2 = false
console.log('列表2 刷新完成')
}, 1500)
}
function onRefresherrestore2() {
data.pullingDistance2 = 0
}
function onRefresherabort2() {
data.pullingDistance2 = 0
}
function onRefresherpulling3(e: RefresherEvent) {
data.pullingDistance3 = e.detail.dy
}
function onRefresherrefresh3() {
data.refreshing3 = true
console.log('列表3 触发刷新')
setTimeout(() => {
data.listCount3 += 5
data.refreshing3 = false
console.log('列表3 刷新完成')
}, 1500)
}
function onRefresherrestore3() {
data.pullingDistance3 = 0
}
function onRefresherabort3() {
data.pullingDistance3 = 0
}
function onRefresherpulling4(e: RefresherEvent) {
data.pullingDistance4 = e.detail.dy
}
function onRefresherrefresh4() {
data.refreshing4 = true
console.log('列表4 触发刷新')
setTimeout(() => {
data.listCount4 += 5
data.refreshing4 = false
console.log('列表4 刷新完成')
}, 1500)
}
function onRefresherrestore4() {
data.pullingDistance4 = 0
}
function onRefresherabort4() {
data.pullingDistance4 = 0
}
const getBoundingClientRectForRefreshing = (elementId: string) : DOMRect => {
return uni.getElementById(elementId)?.getBoundingClientRect()!;
}
defineExpose({
data,
getBoundingClientRectForRefreshing
})
</script>
<style>
.content-item {
margin: 5px 10px;
}
.text {
color: #666;
font-size: 14px;
}
.loading-dark{
border-color:white;
width: 20px;
height: 20px;
}
.text-dark{
color: white;
margin-top: 5px;
}
.loading-big-font{
width: 24px;
height: 24px;
}
</style>

查看文件

@@ -0,0 +1,138 @@
const platformInfo = process.env.uniTestPlatformInfo.toLocaleLowerCase()
const isMP = platformInfo.startsWith('mp')
const isAndroid = platformInfo.startsWith('android')
describe('component-native-scroll-view-props', () => {
if (isMP) {
it('skip', () => {
expect(1).toBe(1)
})
return
}
let page;
beforeAll(async () => {
page = await program.reLaunch('/pages/component/scroll-view/scroll-view-props');
await page.waitFor(300);
});
async function setPageData(newData) {
return await page.setData({ data: newData });
}
if(!isMP) {
//检测竖向可滚动区域
it('check_scroll_height', async () => {
await setPageData({ scrollX: false })
await page.waitFor(300);
const value = await page.callMethod('checkScrollHeight')
expect(value).toBe(true)
})
}
//检测竖向scrolltop属性赋值
it('check_scroll_top', async () => {
await setPageData({ scrollTop: 600 })
await page.waitFor(600)
//检测滚动top 是否触发scroll 事件
const scrollChangeTop = await page.data('data.scrollChangeTop')
console.log("scrollChangeTop="+scrollChangeTop)
expect(scrollChangeTop-600).toBeGreaterThanOrEqual(0)
const element = await page.$('#scrollViewY')
const scrollTop = await element.property("scrollTop")
console.log("check_scroll_top---"+scrollTop)
expect(scrollTop-600).toBeGreaterThanOrEqual(0)
})
//检测竖向scroll_into_view属性赋值
it('check_scroll_into_view_top', async () => {
await setPageData({ scrollIntoView: "item3" })
await page.waitFor(600)
const element = await page.$('#scrollViewY')
const scrollTop = await element.property("scrollTop")
console.log("check_scroll_into_view_top--"+scrollTop)
await setPageData({ scrollIntoView: "" })
expect(scrollTop-570).toBeGreaterThanOrEqual(0)
})
if(!isAndroid) {//Android scroll_into_view暂时未支持孙节点
//检测竖向scroll_into_view滚动到孙节点属性赋值
it('check_scroll_into_view_top_grand_child', async () => {
await setPageData({ scrollIntoView: "grand_child_item3" })
await page.waitFor(600)
const element = await page.$('#scrollViewY')
const scrollTop = await element.property("scrollTop")
console.log("check_scroll_into_view_top--"+scrollTop)
await setPageData({ scrollIntoView: "" })
expect(scrollTop-570).toBeGreaterThanOrEqual(0)
})
}
if(!isMP) {
//检测横向可滚动区域
it('check_scroll_width', async () => {
await setPageData({ scrollX: true })
await page.waitFor(300);
const value = await page.callMethod('checkScrollWidth')
expect(value).toBe(true)
})
}
//检测横向scrollLeft属性赋值
it('check_scroll_left', async () => {
await setPageData({ scrollX: true })
await setPageData({ scrollLeft: 600 })
await page.waitFor(600)
const element = await page.$('#scrollViewX')
const scrollLeft = await element.property("scrollLeft")
console.log("check_scroll_left---"+scrollLeft)
expect(scrollLeft-600).toBeGreaterThanOrEqual(0)
})
//检测横向scroll_into_view属性赋值
it('check_scroll_into_view_left', async () => {
await setPageData({ scrollX: true })
await setPageData({ scrollIntoView: "horizontal_item3" })
await page.waitFor(600)
const element = await page.$('#scrollViewX')
const scrollLeft = await element.property("scrollLeft")
console.log("check_scroll_into_view_left--"+scrollLeft)
await setPageData({ scrollIntoView: "" })
expect(scrollLeft-930).toBeGreaterThanOrEqual(0)
})
if(!isAndroid) {//Android scroll_into_view 暂未支持孙节点
//检测横向scroll_into_view滚动到孙节点属性赋值
it('check_scroll_into_view_left_grand_child', async () => {
await setPageData({ scrollX: true })
await setPageData({ scrollIntoView: "horizontal_grand_child__item3" })
await page.waitFor(600)
const element = await page.$('#scrollViewX')
const scrollLeft = await element.property("scrollLeft")
console.log("check_scroll_into_view_left--"+scrollLeft)
await setPageData({ scrollIntoView: "" })
expect(scrollLeft-930).toBeGreaterThanOrEqual(0)
})
}
//截图对比
it('scroll-view-props-screenshot', async () => {
//禁止滚动条
await setPageData({ showScrollbar: false })
await page.waitFor(1000);
const image = await program.screenshot({fullPage: true});
expect(image).toSaveImageSnapshot();
})
//截图末尾位置元素
it('scroll-view-props-last-item-screenshot', async () => {
//滚动到末尾位置
await setPageData({ scrollLeft: 10000 })
await page.waitFor(1000);
const image = await program.screenshot({fullPage: true});
expect(image).toSaveImageSnapshot();
})
});

查看文件

@@ -0,0 +1,297 @@
<template>
<!-- <view class="page-scroll-view"> -->
<page-head title="非下拉刷新的scroll-view属性示例"></page-head>
<!-- 暂时分成两个方向不同的滚动视图,原因为:scroll-view组件不支持动态改变direction。 -->
<scroll-view v-if="data.scrollX" direction="horizontal" :scroll-top="data.scrollTop" :scroll-left="data.scrollLeft"
:upper-threshold="data.upperThreshold" :lower-threshold="data.lowerThreshold" :scroll-into-view="data.scrollIntoView"
:enable-back-to-top="data.enableBackToTop" :scroll-with-animation="data.scrollWithAnimation" style="flex-direction: row;"
class="uni-margin-wrap" :show-scrollbar="data.showScrollbar" :bounces="data.bounces" @scrolltoupper="scrolltoupper"
@scrolltolower="scrolltolower" @scroll="scroll" @scrollend="scrollend" ref="scrollViewXRef" id="scrollViewX">
<!-- h-margin-right末尾元素添加margin-right 测试bug #3866-->
<view class="item" :id="'horizontal_'+item.id" v-for="(item,index) in data.items"
:class="index==9 ? 'h-margin-right': ''">
<view :id="'horizontal_grand_child__' + item.id"></view>
<text class="uni-text">{{item.label}}</text>
</view>
</scroll-view>
<scroll-view v-else direction="vertical" :scroll-top="data.scrollTop" :scroll-left="data.scrollLeft"
:upper-threshold="data.upperThreshold" :lower-threshold="data.lowerThreshold" :scroll-into-view="data.scrollIntoView"
:enable-back-to-top="data.enableBackToTop" :scroll-with-animation="data.scrollWithAnimation" :show-scrollbar="data.showScrollbar"
:bounces="data.bounces" @scrolltoupper="scrolltoupper" @touchmove="onTouchMove" @scrolltolower="scrolltolower"
@scroll="scroll" @scrollend="scrollend" ref="scrollViewYRef" id="scrollViewY" class="uni-margin-wrap">
<!-- v-margin-bottom末尾元素添加margin-bottom 测试bug #3866-->
<view class="item" :id="item.id" v-for="(item, index) in data.items" :class="index==9 ? 'v-margin-bottom': ''">
<view :id="'grand_child_' + item.id"></view>
<text class="uni-text">{{item.label}}</text>
</view>
</scroll-view>
<scroll-view class="uni-list">
<view class="uni-list-cell uni-list-cell-padding">
<text>点击状态栏回到顶部(仅iOS)</text>
<switch :checked="data.enableBackToTop" @change="data.enableBackToTop=!data.enableBackToTop"></switch>
</view>
<view class="uni-list-cell uni-list-cell-padding">
<text>是否显示滚动条</text>
<switch :checked="data.showScrollbar" @change="data.showScrollbar=!data.showScrollbar"></switch>
</view>
<view class="uni-list-cell uni-list-cell-padding">
<text>是否有反弹效果</text>
<switch :checked="data.bounces" @change="data.bounces=!data.bounces"></switch>
</view>
<view class="uni-list-cell uni-list-cell-padding">
<text>是否开启滚动时使用动画过渡</text>
<switch :checked="data.scrollWithAnimation" @change="data.scrollWithAnimation=!data.scrollWithAnimation"></switch>
</view>
<view class="uni-list-cell uni-list-cell-padding">
<text>是否横向滚动</text>
<switch :checked="data.scrollX" @change="changeDirectionX"></switch>
</view>
<view class="uni-list-cell uni-list-cell-padding">
<text>是否竖向滚动</text>
<switch :checked="data.scrollY" @change="changeDirectionY"></switch>
</view>
<view class="uni-slider uni-list-cell-padding">
<text>拖动设置scroll-top</text>
</view>
<view class="uni-slider uni-list-cell-padding">
<slider :max="1000" :min="0" :step="10" :value="data.scrollTop" :show-value="true" @change="handleChangeScrollTop" />
</view>
<view class="uni-slider uni-list-cell-padding">
<text>拖动设置scroll-left</text>
</view>
<view class="uni-slider uni-list-cell-padding">
<slider :max="1000" :min="0" :step="10" :value="data.scrollLeft" :show-value="true"
@change="handleChangeScrollLeft" />
</view>
<view class="uni-list-cell uni-list-cell-padding">
<text>设置触发scrolltoupper的距离</text>
<input class="uni-list-cell-input" type="number" :value="data.upperThreshold" @input="handleUpperThresholdInput" />
</view>
<view class="uni-list-cell uni-list-cell-padding">
<text>设置触发scrolltolower的距离</text>
<input class="uni-list-cell-input" type="number" :value="data.lowerThreshold" @input="handleLowerThresholdInput" />
</view>
<view class="uni-list-cell uni-list-cell-padding">
<button type="primary" class="button" @click="handleScrollIntoView">
滚动到id为`item3`的子视图
</button>
</view>
<view class="uni-list-cell uni-list-cell-padding">
</view>
</scroll-view>
<!-- </view> -->
</template>
<script setup lang="uts">
type Item = {
id : string,
label : string,
}
type DataType = {
items: Item[],
scrollX: boolean,
scrollY: boolean,
bounces: boolean,
scrollTop: number,
scrollLeft: number,
scrollChangeTop: number,
scrollIntoView: string,
enableBackToTop: boolean,
scrollWithAnimation: boolean,
showScrollbar: boolean,
upperThreshold: number,
lowerThreshold: number,
}
// 使用reactive包装数据,便于自动化测试获取
const data = reactive({
items: [] as Item[],
scrollX: false,
scrollY: true,
bounces: false,
scrollTop: 0,
scrollLeft: 0,
scrollChangeTop: 0,
scrollIntoView: "",
enableBackToTop: false,
scrollWithAnimation: false,
showScrollbar: true,
upperThreshold: 50,
lowerThreshold: 50,
} as DataType)
const scrollViewXRef = ref<UniScrollViewElement | null>(null)
const scrollViewYRef = ref<UniScrollViewElement | null>(null)
// Methods
function handleChangeScrollLeft(e : UniSliderChangeEvent) {
data.scrollLeft = e.detail.value
}
function handleChangeScrollTop(e : UniSliderChangeEvent) {
data.scrollTop = e.detail.value
}
function changeDirectionX() {
data.scrollX = !data.scrollX
if (data.scrollX) {
data.scrollY = false
}
data.scrollTop = 0
data.scrollLeft = 0
}
function changeDirectionY() {
data.scrollY = !data.scrollY
if (data.scrollY) {
data.scrollX = false
}
data.scrollTop = 0
data.scrollLeft = 0
}
function handleScrollIntoView() {
if (data.scrollX) {
data.scrollIntoView = "horizontal_item3"
} else {
data.scrollIntoView = "item3"
}
setTimeout(() => {
data.scrollIntoView = ""
}, 0)
}
function handleUpperThresholdInput(e : InputEvent) {
const value = e.detail.value
if (value == "") {
data.upperThreshold = 50
} else {
data.upperThreshold = parseInt(e.detail.value)
}
}
function handleLowerThresholdInput(e : InputEvent) {
const value = e.detail.value
if (value == "") {
data.lowerThreshold = 50
} else {
data.lowerThreshold = parseInt(e.detail.value)
}
}
function scrolltoupper() {
console.log("滚动到顶部")
}
function scrolltolower() {
console.log("滚动到底部")
}
function scroll(e : ScrollEvent) {
data.scrollChangeTop = e.detail.scrollTop
console.log("scroll-top : " + e.detail.scrollTop + " scroll-left : " + e.detail.scrollLeft)
}
function scrollend() {
console.log("滚动停止")
}
function onTouchMove() {
console.log("TouchMove")
}
function checkScrollHeight() : Boolean {
var element = scrollViewYRef.value
if (element != null) {
var scrollHeight = element.scrollHeight
console.log("checkScrollHeight" + scrollHeight)
if (scrollHeight > 1900) {
return true
}
}
return false
}
function checkScrollWidth() : Boolean {
var element = scrollViewXRef.value
if (element != null) {
var scrollWidth = element.scrollWidth
console.log("checkScrollWidth---" + scrollWidth)
if (scrollWidth > 1900) {
return true
}
}
return false
}
// Lifecycle
onLoad((options : OnLoadOptions) => {
for (let i = 0; i < 10; i++) {
const item = {
id: "item" + i,
label: "item" + i,
} as Item
data.items.push(item)
}
})
defineExpose({
data,
checkScrollHeight,
checkScrollWidth
})
</script>
<style>
.uni-margin-wrap {
height: 250px;
margin: 0 25px 25px 25px;
}
.item {
justify-content: center;
align-items: center;
height: 250px;
width: 100%;
background-color: azure;
border-width: 1px;
border-style: solid;
border-color: chocolate;
}
.uni-list {
flex: 1;
}
.uni-text {
color: black;
font-size: 50px;
}
.uni-slider {
justify-content: center;
}
.uni-list-cell-input {
width: 50px;
border: 1px solid #ccc;
text-align: center;
}
.button {
flex: 1;
}
/*自动化测试专用*/
.v-margin-bottom {
margin-bottom: 50px;
}
/*自动化测试专用*/
.h-margin-right {
margin-right: 50px;
}
</style>

查看文件

@@ -0,0 +1,74 @@
jest.setTimeout(30000)
const PAGE_PATH = '/pages/component/scroll-view/scroll-view-refresher-props'
const platformInfo = process.env.uniTestPlatformInfo.toLocaleLowerCase()
const isMP = platformInfo.startsWith('mp')
const isAndroid = platformInfo.startsWith('android')
const isVapor = process.env.UNI_APP_X_DOM2 === 'true'
describe('scroll-view-refresher-props', () => {
if (isMP) {
it('skip', () => {
expect(1).toBe(1)
})
return
}
let page
async function performPullRefresh(pullDistance = 180, offsetY = 10) {
const rect = await page.callMethod('getBoundingClientRectForTest')
const windowInfo = await program.callUniMethod('getWindowInfo')
const startX = Math.round(rect.left + rect.width / 2)
const startY = Math.round(rect.top + offsetY + windowInfo.safeAreaInsets.top + 44)
const endY = Math.round(startY + pullDistance)
await program.swipe({
startPoint: {
x: startX,
y: startY
},
endPoint: {
x: startX,
y: endY
},
duration: 500
})
await page.waitFor(800)
}
beforeAll(async () => {
page = await program.reLaunch(PAGE_PATH)
await page.waitFor('view')
await page.waitFor(500)
})
it('screenshot', async () => {
const image = await program.screenshot({ fullPage: true })
expect(image).toSaveImageSnapshot()
})
if (isAndroid && isVapor) {
beforeEach(async () => {
await page.callMethod('resetAndroidOverscrollForTest')
await page.waitFor(100)
})
it('check_android_overscroll', async () => {
await page.callMethod('setAndroidOverscrollForTest', true)
await page.callMethod('setRefresherEnabledForTest', false)
await page.waitFor(100)
expect(await page.callMethod('getAndroidOverscrollForTest')).toBe(true)
expect(await page.callMethod('getRefresherRefreshCountForTest')).toBe(0)
await performPullRefresh()
expect(await page.callMethod('getAndroidOverscrollForTest')).toBe(true)
expect(await page.callMethod('getRefresherRefreshCountForTest')).toBe(0)
})
}
})

查看文件

@@ -0,0 +1,307 @@
<template>
<!-- #ifdef APP -->
<view class="page-scroll-view">
<!-- #endif -->
<page-head title="下拉刷新的scroll-view属性示例"></page-head>
<view class="uni-margin-wrap">
<scroll-view id="refresher-scroll-view" direction="vertical" :bounces="bounces" :refresher-enabled="refresherEnabled" :refresher-threshold="refresherThreshold"
:refresher-default-style="refresherDefaultStyle" :refresher-background="refresherBackground"
<!-- #ifdef APP-ANDROID && VUE3-VAPOR -->
:android-overscroll="androidOverscroll"
<!-- #endif -->
:refresher-triggered="refresherTriggered" @refresherpulling="refresherpulling"
@refresherrefresh="refresherrefresh" @refresherrestore="refresherrestore" @refresherabort="refresherabort"
style="width: 100%;height: 100%;">
<view class="item" :id="item.id" v-for="(item,_) in items">
<text class="uni-text">{{item.label}}</text>
</view>
</scroll-view>
</view>
<scroll-view class="uni-list" style="padding-top: 16px;">
<view class="uni-list-cell-padding">
<text class="refresher-tips">**下拉刷新的属性设置需要先打开下拉刷新开关**</text>
</view>
<view class="uni-list-cell uni-list-cell-padding">
<text>是否开启下拉刷新</text>
<switch :checked="refresherEnabled" @change="handleTrunOnRefresher"></switch>
</view>
<view class="uni-list-cell uni-list-cell-padding">
<text>设置下拉刷新状态</text>
<switch :disabled="!refresherEnabled" :checked="refresherTriggered"
@change="refresherTriggered=!refresherTriggered"></switch>
</view>
<view class="uni-list-cell uni-list-cell-padding">
<text>是否开启回弹效果</text>
<switch :checked="bounces" @change="handleBouncesChange"></switch>
</view>
<!-- #ifdef APP-ANDROID && VUE3-VAPOR -->
<view class="uni-list-cell uni-list-cell-padding">
<text>是否开启弹簧回弹效果</text>
<switch :checked="androidOverscroll" @change="handleAndroidOverscrollChange"></switch>
</view>
<!-- #endif -->
<view class="uni-list-cell uni-list-cell-padding">
<text>设置下拉刷新阈值</text>
<input class="uni-list-cell-input" :disabled="!refresherEnabled" :value="refresherThreshold" type="number"
@input="handleRefresherThresholdInput" />
</view>
<view class="uni-list-cell-padding">
<text>设置下拉刷新区域背景颜色</text>
<text class="refresher-background-value">当前值:{{ refresherBackground }}</text>
<radio-group class="refresher-background-group" @change="handleRefresherBackgroundChange">
<radio v-for="(option, _) in refresherBackgroundOptions" class="refresher-background-radio"
:value="option.value" :checked="refresherBackground == option.value" :disabled="!refresherEnabled">{{ option.label }}</radio>
</radio-group>
</view>
<view class="uni-list-cell-padding">
<text>设置下拉刷新默认样式</text>
<text class="refresher-background-value">当前值:{{ refresherDefaultStyle }}</text>
<radio-group class="refresher-background-group" @change="handleRefresherDefaultStyleChange">
<radio v-for="(option, _) in refresherStyleOptions" class="refresher-background-radio"
:value="option.value" :checked="refresherDefaultStyle == option.value" :disabled="!refresherEnabled">{{ option.label }}</radio>
</radio-group>
</view>
</scroll-view>
<!-- #ifdef APP -->
</view>
<!-- #endif -->
</template>
<script setup lang="uts">
type Item = {
id : string,
label : string,
}
type RefresherBackgroundOption = {
label : string,
value : string,
}
type RefresherStyleOption = {
label : string,
value : string,
}
const items = ref<Item[]>([])
const bounces = ref(true)
const refresherEnabled = ref(true)
const refresherTriggered = ref(false)
const androidOverscroll = ref(false)
const refresherRefreshCount = ref(0)
const refresherThreshold = ref(45)
const refresherDefaultStyle = ref("black")
const refresherBackground = ref("transparent")
const refresherBackgroundOptions : RefresherBackgroundOption[] = [
{
label: "透明",
value: "transparent"
},
{
label: "白色",
value: "#ffffff"
},
{
label: "灰色",
value: "#8f8f8f"
},
{
label: "蓝色",
value: "#0000ff"
}
]
const refresherStyleOptions : RefresherStyleOption[] = [
{
label: "none",
value: "none"
},
{
label: "black",
value: "black"
},
{
label: "white",
value: "white"
}
]
onLoad(() => {
for (let i = 0; i < 10; i++) {
const item : Item = {
id: "item" + i,
label: "item" + i,
}
items.value.push(item);
}
})
function handleTrunOnRefresher() {
refresherTriggered.value = false;
//不能同时关闭下拉状态和关闭下拉刷新。
setTimeout(() => {
refresherEnabled.value = !refresherEnabled.value;
}, 0)
}
function handleRefresherThresholdInput(e : InputEvent) {
const value = e.detail.value;
if (value == "") {
refresherThreshold.value = 45;
} else {
refresherThreshold.value = parseInt(e.detail.value);
}
}
function handleAndroidOverscrollChange() {
androidOverscroll.value = !androidOverscroll.value;
}
function handleBouncesChange() {
bounces.value = !bounces.value
}
function handleRefresherBackgroundChange(event : UniRadioGroupChangeEvent) {
refresherBackground.value = event.detail.value;
}
function handleRefresherDefaultStyleChange(event : UniRadioGroupChangeEvent) {
refresherDefaultStyle.value = event.detail.value;
}
//响应事件
function refresherpulling() {
console.log("下拉刷新控件被下拉");
}
function refresherrefresh() {
console.log("下拉刷新被触发");
refresherRefreshCount.value += 1
refresherTriggered.value = true;
//不能同时关闭下拉状态和关闭下拉刷新。
setTimeout(() => {
refresherTriggered.value = false;
}, 1500)
}
function refresherrestore() {
console.log("下拉刷新被复位");
}
function refresherabort() {
console.log("下拉刷新被中止");
}
// 自动化测试专用
function toggleAndroidOverscrollForTest() {
handleAndroidOverscrollChange()
}
// 自动化测试专用
function setAndroidOverscrollForTest(value : boolean) {
androidOverscroll.value = value
}
// 自动化测试专用
function setRefresherEnabledForTest(value : boolean) {
refresherTriggered.value = false
refresherEnabled.value = value
}
// 自动化测试专用
function getAndroidOverscrollForTest() : boolean {
return androidOverscroll.value
}
// 自动化测试专用
function getRefresherRefreshCountForTest() : number {
return refresherRefreshCount.value
}
// 自动化测试专用
function getBoundingClientRectForTest() : DOMRect {
return uni.getElementById('refresher-scroll-view')?.getBoundingClientRect()!
}
// 自动化测试专用
function resetAndroidOverscrollForTest() {
androidOverscroll.value = false
refresherEnabled.value = true
refresherTriggered.value = false
refresherRefreshCount.value = 0
}
defineExpose({
getBoundingClientRectForTest,
getAndroidOverscrollForTest,
getRefresherRefreshCountForTest,
resetAndroidOverscrollForTest,
setAndroidOverscrollForTest,
setRefresherEnabledForTest,
toggleAndroidOverscrollForTest,
})
</script>
<style>
.uni-margin-wrap {
height: 200px;
margin: 0 25px 25px 25px;
}
.item {
justify-content: center;
align-items: center;
height: 200px;
width: 100%;
background-color: azure;
border-width: 1px;
border-style: solid;
border-color: chocolate;
}
.refresher-tips {
font-size: 12px;
text-align: center;
color: red;
}
.refresher-background-value {
margin-top: 8px;
font-size: 12px;
color: #666666;
}
.uni-text {
color: black;
font-size: 50px;
}
.uni-list {
flex: 1;
}
.uni-list-cell-input {
max-width: 100px;
border: 1px solid #ccc;
text-align: center;
}
.refresher-background-group {
flex-direction: row;
flex-wrap: wrap;
margin-top: 5px;
}
.refresher-background-radio {
margin-right: 12px;
margin-bottom: 8px;
}
</style>

查看文件

@@ -0,0 +1,107 @@
const platformInfo = process.env.uniTestPlatformInfo.toLocaleLowerCase()
const isAndroid = platformInfo.startsWith('android')
const isIos = platformInfo.startsWith('ios')
const isMP = platformInfo.startsWith('mp')
const isHarmony = platformInfo.startsWith('harmony')
const isAppWebView = process.env.UNI_AUTOMATOR_APP_WEBVIEW == 'true'
describe('component-native-scroll-view-refresher', () => {
if (isMP || isAppWebView) {
it('skip', () => {
expect(1).toBe(1)
})
return
}
if (process.env.UNI_TEST_DEVICES_DIRECTION == 'landscape') {
it('跳过横屏模式', () => {
expect(1).toBe(1)
})
return
}
let page;
async function setPageData(newData) {
return await page.setData({ data: newData });
}
beforeAll(async () => {
page = await program.reLaunch('/pages/component/scroll-view/scroll-view-refresher');
await page.waitFor(300);
});
it('scroll-view-refresher-screenshot', async () => {
//禁止滚动条
await setPageData({
showScrollbar: false
})
await page.waitFor(300);
const image = await program.screenshot({fullPage: true});
expect(image).toSaveImageSnapshot();
})
it('check_refresher_refresh_event', async () => {
await setPageData({
refresherTriggered: true
})
await page.waitFor(2000);
expect(await page.data('data.refresherrefreshTimes')).toBe(1)
// 手动设置下拉刷新状态refresher-triggered为true时,在web和iOS不触发@refresherpulling事件
if(isAndroid){
expect(await page.data('data.onRefresherpullingTest')).toBe('refresherpulling:Success')
expect(await page.data('data.refresherrefreshTest')).toBe('refresherrefresh:Success')
}
await page.waitFor(2000);
expect(await page.data('data.onRefresherrestoreTest')).toBe('refresherrestore:Success')
});
// 仅App端支持手势下拉刷新,在不同设备上位置有差异可能导致不触发中止事件
// 安卓端仅测'android 11.0.0'、'android 10.0.0_x86_64'、'android 10.0.0_x86'
if(isAndroid || isIos || isHarmony){
it('check_refresherabort', async () => {
if(isIos || isHarmony){
await program.swipe({
startPoint: {x: 100,y: 500},
endPoint: {x: 100,y: 630},
duration: 100
})
}else if(isAndroid){
await program.swipe({
startPoint: {x: 100,y: 400},
endPoint: {x: 100,y: 450},
duration: 1000
})
}
await page.waitFor(1500)
if(isIos || platformInfo.startsWith('android 10') || platformInfo.startsWith('android 11')){
expect(await page.data('data.onRefresherabortTest')).toBe('refresherabort:Success')
}
});
}
it('check_refresher_snapshot', async () => {
await setPageData({
refresherTriggered: true
})
await page.waitFor(300);
const image = await program.screenshot({fullPage: true});
expect(image).toSaveImageSnapshot();
await page.waitFor(1500);
});
//验证issues 16020bug问题
it('check_page_orientation_snapshot', async () => {
// if(isAndroid || isIos) {
if(isAndroid || isHarmony) {
await page.callMethod('setPageStyle', {pageOrientation: "landscape"})
await page.waitFor(800);
const image = await program.screenshot({fullPage: true});
expect(image).toSaveImageSnapshot();
await page.callMethod('setPageStyle', {pageOrientation: "portrait"})
await page.waitFor(800);
} else {
expect(1).toBe(1)
}
});
});

查看文件

@@ -0,0 +1,167 @@
<template>
<view class="container">
<page-head title="scroll-view 默认下拉刷新"></page-head>
<scroll-view class="scroll" refresher-enabled=true :refresher-triggered="data.refresherTriggered"
@refresherrefresh="onRefresherrefresh" @refresherabort="onRefresherabort" @refresherrestore="onRefresherrestore"
@refresherpulling="onRefresherpulling" @scrolltolower="onScrolltolower" :show-scrollbar="data.showScrollbar">
<view v-for="key in scrollData" :key="key">
<view class="scroll-item">
<text class="scroll-item-title">{{key}}</text>
</view>
</view>
</scroll-view>
</view>
</template>
<script setup lang="uts">
type RefresherEventTest = {
type : string;
target : UniElement | null;
currentTarget : UniElement | null;
dy : number;
}
type DataType = {
refresherTriggered: boolean,
refresherrefreshTimes: number,
showScrollbar: boolean,
refresherrefreshTest: string,
onRefresherabortTest: string,
onRefresherrestoreTest: string,
onRefresherpullingTest: string,
}
const scrollData = ref([] as Array<string>)
const refresherrefresh = ref(false)
const data = reactive({
refresherTriggered: false,
refresherrefreshTimes: 0,
showScrollbar: false,
refresherrefreshTest: "",
onRefresherabortTest: "",
onRefresherrestoreTest: "",
onRefresherpullingTest: "",
} as DataType)
// 自动化测试专用(由于事件event参数对象中存在循环引用,在ios端JSON.stringify报错,自动化测试无法page.data获取)
function checkEventTest(e : RefresherEventTest, eventName : String) {
// #ifndef MP
const isPass = e.type === eventName && e.target instanceof UniElement && e.currentTarget instanceof UniElement && e.dy > 0;
// #endif
// #ifdef MP
const isPass = true
// #endif
const result = isPass ? `${eventName}:Success` : `${eventName}:Fail`;
switch (eventName) {
case 'refresherrefresh':
data.refresherrefreshTest = result
break;
case 'refresherpulling':
data.onRefresherpullingTest = result
break;
case 'refresherrestore':
data.onRefresherrestoreTest = result
break;
case 'refresherabort':
data.onRefresherabortTest = result
break;
default:
break;
}
}
function onRefresherrefresh(e : UniRefresherEvent) {
refresherrefresh.value = true
console.log("onRefresherrefresh------下拉刷新触发")
checkEventTest({
type: e.type,
target: e.target,
currentTarget: e.currentTarget,
dy: e.detail.dy,
} as RefresherEventTest, 'refresherrefresh')
data.refresherTriggered = true
data.refresherrefreshTimes++
setTimeout(() => {
data.refresherTriggered = false
}, 1500)
}
function onRefresherabort(e : UniRefresherEvent) {
console.log("onRefresherabort------下拉刷新被中止")
checkEventTest({
type: e.type,
target: e.target,
currentTarget: e.currentTarget,
dy: e.detail.dy,
} as RefresherEventTest, 'refresherabort')
}
function onRefresherrestore(e : UniRefresherEvent) {
refresherrefresh.value = false
console.log("onRefresherrestore------下拉刷新被复位")
checkEventTest({
type: e.type,
target: e.target,
currentTarget: e.currentTarget,
dy: e.detail.dy,
} as RefresherEventTest, 'refresherrestore')
}
function onRefresherpulling(e : UniRefresherEvent) {
console.log("onRefresherpulling------下拉刷新控件被下拉-dy=" + e.detail.dy)
checkEventTest({
type: e.type,
target: e.target,
currentTarget: e.currentTarget,
dy: e.detail.dy,
} as RefresherEventTest, 'refresherpulling')
}
function onScrolltolower(e : UniScrollToLowerEvent) {
console.log("onScrolltolower 滚动到底部-----" + e.detail.direction)
}
//自动化测试专用
function setPageStyle(pageStyle: UTSJSONObject) {
const pages = getCurrentPages();
const currentPage = pages[pages.length - 1];
currentPage.setPageStyle(pageStyle);
}
onLoad(() => {
let lists : Array<string> = []
for (let i = 0; i < 20; i++) {
lists.push("item---" + i)
}
scrollData.value = lists
})
defineExpose({
data,
setPageStyle
})
</script>
<style>
.container {
flex: 1;
}
.scroll {
background-color: #eee;
/* position: relative; */
width: 100%;
flex: 1;
/* border-color: red; */
}
.scroll-item {
margin-left: 6px;
margin-right: 6px;
margin-top: 6px;
background-color: #fff;
}
.scroll-item-title {
width: 100%;
height: 60px;
line-height: 60px;
text-align: center;
color: #555;
}
</style>

查看文件

@@ -0,0 +1,109 @@
const platformInfo = process.env.uniTestPlatformInfo.toLocaleLowerCase()
const isMP = platformInfo.startsWith('mp')
const isWeb = platformInfo.startsWith('web')
const isHarmony = platformInfo.startsWith('harmony')
describe('component-native-scroll-view', () => {
if (isMP) {
it('skip', () => {
expect(1).toBe(1)
})
return
}
let page;
beforeAll(async () => {
page = await program.reLaunch('/pages/component/scroll-view/scroll-view');
await page.waitFor("view");
});
it('Event scroll-vertical',async()=>{
// 纵向滚动
await page.setData({data:{scrollTop: 100}})
await page.waitFor(1000)
// 设置top 是否触发scroll 事件
const topScrollDetail = await page.data('data.scrollDetailTest')
expect(topScrollDetail.scrollLeft).toBe(0)
// Android 差异scrollTop:99.809525
expect(topScrollDetail.scrollTop).toBeGreaterThan(99.5)
//expect([100, 99.809525]).toContain(topScrollDetail.scrollTop);
expect(topScrollDetail.scrollHeight).toBeGreaterThan(0)
expect(topScrollDetail.scrollWidth).toBeGreaterThan(0)
expect(topScrollDetail.deltaX).toBe(0)
// Harmony 差异 deltaY:最后可能为0
// expect(topScrollDetail.deltaY).not.toBe(0)
expect(await page.data('data.isScrollTest')).toBe('scroll:Success')
})
it('Event scroll-horizontal',async()=>{
// 横向滚动
await page.setData({data:{scrollLeft:220}})
await page.waitFor(1000)
//设置left 是否触发scroll 事件
const leftScrollDetail = await page.data('data.scrollDetailTest')
// Android 差异scrollLeft:219.80952
expect(leftScrollDetail.scrollLeft).toBeGreaterThan(219.5)
//expect([220, 219.80952]).toContain(leftScrollDetail.scrollLeft);
expect(leftScrollDetail.scrollTop).toBe(0)
expect(leftScrollDetail.scrollHeight).toBeGreaterThan(0)
expect(leftScrollDetail.scrollWidth).toBeGreaterThan(0)
// 在安卓差异 -99.809525
expect(leftScrollDetail.deltaX).toBeLessThan(-99.5)
//expect([-100, -99.809525]).toContain(leftScrollDetail.deltaX);
expect(leftScrollDetail.deltaY).toBe(0)
expect(await page.data('data.isScrollTest')).toBe('scroll:Success')
})
// 移后:此测试用例在某些mac-chrome会影响scroll-horizontal的deltaX结果
it('scroll-view-screenshot', async () => {
//禁止滚动条
await page.setData({
data:{showScrollbar: false}
})
await page.waitFor(1000);
const image = await program.screenshot({fullPage: true});
expect(image).toSaveImageSnapshot();
});
it('Event scrolltolower-滚动到底部/右边',async()=>{
// 滚动到底部scrollTop:300,是否触发scrolltolower事件
await page.setData({data:{scrollTop: 300}})
await page.waitFor(600)
expect(await page.data('data.isScrolltolowerTest')).toBe('scrolltolower:Success-bottom')
})
it('Event scrolltoupper-滚动到顶部/左边',async()=>{
// 滚动到顶部scrollTop: 0,是否触发scrolltoupper事件
await page.setData({data:{scrollTop: 0}})
// await page.callMethod('goTop')
await page.waitFor(600)
expect(await page.data('data.isScrolltoupperTest')).toBe('scrolltoupper:Success-top')
})
if(!isWeb && !isMP){
it('Event scrollend-滚动结束时触发仅App端支持',async()=>{
if(isHarmony) {
// 鸿蒙scrollEnd触发比较慢
await page.waitFor(500)
}
const endDetail = await page.data('data.scrollEndDetailTest')
expect(endDetail.scrollLeft).toBe(0)
expect(endDetail.scrollTop).toBe(0)
expect(endDetail.deltaY).toBe(0)
expect(endDetail.deltaX).toBe(0)
expect(endDetail.scrollHeight).toBeGreaterThan(0)
expect(endDetail.scrollWidth).toBeGreaterThan(0)
})
}
if(!isMP) {
it('通过UniElement.scrollBy检测scroll事件是否触发',async()=>{
await page.callMethod('setVerticalScrollBy', 120)
// Harmony 平台动画为1000毫秒 所以600毫秒可能未滚动到指定区域
await page.waitFor(1000)
const scrollDetail = await page.data('data.scrollDetailTest')
expect(scrollDetail.scrollTop).toBeGreaterThan(119)
})
}
});

查看文件

@@ -0,0 +1,263 @@
<template>
<!-- #ifdef APP && !VUE3-VAPOR -->
<scroll-view class="page-scroll-view">
<!-- #endif -->
<page-head title="scroll-view,区域滚动视图"></page-head>
<view class="uni-padding-wrap uni-common-mt">
<view class="uni-title uni-common-mt">
<text class="uni-title-text">Vertical Scroll</text>
<text class="uni-subtitle-text">纵向滚动</text>
</view>
<view>
<scroll-view :scroll-top="data.scrollTop" :direction="data.scrollDirection" class="scroll-Y" scroll-with-animation="true"
@scrolltoupper="upper" @scrolltolower="lower" @scroll="scroll" @scrollend="end"
:show-scrollbar="data.showScrollbar" id="verticalScrollView">
<view class="scroll-view-item uni-bg-red"><text class="text">A</text></view>
<view class="scroll-view-item uni-bg-green"><text class="text">B</text></view>
<view class="scroll-view-item uni-bg-blue"><text class="text">C</text></view>
</scroll-view>
</view>
<view @tap="goTop" class="uni-center uni-common-mt">
<text class="uni-link">点击这里返回顶部</text>
</view>
<boolean-data :defaultValue="false" title="是否禁用scroll-view滚动" @change="change_disabled_boolean"></boolean-data>
<view class="uni-title uni-common-mt">
<text class="uni-title-text">Horizontal Scroll</text>
<text class="uni-subtitle-text">横向滚动</text>
</view>
<view>
<scroll-view class="scroll-view_H" direction="horizontal" @scroll="scroll" @scrollend="end"
:scroll-left="data.scrollLeft" :show-scrollbar="data.showScrollbar">
<view class="scroll-view-item_H uni-bg-red"><text class="text">A</text></view>
<view class="scroll-view-item_H uni-bg-green"><text class="text">B</text></view>
<view class="scroll-view-item_H uni-bg-blue"><text class="text">C</text></view>
</scroll-view>
</view>
<text class="uni-title-text">scroll-view样式大合集</text>
<scroll-view class="scroll-view-style-demo" direction="vertical">
<view class="style-demo-item uni-bg-red"><text class="text">1</text></view>
<view class="style-demo-item uni-bg-green"><text class="text">2</text></view>
<view class="style-demo-item uni-bg-blue"><text class="text">3</text></view>
</scroll-view>
<navigator url="/pages/component/scroll-view/scroll-view-props" hover-class="none">
<button type="primary" class="button">
非下拉刷新的属性示例
</button>
</navigator>
<view class="uni-common-pb"></view>
<navigator url="/pages/component/scroll-view/scroll-view-refresher-props" hover-class="none">
<button type="primary" class="button">
下拉刷新的属性示例
</button>
</navigator>
<view class="uni-common-pb"></view>
<navigator url="/pages/component/scroll-view/scroll-view-refresher" hover-class="none">
<button type="primary" class="button"> 默认下拉刷新示例 </button>
</navigator>
<view class="uni-common-pb"></view>
<navigator url="/pages/component/scroll-view/scroll-view-custom-refresher-props" hover-class="none">
<button type="primary" class="button">
自定义下拉刷新示例
</button>
</navigator>
<view class="uni-common-pb"></view>
</view>
<!-- #ifdef APP && !VUE3-VAPOR -->
</scroll-view>
<!-- #endif -->
</template>
<script setup lang="uts">
type ScrollEventTest = {
type : string;
target : UniElement | null;
currentTarget : UniElement | null;
direction ?: string
}
type DataType = {
scrollTop: number;
oldScrollTop: number;
scrollLeft: number;
showScrollbar: boolean;
// 控制外层scroll-view的direction属性
scrollDirection: string;
// 自动化测试
isScrollTest: string;
isScrolltolowerTest: string;
isScrolltoupperTest: string;
scrollDetailTest: UniScrollEventDetail | null;
scrollEndDetailTest: UniScrollEventDetail | null;
}
const data = reactive({
scrollTop: 0,
oldScrollTop: 0,
scrollLeft: 120,
showScrollbar: true,
scrollDirection: "vertical",
// 自动化测试
isScrollTest: '',
isScrolltolowerTest: '',
isScrolltoupperTest: '',
scrollDetailTest: null as UniScrollEventDetail | null,
scrollEndDetailTest: null as UniScrollEventDetail | null,
} as DataType)
// 自动化测试专用(由于事件event参数对象中存在循环引用,在ios端JSON.stringify报错,自动化测试无法page.data获取)
const checkEventTest = (e : ScrollEventTest, eventName : String) => {
// #ifndef MP
const isPass = e.type === eventName && e.target instanceof UniElement && e.currentTarget instanceof UniElement;
// #endif
// #ifdef MP
const isPass = true
// #endif
const result = isPass ? `${eventName}:Success` : `${eventName}:Fail`;
switch (eventName) {
case 'scroll':
data.isScrollTest = result
break;
case 'scrolltolower':
data.isScrolltolowerTest = result + `-${e.direction}`
break;
case 'scrolltoupper':
data.isScrolltoupperTest = result + `-${e.direction}`
break;
default:
break;
}
}
const upper = (e : UniScrollToUpperEvent) => {
console.log('滚动到顶部/左边', e)
checkEventTest({
type: e.type,
target: e.target,
currentTarget: e.currentTarget,
direction: e.detail.direction,
} as ScrollEventTest, 'scrolltoupper')
}
const lower = (e : UniScrollToLowerEvent) => {
console.log('滚动到底部/右边', e)
checkEventTest({
type: e.type,
target: e.target,
currentTarget: e.currentTarget,
direction: e.detail.direction,
} as ScrollEventTest, 'scrolltolower')
}
const scroll = (e : UniScrollEvent) => {
data.scrollDetailTest = e.detail
checkEventTest({
type: e.type,
target: e.target,
currentTarget: e.currentTarget
} as ScrollEventTest, 'scroll')
data.oldScrollTop = e.detail.scrollTop
}
const end = (e : UniScrollEvent) => {
console.log('滚动结束时触发', e)
data.scrollEndDetailTest = e.detail
checkEventTest({
type: e.type,
target: e.target,
currentTarget: e.currentTarget
} as ScrollEventTest, 'scrollend')
}
const goTop = () => {
// 解决view层不同步的问题
data.scrollTop = data.oldScrollTop
nextTick(() => {
data.scrollTop = 0
})
uni.showToast({
icon: 'none',
title: '纵向滚动 scrollTop 值已被修改为 0',
})
}
// 自动化测试专用
const setVerticalScrollBy = (y : number) => {
const element = uni.getElementById("verticalScrollView")
if (element != null) {
element.scrollBy(0, y)
}
}
defineExpose({
data,
setVerticalScrollBy
})
const change_disabled_boolean = (disabled: boolean) => {
if(disabled) {
data.scrollDirection = "none"
} else {
data.scrollDirection = "vertical"
}
}
</script>
<style>
.scroll-Y {
height: 150px;
}
.scroll-view_H {
width: 100%;
flex-direction: row;
}
.scroll-view-item {
height: 150px;
justify-content: center;
align-items: center;
}
.scroll-view-item_H {
width: 100%;
height: 150px;
justify-content: center;
align-items: center;
}
.text {
font-size: 18px;
color: #ffffff;
}
.button {
margin-top: 15px;
}
.scroll-view-style-demo {
flex-direction: column;
justify-content: flex-start;
flex-wrap: nowrap;
align-items: center;
width: 90%;
height: 80px;
background-color: #e3f2fd;
background-image: linear-gradient(to right, #e3f2fd, #a9d5fa);
border: 1px solid #007aff;
border-radius: 4px;
margin: 10px;
padding: 10px;
display: flex;
opacity: 0.95;
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.15);
}
.style-demo-item {
width: 100px;
height: 80px;
}
</style>