You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: components/dialog/README.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,15 +32,15 @@ The `d2l-dialog` element is a generic dialog that provides a slot for arbitrary
32
32
* Label primary actions with clear and predictable language. Use verbs like, “Add” or “Save” that indicate the outcome of a dialog rather than, “OK” or “Close”
33
33
* Keep dialog titles concise
34
34
* Maintain a language relationship between the action that triggered the dialog, dialog title, and dialog primary button.
35
-
* When it is necessary to stack multiple dialogs, ensure the stacked dialog is nested within the DOM of the dialog containing the opener
35
+
* When it is necessary to nest multiple dialogs, ensure the nested dialog is within the DOM of the dialog containing the opener
36
36
<!-- docs: end dos -->
37
37
38
38
<!-- docs: start donts -->
39
39
* Don’t use a dialog when you could reasonably use an alternative that preserves user context, like expanding options inline
40
40
* Don’t use a dialog to show error, success, or warning messages. Use an inline or toast alert instead.
41
-
* Avoid creating large, complex dialogs
42
-
* Avoid opening a dialog from within other dialogs (stacking dialogs)
43
-
* Avoid a title length that could easily wrap to two lines
41
+
* Avoid opening a dialog from another dialog (nesting) since this can increase cognitive load and disorient users
42
+
* Exception: confirmation dialogs that protect users from losing unsaved work
43
+
* Avoid titles that are long enough to wrap onto multiple lines
0 commit comments