fix(countdown): 将destroy 的默认值设置为 true

[iDestin]

🤔 这个变动的性质是？

• 新特性提交
• 日常 bug 修复
• 站点、文档改进
• 演示代码改进
• 组件样式/交互改进
• TypeScript 定义更新
• 包体积优化
• 性能优化
• 功能增强
• 国际化改进
• 重构
• 代码风格优化
• 测试用例
• 分支合并
• 其他改动（是关于什么的改动？）

🔗 相关 Issue

#3392

💡 需求背景和解决方案

将 destroy 的默认值设置为 true

☑️ 请求合并前的自查清单

⚠️ 请自检并全部勾选全部选项。⚠️

• 文档已补充或无须补充
• 代码演示已提供或无须提供
• TypeScript 定义已补充或无须补充
• fork仓库代码是否为最新避免文件冲突
• Files changed 没有 package.json lock 等无关文件

Summary by CodeRabbit

发布说明

• 变更
  • 调整 destroy 属性默认值从 false 改为 true，组件卸载时将自动执行清理操作。

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

整体概览

倒计时组件的 destroy 属性默认值从 false 更改为 true，使组件在卸载时默认取消动画帧。同时，文档更新以反映此更改，并新增 onUpdate 回调属性文档。

变更清单

倒计时组件默认行为更新	变更内容
核心实现 src/packages/countdown/countdown.tsx, src/packages/countdown/countdown.taro.tsx	将 defaultProps 中的 destroy 默认值从 false 改为 true，改变组件卸载时的清理行为
文档更新 src/packages/countdown/doc.en-US.md, src/packages/countdown/doc.md, src/packages/countdown/doc.taro.md, src/packages/countdown/doc.zh-TW.md	更新 destroy 属性默认值文档（false → true），新增 onUpdate 回调属性说明（(restTime: any) => void）

代码审查工作量评估

🎯 2 (简单) | ⏱️ ~10 分钟

• 变更为同一属性的默认值修改，涉及多个文件但改动重复一致
• 文档更新为说明性文本，无复杂逻辑
• 建议确认 onUpdate 属性是否已在组件类型定义或实现中声明

可能关联的议题

• [bug]: CountDown组件销毁后没有默认清除定时任务 #3392 — 直接修复倒计时组件卸载时定时器未清理的缺陷，将 destroy 默认值改为 true 确保自动清理

建议审查者

• xiaoyatong
• irisSong

兔子的诗

🐰 倒计时滴答声声美，
销毁旗帜翻起来，
默认清理莫遗漏，
回调新增伴左右，
组件焕然一新在。

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	PR标题明确说明了主要变更：将countdown组件的destroy属性默认值从false改为true，与代码改动相符。
Description check	✅ Passed	PR描述按照模板填写，选择了正确的变更类型（bug修复），关联了Issue（#3392），提供了解决方案说明，并完成了自查清单。
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e9a80b8 and 7c47c83.

📒 Files selected for processing (6)

• src/packages/countdown/countdown.taro.tsx (1 hunks)
• src/packages/countdown/countdown.tsx (1 hunks)
• src/packages/countdown/doc.en-US.md (1 hunks)
• src/packages/countdown/doc.md (1 hunks)
• src/packages/countdown/doc.taro.md (1 hunks)
• src/packages/countdown/doc.zh-TW.md (1 hunks)

🧰 Additional context used

🧠 Learnings (1)

📚 Learning: 2025-05-02T01:45:09.576Z

Learnt from: irisSong
Repo: jdf2e/nutui-react PR: 3209
File: src/packages/searchbar/searchbar.taro.tsx:111-124
Timestamp: 2025-05-02T01:45:09.576Z
Learning: 在 React/Taro 组件中使用 setTimeout 或 setInterval 时，应当在组件卸载时通过 useEffect 的清理函数清除定时器，以防止内存泄漏。可以使用 useState 存储定时器 ID，并在 useEffect 的返回函数中清除。

Applied to files:

• src/packages/countdown/countdown.taro.tsx

🔇 Additional comments (6)

src/packages/countdown/countdown.tsx (1)

23-23: 默认启用资源清理，防止内存泄漏

将 destroy 默认值从 false 改为 true 是一个很好的改进。这确保了组件卸载时会自动取消动画帧（见 Line 272），符合 React 最佳实践，可以有效防止内存泄漏。

需要注意的是，这是一个破坏性变更，依赖旧默认行为的用户需要显式设置 destroy={false} 来保持原有行为。

Based on learnings

src/packages/countdown/countdown.taro.tsx (1)

26-26: Taro 版本与 Web 版本保持一致

Taro 版本的 destroy 默认值同步更新为 true，与 src/packages/countdown/countdown.tsx 保持一致。这确保了跨平台的行为一致性，组件卸载时会自动清理动画帧资源。

src/packages/countdown/doc.en-US.md (1)

102-102: 文档更新正确

英文文档已正确更新 destroy 属性的默认值为 true，与代码实现保持一致。

src/packages/countdown/doc.zh-TW.md (1)

102-102: 繁体中文文档更新正确

繁体中文文档已正确更新 destroy 属性的默认值为 true，与代码实现保持一致。

src/packages/countdown/doc.md (1)

102-102: 简体中文文档更新正确

简体中文文档已正确更新 destroy 属性的默认值为 true，与代码实现保持一致。

src/packages/countdown/doc.taro.md (1)

102-102: Taro 文档更新正确

Taro 版本的简体中文文档已正确更新 destroy 属性的默认值为 true，与代码实现保持一致。

Tip

📝 Customizable high-level summaries are now available in beta!

You can now customize how CodeRabbit generates the high-level summary in your pull requests — including its content, structure, tone, and formatting.

• Provide your own instructions using the high_level_summary_instructions setting.
• Format the summary however you like (bullet lists, tables, multi-section layouts, contributor stats, etc.).
• Use high_level_summary_in_walkthrough to move the summary from the description to the walkthrough section.

Example instruction:

"Divide the high-level summary into five sections:

1. 📝 Description — Summarize the main change in 50–60 words, explaining what was done.
2. 📓 References — List relevant issues, discussions, documentation, or related PRs.
3. 📦 Dependencies & Requirements — Mention any new/updated dependencies, environment variable changes, or configuration updates.
4. 📊 Contributor Summary — Include a Markdown table showing contributions:
   | Contributor | Lines Added | Lines Removed | Files Changed |
5. ✔️ Additional Notes — Add any extra reviewer context.
   Keep each section concise (under 200 words) and use bullet or numbered lists for clarity."

Note: This feature is currently in beta for Pro-tier users, and pricing will be announced later.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}