feat(week-date): ✨ 新增 WeekDate 周日期选择组件 by North-al · Pull Request #1438 · Moonofweisheng/wot-design-uni

North-al · 2026-01-06T09:43:51Z

🤔 这个 PR 的性质是？(至少选择一个)

🔗 相关 Issue

[新功能需求] 周组件 #626

💡 需求背景和解决方案

组件场景

预约/排班按周查看
周计划、周统计数据切换

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

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

文档已补充或无须补充
代码演示已提供或无须提供
TypeScript 定义已补充或无须补充

Summary by CodeRabbit

发行说明

新特性
- 新增 WeekDate 周日期选择器组件：周选择、可配置周起始日、形状切换、禁用日期、选择/切换事件与图标插槽。
文档
- 添加中英文组件文档与演示页，包含用法示例、事件说明、类型与插槽示例。
Chores
- 补充国际化文案、导航/页面条目与主题变量以支持新组件展示与样式定制。

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

vercel · 2026-01-06T09:43:56Z

@North-al is attempting to deploy a commit to the weisheng's projects Team on Vercel.

A member of the Team first needs to authorize it.

netlify · 2026-01-06T09:43:57Z

✅ Deploy Preview for wot-design-uni ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`5e17b2c`
🔍 Latest deploy log	https://app.netlify.com/projects/wot-design-uni/deploys/695ce4fd954fbc0008d1bba2
😎 Deploy Preview	https://deploy-preview-1438--wot-design-uni.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

coderabbitai · 2026-01-06T09:44:06Z

Walkthrough

新增 WeekDate 周日期选择器：包含 Vue SFC 组件、类型与导出、样式与主题变量、演示子页面、路由与导航项、本地化词条及中英文文档与示例页面（无现有 API 签名变更）。

Changes

Cohort / File(s)	变更摘要
文档 & 侧边栏 `docs/component/week-date.md`, `docs/en-US/component/week-date.md`, `docs/.vitepress/locales/en-US.ts`, `docs/.vitepress/locales/zh-CN.ts`	新增中/英文组件文档页，并在 VitePress 本地化侧边栏中插入 WeekDate 导航项。
演示页面 & 路由 `src/pages.json`, `src/pages/index/Index.vue`, `src/subPages/weekDate/Index.vue`	新增页面配置与主导航条目；添加子页面演示（多用例、事件、插槽、toast 示例）。
国际化资源 `src/locale/en-US.json`, `src/locale/zh-CN.json`	新增多条 WeekDate 相关中/英文本地化键值。
组件实现与类型导出 `src/uni_modules/wot-design-uni/components/wd-week-date/wd-week-date.vue`, `.../types.ts`, `.../index.ts`	新增 wd-week-date Vue SFC（props/emits、周列表、翻周与选择逻辑）；新增类型：`WeekStart`、`WeekDateItem`、`WeekChangeEvent`、`weekDateProps`；在 index.ts 中导出类型。
样式与主题变量 `src/uni_modules/wot-design-uni/components/wd-week-date/index.scss`, `src/uni_modules/wot-design-uni/components/common/abstracts/variable.scss`, `src/uni_modules/wot-design-uni/components/wd-config-provider/types.ts`	新增组件 SCSS；在全局变量文件新增约 10 个 week-date 主题变量；在 ConfigProvider 类型中加入 `weekDateThemeVars`。

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

签名组件 #830 — 也新增输入类组件并修改站点导航/页面配置，与本次对 src/pages.json 和导航项的更改存在代码层面关联。

Suggested reviewers

Moonofweisheng

Poem

🐰 新周到来翩翩跳，七日排队暖心跳
文档示例仔细描，样式变量整齐包
选中翻周皆可报，插槽图标任意调 🎋

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	PR标题清晰准确地总结了主要变更：新增WeekDate周日期选择组件，与changeset的核心目的完全相符。
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

📝 Generate docstrings

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

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

coderabbitai

Actionable comments posted: 1

🤖 Fix all issues with AI Agents

In @src/uni_modules/wot-design-uni/components/wd-week-date/wd-week-date.vue:
- Line 71: WEEK_LABELS is hardcoded to Chinese and breaks i18n; replace the
constant with a locale-aware source by reading week day labels from your i18n
system or dayjs locale inside the wd-week-date component (e.g., derive labels
where WEEK_LABELS is used), e.g., create a computed/getter (used in the
template) that fetches localized weekday names from your i18n API or
dayjs.localeData().weekdaysMin() and use that instead of the static WEEK_LABELS
constant.

🧹 Nitpick comments (3)

docs/component/week-date.md (1)
45-88: 建议改进文档示例的变量命名

三个禁用日期的示例都使用了相同的变量名 value4，这可能让读者感到困惑。建议使用不同的变量名以提高文档清晰度。另外，示例中使用了 dayjs 但未展示导入语句。
💡 建议的改进方案

在第一个示例之前添加 dayjs 导入说明：
import dayjs from 'dayjs'
并为不同示例使用不同的变量名：

禁用之前的日期：使用 value4

禁用之后的日期：使用 value5 或 valueAfter

禁用星期三和星期五：使用 value6 或 valueWeekdays
src/uni_modules/wot-design-uni/components/wd-week-date/types.ts (1)
2-2: 移除未使用的导入。

makeNumberProp 和 numericProp 已导入但未使用，建议移除以保持代码整洁。
🔎 建议修改
-import { baseProps, makeNumberProp, makeNumericProp, makeRequiredProp, makeStringProp, numericProp } from '../common/props'
+import { baseProps, makeNumericProp, makeRequiredProp, makeStringProp } from '../common/props'
src/subPages/weekDate/Index.vue (1)
91-101: Toast 消息使用了硬编码的中文字符串。

事件处理函数中的 Toast 消息（如 切换日期：、日期：、类型：）使用了硬编码的中文文本，与 demo-block 标题使用 $t() 进行国际化的方式不一致。此外，第 100 行的 as string 类型断言是多余的，因为 WeekChangeEvent.date 已经是 string 类型。
🔎 建议修改
 const handleSelect5 = (date: WeekDateItem) => {
-  success(`切换日期：${date.fullDate}`)
+  success(`${t('qie-huan-ri-qi')}：${date.fullDate}`)
 }

 const handleChange6 = (date: WeekChangeEvent) => {
-  success(`日期：${date.date}，类型：${date.type}`)
+  success(`${t('ri-qi')}：${date.date}，${t('lei-xing')}：${date.type}`)
 }

 const handleChange7 = (date: WeekChangeEvent) => {
-  success(`日期：${date.date}，类型：${date.type}`)
-  value7.value = date.date as string
+  success(`${t('ri-qi')}：${date.date}，${t('lei-xing')}：${date.type}`)
+  value7.value = date.date
 }

📜 Review details

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 3b6833c and 70225d4.

📒 Files selected for processing (15)

docs/.vitepress/locales/en-US.ts
docs/.vitepress/locales/zh-CN.ts
docs/component/week-date.md
docs/en-US/component/week-date.md
src/locale/en-US.json
src/locale/zh-CN.json
src/pages.json
src/pages/index/Index.vue
src/subPages/weekDate/Index.vue
src/uni_modules/wot-design-uni/components/common/abstracts/variable.scss
src/uni_modules/wot-design-uni/components/wd-config-provider/types.ts
src/uni_modules/wot-design-uni/components/wd-week-date/index.scss
src/uni_modules/wot-design-uni/components/wd-week-date/index.ts
src/uni_modules/wot-design-uni/components/wd-week-date/types.ts
src/uni_modules/wot-design-uni/components/wd-week-date/wd-week-date.vue

🧰 Additional context used

🧠 Learnings (2)

📚 Learning: 2024-11-26T02:35:53.123Z

Learnt from: Moonofweisheng
Repo: Moonofweisheng/wot-design-uni PR: 737
File: src/uni_modules/wot-design-uni/components/wd-divider/wd-divider.vue:25-25
Timestamp: 2024-11-26T02:35:53.123Z
Learning: 在 `wd-divider.vue` 文件（路径：`src/uni_modules/wot-design-uni/components/wd-divider/wd-divider.vue`）中，`props.customStyle` 是字符串类型，用于传递自定义的样式字符串。

Applied to files:

docs/component/week-date.md
src/uni_modules/wot-design-uni/components/wd-week-date/wd-week-date.vue
src/uni_modules/wot-design-uni/components/common/abstracts/variable.scss
src/subPages/weekDate/Index.vue

📚 Learning: 2024-11-24T06:12:44.418Z

Learnt from: Moonofweisheng
Repo: Moonofweisheng/wot-design-uni PR: 733
File: src/uni_modules/wot-design-uni/components/wd-tabs/wd-tabs.vue:327-327
Timestamp: 2024-11-24T06:12:44.418Z
Learning: 在 `src/uni_modules/wot-design-uni/components/wd-tabs/wd-tabs.vue` 中，由于 `title` 可能会发生变化，涉及到 `title` 的优化不太容易实现，需谨慎处理。

Applied to files:

src/uni_modules/wot-design-uni/components/wd-week-date/wd-week-date.vue
src/subPages/weekDate/Index.vue

🪛 Biome (2.1.2)

src/pages.json

[error] 821-822: Expected a property but instead found '// #ifdef MP'.

Expected a property here.

(parse)

[error] 821-822: End of file expected