From 3b9b1bc4022db7be6aaa3d7f063f6d60cfa2ef1a Mon Sep 17 00:00:00 2001 From: Jack Steinberg Date: Tue, 25 Jun 2019 16:38:19 +0900 Subject: [PATCH 1/6] Add description of behavior to explainer --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index 5b7937d..7860d98 100644 --- a/README.md +++ b/README.md @@ -159,6 +159,18 @@ See [whatwg/html#4697](https://github.com/whatwg/html/issues/4697) for more disc ### The `` element +#### Behavior + +The `` element provides a subtle, non-interruptive notification to the user at a time of the developer's choosing. +The toast will appear in a developer-supplied position on the screen, +and will typically contain a message and optionally action and dismiss buttons +(though other markup in the element is supported). +The contents will be announced to a screen reader +(politely or assertively depending on `type` [see [#18](https://github.com/jackbsteinberg/std-toast/issues/18)]), +and the optional action / dismiss buttons will appear next in the tabbing order. +After a certain duration, the toast will timeout and hide itself, +but this timeout will be suspended while the toast has focus or `mousehover`. + #### Attributes - [Global attributes](https://html.spec.whatwg.org/multipage/dom.html#global-attributes) From aea0c8b3ceaee9ad9275f0f0806cd91c7402056e Mon Sep 17 00:00:00 2001 From: Jack Steinberg Date: Tue, 25 Jun 2019 16:46:23 +0900 Subject: [PATCH 2/6] Tweak behavior language --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 7860d98..dec339b 100644 --- a/README.md +++ b/README.md @@ -161,15 +161,15 @@ See [whatwg/html#4697](https://github.com/whatwg/html/issues/4697) for more disc #### Behavior -The `` element provides a subtle, non-interruptive notification to the user at a time of the developer's choosing. -The toast will appear in a developer-supplied position on the screen, +The `` element provides a subtle, non-interruptive notification to the user. +The toast will appear at a customized time and position on the screen, and will typically contain a message and optionally action and dismiss buttons (though other markup in the element is supported). The contents will be announced to a screen reader -(politely or assertively depending on `type` [see [#18](https://github.com/jackbsteinberg/std-toast/issues/18)]), +(politely or assertively depending on `type` [see [attributes](####attributes)]), and the optional action / dismiss buttons will appear next in the tabbing order. After a certain duration, the toast will timeout and hide itself, -but this timeout will be suspended while the toast has focus or `mousehover`. +though this timeout will be suspended while the toast has focus or `mousehover`. #### Attributes From 29a6f44dc89d8a925fa68df6e0a6693d52552e71 Mon Sep 17 00:00:00 2001 From: Jack Steinberg Date: Tue, 25 Jun 2019 16:56:49 +0900 Subject: [PATCH 3/6] Update README.md Co-Authored-By: fergald --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index dec339b..d71f4fc 100644 --- a/README.md +++ b/README.md @@ -164,7 +164,7 @@ See [whatwg/html#4697](https://github.com/whatwg/html/issues/4697) for more disc The `` element provides a subtle, non-interruptive notification to the user. The toast will appear at a customized time and position on the screen, and will typically contain a message and optionally action and dismiss buttons -(though other markup in the element is supported). +(though arbitrary markup in the element is supported). The contents will be announced to a screen reader (politely or assertively depending on `type` [see [attributes](####attributes)]), and the optional action / dismiss buttons will appear next in the tabbing order. From 0420b8ed17372bd18c3726a4889f9169d854109d Mon Sep 17 00:00:00 2001 From: Jack Steinberg Date: Tue, 25 Jun 2019 17:13:02 +0900 Subject: [PATCH 4/6] Update README.md Co-Authored-By: Domenic Denicola --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index d71f4fc..6b4283f 100644 --- a/README.md +++ b/README.md @@ -166,7 +166,7 @@ The toast will appear at a customized time and position on the screen, and will typically contain a message and optionally action and dismiss buttons (though arbitrary markup in the element is supported). The contents will be announced to a screen reader -(politely or assertively depending on `type` [see [attributes](####attributes)]), +(politely or assertively depending on `type` [see [attributes](#attributes)]), and the optional action / dismiss buttons will appear next in the tabbing order. After a certain duration, the toast will timeout and hide itself, though this timeout will be suspended while the toast has focus or `mousehover`. From 86169c77e1ad6ec3d188833bda88df2fc3f3ddf7 Mon Sep 17 00:00:00 2001 From: Jack Steinberg Date: Tue, 25 Jun 2019 17:13:12 +0900 Subject: [PATCH 5/6] Update README.md Co-Authored-By: Domenic Denicola --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6b4283f..68d9289 100644 --- a/README.md +++ b/README.md @@ -167,7 +167,7 @@ and will typically contain a message and optionally action and dismiss buttons (though arbitrary markup in the element is supported). The contents will be announced to a screen reader (politely or assertively depending on `type` [see [attributes](#attributes)]), -and the optional action / dismiss buttons will appear next in the tabbing order. +and the focusable contents of the toast, if any, will appear next in the tabbing order. After a certain duration, the toast will timeout and hide itself, though this timeout will be suspended while the toast has focus or `mousehover`. From de47e0af7474597ab7e8356314adc89fa0e5fd25 Mon Sep 17 00:00:00 2001 From: Jack Steinberg Date: Tue, 25 Jun 2019 17:17:02 +0900 Subject: [PATCH 6/6] Update README.md Co-Authored-By: Domenic Denicola --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 68d9289..c4d0623 100644 --- a/README.md +++ b/README.md @@ -169,7 +169,7 @@ The contents will be announced to a screen reader (politely or assertively depending on `type` [see [attributes](#attributes)]), and the focusable contents of the toast, if any, will appear next in the tabbing order. After a certain duration, the toast will timeout and hide itself, -though this timeout will be suspended while the toast has focus or `mousehover`. +though this timeout will be suspended while the toast has focus or the mouse is hovering over it. #### Attributes