Skip to content

Comments

feat(button): Support better customization with semantic classNames/styles as function#54813

Merged
zombieJ merged 34 commits intoant-design:nextfrom
meet-student:button
Sep 4, 2025
Merged

feat(button): Support better customization with semantic classNames/styles as function#54813
zombieJ merged 34 commits intoant-design:nextfrom
meet-student:button

Conversation

@meet-student
Copy link
Member

@meet-student meet-student commented Aug 29, 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

💡 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 Support better customization with semantic classNames/styles as function

@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 Aug 29, 2025

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.

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.

✨ 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
🪧 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.
    • 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.
  • 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 the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit 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

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • 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.

@github-actions
Copy link
Contributor

github-actions bot commented Aug 29, 2025

Preview is ready

@github-actions
Copy link
Contributor

github-actions bot commented Aug 29, 2025

👁 Visual Regression Report for PR #54813 Failed ❌

🎯 Target branch: next (320c510)
📖 View Full Report ↗︎
📖 Alternative Report ↗︎
📊 Summary: 🔄 9 changed, 🆕 3 added

Expected (Branch next) Actual (Current PR) Diff
button-component-token.compact.png button-component-token.compact.png button-component-token.compact.png button-component-token.compact.png
button-component-token.dark.png button-component-token.dark.png button-component-token.dark.png button-component-token.dark.png
button-component-token.default.png button-component-token.default.png button-component-token.default.png button-component-token.default.png
form-disabled.compact.png form-disabled.compact.png form-disabled.compact.png form-disabled.compact.png
form-disabled.dark.png form-disabled.dark.png form-disabled.dark.png form-disabled.dark.png
form-disabled.default.png form-disabled.default.png form-disabled.default.png form-disabled.default.png
transfer-large-data.compact.png transfer-large-data.compact.png transfer-large-data.compact.png transfer-large-data.compact.png
transfer-large-data.dark.png transfer-large-data.dark.png transfer-large-data.dark.png transfer-large-data.dark.png

Warning

There are more diffs not shown in the table. Please check the Full Report for details.


Important

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

  • Checked all diffs in the full report
  • Visual diff is acceptable

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 @meet-student, 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 significantly enhances the customization capabilities of the Button component by introducing a new prop that allows for dynamic application of styles and class names based on the component's properties. This change aims to provide greater flexibility for design systems and specific styling requirements, making the Button component more adaptable without altering its core behavior.

Highlights

  • Enhanced Button Customization: Introduced a new rulesSemantics prop to the Button component, allowing developers to define conditional class names and styles based on the button's current props. This provides a powerful mechanism for highly flexible and dynamic styling.
  • New Utility Hooks: Added useMergeRulesSemantics, useMergeRulesClassNames, and useMergeRulesStyles hooks under components/_util/hooks. These hooks facilitate the merging of class names and styles based on predefined rules and component properties.
  • Documentation and Demo Updates: Refactored the Button component's semantic demo structure, renaming the existing demo and adding a new semantic/rules.tsx demo to showcase the rulesSemantics prop. The Dumi theme was also updated to include a toggle for viewing basic vs. rules-based semantic examples. Documentation files (index.en-US.md, index.zh-CN.md) were updated to reflect the new prop and demo structure.
  • Comprehensive Testing: Included a new test file (useMergeRulesSemantics.test.tsx) to ensure the correct functionality and merging logic of the newly introduced semantic rules hooks, covering various scenarios including nested class names and style merging.
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 introduces a new rulesSemantics prop for the Button component, allowing for more advanced, rule-based customization of styles and class names. The implementation includes new utility hooks (useMergeRulesSemantics, useMergeRulesClassNames, useMergeRulesStyles) with corresponding tests, and updates to the documentation to demonstrate the new feature. The overall approach is solid, but I've identified some issues with the TypeScript type definitions for nested class names that should be addressed to ensure type safety and improve the developer experience. My review includes suggestions to correct these types.

@meet-student
Copy link
Member Author

2025-08-29.21.57.42.mov

@meet-student meet-student changed the title refactor: support better customize for Button customize refactor: Support better customize for Button customize Aug 29, 2025
@pkg-pr-new
Copy link

pkg-pr-new bot commented Aug 29, 2025

More templates

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

commit: b532ab5

@codecov
Copy link

codecov bot commented Aug 29, 2025

Bundle Report

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

Bundle name Size Change
antd.min-array-push 11.58MB 7.84MB (209.32%) ⬆️⚠️

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.09MB 6.09MB 100.0% 🚀
antd.js (New) 5.49MB 5.49MB 100.0% 🚀
antd-with-locales.min.js (Deleted) -2.06MB 0 bytes -100.0% 🗑️
antd.min.js (Deleted) -1.68MB 0 bytes -100.0% 🗑️

@codecov
Copy link

codecov bot commented Aug 29, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (ecdb775) to head (b532ab5).
⚠️ Report is 2 commits behind head on next.

Additional details and impacted files
@@            Coverage Diff            @@
##              next    #54813   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files          792       792           
  Lines        14566     14575    +9     
  Branches      3875      3876    +1     
=========================================
+ Hits         14566     14575    +9     

☔ 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.

@meet-student meet-student marked this pull request as draft August 29, 2025 14:25
@meet-student meet-student marked this pull request as ready for review September 1, 2025 13:08
afc163
afc163 previously approved these changes Sep 3, 2025
@dosubot dosubot bot added the lgtm This PR has been approved by a maintainer label Sep 3, 2025
Co-authored-by: afc163 <[email protected]>
Signed-off-by: 遇见同学 <[email protected]>
afc163
afc163 previously approved these changes Sep 3, 2025
afc163
afc163 previously approved these changes Sep 3, 2025
@zombieJ zombieJ merged commit 0914ea4 into ant-design:next Sep 4, 2025
39 checks passed
@meet-student meet-student deleted the button branch October 1, 2025 02:48
@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.

4 participants