更新记录

0.1.0（2026-09-02）

新版本发布，后续增加ios版本

0.1.0（2026-09-02）

• 首次发布。
• 支持打开 TXT 文本和本地 TXT 文件。
• 支持多种翻页效果、阅读样式配置和章节/页面导航。
• 支持页面变化和加载错误事件。

平台兼容性

uni-app(5.0)

yzj-read-view

基于 libreadview 0.0.5 的 Android TXT 原生阅读组件，支持覆盖、滑动、滚动和仿真翻页。

平台支持

插件不申请存储权限。使用 openFile 时，请传入应用本身有权读取的本地文件路径。

基础示例

以下示例适用于 pages 目录下的 App-Android nvue 页面。

<template>
  <view class="page">
    <yzj-read-view
      ref="reader"
      class="reader"
      effect="cover"
      :title-text-size="18"
      :content-text-size="16"
      :title-text-color="0xff333333"
      :content-text-color="0xff333333"
      :header-and-footer-text-color="0xff888888"
      :page-background-color="0xfffffdf8"
      :page-padding="16"
      :content-padding="0"
      @pagechange="onPageChange"
      @error="onError"
    />

    <view class="actions">
      <button @click="openText">打开文本</button>
      <button @click="nextPage">下一页</button>
    </view>
  </view>
</template>

<script>
const BOOK_TEXT = `第一章 开始阅读

这里是需要显示的 TXT 文本内容。

第二章 更多内容

阅读器会根据组件尺寸自动分页。`

export default {
  onReady() {
    this.openText()
  },
  methods: {
    openText() {
      const reader = this.$refs.reader
      if (reader != null) {
        reader.openText(BOOK_TEXT)
      }
    },
    openFile() {
      const reader = this.$refs.reader
      if (reader != null) {
        reader.openFile('/storage/emulated/0/Download/book.txt', 'UTF-8', 1, 1)
      }
    },
    nextPage() {
      const reader = this.$refs.reader
      if (reader != null) {
        reader.nextPage()
      }
    },
    onPageChange(payload) {
      const progress = JSON.parse(payload)
      console.log(`第 ${progress.chapterIndex} 章，第 ${progress.pageIndex} 页`)
    },
    onError(payload) {
      const error = JSON.parse(payload)
      console.error(error.code, error.message)
    }
  }
}
</script>

<style>
.reader {
  width: 750px;
  height: 900px;
}

.actions {
  display: flex;
  flex-direction: row;
}
</style>

openText 与 openFile 连续调用时，最后一次调用生效。

属性

属性变化后会自动同步到原生阅读视图。

效果参数

传入其他值时自动使用 cover。

方法

事件

原生事件参数是 JSON 字符串，使用前通过 JSON.parse 解析。

注意事项

• 组件必须设置明确的宽度和高度，否则原生阅读视图无法分页。
• openFile 支持普通绝对路径和 file:// URI，不支持 content:// URI。
• ibook-curl 在 Android 5.0、5.1 上存在上游兼容性风险，不建议在 API 21、22 设备启用。
• 当前版本只读取 TXT 文本，不提供 EPUB、书签、阅读进度持久化等能力。
• 同一页面可创建多个组件实例，各实例事件和资源相互隔离。