Skip to content

feat(cascader): Support better customization with semantic classNames/styles as function#54960

Merged
zombieJ merged 5 commits intoant-design:nextfrom
meet-student:cascader
Sep 30, 2025
Merged

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

Conversation

@meet-student
Copy link
Member

中文版模板 / 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 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 Sep 12, 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
🧪 Early access (Sonnet 4.5): enabled

We are currently testing the Sonnet 4.5 model, which is expected to improve code review quality. However, this model may lead to increased noise levels in the review comments. Please disable the early access features if the noise level causes any inconvenience.

Note:

  • Public repositories are always opted into early access features.
  • You can enable or disable early access features from the CodeRabbit UI or by updating the CodeRabbit configuration file.

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

@github-actions
Copy link
Contributor

github-actions bot commented Sep 12, 2025

Preview failed

@github-actions
Copy link
Contributor

github-actions bot commented Sep 12, 2025

👁 Visual Regression Report for PR #54960 Failed ❌

🎯 Target branch: next (77e7238)
📖 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
cascader-style-class.compact.png cascader-style-class.compact.png 🆕🆕🆕 Added 🆕🆕🆕
cascader-style-class.dark.png cascader-style-class.dark.png 🆕🆕🆕 Added 🆕🆕🆕
cascader-style-class.default.png cascader-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
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 improves the Cascader component's styling capabilities by introducing new classNames and styles props. These additions allow for more precise and dynamic control over the component's appearance, enabling developers to tailor its look and feel to specific application requirements, including conditional styling based on component state.

Highlights

  • Enhanced Customization for Cascader Component: The Cascader component now supports more granular customization through new classNames and styles props. These props allow developers to apply custom CSS classes and inline styles to specific semantic parts of the component.
  • Function-Based Styling: Both classNames and styles props can now accept functions in addition to static objects. This enables dynamic styling based on the component's current props (e.g., disabled state), offering greater flexibility and adaptive UI design.
  • Semantic Node Support: Customization is supported for various semantic nodes including root, prefix, and suffix of the main component, as well as popup.root, popup.list, and popup.listItem for elements within the dropdown popup.
  • New Demo and Documentation: A new demo (style-class.tsx) has been added to showcase the usage of these new customization features, accompanied by updated documentation in both English and Chinese, detailing the available semantic nodes and usage examples.
  • Comprehensive Test Coverage: New unit tests have been introduced to ensure the correct application of both object-based and function-based classNames and styles across all supported semantic nodes of the Cascader component.
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 valuable enhancement to the Cascader component by adding support for function-based classNames and styles. This allows for more dynamic and flexible customization. The implementation is well-structured, with new tests and demos to cover the new functionality. I've identified a couple of issues with the TypeScript type definitions that could lead to type errors and have provided suggestions to correct them. Overall, this is a great feature addition.

@pkg-pr-new
Copy link

pkg-pr-new bot commented Sep 12, 2025

@codecov
Copy link

codecov bot commented Sep 12, 2025

Bundle Report

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

Bundle name Size Change
antd.min-array-push 11.66MB 7.91MB (210.52%) ⬆️⚠️

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.52MB 5.52MB 100.0% 🚀
antd-with-locales.min.js (Deleted) -2.07MB 0 bytes -100.0% 🗑️
antd.min.js (Deleted) -1.69MB 0 bytes -100.0% 🗑️

@codecov
Copy link

codecov bot commented Sep 17, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (53638e2) to head (581a504).
⚠️ Report is 4 commits behind head on next.

Additional details and impacted files
@@            Coverage Diff            @@
##              next    #54960   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files          798       798           
  Lines        14749     14750    +1     
  Branches      3896      3896           
=========================================
+ Hits         14749     14750    +1     

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

const useStyles = createStyles(({ token }) => {
return {
root: {
border: `1px solid ${token.colorPrimary}`,
Copy link
Member

Choose a reason for hiding this comment

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

这个看起来没改到正确的位置上:

Image

@thinkasany thinkasany requested a review from Copilot September 28, 2025 12:17
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 enhances the Cascader component by supporting function-based classNames and styles props for better semantic structure customization. It updates the component to accept both object and function types for these props, enabling dynamic styling based on component state.

  • Adds function type support to classNames and styles props for the Cascader component
  • Updates TypeScript definitions with new semantic types
  • Refactors internal implementation to support function-based customization

Reviewed Changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
components/cascader/index.tsx Implements function-based semantic styling with new TypeScript types and refactored component logic
components/cascader/index.en-US.md Updates English documentation to describe function support for classNames/styles
components/cascader/index.zh-CN.md Updates Chinese documentation to describe function support for classNames/styles
components/cascader/demo/style-class.tsx Adds demo showing both object and function-based styling
components/cascader/demo/style-class.md Documentation for the new styling demo
components/cascader/tests/semantic.test.tsx Adds test coverage for function-based classNames and styles
components/_util/statusUtils.ts Adds additional input status types for broader validation support

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

@dosubot dosubot bot added the lgtm This PR has been approved by a maintainer label Sep 30, 2025
@zombieJ zombieJ merged commit e7148d3 into ant-design:next Sep 30, 2025
39 checks passed
@meet-student meet-student deleted the cascader branch October 1, 2025 02:47
@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