Skip to content

Comments

feat(image): Support better customization with semantic classNames/styles as function#54980

Merged
zombieJ merged 21 commits intoant-design:nextfrom
meet-student:image
Sep 30, 2025
Merged

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

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

👁 Visual Regression Report for PR #54980 Failed ❌

🎯 Target branch: next (84f761e)
📖 View Full Report ↗︎
📖 Alternative Report ↗︎
📊 Summary: 🔄 1 changed, 🆕 6 added

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

Important

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

  • Visual diff is acceptable

@github-actions
Copy link
Contributor

github-actions bot commented Sep 12, 2025

Preview is ready

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 customization capabilities of the Image component by introducing support for function-based classNames and styles props. This enhancement allows developers to apply dynamic styling and class assignments to various parts of the image component, including its preview popup, based on the component's current properties.

Highlights

  • Enhanced Customization: The Image component now supports classNames and styles props as functions, allowing for dynamic styling and class assignment based on component properties.
  • Dynamic Styling Capabilities: This enhancement provides greater flexibility for developers to apply conditional styling to various parts of the image component, including its preview popup.
  • New Demo and Tests: A new demo (style-class.tsx) and comprehensive test cases have been added to showcase and validate this new functionality, ensuring proper implementation and 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 introduces a valuable enhancement to the Image component by allowing classNames and styles props to be functions. This provides greater flexibility for dynamic styling based on the component's props. The implementation is solid, with new types, updated logic in the Image component, and comprehensive tests and demos.

My review includes a few suggestions to improve code quality:

  • A performance consideration regarding an ineffective useMemo hook.
  • A suggestion to refactor duplicated code in the new demo file for better maintainability.
  • A couple of minor typo fixes in the documentation.

Overall, this is a great feature addition. Addressing these points will help polish the implementation.

@codecov
Copy link

codecov bot commented Sep 12, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (38fc1dc) to head (35f79a5).
⚠️ Report is 9 commits behind head on next.

Additional details and impacted files
@@            Coverage Diff            @@
##              next    #54980   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files          798       798           
  Lines        14727     14727           
  Branches      3896      3896           
=========================================
  Hits         14727     14727           

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

@pkg-pr-new
Copy link

pkg-pr-new bot commented Sep 21, 2025

More templates

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

commit: 35f79a5

@codecov
Copy link

codecov bot commented Sep 21, 2025

Bundle Report

Changes will increase total bundle size by 44 bytes (0.0%) ⬆️. This is within the configured threshold ✅

Detailed changes
Bundle name Size Change
antd.min-array-push 11.65MB 44 bytes (0.0%) ⬆️

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 22 bytes 6.13MB 0.0%
antd.js 22 bytes 5.52MB 0.0%

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.

@meet-student
Copy link
Member Author

image

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.

};
return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
<Image {...sharedProps} preview={{ open: false }} styles={stylesFn} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

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.

};
return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
<Image {...sharedProps} preview={{ open: false }} styles={stylesFn} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

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.

};
return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
<Image {...sharedProps} preview={{ open: false }} styles={stylesFn} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

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.

};
return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
<Image {...sharedProps} preview={{ open: false }} styles={stylesFn} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

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.

<div
class="ant-image css-var-root ant-image-css-var"
>
<img
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

</div>
`;

exports[`Image.Semantic should render with classNames and styles when passed as functions to PreviewGroup 1`] = `"<div class="ant-image css-var-root ant-image-css-var" style="width: 100px;"><img class="ant-image-img" width="100" src="https://example.com/image.png"><div class="ant-image-cover ant-image-cover-center"></div></div>"`;
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.


exports[`Image.Semantic should render with classNames and styles when passed as functions to PreviewGroup 1`] = `"<div class="ant-image css-var-root ant-image-css-var" style="width: 100px;"><img class="ant-image-img" width="100" src="https://example.com/image.png"><div class="ant-image-cover ant-image-cover-center"></div></div>"`;

exports[`Image.Semantic should render with custom classNames and styles when passed to PreviewGroup 1`] = `"<div class="ant-image css-var-root ant-image-css-var"><img class="ant-image-img" src="https://example.com/image.png"><div class="ant-image-cover ant-image-cover-center"></div></div>"`;
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

};
return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
<Image {...sharedProps} preview={{ open: false }} styles={stylesFn} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

classNames={classNamesObject}
styles={stylesObject}
>
<Image src="https://example.com/image.png" />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.


const { container } = render(
<Image.PreviewGroup preview={{ open: false }} classNames={classNamesFn} styles={stylesFn}>
<Image width={100} src="https://example.com/image.png" />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

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.

return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
<Image {...sharedProps} preview={{ open: false }} styles={stylesFn} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

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.

return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
<Image {...sharedProps} preview={{ open: false }} styles={stylesFn} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

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.

return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
<Image {...sharedProps} preview={{ open: false }} styles={stylesFn} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.


// const { container } = render(
// <Image.PreviewGroup preview={{ open: false }} classNames={classNamesFn} styles={stylesFn}>
// <Image src="https://example.com/image.png" />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

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.

return (
<Flex gap="middle">
<Image {...sharedProps} styles={styles} />
<Image {...sharedProps} preview={{ open: false }} styles={stylesFn} />
Copy link

Choose a reason for hiding this comment

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

This image is missing a text alternative. This is a problem for people using screen readers.

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.

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

3 participants