diff --git a/1st-gen/packages/tray/README.md b/1st-gen/packages/tray/README.md index e8ad8ca004e..e9533a3dd77 100644 --- a/1st-gen/packages/tray/README.md +++ b/1st-gen/packages/tray/README.md @@ -25,11 +25,7 @@ import { Tray } from '@spectrum-web-components/tray'; ### Anatomy -A tray has a single default `slot`. - - -Dialog - +A tray has a single default `slot`. Expected content typically includes dialogs and their content, plain text, forms and/or form elements, and some native HTML elements. Always ensure that your tray's content is accessible according to WCAG standards. ```html @@ -43,30 +39,6 @@ A tray has a single default `slot`. ``` - -Menu - - -```html - - Toggle menu - - - Deselect - Select Inverse - Feather... - Select and Mask... - - Save Selection - Make Work Path - - - -``` - - - - ### Accessibility `` presents a page blocking experience and should be opened with the `Overlay` API using the `modal` interaction to ensure that the content appropriately manages the presence of other content in the tab order of the page and the availability of that content for a screen reader. @@ -87,20 +59,35 @@ This dismiss helper pattern is also implemented in the [``](https://o Content has no buttons -This example shows the default behavior where the tray automatically detects that the menu content lacks dismiss buttons and renders visually hidden helpers. Screen readers will announce them as "Dismiss, button" and these helpers are keyboard accessible. +This example shows the default behavior where the tray automatically detects that the content lacks dismiss buttons and renders visually hidden helpers. Screen readers will announce them as "Dismiss, button" and these helpers are keyboard accessible. ```html - Toggle menu content + Toggle tray content - - Deselect - Select Inverse - Feather... - Select and Mask... - +
+

+ Custom content that doesn't have dismiss functionality, so the + tray detects it needs the visually-hidden dismiss buttons. +

+ +
``` @@ -137,7 +124,7 @@ Set `has-keyboard-dismiss` (or `has-keyboard-dismiss="true"`) to prevent the tra Toggle without helpers -

+

Custom content that should have custom dismiss functionality, even though the tray didn't detect buttons in this slot.