Skip to content

Comments

feat(switch): Support better customization with semantic classNames/styles as function#54994

Merged
zombieJ merged 35 commits intoant-design:nextfrom
xkhanhan:feat/update_switch_0912
Sep 28, 2025
Merged

feat(switch): Support better customization with semantic classNames/styles as function#54994
zombieJ merged 35 commits intoant-design:nextfrom
xkhanhan:feat/update_switch_0912

Conversation

@xkhanhan
Copy link
Contributor

@xkhanhan xkhanhan commented Sep 13, 2025

中文版模板 / Chinese template

🤔 This is a ...

  • 🆕 New feature
  • 🐞 Bug fix
  • 📝 Site / documentation improvement
  • 📽️ Demo improvement
  • 💄 Component style improvement
  • 🤖 TypeScript definition improvement
  • 📦 Bundle size optimization
  • ⚡️ Performance optimization
  • ⭐️ Feature enhancement
  • 🌐 Internationalization
  • 🛠 Refactoring
  • 🎨 Code style optimization
  • ✅ Test Case
  • 🔀 Branch merge
  • ⏩ Workflow
  • ⌨️ Accessibility improvement
  • ❓ Other (about what?)

🔗 Related Issues

  • Describe the source of related requirements, such as links to relevant issue discussions.
  • For example: close #xxxx, fix #xxxx

💡 Background and Solution

  • The specific problem to be addressed.
  • List the final API implementation and usage if needed.
  • If there are UI/interaction changes, consider providing screenshots or GIFs.

📝 Change Log

Language Changelog
🇺🇸 English Support better customization with semantic classNames/styles as function
🇨🇳 Chinese 支持通过语义类名/样式作为函数实现更好的自定义

@bolt-new-by-stackblitz
Copy link

Review PR in StackBlitz Codeflow Run & review this pull request in StackBlitz Codeflow.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Sep 13, 2025

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

✨ Finishing touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment

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.

@github-actions
Copy link
Contributor

github-actions bot commented Sep 13, 2025

Preview is ready

@github-actions
Copy link
Contributor

github-actions bot commented Sep 13, 2025

👁 Visual Regression Report for PR #54994 Failed ❌

🎯 Target branch: next (47deda9)
📖 View Full Report ↗︎
📖 Alternative Report ↗︎
📊 Summary: 🔄 1 changed, 🆕 3 added

Expected (Branch next) Actual (Current PR) Diff
table-sticky.dark.png table-sticky.dark.png table-sticky.dark.png table-sticky.dark.png
switch-style-class.compact.png switch-style-class.compact.png 🆕🆕🆕 Added 🆕🆕🆕
switch-style-class.dark.png switch-style-class.dark.png 🆕🆕🆕 Added 🆕🆕🆕
switch-style-class.default.png switch-style-class.default.png 🆕🆕🆕 Added 🆕🆕🆕

Important

There are 4 diffs found in this PR: 🔄 1 changed, 🆕 3 added.
Please check all items:

  • Visual diff is acceptable

Copy link

@accesslint accesslint bot left a comment

Choose a reason for hiding this comment

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

There are accessibility issues in these changes.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Summary of Changes

Hello @xkhanhan, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces significant improvements to the Ant Design Switch component's customization capabilities. By adding new classNames and styles props, developers can now apply custom CSS classes and inline styles to specific semantic parts of the component. This enhancement supports both static object-based definitions and dynamic function-based definitions that respond to the component's props, making the Switch component highly adaptable to various design systems and styling requirements.

Highlights

  • Enhanced Customization: The Switch component now offers more flexible styling options through new classNames and styles props, allowing for granular control over its semantic sub-elements.
  • Dynamic Styling with Functions: Both classNames and styles props can accept either plain objects for static customization or functions that receive the component's current props, enabling dynamic styling based on the Switch's state or configuration.
  • Semantic Targeting: Customizations can be applied to specific parts of the Switch component, such as the root element and its content, providing precise control over appearance.
  • New API and Documentation: The Switch component's API documentation has been updated to reflect these new classNames and styles props, accompanied by a new demo (style-class.tsx) showcasing their practical usage.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in issue comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request adds a great customization feature to the Switch component by allowing classNames and styles to be passed as functions. The overall implementation is good, but I've found an issue in how the class names are applied, which causes incorrect rendering. I've also left some comments on improving the code clarity, tests, and documentation. Please take a look at my suggestions.

@pkg-pr-new
Copy link

pkg-pr-new bot commented Sep 13, 2025

More templates

npm i https://pkg.pr.new/ant-design/ant-design/antd@54994

commit: 998c55a

@codecov
Copy link

codecov bot commented Sep 13, 2025

Bundle Report

Changes will increase total bundle size by 7.92MB (211.19%) ⬆️⚠️, exceeding the configured threshold of 5%.

Bundle name Size Change
antd.min-array-push 11.67MB 7.92MB (211.19%) ⬆️⚠️

Affected Assets, Files, and Routes:

view changes for bundle: antd.min-array-push

Assets Changed:

Asset Name Size Change Total Size Change (%)
antd-with-locales.js (New) 6.14MB 6.14MB 100.0% 🚀
antd.js (New) 5.54MB 5.54MB 100.0% 🚀
antd-with-locales.min.js (Deleted) -2.06MB 0 bytes -100.0% 🗑️
antd.min.js (Deleted) -1.69MB 0 bytes -100.0% 🗑️

@thinkasany thinkasany requested a review from Copilot September 13, 2025 10:01
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR introduces enhanced customization capabilities for the Switch component by adding support for semantic classNames and styles as functions. This allows developers to dynamically customize the appearance of different parts of the Switch component based on the component's properties and state.

  • Adds support for function-based classNames and styles that receive component props as parameters
  • Integrates the useMergeSemantic hook for better handling of semantic styling
  • Provides comprehensive demo and test coverage for the new functionality

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated no comments.

Show a summary per file
File Description
components/switch/index.tsx Core implementation adding function-based classNames/styles support and useMergeSemantic integration
components/switch/index.en-US.md English documentation updates describing the new classNames/styles function support
components/switch/index.zh-CN.md Chinese documentation updates describing the new classNames/styles function support
components/switch/demo/style-class.tsx Demo component showcasing both object and function-based customization
components/switch/demo/style-class.md Demo documentation explaining the new feature
components/switch/tests/style-class.test.tsx Comprehensive test coverage for the new functionality
components/switch/tests/snapshots/demo.test.ts.snap Updated snapshots for demo tests
components/switch/tests/snapshots/demo-extend.test.ts.snap Updated snapshots for extended demo tests

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@meet-student meet-student changed the title feat(switch): Support better customization with semantic classNames/s… feat(switch): Support better customization with semantic classNames/styles as function Sep 18, 2025
@codecov
Copy link

codecov bot commented Sep 18, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (60ac885) to head (998c55a).
⚠️ Report is 33 commits behind head on next.

Additional details and impacted files
@@            Coverage Diff            @@
##              next    #54994   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files          793       793           
  Lines        14661     14665    +4     
  Branches      3893      3892    -1     
=========================================
+ Hits         14661     14665    +4     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

xkhanhan and others added 6 commits September 18, 2025 21:06
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Signed-off-by: thinkasany <[email protected]>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Signed-off-by: thinkasany <[email protected]>
Copy link

@accesslint accesslint bot left a comment

Choose a reason for hiding this comment

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

There are accessibility issues in these changes.

Copy link

@accesslint accesslint bot left a comment

Choose a reason for hiding this comment

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

There are accessibility issues in these changes.

@li-jia-nan
Copy link
Member

冲突看一下

Copy link

@accesslint accesslint bot left a comment

Choose a reason for hiding this comment

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

There are accessibility issues in these changes.

</span>
</span>
</button>
<button
Copy link

Choose a reason for hiding this comment

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

Looks like this element is missing an accessible name or label. That makes it hard for people using screen readers or voice control to use the control.

</span>
</span>
</button>
<button
Copy link

Choose a reason for hiding this comment

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

Looks like this element is missing an accessible name or label. That makes it hard for people using screen readers or voice control to use the control.

@dosubot dosubot bot added the lgtm This PR has been approved by a maintainer label Sep 28, 2025
@zombieJ zombieJ merged commit dba8b74 into ant-design:next Sep 28, 2025
39 checks passed
@github-actions
Copy link
Contributor

🎉 Thank you for your contribution! If you have not yet joined our DingTalk community group, please feel free to join us (when joining, please provide the link to this PR).

🎉 感谢您的贡献!如果您还没有加入钉钉社区群,请扫描下方二维码加入我们(加群时请提供此 PR 链接)。

钉钉社区群二维码

@zombieJ zombieJ mentioned this pull request Nov 4, 2025
17 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lgtm This PR has been approved by a maintainer

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants