在这里插入图片描述
在这里插入图片描述

✨ 功能特性

  • 全诗收录 — 《木兰诗》全文 7 段,完整无缺
  • 逐段背诵 — 点击任意段落切换显示/隐藏,随时自测
  • 一键控制 — 「全部显示」/「全部隐藏」批量操作
  • 进度追踪 — 实时显示已掌握段数(如 5/7
  • 古典风格 — 宣纸底色、朱红点缀、古籍字体配色

🖼 界面预览

┌─────────────────────────────┐
│        木 兰 诗              │
│       —— 北朝民歌           │
│  点击段落切换显示/隐藏       │
├─────────────────────────────┤
│  [全部隐藏]      进度: 7/7  │
├─────────────────────────────┤
│ ┌─ 第一段 ──── [隐藏] ─┐   │
│ │ 唧唧复唧唧,木兰当户织。│   │
│ │ 不闻机杼声,唯闻女叹息。│   │
│ └─────────────────────────┘   │
│ ┌─ 第二段 ──── [隐藏] ─┐   │
│ │ 问女何所思,问女何所忆。│   │
│ │ ……                     │   │
│ └─────────────────────────┘   │
│             ……                │
└─────────────────────────────┘

🚀 快速开始

环境要求

  • DevEco Studio 5.0+
  • HarmonyOS SDK 5.0.0+
  • 支持 Phone 设备的模拟器或真机

运行步骤

# 1. 克隆项目
git clone https://github.com/your-username/mulan-poem-app.git

# 2. 用 DevEco Studio 打开项目根目录
#    File → Open → 选择 MyApplication 文件夹

# 3. 连接设备或启动模拟器

# 4. 点击运行 ▶

📁 项目结构

MyApplication/
├── AppScope/
│   └── app.json5                # 应用配置(bundleName、版本等)
├── entry/
│   └── src/main/ets/
│       ├── entryability/
│       │   └── EntryAbility.ets  # Ability 生命周期
│       └── pages/
│           └── Index.ets         # ★ 主页面:全部功能实现
│   └── src/main/resources/
│       └── base/element/
│           ├── string.json       # 字符串资源
│           ├── color.json        # 颜色资源
│           └── float.json        # 字号资源
├── oh-package.json5              # 依赖管理
└── README.md                     # 本文件

🧠 使用技巧

学习阶段 操作方法
初读 全部显示,通读全诗 2-3 遍
分段记忆 每次隐藏 1 段,尝试背诵,点击显示对照
整体背诵 点击「全部隐藏」,逐段回忆,逐段显示验证
巩固 隐藏后半段,重点背诵薄弱段落

🛠 技术实现

  • 框架: HarmonyOS ArkUI(ETS 语言)
  • 组件: List + ForEach 实现段落列表,@Builder 封装卡片组件
  • 状态管理: @State 驱动 hiddenFlags 数组,实时响应 UI 变化
  • 样式: 纯色主题,无第三方依赖

📄 《木兰诗》原文

唧唧复唧唧,木兰当户织。不闻机杼声,唯闻女叹息。

问女何所思,问女何所忆。女亦无所思,女亦无所忆。昨夜见军帖,可汗大点兵。军书十二卷,卷卷有爷名。阿爷无大儿,木兰无长兄。愿为市鞍马,从此替爷征。

东市买骏马,西市买鞍鞯,南市买辔头,北市买长鞭。旦辞爷娘去,暮宿黄河边。不闻爷娘唤女声,但闻黄河流水鸣溅溅。旦辞黄河去,暮至黑山头。不闻爷娘唤女声,但闻燕山胡骑鸣啾啾。

万里赴戎机,关山度若飞。朔气传金柝,寒光照铁衣。将军百战死,壮士十年归。

归来见天子,天子坐明堂。策勋十二转,赏赐百千强。可汗问所欲,木兰不用尚书郎。愿驰千里足,送儿还故乡。

爷娘闻女来,出郭相扶将。阿姊闻妹来,当户理红妆。小弟闻姊来,磨刀霍霍向猪羊。开我东阁门,坐我西阁床。脱我战时袍,著我旧时裳。当窗理云鬓,对镜帖花黄。出门看火伴,火伴皆惊忙。同行十二年,不知木兰是女郎。

雄兔脚扑朔,雌兔眼迷离。双兔傍地走,安能辨我是雄雌?


License: MIT
Author: Generated with ❤️ by AtomCode

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐