95 lines
3.1 KiB
Markdown
95 lines
3.1 KiB
Markdown
# 玫瑰日图标设计
|
||
|
||
## 背景
|
||
|
||
在日历单元格上为每年 **10 月 16 日** 增加一个小玫瑰图标，作为纪念日标识。实现方式参考已有的生日皇冠图标配置。
|
||
|
||
## 目标
|
||
|
||
- 每年 10 月 16 日的单元格左上角显示玫瑰图标。
|
||
- 与生日皇冠共用同一套渲染位置、尺寸和点击动画。
|
||
- 若 10 月 16 日同时命中生日，优先显示玫瑰图标。
|
||
- 不引入额外的无障碍文本，图标仅作为视觉装饰。
|
||
|
||
## 方案选择
|
||
|
||
采用**方案一：沿用生日模式做最小扩展**。理由：
|
||
|
||
- 与现有生日代码完全同构，改动最小；
|
||
- 符合用户“参考已有生日的配置”的要求；
|
||
- 可读性最好，降低维护者理解成本。
|
||
|
||
## 详细设计
|
||
|
||
### 数据层
|
||
|
||
文件：`core/src/main/kotlin/plus/rua/project/LunarCache.kt`
|
||
|
||
在 `DayCellInfo` 中新增字段：
|
||
|
||
```kotlin
|
||
data class DayCellInfo(
|
||
val annotationText: String,
|
||
val isAnnotationHighlight: Boolean,
|
||
val holidayBadge: String?,
|
||
val lunarMonthName: String? = null,
|
||
val isBirthday: Boolean = false,
|
||
val isRoseDay: Boolean = false,
|
||
)
|
||
```
|
||
|
||
在 `LunarCache.compute()` 中加入玫瑰日判断：
|
||
|
||
```kotlin
|
||
val isRoseDay = date.month.number == 10 && date.day == 16
|
||
```
|
||
|
||
并将 `isRoseDay` 传入所有 `DayCellInfo(...)` 构造分支。
|
||
|
||
### UI 层
|
||
|
||
文件：`core/src/main/kotlin/plus/rua/project/ui/DayCell.kt`
|
||
|
||
在 `DayCellImpl` 中：
|
||
|
||
1. 读取 `val isRoseDay = lunarData.isRoseDay`。
|
||
2. 新增 `roseClickTick` 与 `roseScale` 状态。
|
||
3. 在 `clickable` 的 `onClick` 中：若 `isRoseDay` 则触发 `roseClickTick += 1`，随后调用外部 `onClick()`。
|
||
4. 在 `Box` 的左上角优先渲染玫瑰图标：
|
||
- 若 `isRoseDay` 为 `true`，显示 `R.drawable.ic_rose`；
|
||
- 否则若 `isBirthday` 为 `true`，显示 `R.drawable.ic_birthday_crown`。
|
||
5. 图标尺寸、内边距与皇冠保持一致：
|
||
- `size(14.dp)`
|
||
- `padding(start = 2.dp, top = 2.dp)`
|
||
- `rotationZ = -45f`
|
||
- 点击时通过 `graphicsLayer` 的 `scaleX / scaleY` 播放弹跳动画。
|
||
|
||
### 资源
|
||
|
||
- 源文件：`~/Pictures/rose-svgrepo-com.svg`
|
||
- 目标路径：`core/src/main/res/drawable/ic_rose.xml`
|
||
- 转换方式：将 SVG 转为 Android VectorDrawable，保留原始填充色，渲染时使用 `Color.Unspecified`。
|
||
|
||
### 测试
|
||
|
||
新增文件：`core/src/test/kotlin/plus/rua/project/LunarCacheRoseDayTest.kt`
|
||
|
||
覆盖以下场景：
|
||
|
||
1. `LocalDate(2026, 10, 16)` 的 `isRoseDay` 为 `true`。
|
||
2. 普通日期（如 `LocalDate(2026, 6, 15)`）的 `isRoseDay` 为 `false`。
|
||
3. 非 10 月的 16 日（如 `LocalDate(2026, 9, 16)`）的 `isRoseDay` 为 `false`。
|
||
|
||
## 改动文件
|
||
|
||
- `core/src/main/kotlin/plus/rua/project/LunarCache.kt`
|
||
- `core/src/main/kotlin/plus/rua/project/ui/DayCell.kt`
|
||
- `core/src/main/res/drawable/ic_rose.xml`（新增）
|
||
- `core/src/test/kotlin/plus/rua/project/LunarCacheRoseDayTest.kt`（新增）
|
||
|
||
## 风险与注意事项
|
||
|
||
- 图标与生日皇冠同位置，需确保 `isRoseDay` 判断在前，避免被生日皇冠覆盖。
|
||
- SVG 转换后需检查 `viewportWidth` / `viewportHeight` 与 `pathData` 是否正确。
|
||
- 新增字段后 `DayCellInfo` 的 `copy` / 解构等用法不受影响。
|