7.x Migration

Refer to the Carbon X Migration Guide for more information on migrating from v9 to v10.

• Process
• Components
• Polyfills

Process

1. Update your carbon-components-react package using npm or yarn.
2. When migrating from v6 to v7, you'll first want to address your component instances marked with Removed in the table below. E.g. if you're using the <Footer /> React component that was previously available in Carbon, you'll need to either remove your footer instances or create your own footer component so the <Footer /> syntax is recognized in your client-side JavaScript.

Components

Component	v10
Accordion	No breaking changes
AccordionItem	No breaking changes
Breadcrumb	No breaking changes
BreadcrumbItem	No breaking changes
Button	Migrate
Checkbox	No breaking changes
CodeSnippet	No breaking changes
ComboBox	No breaking changes
ComposedModal	No breaking changes
ContentSwitcher	No breaking changes
Copy	No breaking changes
CopyButton	No breaking changes
DangerButton	No breaking changes
DataTable	Migrate
DatePicker	Migrate
DatePickerInput	No breaking changes
Dropdown	Existing import remapped to DropdownV2
DropdownItem	No breaking changes
DropdownV2	Renamed to Dropdown
FileUploader	No breaking changes
Footer	Removed
Form	No breaking changes
FormGroup	No breaking changes
FormItem	No breaking changes
FormLabel	No breaking changes
Icon	Migrate
InlineCheckbox	Migrate
InlineLoading	No breaking changes
Link	No breaking changes
ListBox	No breaking changes
ListItem	No breaking changes
Loading	No breaking changes
Modal	No breaking changes
ModalWrapper	No breaking changes
MultiSelect	No breaking changes
Notification	Deprecated, use InlineNotification or ToastNotification instead
NumberInput	Migrate
OverflowMenu	Migrate
OverflowMenuItem	Migrate
Pagination	Export now points to PaginationV2
PaginationV2	Renamed to Pagination
PrimaryButton	No breaking changes
ProgressIndicator	No breaking changes
RadioButton	Migrate
RadioButtonGroup	No breaking changes
RadioTile	No breaking changes
Search	No breaking changes
SearchFilterButton	No breaking changes
SearchLayoutButton	No breaking changes
SecondaryButton	No breaking changes
Select	No breaking changes
SelectItem	No breaking changes
SelectItemGroup	No breaking changes
SkeletonPlaceholder	No breaking changes
SkeletonText	No breaking changes
Slider	Migrate
StructuredList	No breaking changes
Switch	No breaking changes
Tab	No breaking changes
TabContent	No breaking changes
Table	Export now points to DataTable.Table
TableBody	Export now points to DataTable.TableBody
TableData	Removed
TableHead	Export now points to DataTable.TableHead
TableHeader	Export now points to DataTable.TableHeader
TableRow	Export now points to DataTable.TableRow
TableRowExpanded	Removed
Tabs	No breaking changes
Tag	Migrate
TextArea	No breaking changes
TextInput	No breaking changes
Tile	No breaking changes
TileGroup	No breaking changes
TimePicker	No breaking changes
TimePickerSelect	No breaking changes
Toggle	No breaking changes
ToggleSmall	No breaking changes
Toolbar	No breaking changes
ToolbarSearch	No breaking changes
Tooltip	Migrate
TooltipDefinition	No breaking changes
TooltipIcon	No breaking changes
TooltipSimple	Removed, use TooltipDefinition or TooltipIcon instead
UI Shell	New, experimental
UnorderedList	No breaking changes

Polyfills

Required polyfills list has been updated, adding:

• Element.prototype.closest()
• Element.prototype.matches()