Skip to content

Conversation

@KevinTCoughlin
Copy link
Member

@KevinTCoughlin KevinTCoughlin commented Apr 20, 2018

Pull request checklist

Description of changes

#4581 reported that iconClassName does not apply a custom className to Nav button icons as the documentation says. Looking thru the changes this functionality seems to have been refactored to IIConProps. As far as I can tell this prop is unused across the lib code and can be safely removed. However, lets mark it as deprecated for now and advise using IIconProps.className inherited from React.HTMLAttributes<HTMLElement>.

Last time I can see iconClassName in use is: https://github.com/OfficeDev/office-ui-fabric-react/blob/5.0/packages/office-ui-fabric-react/src/components/Nav/Nav.tsx#L152

Focus areas to test

Property is unused so it doesn't work now anyway. You can test that IIConProps works by looking at the "Delete" nav item's icon in https://codepen.io/kevintcoughlin/pen/aGoGvm?editors=1010. Deprecated for now so should not be a breaking change for anyone.

@oengusmacinog-zz
Copy link
Collaborator

I'm thinking deprecate, and change the comment to point out it does nothing. Someone might have used it and not looked too closely and not noticed it doesn't do what it was intended to do anymore, or used it before it was removed and didn't notice - but if its removed and used in that way it will still be a breaking change that they will have to dig out and fix. Deprecate now and remove in v6 makes more sense to me.

@KevinTCoughlin KevinTCoughlin force-pushed the keco/nav-iconClassName branch from d3c8ce0 to cd61afd Compare April 20, 2018 18:21

/**
* Classname to apply to the icon link.
* iconClassName has been deprecated in favor of IIconProps. Use IIconProps.className instead.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Can you change IIconProps (the Type) to iconProps (the actual prop of type IIconProps you want to use).

Nitpicky I know, but clarity is everything in the documentation.

@dzearing dzearing merged commit 6f66dfa into microsoft:master Apr 23, 2018
Markionium added a commit to Markionium/office-ui-fabric-react that referenced this pull request Apr 26, 2018
* master: (42 commits)
  Applying package updates.
  ProgressIndicator: Finish conversion to mergeStyles (microsoft#4595)
  Fix props validation for Breadcrumb (microsoft#4666)
  No unused vars part of ts (microsoft#4670)
  Picker/Autofill: fixes several minor bugs. (microsoft#4569)
  Fix Calendar component PREV/NEXT month, year, and "Go to today" handlers firing twice (microsoft#4662)
  Applying package updates.
  Merge styles order (microsoft#4664)
  Fabric component: revert class change and make it backwards compatible (microsoft#4671)
  Addressing Issue microsoft#3707 - OverflowSet: Add the ability to set aria-label (microsoft#4667)
  Fix input type for Tile ARIA label prop (microsoft#4668)
  Fix theme slots for DetailsList header colors (microsoft#4658)
  Applying package updates.
  Jolore/calendar updates (microsoft#4643)
  Remove wordWrap setting. (microsoft#4657)
  Pivot: convert to mergeStyles - part 1  (microsoft#4656)
  Use the `data-is-scrollable` attribute on the correct ScrollablePane div (microsoft#4602)
  Applying package updates.
  Remove unused iconClassName prop from Nav.types (microsoft#4634)
  Jest snapshots: classes in animations should autoexpand. (microsoft#4647)
  ...
Markionium added a commit to Markionium/office-ui-fabric-react that referenced this pull request Apr 26, 2018
* master: (34 commits)
  Applying package updates.
  ProgressIndicator: Finish conversion to mergeStyles (microsoft#4595)
  Fix props validation for Breadcrumb (microsoft#4666)
  No unused vars part of ts (microsoft#4670)
  Picker/Autofill: fixes several minor bugs. (microsoft#4569)
  Fix Calendar component PREV/NEXT month, year, and "Go to today" handlers firing twice (microsoft#4662)
  Applying package updates.
  Merge styles order (microsoft#4664)
  Fabric component: revert class change and make it backwards compatible (microsoft#4671)
  Addressing Issue microsoft#3707 - OverflowSet: Add the ability to set aria-label (microsoft#4667)
  Fix input type for Tile ARIA label prop (microsoft#4668)
  Fix theme slots for DetailsList header colors (microsoft#4658)
  Applying package updates.
  Jolore/calendar updates (microsoft#4643)
  Remove wordWrap setting. (microsoft#4657)
  Pivot: convert to mergeStyles - part 1  (microsoft#4656)
  Use the `data-is-scrollable` attribute on the correct ScrollablePane div (microsoft#4602)
  Applying package updates.
  Remove unused iconClassName prop from Nav.types (microsoft#4634)
  Jest snapshots: classes in animations should autoexpand. (microsoft#4647)
  ...
@microsoft microsoft locked as resolved and limited conversation to collaborators Aug 31, 2019
@KevinTCoughlin KevinTCoughlin deleted the keco/nav-iconClassName branch January 2, 2020 19:32
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

INavLink iconClassName property is not reflected in the UI

3 participants