Skip to content

feat(icon): apply rh-standard styling and add opt-out#12320

Merged
nicolethoen merged 4 commits intopatternfly:mainfrom
kmcfaul:rh-standard-icon-styling
Apr 15, 2026
Merged

feat(icon): apply rh-standard styling and add opt-out#12320
nicolethoen merged 4 commits intopatternfly:mainfrom
kmcfaul:rh-standard-icon-styling

Conversation

@kmcfaul
Copy link
Copy Markdown
Contributor

@kmcfaul kmcfaul commented Apr 6, 2026

What: Closes #12321

  • Bumps core version for new class
  • Automatically applies class for all standard icons
  • Adds noDefaultStyle to opt out of applying the class

Summary by CodeRabbit

  • New Features
    • Icons gain an optional prop to opt out of the library's default SVG styling; default styling remains enabled.
    • Icons are now assigned type-aware default SVG classes so different icon types receive appropriate base styling.
  • Tests
    • Added tests verifying default styling, explicit enabling, and opt-out behavior for icon rendering.

@kmcfaul kmcfaul changed the title feat(icon): add rh-standard set classname & opt-out feat(icon): apply rh-standard styling and add opt-out Apr 6, 2026
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 6, 2026

Walkthrough

Adds an optional noDefaultStyle?: boolean prop (default false) to generated icon components to opt out of appending a configured svgClassName; updates the icon generation script to emit svgClassName for certain icon types; adds tests covering the new prop behavior.

Changes

Cohort / File(s) Summary
Icon factory
packages/react-icons/src/createIcon.tsx
Exported SVGIconProps gains noDefaultStyle?: boolean; generated icon class now declares static defaultProps = { noDefaultStyle: false }; render logic skips appending svgClassName when noDefaultStyle is truthy.
Icon generation script
packages/react-icons/scripts/parseRHIcons.mjs
Adds ICON_TYPE_CLASSES mapping and updates formatModule to accept iconType and emit svgClassName in per-icon modules when applicable.
Tests
packages/react-icons/src/__tests__/createIcon.test.tsx
Adds rhStandardIcon fixture and three tests verifying svgClassName is applied by default, applied when noDefaultStyle={false}, and omitted when noDefaultStyle is truthy.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested reviewers

  • nicolethoen
  • thatblindgeye
  • dlabaj
  • mcoker
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: applying rh-standard styling to icons with an opt-out mechanism via the noDefaultStyle prop.
Linked Issues check ✅ Passed The PR successfully implements both requirements from #12321: automatically applies rh-standard class to standard icons and provides opt-out via noDefaultStyle prop.
Out of Scope Changes check ✅ Passed All changes are within scope: SVGIconProps extension, default prop addition, and parseRHIcons script updates directly support the rh-standard styling feature objectives.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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.

@patternfly-build
Copy link
Copy Markdown
Collaborator

patternfly-build commented Apr 6, 2026

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
packages/react-icons/src/createIcon.tsx (1)

100-114: ⚠️ Potential issue | 🟠 Major

Opt-out is not applied in the dual-render path.

noStandardSetStyling is only respected in the single-icon branch (Lines 107-114). In the dual-render branch (Lines 155-156), createSvg(...) still unconditionally appends svgClassName, so pf-v6-icon-rh-standard can still render even when opt-out is true.

💡 Proposed fix
-const createSvg = (icon: IconDefinition, iconClassName: string) => {
+const createSvg = (icon: IconDefinition, iconClassName: string, noStandardSetStyling = false) => {
   const { xOffset, yOffset, width, height, svgPathData, svgClassName } = icon ?? {};
@@
-  if (svgClassName) {
+  if (svgClassName && !(noStandardSetStyling && svgClassName === 'pf-v6-icon-rh-standard')) {
     classNames.push(svgClassName);
   }
@@
-        if (svgClassName) {
-          if (svgClassName !== 'pf-v6-icon-rh-standard') {
-            classNames.push(svgClassName);
-          } else {
-            if (!noStandardSetStyling) {
-              classNames.push(svgClassName);
-            }
-          }
-        }
+        if (svgClassName && !(noStandardSetStyling && svgClassName === 'pf-v6-icon-rh-standard')) {
+          classNames.push(svgClassName);
+        }
@@
-            {icon && createSvg(icon, 'pf-v6-icon-default')}
-            {rhUiIcon && createSvg(rhUiIcon, 'pf-v6-icon-rh-ui')}
+            {icon && createSvg(icon, 'pf-v6-icon-default', noStandardSetStyling)}
+            {rhUiIcon && createSvg(rhUiIcon, 'pf-v6-icon-rh-ui', noStandardSetStyling)}

Also applies to: 143-157

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@packages/react-icons/src/createIcon.tsx` around lines 100 - 114, The
dual-render path is appending svgClassName unconditionally when calling
createSvg, so the opt-out flag noStandardSetStyling isn't respected and
pf-v6-icon-rh-standard can still be applied; update the dual-render branch in
createIcon/createSvg usage to mirror the single-icon logic: when svgClassName is
defined, only push it to the class list if it's not 'pf-v6-icon-rh-standard' or
if noStandardSetStyling is false (i.e., skip adding that specific class when
noStandardSetStyling is true), ensuring the same conditional handling of
svgClassName used for the single-icon branch (referencing svgClassName,
noStandardSetStyling, createSvg, and iconData/rhUiIcon).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Outside diff comments:
In `@packages/react-icons/src/createIcon.tsx`:
- Around line 100-114: The dual-render path is appending svgClassName
unconditionally when calling createSvg, so the opt-out flag noStandardSetStyling
isn't respected and pf-v6-icon-rh-standard can still be applied; update the
dual-render branch in createIcon/createSvg usage to mirror the single-icon
logic: when svgClassName is defined, only push it to the class list if it's not
'pf-v6-icon-rh-standard' or if noStandardSetStyling is false (i.e., skip adding
that specific class when noStandardSetStyling is true), ensuring the same
conditional handling of svgClassName used for the single-icon branch
(referencing svgClassName, noStandardSetStyling, createSvg, and
iconData/rhUiIcon).

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 3406e8bd-ce94-4431-9d2e-d539acf6d03d

📥 Commits

Reviewing files that changed from the base of the PR and between a7a847c and 278cbbe.

⛔ Files ignored due to path filters (1)
  • yarn.lock is excluded by !**/yarn.lock, !**/*.lock
📒 Files selected for processing (7)
  • packages/react-core/package.json
  • packages/react-docs/package.json
  • packages/react-icons/package.json
  • packages/react-icons/scripts/icons/rhIconsStandard.mjs
  • packages/react-icons/src/createIcon.tsx
  • packages/react-styles/package.json
  • packages/react-tokens/package.json

Copy link
Copy Markdown
Contributor

@thatblindgeye thatblindgeye left a comment

Choose a reason for hiding this comment

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

Can we add some tests to the createIcon test file for this new prop?

@kmcfaul kmcfaul force-pushed the rh-standard-icon-styling branch from 278cbbe to 0ffa255 Compare April 13, 2026 15:28
@kmcfaul
Copy link
Copy Markdown
Contributor Author

kmcfaul commented Apr 13, 2026

@thatblindgeye Updated. I had a thought as I was adding the unit tests though. Do you think we'd want the noStandardSetStyling prop to be more generic like noDefaultSvgStyling and opt out of all bundled svgClassName?

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
packages/react-icons/src/__tests__/createIcon.test.tsx (1)

63-76: Add one regression test to protect non-standard class behavior.

Current additions validate RH standard behavior, but a guard case for non-standard svgClassName with noStandardSetStyling={true} would prevent accidental broadening later.

Suggested test addition
+test('does not affect non-standard svgClassName when noStandardSetStyling is true', () => {
+  render(<SVGIcon noStandardSetStyling />);
+  expect(screen.getByRole('img', { hidden: true })).toHaveClass(singlePathIcon.svgClassName ?? '');
+});
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@packages/react-icons/src/__tests__/createIcon.test.tsx` around lines 63 - 76,
Add a regression test to ensure a custom svgClassName isn't overridden when
noStandardSetStyling is true: render <RhStandardIcon noStandardSetStyling
svgClassName="my-custom" /> and assert the rendered img (getByRole('img', {
hidden: true })) hasClass('my-custom') and does not
haveClass('pf-v6-icon-rh-standard'); this protects the non-standard class
behavior in the RhStandardIcon component.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@packages/react-icons/src/__tests__/createIcon.test.tsx`:
- Around line 63-76: Add a regression test to ensure a custom svgClassName isn't
overridden when noStandardSetStyling is true: render <RhStandardIcon
noStandardSetStyling svgClassName="my-custom" /> and assert the rendered img
(getByRole('img', { hidden: true })) hasClass('my-custom') and does not
haveClass('pf-v6-icon-rh-standard'); this protects the non-standard class
behavior in the RhStandardIcon component.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 079f5970-a69d-4429-a15f-beb7438d20e1

📥 Commits

Reviewing files that changed from the base of the PR and between 278cbbe and 0ffa255.

📒 Files selected for processing (3)
  • packages/react-icons/scripts/icons/rhIconsStandard.mjs
  • packages/react-icons/src/__tests__/createIcon.test.tsx
  • packages/react-icons/src/createIcon.tsx

@thatblindgeye
Copy link
Copy Markdown
Contributor

Updated. I had a thought as I was adding the unit tests though. Do you think we'd want the noStandardSetStyling prop to be more generic like noDefaultSvgStyling and opt out of all bundled svgClassName?

That would probably be nice, though not a blocker for me.

@kmcfaul
Copy link
Copy Markdown
Contributor Author

kmcfaul commented Apr 14, 2026

@thatblindgeye I did update the prop to be more generic if you don't mind re-reviewing. I figured it simplifies the internal logic a good bit and that way other icons we add that may have default styling have an option to remove it.

Copy link
Copy Markdown

@bekah-stephens bekah-stephens left a comment

Choose a reason for hiding this comment

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

looks good! (I think styling the Standard set differently is super helpful)

@kmcfaul
Copy link
Copy Markdown
Contributor Author

kmcfaul commented Apr 15, 2026

TODO - update parsing script to automatically re-add the classname to standard icons

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
packages/react-icons/scripts/parseRHIcons.mjs (1)

21-26: Simplify ICON_TYPE_CLASSES to only include non-empty mappings.

At Line 22 and Line 25, empty-string entries are no-ops. Keeping only actual class mappings reduces config drift and maintenance overhead.

Proposed simplification
 const ICON_TYPE_CLASSES = {
-  ui: '',
   standard: 'pf-v6-icon-rh-standard',
-  // social: '',
-  microns: ''
+  // social: ''
 };
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@packages/react-icons/scripts/parseRHIcons.mjs` around lines 21 - 26,
ICON_TYPE_CLASSES contains entries with empty-string values (e.g., keys "ui" and
"microns") that are no-ops; remove those keys and keep only mappings with actual
class names (e.g., retain "standard": "pf-v6-icon-rh-standard") so the
configuration only contains meaningful class mappings—update any code that
imports/reads ICON_TYPE_CLASSES to expect only the remaining keys if necessary.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@packages/react-icons/scripts/parseRHIcons.mjs`:
- Around line 21-26: ICON_TYPE_CLASSES contains entries with empty-string values
(e.g., keys "ui" and "microns") that are no-ops; remove those keys and keep only
mappings with actual class names (e.g., retain "standard":
"pf-v6-icon-rh-standard") so the configuration only contains meaningful class
mappings—update any code that imports/reads ICON_TYPE_CLASSES to expect only the
remaining keys if necessary.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 38dd5390-a909-45da-ab86-e34f01bae516

📥 Commits

Reviewing files that changed from the base of the PR and between a5ffaf6 and 9a8efd4.

📒 Files selected for processing (1)
  • packages/react-icons/scripts/parseRHIcons.mjs

Copy link
Copy Markdown
Contributor

@mcoker mcoker left a comment

Choose a reason for hiding this comment

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

rm -rf'd the dist/static dir and ran npm run update-rhds-icons && npm run generate and it generated new svgs and added the .pf-v6-icon-rh-standard to "rh-standard-*" icons. Also validated .pf-v6-icon-rh-standard isn't added to non-standard icons.

Wasn't able to start the dev server (complaining about classnames not in the styles object) to validate regular react-icons components work properly, but validated .pf-v6-icon-rh-standard is in the react-icons icon component data, and IIRC the static icons are created using the same script the react-icons components use to generate the svg so should be good!

@nicolethoen nicolethoen merged commit 930cd56 into patternfly:main Apr 15, 2026
14 checks passed
@patternfly-build
Copy link
Copy Markdown
Collaborator

Your changes have been released in:

  • @patternfly/react-code-editor@6.5.0-prerelease.59
  • @patternfly/react-core@6.5.0-prerelease.56
  • @patternfly/react-docs@7.5.0-prerelease.66
  • @patternfly/react-drag-drop@6.5.0-prerelease.57
  • @patternfly/react-icons@6.5.0-prerelease.24
  • demo-app-ts@6.5.0-prerelease.85
  • @patternfly/react-table@6.5.0-prerelease.58
  • @patternfly/react-templates@6.5.0-prerelease.56

Thanks for your contribution! 🎉

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.

Icon - apply rhds standard icon variant

7 participants