# 小组件

蛋日将即将到来的生日扩展到主屏幕、锁定屏幕和 Apple Watch；在支持的系统版本上，还会扩展到控制中心，以及灵动岛上的 Live Activity，让关键日期可以从更多地方查看。这些界面会沿用应用内的日期格式偏好，并在数据变更后自动刷新。

## 主屏幕小组件

蛋日提供多款各具特点的主屏幕小组件，它们在小组件库中分别列出。添加小组件时，你先按名称挑选想要的那一款，再从它支持的尺寸中选择：

- **下一个生日：** 聚焦下一个即将到来的生日，显示头像、姓名、倒计时和年龄。提供小号、中号、大号和超大尺寸。
- **生日列表：** 以紧凑列表显示即将到来的生日。提供小号和中号尺寸。
- **生日日历：** 在日历网格上浏览生日。提供小号、中号、大号和超大尺寸。
- **待机倒数：** 为待机模式设计的大号生日倒计时。仅提供中号尺寸。
- **本月进度：** 随着日子流逝、生日逐个点亮，一眼掌握当月概况。仅提供小号尺寸。
- **生日封面：** 在即将到来的生日网格之上突出展示今天的生日。在 iOS 27 或更新版本上提供超大竖向尺寸。

  大多数小组件都可以限定到某位好友或某个分组。长按小组件并点击
  **编辑小组件**，将 **显示模式** 设为 **最近的生日**、**指定好友** 或
  **分组**。当你选择 **指定好友** 或 **分组** 时，请在下方选择对应的 **好友** 或
  **分组**。

## 锁定屏幕小组件

**下一个生日** 和 **生日列表** 也可以作为锁定屏幕小组件使用（放在时钟上方或下方）。提供三种附加样式：

- **圆形：** 紧凑的圆环，显示下一个生日的头像或倒计时。
- **矩形：** 小卡片，带有姓名和倒计时行。
- **嵌入：** 紧挨时钟的一行文字。

和主屏幕小组件一样，锁定屏幕小组件也可以编辑，固定到 **指定好友** 或限定到某个 **分组**。

## 控制中心控件

在支持的系统版本上，蛋日支持多种控制中心控件，适合高频操作：

- **添加生日：** 直接进入新增好友流程。
- **近期生日：** 显示最近即将到来的生日，可按分组配置。
- **生日倒计时：** 固定某一位好友，持续显示这位好友的专属倒计时。

这些控件减少了从想法到操作之间的步骤，对于经常管理生日的用户尤其有用。

## Live Activity 与灵动岛

蛋日提供 **生日倒计时** Live Activity，为某位好友的生日倒数。它会显示好友的头像、姓名、目标日期、实时倒计时和进度条，并在当天来临时切换到庆祝状态。

- 在 **锁定屏幕** 上，倒计时以卡片形式呈现，点击即可打开该好友的详情。
- 在 **灵动岛** 上，它会在展开、紧凑和最小三种呈现形式之间自适应，让你在使用其他应用时也能看到倒计时。

随着日期临近，这个倒计时会与生日闹钟一同运行。

  

[生日闹钟](/docs/zh-CN/birthday-alarm)

    设置闹钟，并选择倒计时 Live Activity 提前多久开始。
  

## Apple Watch

蛋日既包含独立的 Apple Watch 应用，也提供表盘复杂功能。手表端可以直接在腕上显示即将到来的生日、好友详情和倒计时信息。

日期格式偏好会从 iPhone 同步到 Apple Watch，因此手表应用、小组件与主应用可以保持一致的日期顺序。

在支持的入口中，点击复杂功能或列表项后可以直接进入对应好友。需要更完整界面时，蛋日也支持将查看流程继续切回 iPhone。

## 添加与配置方式

**添加主屏幕小组件**

要添加主屏幕小组件，长按主屏幕，点击左上角的 **+** 按钮，搜索“Cakeday”，选择一个尺寸，然后放置到你想要的位置。

**添加控制中心控件**

在支持的系统版本上，控制中心控件可在系统的控制中心自定义界面中添加。部分控件支持进一步配置，例如选择某个分组或指定某位好友。

## 更新机制

每当你在蛋日中新增、编辑或删除生日记录后，应用都会为相关小组件和控件请求刷新。Apple Watch 端的数据也会同步更新，让配套界面保持最新。

实际刷新时间仍取决于系统调度、电量状况和小组件预算，因此可能出现短暂延迟。