场景一:当Scroll组件嵌套Web组件滑动时,滑动冲突,如何处理?
场景二:Swiper组件嵌套Scroll组件,Scroll组件内再嵌套Web组件,Web页面内的markdown表格可以横向滑动,但触摸表格上下滑动时无法触发Scroll组件滑动。
Web组件和Scroll组件在同一页面时,会存在Web获取焦点,导致Scroll无法上下滑动。
解决思路是可以通过设置边界调节来屏蔽其中一个的滑动响应来实现避免冲突的效果。
可以在Scroll的onWillScroll事件中增加判断,在Scroll滑动到底部之前屏蔽所有Web响应,不过需要注意的是,如果Web本身也需要滑动的话,该方法不太适用,这种场景下可以使用方案二来处理冲突。
代码示例如下。
.onWillScroll(() => {
if (this.scroller.isAtEnd()) {
this.webEnable = true;
console.info(`webEnable: ${this.webEnable}`);
} else {
this.webEnable = false;
console.info(`webEnable: ${this.webEnable}`);
}
}); 代码运行效果图如下:

可以使用触摸测试控制来规避此种情况,请给显示在上层的节点设置hitTestBehavior为HitTestMode.Transparent。详情见参考文档。
代码示例如下。
.hitTestBehavior(HitTestMode.Transparent); // 自身和子节点均响应触摸测试,不会阻塞兄弟节点和祖先节点的触摸测试。
代码运行效果图如下:

在嵌套滚动组件时,可以通过设置"nestedScroll"属性来控制滚动顺序。
.nestedScroll({
scrollForward: NestedScrollMode.PARENT_FIRST, // 向前滚动父容器优先
scrollBackward: NestedScrollMode.SELF_FIRST // 向后滚动子组件优先
}); 代码运行效果图如下:

import { webview } from '@kit.ArkWeb';
@Component
struct Solution1 {
private scroller: Scroller = new Scroller();
private webController: webview.WebviewController = new webview.WebviewController();
@State webEnable: boolean = false;
build() {
Scroll(this.scroller) {
Column({ space: 20 }) {
Web({
// 开发者需根据需求替换src
src: $rawfile('ScrollWeb.html'),
controller: this.webController
})
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM])
.fileAccess(true)
.geolocationAccess(false)
.width('100%')
.height('100%')
.enabled(this.webEnable);
Row()
.height(150);
};
}
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM])
.width('100%')
.height('100%')
.backgroundColor('#F1F3F5')
.onWillScroll(() => {
if (this.scroller.isAtEnd()) {
this.webEnable = true;
console.info(`webEnable: ${this.webEnable}`);
} else {
this.webEnable = false;
console.info(`webEnable: ${this.webEnable}`);
}
});
}
}
@Component
struct Solution2 {
private scroller: Scroller = new Scroller();
private webController: webview.WebviewController = new webview.WebviewController();
build() {
Scroll(this.scroller) {
Column({ space: 20 }) {
Web({
// 开发者需根据需求替换src
src: $rawfile('ScrollWeb.html'),
controller: this.webController
})
.fileAccess(true)
.geolocationAccess(false)
.width('100%')
.height('100%')
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]);
Row()
.height(150);
};
}
.width('100%')
.height('100%')
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM])
.backgroundColor('#F1F3F5')
.hitTestBehavior(HitTestMode.Transparent); // 自身和子节点均响应触摸测试,不会阻塞兄弟节点和祖先节点的触摸测试。
}
}
@Component
struct Solution3 {
private scroller: Scroller = new Scroller();
private webController: webview.WebviewController = new webview.WebviewController();
build() {
Scroll(this.scroller) {
Column({ space: 20 }) {
Web({
// 开发者需根据需求替换src
src: $rawfile('ScrollWeb.html'),
controller: this.webController
})
.fileAccess(true)
.geolocationAccess(false)
.width('100%')
.height('100%')
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM])
.nestedScroll({
scrollForward: NestedScrollMode.PARENT_FIRST, // 向前滚动父容器优先
scrollBackward: NestedScrollMode.SELF_FIRST // 向后滚动子组件优先
});
Row()
.height(150);
};
}
.width('100%')
.height('100%')
.backgroundColor('#F1F3F5')
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]);
}
}
@Entry
@Component
struct TabsExample {
fontColor: string = '#182431';
selectedFontColor: string = '#007DFF';
@State currentIndex: number = 0;
@State selectedIndex: number = 0;
private controller: TabsController = new TabsController();
@Builder
tabBuilder(index: number, name: string) {
Column() {
Text(name)
.fontColor(this.selectedIndex === index ? this.selectedFontColor : this.fontColor)
.fontSize(16)
.fontWeight(this.selectedIndex === index ? 500 : 400)
.lineHeight(22)
.margin({ top: 17, bottom: 7 });
Divider()
.strokeWidth(2)
.color('#007DFF')
.opacity(this.selectedIndex === index ? 1 : 0);
}.width('100%');
}
build() {
Column() {
Tabs({ barPosition: BarPosition.Start, index: this.currentIndex, controller: this.controller }) {
TabContent() {
Solution1().expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]);
}
.tabBar(this.tabBuilder(0, '方案1'))
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]);
TabContent() {
Solution2().expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]);
}
.tabBar(this.tabBuilder(1, '方案2'))
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]);
TabContent() {
Solution3().expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]);
}
.tabBar(this.tabBuilder(2, '方案3'))
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]);
}
//.vertical(false)
//.barMode(BarMode.Fixed)
.barWidth(360)
.barHeight(56)
.animationDuration(400)
.onChange((index: number) => {
// currentIndex控制TabContent显示页签
this.currentIndex = index;
this.selectedIndex = index;
})
.onAnimationStart((index: number, targetIndex: number, event: TabsAnimationEvent) => {
if (index === targetIndex) {
return;
}
console.info(`event currentOffset ${event.currentOffset}`);
// selectedIndex控制自定义TabBar内Image和Text颜色切换
this.selectedIndex = targetIndex;
})
.width('100%')
.height('100%')
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]);
}
.width('100%')
.height('100%')
.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]);
}
} html页面代码:
<!-- index.html -->
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" id="viewport" content="width=device-width, initial-scale=1.0">
<style>
.lightgray {
background-color: #D1D1D6;
}
.midgray {
background-color: #C7C7CC;
}
.lightgray, .midgray {
font-size:16px;
height:200px;
text-align: center; /* 水平居中 */
line-height: 200px; /* 垂直居中(值等于容器高度) */
}
</style>
</head>
<body>
<div class="lightgray" >webArea</div>
<div class="midgray">webArea</div>
<div class="lightgray">webArea</div>
<div class="midgray">webArea</div>
<div class="lightgray">webArea</div>
<div class="midgray">webArea</div>
<div class="lightgray">webArea</div>
</body>
</html> Web页面内CSS样式中设置了overscroll-behavior: none属性,该属性会阻止滚动行为向外层容器传递,导致触摸表格上下滑动时无法触发Scroll组件滑动。在前端页面的table_content元素中删除overscroll-behavior: none属性即可恢复正常的滑动传递。
当两个可响应滑动的组件(如Web和Scroll)共存时,可能出现焦点抢占导致某一组件无法滑动的问题。
通过控制组件的交互响应优先级,避免冲突,主要有三类方案:
根据外部条件(如滚动位置)切换组件的交互状态,在需要某一组件响应时,禁用另一组件。
例:Scroll未滑到底部时禁用Web的交互,滑到底部后再启用Web。
通过设置组件的触摸测试行为(如hitTestBehavior),自身和子节点均响应触摸测试,不会阻塞兄弟节点和祖先节点的触摸测试。
例:给Scroll设置hitTestBehavior属性为HitTestMode.Transparent,使自身和子节点均可响应。
为嵌套的滚动组件配置滚动顺序规则(如nestedScroll),明确父/子组件的滚动优先级,按规则依次响应。
例:向前滚动时父组件优先,向后滚动时子组件优先。