在实际开发过程中,切换Tabs时通常会涉及内容视图的数据刷新。以下是常见的Tabs页面刷新场景:
场景 | 方案 |
|---|---|
场景一 | 方案一:基于事件总线(Emitter)的通信机制 方案二:基于状态共享(@Provider/@Consumer)的响应式通信 |
场景二 | 方案一:基于事件总线(Emitter)的通信机制 方案二:基于状态共享(@Provider/@Consumer)的响应式通信 方案三:基于自定义组件生命周期函数aboutToAppear实现 |
场景一:Tabs每次切换时,目标TabContent页面都请求数据刷新页面。
TabEmitterPage.ets代码如下:
import { emitter } from '@kit.BasicServicesKit';
@Entry
@Component
struct TabEmitterPage {
fontColor: string = '#182431';
selectedFontColor: string = '#007DFF';
@State selectedIndex: number = 0;
@Builder
tabBuilder(index: number) {
Column() {
Text(`Tab${index + 1}`)
.fontColor(this.selectedIndex === index ? this.selectedFontColor : this.fontColor)
.fontSize(20)
.fontWeight(500);
}.width('100%');
}
refreshTabContent(index: number) {
if (index === 0) {
// 事件携带的数据
let eventData: emitter.EventData = {
data: {}
};
// 通过emitter.emit('refreshTableOne')发送指定的事件
emitter.emit('refreshTableOne', eventData);
} else if (index === 1) {
// 事件携带的数据
let eventData: emitter.EventData = {
data: {}
};
// 通过emitter.emit('refreshTableTwo')发送指定的事件
emitter.emit('refreshTableTwo', eventData);
}
}
build() {
Tabs({ barPosition: BarPosition.End }) {
TabContent() {
Column() {
EmitterContentOne();
}.height('100%').width('100%')
.justifyContent(FlexAlign.Center);
}.tabBar(this.tabBuilder(0));
TabContent() {
Column() {
EmitterContentTwo();
}.height('100%').width('100%')
.justifyContent(FlexAlign.Center);
}.tabBar(this.tabBuilder(1));
}
.barHeight(56)
.onAnimationStart((index: number, targetIndex: number) => {
if (index === targetIndex) {
return;
}
this.selectedIndex = targetIndex; // selectedIndex控制自定义TabBar内Text颜色切换
this.refreshTabContent(targetIndex); // 在切换动画启动时发送刷新事件
}).width('100%').height('100%');
}
}
@Component
struct EmitterContentOne {
@State counter: number = 0;
aboutToAppear(): void {
// Tabs子组件通过emitter.on持续订阅该事件去刷新数据
emitter.on('refreshTableOne', () => {
this.counter += 1;
});
}
aboutToDisappear(): void {
emitter.off('refreshTableOne');
}
build() {
Text(`切换Tabs刷新数据${this.counter}`);
}
}
@Component
struct EmitterContentTwo {
@State text: string = 'A';
aboutToAppear(): void {
// Tabs子组件通过emitter.on持续订阅该事件去刷新数据
emitter.on('refreshTableTwo', () => {
this.text += 'A';
});
}
aboutToDisappear(): void {
emitter.off('refreshTableTwo');
}
build() {
Text(`切换Tabs刷新数据${this.text}`);
}
} ConsumerPage.ets代码如下:
@Entry
@Component
struct ConsumerPage {
fontColor: string = '#182431';
selectedFontColor: string = '#007DFF';
@Provide('refreshNumber') refreshNumber: number = 0; // 记录要刷新的子页
@State selectedIndex: number = 0;
@Builder
tabBuilder(index: number) {
Column() {
Text(`Tab${index + 1}`)
.fontColor(this.selectedIndex === index ? this.selectedFontColor : this.fontColor)
.fontSize(20)
.fontWeight(500);
}.width('100%');
}
build() {
Tabs({ barPosition: BarPosition.End }) {
TabContent() {
Column() {
ConsumerContentOne({ index: 0 });
}.height('100%').width('100%')
.justifyContent(FlexAlign.Center);
}.tabBar(this.tabBuilder(0));
TabContent() {
Column() {
ConsumerContentTwo({ index: 1 });
}.height('100%').width('100%')
.justifyContent(FlexAlign.Center);
}.tabBar(this.tabBuilder(1));
}
.barHeight(56)
.onAnimationStart((index: number, targetIndex: number) => {
if (index === targetIndex) {
console.info(`onAnimationStart ${index} ${targetIndex}`);
return;
}
this.selectedIndex = targetIndex; // selectedIndex控制自定义TabBar内Text颜色切换
this.refreshNumber = targetIndex; // 更新目标页签,触发刷新
})
.width('100%')
.height('100%');
}
}
@Component
struct ConsumerContentOne {
index: number = 0; // 记录当前子页的页签序号
@State counter: number = 0;
@Consume('refreshNumber') @Watch('refresh') refreshNumber: number;
refresh() {
// 目标页签是当前子页
if (this.index === this.refreshNumber) {
// 在此进行网络请求
this.counter += 1; // 刷新数据
}
}
build() {
Text(`切换Tabs刷新数据${this.counter}`);
}
}
@Component
struct ConsumerContentTwo {
index: number = 0; // 记录当前子页的页签序号
@State text: string = 'A';
@Consume('refreshNumber') @Watch('refresh') refreshNumber: number;
refresh() {
// 目标页签是当前子页
if (this.index === this.refreshNumber) {
// 在此进行网络请求
this.text += 'A'; // 刷新数据
}
}
build() {
Text(`切换Tabs刷新数据${this.text}`);
}
} 场景二:TabContent仅在首次显示时请求数据并刷新页面,后续切换回该TabContent时不再重复请求。
示例如下:对ConsumerPage.ets中的ConsumerContentTwo组件做如下修改后,则该子组件只会刷新一次。
@Component
export struct ConsumerContentTwo {
enableFresh: boolean = true;
index: number = 0; // 记录当前子页的页签序号
@State text: string = 'A';
@Consume('refreshNumber') @Watch('refresh') refreshNumber: number;
refresh() {
// 目标页签是当前子页
if (this.enableFresh && this.index === this.refreshNumber) {
// 在此进行网络请求
this.text += 'A'; // 刷新数据
this.enableFresh = false;
}
}
build() {
Text(`切换Tabs刷新数据${this.text}`);
}
} Q:Tab中其嵌套Web页面,在Web页面的onPageShow添加页面刷新不生效?
A:在TabContent里面的子组件不会回调onPageShow方法,参考上述方案刷新TabContent子页。
Q:为什么数据在页签切换时没有立即更新,在切换完成后页面才刷新数据?
A:Tabs的onChange事件是在页面切换之后才开始执行的,所以会出现数据未及时的情况。可以将刷新的逻辑放在onAnimationStart或onSelected中执行。
Q:数据dataSource已经改变了,但是页面没有刷新?
A:根据dataSource所使用的装饰器,查看官网文档中此装饰器对应限制条件。并按状态变量改变不触发组件刷新问题常用定位方法进行排查。
Q:为什么TabContent切换时,布局会变动,页面内容闪烁?
A:在设置根组件的justifyContent属性时,使用了和页签索引绑定的@State状态变量,所以页签切换时,TabContent会重绘。