Tabs组件存在横向滑动的控制手势,当其内部嵌套Tabs或横向的List、Scroll、Swiper、Grid等滚动与滑动组件时,会产生横向滚动手势冲突,导致外部的Tabs无法横向切换。以Grid为例问题现象如下:

当Grid组件滑动到右侧底部时,预期触发Tabs从“首页1”切换到“首页2”,实际未触发。
List、Scroll、Grid滚动组件支持nestedScroll通用属性,可以设置滚动优先级。以Tabs嵌套横向滚动的Grid为例,在开启Tabs滑动切换的前提下给Grid设置嵌套滚动nestedScroll属性。
@Entry
@Component
struct TabsGridDemo {
tabsController: TabsController = new TabsController();
gridData: Resource[] = [];
@State selectIndex: number = 0;
@Builder
tabContent(nam: string, targetIndex: number) {
Text(nam)
.fontColor(this.selectIndex === targetIndex ? '#0a59f7' : '#99000000')
}
aboutToAppear(): void {
for (let i = 1; i <= 10; i++) {
this.gridData.push($r(`app.media.${i}`));
}
}
build() {
Column() {
Tabs({ controller: this.tabsController }) {
TabContent() {
Column() {
Grid() {
ForEach(this.gridData, (item: Resource) => {
GridItem() {
Image(item)
.height(150)
.width(150)
};
});
}
.height('25%')
.columnsGap(16)
.rowsTemplate('1fr')
// 设置Grid优先滚动
.nestedScroll({
scrollForward: NestedScrollMode.SELF_FIRST,
scrollBackward: NestedScrollMode.SELF_FIRST,
});
}
.width('100%')
.height('100%')
.padding({
left: 20
})
}.tabBar(this.tabContent('首页1', 0));
TabContent() {
}.tabBar(this.tabContent('首页2', 1));
}
.onSelected((index: number) => {
this.selectIndex = index;
})
}.height('100%').width('100%');
}
} @Entry
@Component
struct TabsSwiperDemo {
tabsController: TabsController = new TabsController();
swiperController: SwiperController = new SwiperController();
data: number[] = [1, 2, 3];
@State selectIndex: number = 0;
@Builder
tabContent(nam: string, targetIndex: number) {
Text(nam)
.fontColor(this.selectIndex === targetIndex ? '#0a59f7' : '#99000000')
}
build() {
Column() {
Tabs({ controller: this.tabsController }) {
TabContent() {
Text('首页的内容').fontSize(30);
}.tabBar(this.tabContent('首页', 0));
TabContent() {
// Swiper在第二个TabContent内。
Swiper(this.swiperController) {
ForEach(this.data, (item: number, index: number) => {
Text(item.toString())
.width('100%')
.height('100%')
.textAlign(TextAlign.Center)
.fontSize(30)
.gesture(
PanGesture()
.onActionStart(() => {
console.info('Pan start');
})
.onActionUpdate(() => {
console.info('Pan update');
})
.onActionEnd((event: GestureEvent) => {
// Swiper在Tabs第二页内采用if/else逻辑优先判定Swiper边缘滑动情况。
if (index === 0 && event.offsetX > 0) {
this.tabsController.changeIndex(0); // Swiper滑动到第一页继续右滑,Tabs控制器跳转到第一页。
} else if (index === (this.data.length - 1) && event.offsetX < 0) {
this.tabsController.changeIndex(2); // Swiper滑动到最后一页继续左滑,Tabs控制器跳转到第三页。
} else if (event.offsetX < 0) {
this.swiperController.showNext(); // Swiper控制器。
} else if (event.offsetX > 0) {
this.swiperController.showPrevious(); // Swiper控制器。
}
})
);
}, (item: string) => item);
};
}.tabBar(this.tabContent('发现', 1));
TabContent() {
Text('推荐的内容').fontSize(30);
}.tabBar(this.tabContent('推荐', 2));
TabContent() {
Text('我的内容').fontSize(30);
}.tabBar(this.tabContent('我的', 3));
}
.onSelected((index: number) => {
this.selectIndex = index;
})
}.width('100%').height('100%');
}
} @Entry
@Component
struct TabsTabsDemo {
tabsController: TabsController = new TabsController();
@State selectIndex0: number = 0; // 外部页签
@State selectIndex1: number = 0; // 内部页签
@Builder
tabContent0(nam: string, targetIndex: number) { // 外层Tab栏
Text(nam)
.fontColor(this.selectIndex0 === targetIndex ? '#0a59f7' : '#99000000')
}
@Builder
tabContent1(nam: string, targetIndex: number) { // 内层Tab栏
Text(nam)
.fontColor(this.selectIndex1 === targetIndex ? '#0a59f7' : '#99000000')
}
build() {
Column() {
Tabs({ controller: this.tabsController }) {
TabContent() {
Text('首页的内容').fontSize(30);
}.tabBar(this.tabContent0('首页', 0));
TabContent() {
Tabs({ barPosition: BarPosition.Start }) {
TabContent() {
Text('tab1').fontSize('30fp');
}.tabBar(this.tabContent1('tab1', 0))
.gesture(
PanGesture({ fingers: 1, distance: 1, direction: PanDirection.Right })
.onActionStart(() => {
console.info('Pan start');
})
.onActionEnd(() => {
this.tabsController.changeIndex(0);
})
);
// 中间的其它TabContent
TabContent() {
Text('tab2').fontSize('30fp');
}.tabBar(this.tabContent1('tab2', 1))
.gesture(
PanGesture({ fingers: 1, distance: 1, direction: PanDirection.Left })
.onActionStart(() => {
console.info('Pan start');
})
.onActionEnd(() => {
this.tabsController.changeIndex(2);
})
);
}
.onSelected((index: number) => {
this.selectIndex1 = index;
})
}.tabBar(this.tabContent0('发现', 1));
TabContent() {
Text('推荐的内容').fontSize(30);
}.tabBar(this.tabContent0('推荐', 2));
TabContent() {
Text('我的内容').fontSize(30);
}.tabBar(this.tabContent0('我的', 3));
}
.onSelected((index: number) => {
this.selectIndex0 = index;
})
}.width('100%').height('100%');
}
} 可以使用手势拦截增强解决Tabs多层嵌套滑动冲突问题。使用示例请参考嵌套场景下拦截内部容器手势,通过onGestureRecognizerJudgeBegin监听手势事件,内层Tabs到头/尾时拒绝手势传递,允许外层Tabs响应。
方案 | 局限性 | 本知识适用场景 | 拓展适用场景 |
|---|---|---|---|
方案一:基于滚动组件通用接口nestedScroll解决滚动冲突。 | 内部组件必须支持滚动与滑动组件的通用nestedScroll接口。 | Tabs嵌套List、Scroll、Grid组件。 | List、Scroll、Grid组件嵌套List、Scroll、Grid组件。 |
方案二:通过自定义手势判断PanGesture实现Tabs嵌套内部组件滚动逻辑判断。 | 内部为List、Scroll、Grid等组件时实现较麻烦。 | Tabs嵌套Swiper、Tabs组件。 | Swiper组件嵌套Swiper、Tabs组件。 |
方案三:使用onGestureRecognizerJudgeBegin拦截内部组件滑动。 | 不支持内部为Scroll、List、Grid组件。 | Tabs嵌套Swiper、Tabs组件。 | Swiper组件嵌套Swiper、Tabs组件。 |
综上所述,总结如下:
Q:Tabs嵌套Web组件出现左右滑动问题如何解决?
A:请参考Tabs组件嵌套Web,无法左右滑动中的解决方案。
Q:Tabs嵌套Scroll组件,如何实现每个TabContent页签中的Scroll容器可以垂直滑动,横向滑动时可以切换页签?
A:Tabs组件的vertical属性设置为false,scrollable属性设置为true,即可通过左右滑动页面内容切换页签。Scroll组件的scrollable属性设置为ScrollDirection.Vertical,可以竖直方向滚动其中内容。