Add initial type="" API draft #49

domenic · 2019-07-17T20:56:37Z

This is one take on the discussions in #18, that makes the existing text more concrete. The issue will remain open to discuss these details as well as alternatives.

jackbsteinberg · 2019-07-17T21:19:54Z

README.md

+  similar to the distinctions between e.g. `<ol>` / `<ul>` / `<menu>` or `<strong>` / `<em>` / `<small>`.
+  - Like other semantic distinctions,
+    authors may want to style based on the distinction.
+    The [default styles](#default-styles) only change the border color of the toast,


I like this for the time being, but we definitely want to remember to bring this up in other toast default style conversations (this is a lot subtler than most other toast libraries' type styles)

jackbsteinberg · 2019-07-17T21:22:10Z

README.md

+    The [default styles](#default-styles) only change the border color of the toast,
+    but can be overridden by a page or design system to give any desired appearance.
+  - The default type is `"info"`.
+  - By default, `"error"` toasts will be treated as having the ARIA role semantics of [alert](https://rawgit.com/w3c/aria/master/#alert),


I feel like "warning" toasts should also have the alert role (assuming we're adding aria roles) but that's a personal preference, either could work

Let's leave this pending discussion in #18. I'm inclined to start conservatively.

jackbsteinberg · 2019-07-17T22:06:17Z

README.md

@@ -209,6 +221,9 @@ const toast = document.createElement('std-toast');
 console.log(toast.open); // false
 ```

+The `type` enumerated attribute is reflected [limited to only known values](https://html.spec.whatwg.org/multipage/common-dom-interfaces.html#limited-to-only-known-values),


In the text this shows up looking like "the type enumerated attribute is reflected limited to only known values", there should probably be parens around the limited to only known values portion.

jackbsteinberg · 2019-07-17T22:11:24Z

README.md

-    - TODO([#18](https://github.com/jackbsteinberg/std-toast/issues/18)): decide on list of WAI-ARIA Roles to use, and decide on types to natively support, create, and style.
+- `type`: an [enumerated attribute](https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#enumerated-attribute) giving the type of toast:
+  one of `"info"`, `"success"`, `"warning"`, or `"error"`.
+  This is used to convey the [semantics](https://html.spec.whatwg.org/multipage/dom.html#represents) of the toast,


Thought: should the types be announced differently to screen readers?

For instance with this toast:

<std-toast type="error" open> Access Denied! </std-toast>

Should the screen reader read out something like error: Access Denied!? Or is this encompassed by the toasts' aria roles?

My general understanding is that screen-reader users should not get content tailored only for them in this way, but I have to run for tonight and want to do more reading before making a definitive statement in that regard.

jackbsteinberg · 2019-07-18T21:29:43Z

One issue that came through when exploring the implementation of this API update is that, without an easy way to fallback to a type="info" value, the pattern doesn't make sense. I propose we update the spec language to represent four toast types, success, warning, error, and a default type, the last of which is not explicit and is by definition the absence of type.

The explicit types would could be styled using [type=____ i] selectors, and the default type would be styled directly onto the toast. This way, the default is more of a fallback, absence of type itself, instead of its own distinct type, which would be technically confusing to implement.

domenic · 2019-07-18T22:02:04Z

That makes sense. In particular, having <std-toast></std-toast> behave mostly the same as <std-toast type="info"></std-toast>, except that only the latter works with std-toast[type=info i] { ... } styling, is kind of bad. I'll update to remove the explicit info value for the type="" attribute.

This change adds the toast type attribute and property according to the PR on the toast explainer here: jackbsteinberg/std-toast#49 There is still work TODO on implementing this PR, w.r.t the showToast type option, a11y behavior for warning / error, and default features for those types (Infinity duration, closebutton, etc) Additionally, a follow-up CL will come out to reconfigure the current reflection tests for type and open to use established reflection test methodology (ex: https://cs.chromium.org/chromium/src/third_party/blink/web_tests/wpt_internal/std-switch/tentative/form-associated-basic.js) Bug: 972945 Change-Id: I58c7079dc4f748928eea44103dece835e549986e

This change adds the toast type attribute and property according to the PR on the toast explainer here: jackbsteinberg/std-toast#49 There is still work TODO on implementing this PR, w.r.t the showToast type option, a11y behavior for warning / error, and default features for those types (Infinity duration, closebutton, etc) Additionally, a follow-up CL will come out to reconfigure the current reflection tests for type and open to use established reflection test methodology (ex: https://cs.chromium.org/chromium/src/third_party/blink/web_tests/wpt_internal/std-switch/tentative/form-associated-basic.js) Bug: 972945 Change-Id: I58c7079dc4f748928eea44103dece835e549986e Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/1708313 Commit-Queue: Jack Steinberg <jacksteinberg@chromium.org> Reviewed-by: Fergal Daly <fergal@chromium.org> Cr-Commit-Position: refs/heads/master@{#680073}

This is one take on the discussions in #18, that makes the existing text more concrete. The issue will remain open to discuss these details as well as alternatives.

…aults, for warning/error toasts

…L property and default styles, a=testonly Automatic update from web-platform-tests Add toast type attribute support with IDL property and default styles This change adds the toast type attribute and property according to the PR on the toast explainer here: jackbsteinberg/std-toast#49 There is still work TODO on implementing this PR, w.r.t the showToast type option, a11y behavior for warning / error, and default features for those types (Infinity duration, closebutton, etc) Additionally, a follow-up CL will come out to reconfigure the current reflection tests for type and open to use established reflection test methodology (ex: https://cs.chromium.org/chromium/src/third_party/blink/web_tests/wpt_internal/std-switch/tentative/form-associated-basic.js) Bug: 972945 Change-Id: I58c7079dc4f748928eea44103dece835e549986e Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/1708313 Commit-Queue: Jack Steinberg <jacksteinberg@chromium.org> Reviewed-by: Fergal Daly <fergal@chromium.org> Cr-Commit-Position: refs/heads/master@{#680073} -- wpt-commits: 109a7d171d08bceb61dce865576de3c15f61c16c wpt-pr: 17923

This change adds the toast type attribute and property according to the PR on the toast explainer here: jackbsteinberg/std-toast#49 There is still work TODO on implementing this PR, w.r.t the showToast type option, a11y behavior for warning / error, and default features for those types (Infinity duration, closebutton, etc) Additionally, a follow-up CL will come out to reconfigure the current reflection tests for type and open to use established reflection test methodology (ex: https://cs.chromium.org/chromium/src/third_party/blink/web_tests/wpt_internal/std-switch/tentative/form-associated-basic.js) Bug: 972945 Change-Id: I58c7079dc4f748928eea44103dece835e549986e Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/1708313 Commit-Queue: Jack Steinberg <jacksteinberg@chromium.org> Reviewed-by: Fergal Daly <fergal@chromium.org> Cr-Commit-Position: refs/heads/master@{#680073}

…L property and default styles, a=testonly Automatic update from web-platform-tests Add toast type attribute support with IDL property and default styles This change adds the toast type attribute and property according to the PR on the toast explainer here: jackbsteinberg/std-toast#49 There is still work TODO on implementing this PR, w.r.t the showToast type option, a11y behavior for warning / error, and default features for those types (Infinity duration, closebutton, etc) Additionally, a follow-up CL will come out to reconfigure the current reflection tests for type and open to use established reflection test methodology (ex: https://cs.chromium.org/chromium/src/third_party/blink/web_tests/wpt_internal/std-switch/tentative/form-associated-basic.js) Bug: 972945 Change-Id: I58c7079dc4f748928eea44103dece835e549986e Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/1708313 Commit-Queue: Jack Steinberg <jacksteinbergchromium.org> Reviewed-by: Fergal Daly <fergalchromium.org> Cr-Commit-Position: refs/heads/master{#680073} -- wpt-commits: 109a7d171d08bceb61dce865576de3c15f61c16c wpt-pr: 17923 UltraBlame original commit: 6b977ac34f96effce492d7b372f3cb8f9fe3b3b5

domenic requested a review from jackbsteinberg July 17, 2019 20:56

domenic mentioned this pull request Jul 17, 2019

Theming options #18

Open

jackbsteinberg reviewed Jul 17, 2019

View reviewed changes

chromium-wpt-export-bot mentioned this pull request Jul 22, 2019

Add toast type attribute support with IDL property and default styles web-platform-tests/wpt#17923

Merged

domenic added 3 commits July 30, 2019 16:21

Add initial type="" API draft

8967cfe

This is one take on the discussions in #18, that makes the existing text more concrete. The issue will remain open to discuss these details as well as alternatives.

Eliminate separate info vs. default values

15e26cb

Change show/showToast timeout defaults, and showToast closeButton def…

c882166

…aults, for warning/error toasts

domenic force-pushed the type-attribute branch from 36276a0 to c882166 Compare July 30, 2019 20:23

domenic merged commit b6a6893 into master Jul 30, 2019

domenic deleted the type-attribute branch July 30, 2019 20:24

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add initial type="" API draft #49

Add initial type="" API draft #49

domenic commented Jul 17, 2019

jackbsteinberg Jul 17, 2019

jackbsteinberg Jul 17, 2019

domenic Jul 18, 2019

jackbsteinberg Jul 17, 2019

jackbsteinberg Jul 17, 2019

domenic Jul 18, 2019

jackbsteinberg commented Jul 18, 2019

domenic commented Jul 18, 2019

Add initial type="" API draft #49

Add initial type="" API draft #49

Conversation

domenic commented Jul 17, 2019

jackbsteinberg Jul 17, 2019

Choose a reason for hiding this comment

jackbsteinberg Jul 17, 2019

Choose a reason for hiding this comment

domenic Jul 18, 2019

Choose a reason for hiding this comment

jackbsteinberg Jul 17, 2019

Choose a reason for hiding this comment

jackbsteinberg Jul 17, 2019

Choose a reason for hiding this comment

domenic Jul 18, 2019

Choose a reason for hiding this comment

jackbsteinberg commented Jul 18, 2019

domenic commented Jul 18, 2019