Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 43 additions & 8 deletions docs/guides/upgrade-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -519,6 +519,10 @@ type: embed

```

### DrawerLayout

- Previously deprecated `_content` prop has been removed from `DrawerLayout.Tray` and `DrawerLayout.Content`. Use `ref` instead.

### Drilldown

Drilldown itself has no token changes. However, its sub-components share tokens with Options components, so the token changes listed under Options apply here as well:
Expand Down Expand Up @@ -581,6 +585,8 @@ type: embed

### FormField

- Previously deprecated `FormFieldLabel` has been removed.

#### FormFieldGroup

`error` or `success` messages are no longer displayed when the component is `readOnly` or `disabled`.
Expand Down Expand Up @@ -709,6 +715,8 @@ type: embed

The default value of the `color` prop has changed from `'inherit'` to `'primary'`. If you need to preserve the previous behavior, explicitly set `color="inherit"`.

- Previously deprecated `'ai'` value of the `color` prop has been removed. Use the `aiVariant` prop instead.

```js
---
type: embed
Expand Down Expand Up @@ -742,6 +750,8 @@ type: embed
### Link

- `isWithinText` prop has been removed.
- Previously deprecated `_link` prop has been removed. Use `ref` instead.
- `'inline-small'` and `'standalone-small'` values of the `variant` prop have been removed. Use `variant="inline"` or `variant="standalone"` with `size="small"` instead.

#### New `size` prop

Expand All @@ -751,13 +761,6 @@ A new `size` prop has been added to control the font size, line height, and icon
- `'medium'` (default)
- `'large'`

#### Deprecated variant values

Comment on lines -754 to -755
Copy link
Copy Markdown
Contributor Author

@ToMESSKa ToMESSKa May 8, 2026

Choose a reason for hiding this comment

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

This was added by @git-nandor before the multi-versioning was introduced so I deleted this as I think the deprecation is not necessary and we can jump straight to removing these values.

The following variant values have been **deprecated** and will be removed in a future version (still supported but warn):

- `'inline-small'`
- `'standalone-small'`

```js
---
type: embed
Expand Down Expand Up @@ -811,6 +814,8 @@ type: embed

#### Menu.Item

- Previously deprecated `_node` prop has been removed. Use `ref` instead.

```js
---
type: embed
Expand Down Expand Up @@ -1029,6 +1034,10 @@ type: embed

```

### Pagination

- Previously deprecated `_root` prop has been removed. Use `ref` instead.

### Pill

#### Deprecated color prop values
Expand Down Expand Up @@ -1189,7 +1198,10 @@ type: embed
<V12ChangelogTable
removed={[
{name:"handleFocusRingSize",note:"style uses sharedTokens.focusOutline.width token"},
{name:"handleFocusRingColor",note:"style uses sharedTokens.focusOutline.onColor token"}
{name:"handleFocusRingColor",note:"style uses sharedTokens.focusOutline.onColor token"},
{name:"handleFocusOutlineColor",note:"only used by the removed deprecated thumb variant"},
{name:"handleFocusOutlineWidth",note:"only used by the removed deprecated thumb variant"},
{name:"handleShadowColor",note:"only used by the removed deprecated thumb variant"}
Comment on lines +1202 to +1204
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

As the thumb variant was removed here #2544 but I realized these tokens should be removed as well so I updated this and told the designers to remove these tokens too.

]}
changed={[
{oldName:"handleShadow",newName:"boxShadow",note:""},
Expand Down Expand Up @@ -1256,6 +1268,10 @@ type: embed

```

### SimpleSelect

- Previously deprecated `_select` prop has been removed. Use `ref` instead.

### SourceCodeEditor

```js
Expand Down Expand Up @@ -1394,6 +1410,8 @@ type: embed

### Tag

- Previously deprecated `title` prop has been removed.

```js
---
type: embed
Expand Down Expand Up @@ -1486,6 +1504,10 @@ type: embed

```

### TimeSelect

- Previously deprecated `_select` prop has been removed. Use `ref` instead.

### ToggleDetails

```js
Expand Down Expand Up @@ -1527,12 +1549,18 @@ type: embed

### TopNavBar

#### TopNavBar.Layout

- `hideActionsUserSeparator` prop has been removed.
Comment on lines +1553 to +1554
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

this prop was removed in the TopNavrBar rework #2512 because it was a fully 'dead' prop but I realized this was missing from the upgrade guide.


#### TopNavBar.Brand

The deprecated `renderName` and `nameBackground` props have been removed. Please remove them from your code.

### TreeBrowser

- Previously deprecated `_root` prop has been removed. Use `ref` instead.

#### Icon system migration

TreeBrowser now uses Lucide icons instead of the legacy icon system:
Expand Down Expand Up @@ -1575,8 +1603,15 @@ type: embed

```

### TruncateText

- Previously deprecated `_ref` prop has been removed. Use `ref` instead.

### View

- Previously deprecated `_element` prop has been removed. Use `ref` instead.
- Previously deprecated `focusRingBorderRadius` prop has been removed. Use the `borderRadius` prop instead.

```js
---
type: embed
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -56,14 +56,6 @@ class DrawerContent extends Component<DrawerLayoutContentProps> {

ref: HTMLDivElement | null = null

get _content() {
console.warn(
'_content property is deprecated and will be removed in v9, please use ref instead'
)

return this.ref
}

private _resizeListener?: ResizeObserver

private _debounced?: Debounced<NonNullable<typeof this.props.onSizeChange>>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -78,14 +78,6 @@ class DrawerTray extends Component<

private _DOMNode: PortalNode = null

get _content() {
console.warn(
'_content property is deprecated and will be removed in v9, please use ref instead'
)

return this.ref
}

constructor(props: DrawerLayoutTrayProps) {
super(props)

Expand Down
1 change: 0 additions & 1 deletion packages/ui-form-field/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,6 @@ The `ui-form-field` package contains the following:

- [FormField](FormField)
- [FormFieldGroup](FormFieldGroup)
- [FormFieldLabel](FormFieldLabel)
- [FormFieldLayout](FormFieldLayout)
- [FormFieldMessage](FormFieldMessage)
- [FormFieldMessages](FormFieldMessages)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@
import { render } from '@testing-library/react'
import { vi } from 'vitest'
import { runAxeCheck } from '@instructure/ui-axe-check'
import { FormFieldLabel } from '@instructure/ui-form-field/latest'
import { FormFieldLabel } from '@instructure/ui-form-field/v11_6'
import '@testing-library/jest-dom'

describe('<FormFieldLabel />', () => {
Expand Down
95 changes: 0 additions & 95 deletions packages/ui-form-field/src/FormFieldLabel/v2/index.tsx

This file was deleted.

49 changes: 0 additions & 49 deletions packages/ui-form-field/src/FormFieldLabel/v2/props.ts

This file was deleted.

Loading
Loading