Skip to content

feat: ✨ 重构 Curtain 优化控制展示隐藏的实现逻辑#895

Merged
Moonofweisheng merged 1 commit into
masterfrom
refactor/curtain-v-model
Feb 14, 2025
Merged

feat: ✨ 重构 Curtain 优化控制展示隐藏的实现逻辑#895
Moonofweisheng merged 1 commit into
masterfrom
refactor/curtain-v-model

Conversation

@Moonofweisheng

@Moonofweisheng Moonofweisheng commented Feb 13, 2025

Copy link
Copy Markdown
Owner

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

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

🔗 相关 Issue

💡 需求背景和解决方案

重构 Curtain 优化控制展示隐藏的实现逻辑

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

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

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

Summary by CodeRabbit

  • Documentation

    • 更新了组件文档,说明了从旧属性切换到通过 v-model 双向绑定管理显示状态,并标记了旧属性为过时。
  • Refactor

    • 调整了状态管理方式,取消了显式的关闭方法,简化了组件交互。
    • 优化了配置选项,使组件使用更符合现代 Vue.js 开发实践。

@vercel

vercel Bot commented Feb 13, 2025

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
wot-design-uni ✅ Ready (Inspect) Visit Preview 💬 Add feedback Feb 13, 2025 0:40am

@coderabbitai

coderabbitai Bot commented Feb 13, 2025

Copy link
Copy Markdown

Walkthrough

本次改动主要涉及 wd-curtain 组件的状态管理方式,将原先通过 value 属性和手动关闭事件转变为使用 v-model 双向绑定。文档、示例页面及组件源码同步更新:

  • 文档和类型定义中将 value 标记为弃用,并引入 modelValue
  • 示例中移除多个手动关闭函数,统一采用 v-model 绑定。
  • 组件内部逻辑调整为直接通过 modelValue 控制显示状态,并触发 update:modelValue 事件。

Changes

文件 更改摘要
docs/.../curtain.md
src/.../types.ts
更新文档和属性定义:用 modelValue 替代 value(标记为弃用),并更新说明。
src/.../Index.vue
src/.../wd-curtain.vue
更新示例和组件实现:移除多个 handleClose 方法,转而使用 v-model 双向绑定及 update:modelValue 事件以简化状态控制。

Sequence Diagram(s)

sequenceDiagram
    participant Parent
    participant CurtainComponent
    Parent->>CurtainComponent: 传入 modelValue(初始状态)
    CurtainComponent-->>Parent: emit update:modelValue(状态变更)
    Parent->>CurtainComponent: 更新后的 modelValue(同步状态)
Loading

Poem

我是一只快乐的小兔,
跳跃在代码的花丛与树丛里。
旧的 value悄然退场,
新的 modelValue欢声迎接。
双向绑定让逻辑简单,
我们一起奔向美好的明天!

✨ Finishing Touches
  • 📝 Generate Docstrings (Beta)

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR. (Beta)
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@netlify

netlify Bot commented Feb 13, 2025

Copy link
Copy Markdown

Deploy Preview for wot-design-uni ready!

Name Link
🔨 Latest commit f6c90b3
🔍 Latest deploy log https://app.netlify.com/sites/wot-design-uni/deploys/67ade81b5bf19d000948cc51
😎 Deploy Preview https://deploy-preview-895--wot-design-uni.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying wot-design-uni with  Cloudflare Pages  Cloudflare Pages

Latest commit: f6c90b3
Status: ✅  Deploy successful!
Preview URL: https://42e97184.wot-design-uni.pages.dev
Branch Preview URL: https://refactor-curtain-v-model.wot-design-uni.pages.dev

View logs

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (2)
src/uni_modules/wot-design-uni/components/wd-curtain/types.ts (1)

19-25: 代码变更符合 Vue 最佳实践!

通过引入 modelValue 并将 value 标记为已弃用,代码遵循了 Vue 的 v-model 约定。建议在 modelValue 的文档注释中添加一个示例,展示如何使用 v-model 绑定。

 /**
  * 绑定值,展示/关闭幕帘
  */
-modelValue: makeBooleanProp(false),
+/**
+ * 绑定值,展示/关闭幕帘
+ * @example
+ * <wd-curtain v-model="isVisible" />
+ */
+modelValue: makeBooleanProp(false),
docs/component/curtain.md (1)

87-90: 建议添加迁移指南!

文档已经清晰地标明了 value 属性的废弃状态,建议添加一个迁移指南部分,帮助用户从 value 迁移到 v-model

 | value                | 绑定值,展示/关闭幕帘(已废弃,请使用 modelValue) | boolean | -                                                                        | -      | -        |
 | modelValue           | 绑定值,展示/关闭幕帘                              | boolean | -                                                                        | -      | $LOWEST_VERSION$   |
+
+## 从 value 迁移到 v-model
+
+为了提供更好的开发体验,我们推荐使用 `v-model` 来控制幕帘的显示状态:
+
+```diff
+- <wd-curtain :value="isVisible" @close="isVisible = false" />
++ <wd-curtain v-model="isVisible" />
+```
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 8e569ac and f6c90b3.

📒 Files selected for processing (4)
  • docs/component/curtain.md (5 hunks)
  • src/pages/curtain/Index.vue (1 hunks)
  • src/uni_modules/wot-design-uni/components/wd-curtain/types.ts (2 hunks)
  • src/uni_modules/wot-design-uni/components/wd-curtain/wd-curtain.vue (3 hunks)
⏰ Context from checks skipped due to timeout of 90000ms (4)
  • GitHub Check: Redirect rules - wot-design-uni
  • GitHub Check: Header rules - wot-design-uni
  • GitHub Check: Pages changed - wot-design-uni
  • GitHub Check: Cloudflare Pages
🔇 Additional comments (3)
src/pages/curtain/Index.vue (1)

26-34: 代码简化提升了可维护性!

使用 v-model 替代手动的关闭事件处理,大大简化了代码结构,减少了重复代码,提高了可维护性。

src/uni_modules/wot-design-uni/components/wd-curtain/wd-curtain.vue (2)

66-67: 事件声明完整且符合规范!

新增 update:modelValue 事件支持 v-model 双向绑定。


70-88: 状态管理逻辑清晰且兼容性好!

  • 使用 modelValue 作为主要状态,同时保持对 value 的向后兼容
  • 通过 watch 确保状态同步和双向绑定

@Moonofweisheng Moonofweisheng merged commit 0e31950 into master Feb 14, 2025
@Moonofweisheng Moonofweisheng deleted the refactor/curtain-v-model branch February 14, 2025 05:00
@coderabbitai coderabbitai Bot mentioned this pull request Sep 9, 2025
19 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant