.onAreaChange((oldValue: Area, newValue: Area) => {
this.textHeight = newValue.height as number
let ratio = Math.max(CommonConstants.SCROLL_HEIGHT / this.textHeight, 0)
this.rollingProgress = Math.floor(ratio * this.textBuffer.length)
}) .onDidScroll(() => {
let yOffset = this.scroller.currentOffset().yOffset
let ratio = Math.max((yOffset + CommonConstants.SCROLL_HEIGHT) / this.textHeight, 0)
this.rollingProgress = Math.floor(ratio * this.textBuffer.length)
}) @State @Watch('change') rollingProgress: number = 0
change() {
console.info(`rollingProgress: ${this.rollingProgress}`);
} 
滚动引起组件位置变化,组件位置变化时,onAreaChange事件的回调会被触发,导致滚动进度状态变量被重新初始化,进而导致UI不刷新的问题。建议改用onSizeChange事件,onSizeChange事件仅会响应由布局变化所导致的组件尺寸发生变化时的回调,不会随滚动触发。
将onAreaChange改为onSizeChange。
import { PromptAction } from '@kit.ArkUI';
import { util } from '@kit.ArkTS';
@Builder
export function readPageBuilder() {
ReadPage();
}
// 定义常量类,存放滚动区域的高度
class CommonConstants {
static readonly SCROLL_HEIGHT = 640;
}
// 定义标题组件
@Component
struct Title {
@Prop leftIcon: Resource | undefined = undefined;
@Prop rightIcon: Resource | undefined = undefined;
@Prop title: Resource | string;
@Prop titleFontsize: number;
@Consume('pathStack') pathStack: NavPathStack;
clickAction: () => void = () => {
};
build() {
Row() {
Row() {
if (this.leftIcon) {
Image(this.leftIcon)
.width(40)
.height(40)
.onClick(() => {
this.pathStack.pop();
});
}
Text(this.title)
.fontWeight(FontWeight.Bold)
.fontSize(this.titleFontsize)
.margin({ left: this.leftIcon ? 10 : 0 });
}
.justifyContent(FlexAlign.Start);
if (this.rightIcon) {
Image(this.rightIcon)
.width(40)
.height(40)
.onClick(() => {
this.clickAction();
});
}
}
.justifyContent(FlexAlign.SpaceBetween)
.width('100%')
.height(56)
.padding({ left: 16, right: 16 });
}
}
// 定义主页面样式
@Entry
@Component
struct ReadPage {
@StorageProp('topRectHeight') topRectHeight: number = 0;
@StorageProp('bottomRectHeight') bottomRectHeight: number = 0;
@Provide('pathStack') pathStack: NavPathStack = new NavPathStack();
@Provide('readChapterArray') readChapterArray: string[] = [];
@Provide('contents') contents: string[] = ['HarmonyOS背景'];
@Provide('ProgressValue') progressValue: number = 0;
@State rollingProgress: number = 0;
@State textBuffer: string = '';
@State textHeight: number = 1;
@State currentText: string = '';
promptAction: PromptAction = this.getUIContext().getPromptAction();
params: number[] = [];
chapterIndex: number = 0;
lastedLearnIndex: number = 0;
private scroller: Scroller = new Scroller;
private controller: TextController = new TextController();
aboutToAppear(): void {
this.params = this.pathStack.getParamByName('ReadPage') as number[];
this.chapterIndex = this.params[0];
this.lastedLearnIndex = this.chapterIndex;
this.readText('content.txt');
}
build() {
NavDestination() {
Column() {
Title({
leftIcon: $r('app.media.arrow_left'),
title: this.contents[0],
titleFontsize: 20
});
Row() {
Text('热爱学习')
.fontColor('#E6000000')
.fontWeight(FontWeight.Bold)
.fontSize(18);
}
.width('100%')
.justifyContent(FlexAlign.Start)
.padding({ left: 16, right: 16 })
.margin({ top: 24 });
Column() {
Scroll(this.scroller) {
Text('', { controller: this.controller }) {
Span(this.currentText.replace(/\n/g, '\n '));
}
.width('100%')
.fontSize(16)
.textIndent(30)
.textAlign(TextAlign.Start)
.padding({ top: 10 })
.onSizeChange((oldValue: SizeOptions, newValue: SizeOptions) => {
this.textHeight = newValue.height as number;
let ratio = Math.max(CommonConstants.SCROLL_HEIGHT / this.textHeight, 0);
this.rollingProgress = Math.floor(ratio * this.textBuffer.length);
});
}
.height(CommonConstants.SCROLL_HEIGHT)
.align(Alignment.Top)
.scrollBar(BarState.Off)
.onDidScroll(() => {
let yOffset = this.scroller.currentOffset().yOffset;
let ratio = Math.max((yOffset + CommonConstants.SCROLL_HEIGHT) / this.textHeight, 0);
this.rollingProgress = Math.floor(ratio * this.textBuffer.length);
})
.onReachEnd(() => {
this.promptAction.showToast({
message: '已完成',
textColor: '#0A59F7',
offset: { dx: 0, dy: 0 }
});
if (this.readChapterArray.indexOf(this.contents[this.chapterIndex]) === -1) {
this.readChapterArray.push(this.contents[this.chapterIndex]);
}
this.progressValue = Math.floor((this.readChapterArray.length / this.contents.length) * 100);
});
Text(this.rollingProgress + '/' + this.textBuffer.length)
.fontColor(Color.Grey)
.fontSize(16)
.textAlign(TextAlign.End)
.margin({ right: 20 })
.width('100%');
}
.borderRadius(16)
.backgroundColor(Color.White)
.padding({ left: 16, right: 16 })
.margin({
top: 10,
left: 16,
right: 16
});
}
.padding({ top: this.getUIContext().px2vp(this.topRectHeight) })
.backgroundColor('#F1F3F5');
}
.hideTitleBar(true)
.backgroundColor('#F1F3F5');
}
// 读取文本文章
private readText(path: string) {
let context = this.getUIContext().getHostContext() as Context;
let fileName: string = path;
context.resourceManager.getRawFileContent(fileName, (_err, value) => {
this.textBuffer = this.uint8ArrayToString(value);
this.currentText = this.textBuffer;
});
}
// 解码二进制数据
private uint8ArrayToString(u8Array: Uint8Array): string {
let desString = '';
if (u8Array && u8Array.length > 0) {
let textDecode = util.TextDecoder.create('utf-8');
desString = textDecode.decodeToString(u8Array);
}
return desString;
}
} 完整示例参考如下:
import { PromptAction } from '@kit.ArkUI';
import { util } from '@kit.ArkTS';
@Builder
export function readPageBuilder() {
ReadPage();
}
// 定义常量类,存放滚动区域的高度
class CommonConstants {
static readonly SCROLL_HEIGHT = 640;
}
// 定义标题组件
@Component
struct Title {
@Prop leftIcon: Resource | undefined = undefined;
@Prop rightIcon: Resource | undefined = undefined;
@Prop title: Resource | string;
@Prop titleFontsize: number;
@Consume('pathStack') pathStack: NavPathStack;
clickAction: () => void = () => {
};
build() {
Row() {
Row() {
if (this.leftIcon) {
Image(this.leftIcon)
.width(40)
.height(40)
.onClick(() => {
this.pathStack.pop();
});
}
Text(this.title)
.fontWeight(FontWeight.Bold)
.fontSize(this.titleFontsize)
.margin({ left: this.leftIcon ? 10 : 0 });
}
.justifyContent(FlexAlign.Start);
if (this.rightIcon) {
Image(this.rightIcon)
.width(40)
.height(40)
.onClick(() => {
this.clickAction();
});
}
}
.justifyContent(FlexAlign.SpaceBetween)
.width('100%')
.height(56)
.padding({ left: 16, right: 16 });
}
}
// 定义主页面样式
@Entry
@Component
struct ReadPage {
@StorageProp('topRectHeight') topRectHeight: number = 0;
@StorageProp('bottomRectHeight') bottomRectHeight: number = 0;
@Provide('pathStack') pathStack: NavPathStack = new NavPathStack();
@Provide('readChapterArray') readChapterArray: string[] = [];
@Provide('contents') contents: string[] = ['HarmonyOS背景'];
@Provide('ProgressValue') progressValue: number = 0;
@State rollingProgress: number = 0;
@State textBuffer: string = '';
@State textHeight: number = 1;
@State currentText: string = '';
promptAction: PromptAction = this.getUIContext().getPromptAction();
params: number[] = [];
chapterIndex: number = 0;
lastedLearnIndex: number = 0;
private scroller: Scroller = new Scroller;
private controller: TextController = new TextController();
aboutToAppear(): void {
this.params = this.pathStack.getParamByName('ReadPage') as number[];
this.chapterIndex = this.params[0];
this.lastedLearnIndex = this.chapterIndex;
this.readText('content.txt');
}
build() {
NavDestination() {
Column() {
Title({
leftIcon: $r('app.media.arrow_left'),
title: this.contents[0],
titleFontsize: 20
});
Row() {
Text('热爱学习')
.fontColor('#E6000000')
.fontWeight(FontWeight.Bold)
.fontSize(18);
}
.width('100%')
.justifyContent(FlexAlign.Start)
.padding({ left: 16, right: 16 })
.margin({ top: 24 });
Column() {
Scroll(this.scroller) {
Text('', { controller: this.controller }) {
Span(this.currentText.replace(/\n/g, '\n '));
}
.width('100%')
.fontSize(16)
.textIndent(30)
.textAlign(TextAlign.Start)
.padding({ top: 10 })
.onSizeChange((oldValue: SizeOptions, newValue: SizeOptions) => {
this.textHeight = newValue.height as number;
let ratio = Math.max(CommonConstants.SCROLL_HEIGHT / this.textHeight, 0);
this.rollingProgress = Math.floor(ratio * this.textBuffer.length);
});
}
.height(CommonConstants.SCROLL_HEIGHT)
.align(Alignment.Top)
.scrollBar(BarState.Off)
.onDidScroll(() => {
let yOffset = this.scroller.currentOffset().yOffset;
let ratio = Math.max((yOffset + CommonConstants.SCROLL_HEIGHT) / this.textHeight, 0);
this.rollingProgress = Math.floor(ratio * this.textBuffer.length);
})
.onReachEnd(() => {
this.promptAction.showToast({
message: '已完成',
textColor: '#0A59F7',
offset: { dx: 0, dy: 0 }
});
if (this.readChapterArray.indexOf(this.contents[this.chapterIndex]) === -1) {
this.readChapterArray.push(this.contents[this.chapterIndex]);
}
this.progressValue = Math.floor((this.readChapterArray.length / this.contents.length) * 100);
});
Text(this.rollingProgress + '/' + this.textBuffer.length)
.fontColor(Color.Grey)
.fontSize(16)
.textAlign(TextAlign.End)
.margin({ right: 20 })
.width('100%');
}
.borderRadius(16)
.backgroundColor(Color.White)
.padding({ left: 16, right: 16 })
.margin({
top: 10,
left: 16,
right: 16
});
}
.padding({ top: this.getUIContext().px2vp(this.topRectHeight) })
.backgroundColor('#F1F3F5');
}
.hideTitleBar(true)
.backgroundColor('#F1F3F5');
}
// 读取文本文章
private readText(path: string) {
let context = this.getUIContext().getHostContext() as Context;
let fileName: string = path;
context.resourceManager.getRawFileContent(fileName, (_err, value) => {
this.textBuffer = this.uint8ArrayToString(value);
this.currentText = this.textBuffer;
});
}
// 解码二进制数据
private uint8ArrayToString(u8Array: Uint8Array): string {
let desString = '';
if (u8Array && u8Array.length > 0) {
let textDecode = util.TextDecoder.create('utf-8');
desString = textDecode.decodeToString(u8Array);
}
return desString;
}
}