Skip to content

Commit

Permalink
docs: remove toggletip references from tag docs (#4205)
Browse files Browse the repository at this point in the history
* remove toggletip references

* update guidance for selectable tag

* update style image

---------

Co-authored-by: kodiakhq[bot] <49736102+kodiakhq[bot]@users.noreply.github.com>
  • Loading branch information
laurenmrice and kodiakhq[bot] authored Aug 23, 2024
1 parent 674d0fd commit ad0902e
Show file tree
Hide file tree
Showing 7 changed files with 19 additions and 16 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 7 additions & 5 deletions src/pages/components/tag/style.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -149,6 +149,8 @@ tokens.
| | | | Background | background-color | `$layer` \* |
| Selectable tag | | Hover | Background | background-color | `$layer-hover` \* |
| | | Focus | Border | border | `$focus` |
| | | Selected | Text | text-color | `$text-inverse` |
| | | | Background | background-color | `$background-inverse` |
| | | Disabled | Text | text-color | `$text-disabled` |
| | | | Border | border | `$border-disabled` |
| | | | Background | background-color | `$layer` \* |
Expand Down Expand Up @@ -274,23 +276,23 @@ There are three fixed heights of tags—large (32px), medium (24px), and small

<div className="image--fixed">

![Structure and spacing measurements of operational tag tooltip and toggletip | px / rem.](images/tag-style-structure-operational-tooltip-toggletip.png)
![Structure and spacing measurements of operational tag tooltip | px / rem.](images/tag-style-structure-operational-tooltip.png)

</div>

<Caption>
Structure and spacing measurements of operational tag tooltip and toggletip |
px / rem.
Structure and spacing measurements of operational tag tooltip | px / rem.
</Caption>

<div className="image--fixed">

![Structure and spacing measurements of operational tag popover | px / rem.](images/tag-style-structure-operational-popover.png)
![Structure and spacing measurements of operational tag popover styles | px / rem.](images/tag-style-structure-operational-popover.png)

</div>

<Caption>
Structure and spacing measurements of operational tag popover | px / rem.
Structure and spacing measurements of operational tag popover styles | px /
rem.
</Caption>

## Size
Expand Down
23 changes: 12 additions & 11 deletions src/pages/components/tag/usage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -114,8 +114,8 @@ to differentiate between them.
- Use in a chat flow to make decisions and advance the chat
- Use for creating user-generated custom labeling and use when needing to remove
created labels
- Use to view an overflow of multiple tags, like in a toggletip, popover, modal,
or detail view
- Use to view an overflow of multiple tags, like in a popover, modal, or detail
view

### When not to use

Expand All @@ -131,7 +131,7 @@ to differentiate between them.
| [Read-only tag](#read-only-tag) | Tags that have no interactive functionality and are commonly used for categorizing and labeling. |
| [Dismissible tag](#dismissible-tag) | Tags that can be dismissed, closed, or removed. These tags are typically used for filtering and creating user-generated content. |
| [Selectable tag](#selectable-tag) | Tags that can be selected or deselected and are frequently used as selections that filter data in the context of a page. They also can be used in chat flows to make decisions to advance the chat. |
| [Operational tag](#operational-tag) | When interacted with, these tags can disclose additional or overflow tags, like in a toggletip, popover, modal, or breadcrumb detail view. |
| [Operational tag](#operational-tag) | When interacted with, these tags can disclose additional or overflow tags, like in a popover, modal, or breadcrumb detail view. |

## Formatting

Expand Down Expand Up @@ -318,7 +318,7 @@ selected state, clicking anywhere on the tag again will deselect it.

Operational tags: Receive a background color change and mouse pointer on hover.
Clicking anywhere on the tag will disclose a way of viewing more related tags in
either a toggletip, popover, modal, or breadcrumb view.
either a popover, modal, or breadcrumb view.

#### Keyboard

Expand All @@ -336,7 +336,7 @@ in the group.

Operational tags: The container receives focus by pressing the `Tab` key.
Pressing the `Enter` or `Space` keys will disclose additional related tags, in a
toggletip, popover, modal, or breadcrumb view.
popover, modal, or breadcrumb view.

### Clickable areas

Expand Down Expand Up @@ -418,10 +418,11 @@ used in a form containing only tags as the selection method, in a chat to make
decisions and forward the chat, and can be used as selections to filter content
on a page or within a component.

In some cases, selectable tags can be used as an alternative to traditional form
In some cases, selectable tags can be an alternative to traditional form
components when the entire form consistently uses tags as its form selection
style. Selectable tags should always remain in high contrast to ensure a
noticeable difference between selected and unselected tags.
style. Selectable tags can be used for multi-selection or single-selection use
cases. These tags should always remain in high contrast to ensure a noticeable
difference between selected and unselected tags.

<Row>
<Column colLg={12}>
Expand Down Expand Up @@ -458,9 +459,9 @@ component for your use case, like a
## Operational tag

Operational tags enable the user to see a more comprehensive view of all tags
disclosed in a toggletip, popover, or breadcrumb detail view. Do not use tags as
links that direct you to an entirely different page or launch you from a current
experience to a separate tab.
disclosed in a popover, or breadcrumb detail view. Do not use tags as links that
direct you to an entirely different page or launch you from a current experience
to a separate tab.

<Row>
<Column colLg={12}>
Expand Down

0 comments on commit ad0902e

Please sign in to comment.