输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
API参考
高级筛选
API version全部版本
设备全部
元服务API集不筛选
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
API参考应用服务Reader Kit（阅读服务）ArkTS组件ReadPageComponent（阅读页组件）

ReadPageComponent（阅读页组件）

更新时间: 2026-06-12 06:54
本文导读

本模块提供ReadPageComponent组件，HarmonyOS应用通过集成该组件可快速构建书籍阅读功能。

起始版本： 5.0.4(16)

导入模块

PhonePC/2in1Tablet
收起
自动换行
深色代码主题
复制
  1. import { ReadPageComponent } from '@kit.ReaderKit';

ReadPageComponent

PhonePC/2in1Tablet

阅读页组件，支持对书籍排版内容的显示、多种翻页交互和翻页动效，以及翻页阅读过程中阅读器所需要的进度、行为感知能力。

说明

  • 支持根据阅读排版设置ReaderSetting对书籍内容进行按页进行排版、渲染。

  • 支持适配不同的设备屏幕尺寸（Phone、PC/2in1、Tablet，包括横竖屏适配），并在此基础上支持通过点击、滑动的方式进行阅读交互，支持仿真、横滑翻页方式（包括翻页过程动效）。

  • 支持排版结果通知能力，打开书籍或者触发翻页后按页提供当前页的排版结果信息PageDataInfo。

装饰器类型： @Component

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.4(16)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Reader.ReaderService.ReaderCore

起始版本： 5.0.4(16)

参数：

展开
参数名 类型 装饰器类型 说明
controller ReaderComponentController _ ReadPageComponent控制器。
readerCallback AsyncCallback<readerCore.ReaderComponentController> _ 回调函数。

build

PhonePC/2in1Tablet

build(): void

用于创建ReadPageComponent对象的构造函数。

模型约束： 此接口仅可在Stage模型下使用。

元服务API： 从版本5.0.4(16)开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Reader.ReaderService.ReaderCore

起始版本： 5.0.4(16)

示例：

收起
自动换行
深色代码主题
复制
  1. import { bookParser, readerCore, ReadPageComponent } from '@kit.ReaderKit';
  2. import { common } from '@kit.AbilityKit';
  3. import { hilog } from '@kit.PerformanceAnalysisKit';
  4. import { BusinessError } from '@kit.BasicServicesKit';
  5. 

  6. @Entry
  7. @Component
  8. struct Reader {
  9.   private readerComponentController: readerCore.ReaderComponentController = new readerCore.ReaderComponentController();
  10. 

  11.   aboutToAppear(): void {
  12.     this.init();
  13.   }
  14. 

  15.   private async init() {
  16.     // 通过提前导入到应用沙箱目录中的书籍文件，初始化书籍解析器
  17.     let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  18.     let filePath: string = `${context.filesDir}/abc.epub`;
  19.     let bookParserHandler: bookParser.BookParserHandler = await bookParser.getDefaultHandler(filePath);
  20.     let spineList: bookParser.SpineItem[] = bookParserHandler.getSpineList();
  21.     let spineIndex: number = spineList[0].index;
  22.     let domPos: string = '';
  23. 

  24.     await this.readerComponentController.init(context);
  25.     this.readerComponentController.registerBookParser(bookParserHandler);
  26.     this.readerComponentController.startPlay(spineIndex || 0, domPos);
  27.     hilog.info(0x0000, 'testTag', `startPlay succeeded`);
  28.   }
  29. 

  30.   aboutToDisappear(): void {
  31.     this.readerComponentController.releaseBook();
  32.   }
  33. 

  34.   build() {
  35.     Stack() {
  36.       ReadPageComponent({
  37.         controller: this.readerComponentController,
  38.         readerCallback: (err: BusinessError, data: readerCore.ReaderComponentController) => {
  39.           this.readerComponentController = data;
  40.         }
  41.       })
  42.     }.width('100%').height('100%').onClick(() => {
  43.       // 支持在此实现点击拉起菜单栏功能
  44.     })
  45.   }
  46. }
ArkTS组件
ArkTS API错误码
相关推荐
文档构建阅读器
文档readerCore（阅读核心能力）
文档PdfView（PDF预览组件）
文档Reader Kit简介
文档FunctionalInput（Input组件）
文档functionalInputComponentManager(场景化融合Input组件管理)
文档音量键翻页
文档无障碍读屏
文档小说阅读自动翻页
文档阅读翻页方式调节
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 API参考 中进行搜索
请输入您想要搜索的关键词