Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(Modal, Menu buttons (Overflow menu), Treeview) Feature flag usage, code tab update #4287

Merged
15 changes: 15 additions & 0 deletions src/pages/components/menu-buttons/code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ title: Menu buttons
tabs: ['Usage', 'Style', 'Code', 'Accessibility']
---

import { Tag } from '@carbon/react';

<PageDescription>

Preview the menu button, combo button, and overflow menu component with the
Expand Down Expand Up @@ -120,6 +122,7 @@ each framework below.
>

<MdxIcon name="react" />
<Tag type="blue">Feature flag</Tag>

</ResourceCard>
</Column>
Expand Down Expand Up @@ -158,6 +161,18 @@ each framework below.
</Column>
</Row>

### Feature flags

A [feature flag](/components/overview/feature-flags/) has been added to the
overflow menu variant of menu buttons to improve accessibility and changes parts
of its functionality, not its visual appearance. For more code-specific feature
flag information, refer to the
[@carbon/react](https://react.carbondesignsystem.com/?path=/docs/experimental-feature-flags-overflowmenu--overview)
framework.

The `enable-v12-overflowmenu` flag improves accessibility by more closely
following the APG pattern for Menu and supports all the new Menu primitives.
laurenmrice marked this conversation as resolved.
Show resolved Hide resolved

## Live demo

<StorybookDemo
Expand Down
12 changes: 12 additions & 0 deletions src/pages/components/menu-buttons/usage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,12 @@ tabs: ['Usage', 'Style', 'Code', 'Accessibility']
---

import A11yStatus from 'components/A11yStatus';
import { Tag } from '@carbon/react';

<PageDescription>

<Tag type="blue">Feature flag</Tag>

Menu buttons, including menu buttons, combo buttons, and overflow menus, open a
menu with a list of interactive options.

Expand Down Expand Up @@ -85,6 +88,15 @@ avoids cluttering the main interface with too many options.
| [Combo button](#combo-button) | Use a combo button when screen real estate is limited and one of the actions has particular importance. They are usually used in the page header. |
| [Overflow menu](#overflow-menu) | Use an overflow menu when additional options are available to the user and there is a space constraint. They are usually used in rows or cards. |

### Feature flags

A [feature flag](/components/overview/feature-flags/) has been added to the
Kritvi-bhatia17 marked this conversation as resolved.
Show resolved Hide resolved
overflow menu variant of menu buttons to improve accessibility and changes parts
of its functionality, not its visual appearance. For code-specific feature flag
information, refer to the [Code](/components/menu-buttons/code/) tab. The
current overflow menu is not being deprecated, but teams are encouraged to use
the feature flag overflow menu for their products moving forward.

## Formatting

### Anatomy
Expand Down
17 changes: 17 additions & 0 deletions src/pages/components/modal/code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ description:
tabs: ['Usage', 'Style', 'Code', 'Accessibility']
---

import { Tag } from '@carbon/react';

<PageDescription>

Preview the modal component with the React live demo. For detailed code usage
Expand All @@ -23,6 +25,7 @@ documentation, see the Storybooks for each framework below.
>

<MdxIcon name="react" />
<Tag type="blue">Feature flag</Tag>

</ResourceCard>
</Column>
Expand Down Expand Up @@ -58,6 +61,20 @@ documentation, see the Storybooks for each framework below.
</Column>
</Row>

### Feature flags

A [feature flag](/components/overview/feature-flags/) has been added to modal to
improve accessibility and changes parts of its functionality, not its visual
appearance. For more code-specific feature flag information, refer to the
[@carbon/react](https://react.carbondesignsystem.com/?path=/docs/experimental-feature-flags-modal--overview)
framework.

The `enable-experimental-focus-wrap-without-sentinels` flag is a new approach to
Kritvi-bhatia17 marked this conversation as resolved.
Show resolved Hide resolved
focus wrap behavior, modifying the DOM to no longer include hidden "sentinel
nodes" that previously marked the beginning and end of the wrapped focus. This
behavior considers all interactive child nodes and wraps focus based on their
tab order.

## Live demo

<StorybookDemo
Expand Down
12 changes: 12 additions & 0 deletions src/pages/components/modal/usage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,12 @@ tabs: ['Usage', 'Style', 'Code', 'Accessibility']
---

import A11yStatus from 'components/A11yStatus';
import { Tag } from '@carbon/react';

<PageDescription>

<Tag type="blue">Feature flag</Tag>

Modals focus the user’s attention exclusively on one task or piece of
information via a window that sits on top of the page content.

Expand Down Expand Up @@ -119,6 +122,15 @@ destructive or irreversible then use a transactional danger modal.
| [Acknowledgment](/components/modal/usage#acknowledgment-modal) | System requires an acknowledgement of the information from the user. Contains only a single button, commonly "OK". |
| [Progress](/components/modal/usage#progress-modal) | Requires several steps to be completed before it can be closed. Contains a cancel, previous, and next/completion buttons. |

### Feature flags

A [feature flag](/components/overview/feature-flags/) has been added to modal to
improve accessibility and changes parts of its functionality, not its visual
appearance. For code-specific feature flag information, refer to the
[Code](/components/modal/code/) tab. The current modal is not being deprecated,
but teams are encouraged to use the feature flag modal for their products moving
forward.

## Formatting

### Anatomy
Expand Down
15 changes: 15 additions & 0 deletions src/pages/components/tree-view/code.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ description:
tabs: ['Usage', 'Style', 'Code', 'Accessibility']
---

import { Tag } from '@carbon/react';

<PageDescription>

Preview the tree view component with the React live demo. For detailed code
Expand All @@ -23,11 +25,24 @@ usage documentation, see the Storybooks for each framework below.
>

<MdxIcon name="react" />
<Tag type="blue">Feature flag</Tag>

</ResourceCard>
</Column>
</Row>

### Feature flags

A [feature flag](/components/overview/feature-flags/) has been added to tree
view to improve accessibility and changes parts of its functionality, not its
visual appearance. For more code-specific feature flag information, refer to the
[@carbon/react](https://react.carbondesignsystem.com/?path=/docs/experimental-feature-flags-treeview--overview)
framework.

The `enable-treeview-controllable` flag allows synchronizing the state
of `selected` and `active` with the application and is a new controllable API of
TreeView.

## Live demo

<StorybookDemo
Expand Down
12 changes: 12 additions & 0 deletions src/pages/components/tree-view/usage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,12 @@ tabs: ['Usage', 'Style', 'Code', 'Accessibility']
---

import A11yStatus from 'components/A11yStatus';
import { Tag } from '@carbon/react';

<PageDescription>

<Tag type="blue">Feature flag</Tag>

A tree view is a hierarchical structure that provides nested levels of
navigation.

Expand Down Expand Up @@ -88,6 +91,15 @@ child nodes.
[breadcrumb](/components/breadcrumb/usage/) component can support an
information architecture several levels deep.

### Feature flags

A [feature flag](/components/overview/feature-flags/) has been added to tree
view to improve accessibility and changes parts of its functionality, not its
visual appearance. For code-specific feature flag information, refer to the
[Code](/components/tree-view/code/) tab. The current tree view is not being
deprecated, but teams are encouraged to use the feature flag tree view for their
products moving forward.

## Formatting

### Anatomy
Expand Down
Loading