Release Partners 8/19/2021

[joshblack]

This week is a check-in point between our Beta 1 and Beta 2 releases. Our current plan is to wrap up the remaining work for the most significant breaking changes left in React. This includes:

Changes to className

The way in which className is applied to a component is inconsistent across the codebase. In v11, we will consistently apply the className prop to the outermost element rendered by a component.

Changes to event handlers

The way in which we call provided event handlers has differing signatures between implementations. In some cases, you may receive a state object as the first argument and the event as the second. In other cases, you may see this reversed or with no state object.

These changes in v11 will standardize event handlers to a single uniform type across components. We'll also standardize how state updates are consumed in these situations.

Prop name consistency

We have over 360 props across the components in our design system. Unfortunately, some of these props are inconsistent in terms of naming or behavior across the system. In v11, we will standardize many of these props to create a consistent experience across the system. Some of the props that we'll be focusing on initially standardizing:

• initial* vs default* prop names
• titleText and labelText for labelling an input node
• Prefixing event handlers with on* versus handle*
• onRequestClose vs onClose vs onDismiss for modals
  • Toast have a prop onClose
  • Allow / reject models should be consistent

Icon updates

We'll be updating our icons from a <IconSize> convention, for example <Add16>, to a <Add size={16}> convention. We'll also be including icons directly in @carbon/react under @carbon/react/icons.

[joshblack]

Questions

• The codemod tooling for the icons was hard to use
  • Takeaway: can you provide this in an easy-to-use way in the interim?
  • Takeaway: can you schedule a lunch & learn session with the upgrade tooling?
• They use some of the internal stuff that Carbon uses, can some of that be included in upcoming betas?
  • Button types
  • Helper functions (keyboard)
  • Stories (proxying)