@brightspace-ui/core 2.26.2 → 2.27.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/components/alert/README.md +0 -4
- package/components/breadcrumbs/README.md +0 -12
- package/components/button/README.md +0 -12
- package/components/button/floating-buttons.md +0 -4
- package/components/calendar/README.md +0 -4
- package/components/card/README.md +0 -4
- package/components/colors/README.md +0 -12
- package/components/count-badge/README.md +0 -9
- package/components/dialog/README.md +0 -12
- package/components/dropdown/README.md +0 -29
- package/components/expand-collapse/README.md +0 -8
- package/components/filter/README.md +0 -15
- package/components/form/docs/form-element-nesting.md +0 -4
- package/components/form/docs/form.md +0 -4
- package/components/inputs/README.md +0 -4
- package/components/inputs/docs/input-checkbox.md +0 -8
- package/components/inputs/docs/input-date-time.md +0 -24
- package/components/inputs/docs/input-numeric.md +0 -8
- package/components/inputs/docs/input-radio.md +0 -4
- package/components/inputs/docs/input-search.md +0 -4
- package/components/inputs/docs/input-select-styles.md +0 -4
- package/components/inputs/docs/input-text.md +0 -12
- package/components/link/README.md +0 -6
- package/components/list/README.md +0 -24
- package/components/loading-spinner/README.md +0 -3
- package/components/menu/README.md +0 -20
- package/components/menu/menu-item-mixin.js +3 -1
- package/components/menu/menu-item-styles.js +4 -19
- package/components/menu/menu.js +2 -1
- package/components/meter/README.md +0 -19
- package/components/overflow-group/README.md +0 -4
- package/components/scroll-wrapper/README.md +0 -4
- package/components/selection/README.md +0 -6
- package/components/skeleton/README.md +1 -11
- package/components/status-indicator/README.md +0 -4
- package/components/switch/README.md +0 -7
- package/components/table/README.md +0 -16
- package/components/tabs/README.md +0 -8
- package/components/tooltip/README.md +0 -8
- package/components/typography/README.md +0 -10
- package/components/typography/demo/typography.html +6 -0
- package/components/typography/styles.js +38 -0
- package/components/typography/typography.js +39 -0
- package/directives/animate/README.md +1 -5
- package/package.json +1 -2
- package/templates/primary-secondary/README.md +0 -4
- package/components/alert/screenshots/alert.png +0 -0
- package/components/breadcrumbs/screenshots/basic.png +0 -0
- package/components/breadcrumbs/screenshots/compact.png +0 -0
- package/components/breadcrumbs/screenshots/limited-width.png +0 -0
- package/components/button/screenshots/button-icon.png +0 -0
- package/components/button/screenshots/button-subtle.png +0 -0
- package/components/button/screenshots/button.png +0 -0
- package/components/button/screenshots/floating-buttons.png +0 -0
- package/components/calendar/screenshots/calendar.png +0 -0
- package/components/card/screenshots/card.png +0 -0
- package/components/colors/screenshots/basic-greys.png +0 -0
- package/components/colors/screenshots/feedback.png +0 -0
- package/components/colors/screenshots/primary-accents.png +0 -0
- package/components/count-badge/screenshots/count-badge-count-large.png +0 -0
- package/components/count-badge/screenshots/count-badge-icon.png +0 -0
- package/components/count-badge/screenshots/count-badge-notification-small.png +0 -0
- package/components/dialog/screenshots/dialog-confirm.png +0 -0
- package/components/dialog/screenshots/dialog-fullscreen.png +0 -0
- package/components/dialog/screenshots/dialog.png +0 -0
- package/components/dropdown/screenshots/dropdown-button-subtle.png +0 -0
- package/components/dropdown/screenshots/dropdown-button.png +0 -0
- package/components/dropdown/screenshots/dropdown-content-mobile-tray.png +0 -0
- package/components/dropdown/screenshots/dropdown-content.png +0 -0
- package/components/dropdown/screenshots/dropdown-context-menu.png +0 -0
- package/components/dropdown/screenshots/dropdown-menu.png +0 -0
- package/components/dropdown/screenshots/dropdown-more.png +0 -0
- package/components/dropdown/screenshots/dropdown-tabs.png +0 -0
- package/components/expand-collapse/screenshots/expand-collapse-content.gif +0 -0
- package/components/expand-collapse/screenshots/more-less.png +0 -0
- package/components/filter/screenshots/filter-mobile.png +0 -0
- package/components/filter/screenshots/filter-multi-dim.png +0 -0
- package/components/filter/screenshots/filter.png +0 -0
- package/components/form/screenshots/form-native.gif +0 -0
- package/components/form/screenshots/nesting-invalid-styling.png +0 -0
- package/components/form/screenshots/nesting-tooltip-conflict.png +0 -0
- package/components/inputs/screenshots/checkbox.gif +0 -0
- package/components/inputs/screenshots/date-range.gif +0 -0
- package/components/inputs/screenshots/date-time-range.gif +0 -0
- package/components/inputs/screenshots/date-time.gif +0 -0
- package/components/inputs/screenshots/date.gif +0 -0
- package/components/inputs/screenshots/label-required.png +0 -0
- package/components/inputs/screenshots/label.png +0 -0
- package/components/inputs/screenshots/number.png +0 -0
- package/components/inputs/screenshots/percent.png +0 -0
- package/components/inputs/screenshots/radio.gif +0 -0
- package/components/inputs/screenshots/search.gif +0 -0
- package/components/inputs/screenshots/select.gif +0 -0
- package/components/inputs/screenshots/text.gif +0 -0
- package/components/inputs/screenshots/textarea-styles.gif +0 -0
- package/components/inputs/screenshots/textarea.gif +0 -0
- package/components/inputs/screenshots/time-range.gif +0 -0
- package/components/inputs/screenshots/time.gif +0 -0
- package/components/link/screenshots/main.png +0 -0
- package/components/link/screenshots/small.png +0 -0
- package/components/link/screenshots/standard.png +0 -0
- package/components/list/screenshots/drag-and-drop.gif +0 -0
- package/components/list/screenshots/list-item-content.png +0 -0
- package/components/list/screenshots/list-item.png +0 -0
- package/components/list/screenshots/list-selection.png +0 -0
- package/components/list/screenshots/list.png +0 -0
- package/components/loading-spinner/screenshots/loading-spinner.gif +0 -0
- package/components/menu/screenshots/checkbox-menu.png +0 -0
- package/components/menu/screenshots/menu-items.png +0 -0
- package/components/menu/screenshots/menu.png +0 -0
- package/components/menu/screenshots/nested-menu.png +0 -0
- package/components/menu/screenshots/radio-menu.png +0 -0
- package/components/meter/screenshots/d2l-meter-circle-completed.png +0 -0
- package/components/meter/screenshots/d2l-meter-circle-has-progress.png +0 -0
- package/components/meter/screenshots/d2l-meter-circle-no-progress.png +0 -0
- package/components/meter/screenshots/d2l-meter-linear-completed.png +0 -0
- package/components/meter/screenshots/d2l-meter-linear-has-progress.png +0 -0
- package/components/meter/screenshots/d2l-meter-linear-no-progress.png +0 -0
- package/components/meter/screenshots/d2l-meter-radial-completed.png +0 -0
- package/components/meter/screenshots/d2l-meter-radial-has-progress.png +0 -0
- package/components/meter/screenshots/d2l-meter-radial-no-progress.png +0 -0
- package/components/meter/screenshots/d2l-meter-radial-with-text.png +0 -0
- package/components/overflow-group/screenshots/overflow-group.png +0 -0
- package/components/scroll-wrapper/screenshots/scroll-wrapper.gif +0 -0
- package/components/selection/screenshots/selection-multiple.png +0 -0
- package/components/selection/screenshots/selection-single.png +0 -0
- package/components/skeleton/screenshots/container.png +0 -0
- package/components/skeleton/screenshots/overview.png +0 -0
- package/components/skeleton/screenshots/paragraph.png +0 -0
- package/components/skeleton/screenshots/text-input.png +0 -0
- package/components/status-indicator/screenshots/bold-indicators.png +0 -0
- package/components/status-indicator/screenshots/default-indicator.png +0 -0
- package/components/status-indicator/screenshots/subtle-indicators.png +0 -0
- package/components/switch/screenshots/switch-visibility.png +0 -0
- package/components/switch/screenshots/switch.png +0 -0
- package/components/table/screenshots/default.png +0 -0
- package/components/table/screenshots/light.png +0 -0
- package/components/table/screenshots/selection.gif +0 -0
- package/components/table/screenshots/sorting.gif +0 -0
- package/components/table/screenshots/sticky.gif +0 -0
- package/components/tabs/screenshots/tabs.png +0 -0
- package/components/tooltip/screenshots/tooltip-boundary.png +0 -0
- package/components/tooltip/screenshots/tooltip-error.png +0 -0
- package/components/typography/screenshots/body-compact.png +0 -0
- package/components/typography/screenshots/body-small.png +0 -0
- package/components/typography/screenshots/body-standard.png +0 -0
- package/components/typography/screenshots/headings.png +0 -0
- package/components/typography/screenshots/labels.png +0 -0
- package/directives/animate/screenshots/focus.gif +0 -0
- package/directives/animate/screenshots/show-hide.gif +0 -0
- package/templates/primary-secondary/screenshots/primary-secondary.gif +0 -0
|
@@ -63,10 +63,6 @@ The `d2l-alert` component can be used to communicate important information relat
|
|
|
63
63
|
<!-- docs: end donts -->
|
|
64
64
|
<!-- docs: end best practices -->
|
|
65
65
|
|
|
66
|
-
<!-- docs: start hidden content -->
|
|
67
|
-

|
|
68
|
-
<!-- docs: end hidden content -->
|
|
69
|
-
|
|
70
66
|
<!-- docs: demo live name:d2l-alert autoSize:false -->
|
|
71
67
|
```html
|
|
72
68
|
<script type="module">
|
|
@@ -2,10 +2,6 @@
|
|
|
2
2
|
|
|
3
3
|
Breadcrumbs are a way-finding tool that helps users understand where they are within an application, while also offering an easy way to navigate "up" to higher level pages.
|
|
4
4
|
|
|
5
|
-
<!-- docs: start hidden content -->
|
|
6
|
-

|
|
7
|
-
<!-- docs: end hidden content -->
|
|
8
|
-
|
|
9
5
|
<!-- docs: demo display:block -->
|
|
10
6
|
```html
|
|
11
7
|
<script type="module">
|
|
@@ -53,10 +49,6 @@ This works well for mobile or other touch devices but not as well for mouse or k
|
|
|
53
49
|
|
|
54
50
|
### Limited Width
|
|
55
51
|
|
|
56
|
-
<!-- docs: start hidden content -->
|
|
57
|
-

|
|
58
|
-
<!-- docs: end hidden content -->
|
|
59
|
-
|
|
60
52
|
Set a `max-width` to constrain breadcrumbs to a particular width:
|
|
61
53
|
|
|
62
54
|
<!-- docs: demo code display:block -->
|
|
@@ -72,10 +64,6 @@ Set a `max-width` to constrain breadcrumbs to a particular width:
|
|
|
72
64
|
|
|
73
65
|
### Compact Mode
|
|
74
66
|
|
|
75
|
-
<!-- docs: start hidden content -->
|
|
76
|
-

|
|
77
|
-
<!-- docs: end hidden content -->
|
|
78
|
-
|
|
79
67
|
Alternately, add the `compact` attribute to only display the last breadcrumb. The `d2l-breadcrumb-current-page` will be hidden:
|
|
80
68
|
|
|
81
69
|
<!-- docs: demo code display:block -->
|
|
@@ -34,10 +34,6 @@ A Button is used to communicate and perform an action.
|
|
|
34
34
|
|
|
35
35
|
The `d2l-button` element can be used just like the native button element, but also supports the `primary` attribute for denoting the primary button.
|
|
36
36
|
|
|
37
|
-
<!-- docs: start hidden content -->
|
|
38
|
-

|
|
39
|
-
<!-- docs: end hidden content -->
|
|
40
|
-
|
|
41
37
|
<!-- docs: demo live name:d2l-button -->
|
|
42
38
|
```html
|
|
43
39
|
<script type="module">
|
|
@@ -73,10 +69,6 @@ The `d2l-button-subtle` element can be used just like the native `button`, but f
|
|
|
73
69
|
|
|
74
70
|
**Note:** It is strongly recommended to use `text` and `icon` as opposed to putting content in the `slot` to ensure that the recommended subtle button style is maintained.
|
|
75
71
|
|
|
76
|
-
<!-- docs: start hidden content -->
|
|
77
|
-

|
|
78
|
-
<!-- docs: end hidden content -->
|
|
79
|
-
|
|
80
72
|
<!-- docs: demo live name:d2l-button-subtle -->
|
|
81
73
|
```html
|
|
82
74
|
<script type="module">
|
|
@@ -113,10 +105,6 @@ To make your `d2l-button-subtle` accessible, use the following properties when a
|
|
|
113
105
|
|
|
114
106
|
The `d2l-button-icon` element can be used just like the native `button`, for instances where only an icon is displayed.
|
|
115
107
|
|
|
116
|
-
<!-- docs: start hidden content -->
|
|
117
|
-

|
|
118
|
-
<!-- docs: end hidden content -->
|
|
119
|
-
|
|
120
108
|
<!-- docs: demo live name:d2l-button-icon -->
|
|
121
109
|
```html
|
|
122
110
|
<script type="module">
|
|
@@ -25,10 +25,6 @@ Floating workflow buttons behavior can be added by using the `<d2l-floating-butt
|
|
|
25
25
|
</d2l-floating-buttons>
|
|
26
26
|
```
|
|
27
27
|
|
|
28
|
-
<!-- docs: start hidden content -->
|
|
29
|
-

|
|
30
|
-
<!-- docs: end hidden content -->
|
|
31
|
-
|
|
32
28
|
## Floating Buttons [d2l-floating-buttons]
|
|
33
29
|
|
|
34
30
|
<!-- docs: demo live name:d2l-floating-buttons autoSize:false display:block size:medium -->
|
|
@@ -2,10 +2,6 @@
|
|
|
2
2
|
|
|
3
3
|
The `d2l-calendar` component can be used to display a responsively sized calendar that allows for date selection. It indicates the currently selected date if `selected-value` is specified, or if the user selects a date.
|
|
4
4
|
|
|
5
|
-
<!-- docs: start hidden content -->
|
|
6
|
-

|
|
7
|
-
<!-- docs: end hidden content -->
|
|
8
|
-
|
|
9
5
|
## Calendar [d2l-calendar]
|
|
10
6
|
|
|
11
7
|
<!-- docs: demo live name:d2l-calendar display:block -->
|
|
@@ -107,10 +107,6 @@ Cards are composed of 3 sections. Each card will have a content section but is n
|
|
|
107
107
|
|
|
108
108
|
The `d2l-card` element is a container that provides specific layout using several slots such as `content`, `header`, `footer`, `badge`, and `actions`. It can also be configured as a link for navigation.
|
|
109
109
|
|
|
110
|
-
<!-- docs: start hidden content -->
|
|
111
|
-

|
|
112
|
-
<!-- docs: end hidden content -->
|
|
113
|
-
|
|
114
110
|
<!-- docs: demo live name:d2l-card size:large -->
|
|
115
111
|
```html
|
|
116
112
|
<script type="module">
|
|
@@ -12,18 +12,6 @@ Run the demo page to see the full palette. See [colors.js](colors.js) for the va
|
|
|
12
12
|
</script>
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
## Basic Greys
|
|
16
|
-
|
|
17
|
-

|
|
18
|
-
|
|
19
|
-
## Primary Accent
|
|
20
|
-
|
|
21
|
-

|
|
22
|
-
|
|
23
|
-
## Feedback
|
|
24
|
-
|
|
25
|
-

|
|
26
|
-
|
|
27
15
|
## Future Enhancements
|
|
28
16
|
|
|
29
17
|
Looking for an enhancement not listed here? Create a GitHub issue!
|
|
@@ -17,11 +17,6 @@ Badges can be used to provide additional contextual information to users in rega
|
|
|
17
17
|
|
|
18
18
|
The `d2l-count-badge` element is a web component to display a number count, depending on your use case different styling options are available.
|
|
19
19
|
|
|
20
|
-
<!-- docs: start hidden content -->
|
|
21
|
-
 -->
|
|
22
|
-

|
|
23
|
-
<!-- docs: end hidden content -->
|
|
24
|
-
|
|
25
20
|
<!-- docs: demo live name:d2l-count-badge -->
|
|
26
21
|
```html
|
|
27
22
|
<script type="module">
|
|
@@ -59,10 +54,6 @@ The `d2l-count-badge` element is a web component to display a number count, depe
|
|
|
59
54
|
|
|
60
55
|
The `d2l-count-badge-icon` element is a web component to display a number count, either in a `"notification"` or `"count"` style with an icon.
|
|
61
56
|
|
|
62
|
-
<!-- docs: start hidden content -->
|
|
63
|
-

|
|
64
|
-
<!-- docs: end hidden content -->
|
|
65
|
-
|
|
66
57
|
<!-- docs: demo live name:d2l-count-badge-icon -->
|
|
67
58
|
```html
|
|
68
59
|
<script type="module">
|
|
@@ -43,10 +43,6 @@ The `d2l-dialog` element is a generic dialog that provides a slot for arbitrary
|
|
|
43
43
|
<!-- docs: end donts -->
|
|
44
44
|
<!-- docs: end best practices -->
|
|
45
45
|
|
|
46
|
-
<!-- docs: start hidden content -->
|
|
47
|
-

|
|
48
|
-
<!-- docs: end hidden content -->
|
|
49
|
-
|
|
50
46
|
<!-- docs: demo live name:d2l-dialog autoSize:false display:block size:large -->
|
|
51
47
|
```html
|
|
52
48
|
<script type="module">
|
|
@@ -157,10 +153,6 @@ The `d2l-dialog-confirm` element is a simple confirmation dialog for prompting t
|
|
|
157
153
|
<!-- docs: end donts -->
|
|
158
154
|
<!-- docs: end best practices -->
|
|
159
155
|
|
|
160
|
-
<!-- docs: start hidden content -->
|
|
161
|
-

|
|
162
|
-
<!-- docs: end hidden content -->
|
|
163
|
-
|
|
164
156
|
<!-- docs: demo live name:d2l-dialog-confirm autoSize:false display:block size:large -->
|
|
165
157
|
```html
|
|
166
158
|
<script type="module">
|
|
@@ -214,10 +206,6 @@ document.querySelector('#open').addEventListener('click', () => {
|
|
|
214
206
|
|
|
215
207
|
The `d2l-dialog-fullscreen` element is a fullscreen variant of the generic `d2l-dialog`. It provides a slot for arbitrary content, and a `footer` slot for workflow buttons. Apply the `data-dialog-action` attribute to workflow buttons to automatically close the dialog with the action value.
|
|
216
208
|
|
|
217
|
-
<!-- docs: start hidden content -->
|
|
218
|
-

|
|
219
|
-
<!-- docs: end hidden content -->
|
|
220
|
-
|
|
221
209
|
<!-- docs: demo live name:d2l-dialog-fullscreen autoSize:false display:block size:large -->
|
|
222
210
|
```html
|
|
223
211
|
<script type="module">
|
|
@@ -58,10 +58,6 @@ If the dropdown is initially empty when it's opened, the dropdown pointer will n
|
|
|
58
58
|
## Opener: Dropdown Button [d2l-dropdown-button]
|
|
59
59
|
`d2l-dropdown-button` is a `d2l-button` opener for dropdown content (`d2l-dropdown-content`, `d2l-dropdown-menu` or `d2l-dropdown-tabs`).
|
|
60
60
|
|
|
61
|
-
<!-- docs: start hidden content -->
|
|
62
|
-

|
|
63
|
-
<!-- docs: end hidden content -->
|
|
64
|
-
|
|
65
61
|
<!-- docs: demo live name:d2l-dropdown-button align:flex-start autoOpen:true autoSize:false size:medium -->
|
|
66
62
|
```html
|
|
67
63
|
<script type="module">
|
|
@@ -90,10 +86,6 @@ If the dropdown is initially empty when it's opened, the dropdown pointer will n
|
|
|
90
86
|
## Opener: Button Subtle [d2l-dropdown-button-subtle]
|
|
91
87
|
`d2l-dropdown-button-subtle` is a `d2l-button-subtle` opener for dropdown content (`d2l-dropdown-content`, `d2l-dropdown-menu` or `d2l-dropdown-tabs`).
|
|
92
88
|
|
|
93
|
-
<!-- docs: start hidden content -->
|
|
94
|
-

|
|
95
|
-
<!-- docs: end hidden content -->
|
|
96
|
-
|
|
97
89
|
<!-- docs: demo live name:d2l-dropdown-button-subtle align:flex-start autoOpen:true autoSize:false size:medium -->
|
|
98
90
|
```html
|
|
99
91
|
<script type="module">
|
|
@@ -131,10 +123,6 @@ To make your `d2l-dropdown-button-subtle` accessible, use the following properti
|
|
|
131
123
|
## Opener: Context Menu [d2l-dropdown-context-menu]
|
|
132
124
|
`d2l-dropdown-context-menu` is a simple/minimal opener for dropdown content (`d2l-dropdown-content`, `d2l-dropdown-menu` or `d2l-dropdown-tabs`).
|
|
133
125
|
|
|
134
|
-
<!-- docs: start hidden content -->
|
|
135
|
-

|
|
136
|
-
<!-- docs: end hidden content -->
|
|
137
|
-
|
|
138
126
|
<!-- docs: demo live name:d2l-dropdown-context-menu align:flex-start autoOpen:true autoSize:false size:medium -->
|
|
139
127
|
```html
|
|
140
128
|
<script type="module">
|
|
@@ -172,10 +160,6 @@ To make your usage of `d2l-dropdown-context-menu` accessible, use the following
|
|
|
172
160
|
## Opener: More [d2l-dropdown-more]
|
|
173
161
|
`d2l-dropdown-more` is a simple/minimal opener for dropdown content (`d2l-dropdown-content`, `d2l-dropdown-menu` or `d2l-dropdown-tabs`).
|
|
174
162
|
|
|
175
|
-
<!-- docs: start hidden content -->
|
|
176
|
-

|
|
177
|
-
<!-- docs: end hidden content -->
|
|
178
|
-
|
|
179
163
|
<!-- docs: demo live name:d2l-dropdown-more align:flex-start autoOpen:true autoSize:false size:medium -->
|
|
180
164
|
```html
|
|
181
165
|
<script type="module">
|
|
@@ -213,11 +197,6 @@ To make your usage of `d2l-dropdown-more` accessible, use the following property
|
|
|
213
197
|
## Content: Container [d2l-dropdown-content]
|
|
214
198
|
`d2l-dropdown-content` is a generic container for dropdown content. It provides behavior such as sizing, positioning, and managing focus gain/loss.
|
|
215
199
|
|
|
216
|
-
<!-- docs: start hidden content -->
|
|
217
|
-

|
|
218
|
-

|
|
219
|
-
<!-- docs: end hidden content -->
|
|
220
|
-
|
|
221
200
|
<!-- docs: demo live name:d2l-dropdown-content align:flex-start autoSize:false autoOpen:true size:medium -->
|
|
222
201
|
```html
|
|
223
202
|
<script type="module">
|
|
@@ -276,10 +255,6 @@ To make your usage of `d2l-dropdown-more` accessible, use the following property
|
|
|
276
255
|
## Content: Menu [d2l-dropdown-menu]
|
|
277
256
|
`d2l-dropdown-menu` is a container for a [d2l-menu](../menu/README.md) component. It provides additional support on top of `d2l-dropdown-content` for closing the menu when menu items are selected, resetting to the root of nested menus when reopening and automatic resizing when the menu resizes.
|
|
278
257
|
|
|
279
|
-
<!-- docs: start hidden content -->
|
|
280
|
-

|
|
281
|
-
<!-- docs: end hidden content -->
|
|
282
|
-
|
|
283
258
|
<!-- docs: demo live name:d2l-dropdown-menu align:flex-start autoSize:false size:medium -->
|
|
284
259
|
```html
|
|
285
260
|
<script type="module">
|
|
@@ -319,10 +294,6 @@ To make your usage of `d2l-dropdown-more` accessible, use the following property
|
|
|
319
294
|
## Content: Tabs [d2l-dropdown-tabs]
|
|
320
295
|
`d2l-dropdown-tabs` is a container for a [d2l-tabs](https://github.com/BrightspaceUI/tabs) component. It provides additional support on top of `d2l-dropdown-content` for automatic resizing when the tab changes.
|
|
321
296
|
|
|
322
|
-
<!-- docs: start hidden content -->
|
|
323
|
-

|
|
324
|
-
<!-- docs: end hidden content -->
|
|
325
|
-
|
|
326
297
|
<!-- docs: demo live name:d2l-dropdown-tabs autoOpen:true autoSize:false align:flex-start size:large -->
|
|
327
298
|
```html
|
|
328
299
|
<script type="module">
|
|
@@ -4,10 +4,6 @@
|
|
|
4
4
|
|
|
5
5
|
The `d2l-expand-collapse-content` element can be used to create expandable and collapsible content. This component only provides the logic to expand and collapse the content; controlling when and how it expands or collapses is the responsibility of the user.
|
|
6
6
|
|
|
7
|
-
<!-- docs: start hidden content -->
|
|
8
|
-

|
|
9
|
-
<!-- docs: end hidden content -->
|
|
10
|
-
|
|
11
7
|
<!-- docs: demo live name:d2l-expand-collapse-content autoSize:false display:block size:small -->
|
|
12
8
|
```html
|
|
13
9
|
<script type="module">
|
|
@@ -48,10 +44,6 @@ To make your usage of `d2l-expand-collapse-content` accessible, the [`aria-expan
|
|
|
48
44
|
|
|
49
45
|
The `d2l-more-less` element can be used to minimize the display of long content, while providing a way to reveal the full content.
|
|
50
46
|
|
|
51
|
-
<!-- docs: start hidden content -->
|
|
52
|
-

|
|
53
|
-
<!-- docs: end hidden content -->
|
|
54
|
-
|
|
55
47
|
<!-- docs: demo live name:d2l-more-less -->
|
|
56
48
|
```html
|
|
57
49
|
<script type="module">
|
|
@@ -2,11 +2,6 @@
|
|
|
2
2
|
|
|
3
3
|
Filter components are often used in conjuction with [tables](../../components/table) and allow users to select a subset of the presented data based on a set of parameters. Filter dimensions provide methods for entering parameters for a wide range of data types.
|
|
4
4
|
|
|
5
|
-
<!-- docs: start hidden content -->
|
|
6
|
-
Filter with multiple dimensions:
|
|
7
|
-

|
|
8
|
-
<!-- docs: end hidden content -->
|
|
9
|
-
|
|
10
5
|
<!-- docs: demo align:start autoOpen:true autoSize:false size:large -->
|
|
11
6
|
```html
|
|
12
7
|
<script type="module">
|
|
@@ -71,11 +66,6 @@ The `d2l-filter` component allows a user to filter on one or more dimensions of
|
|
|
71
66
|
### Single Vs Multi Dimensional
|
|
72
67
|
A filter can be a single dimension (like picking from a list of courses) or offer multiple dimensions (filter by role, or department, or something else). Single-dimension filters can be used side-by-side to promote filters that are more commonly used, while tucking less-used filters into a multi-dimensional filter.
|
|
73
68
|
|
|
74
|
-
<!-- docs: start hidden content -->
|
|
75
|
-
Filter with a single dimension:
|
|
76
|
-

|
|
77
|
-
<!-- docs: end hidden content -->
|
|
78
|
-
|
|
79
69
|
<!-- docs: demo code align:start autoSize:false size:large -->
|
|
80
70
|
```html
|
|
81
71
|
<script type="module">
|
|
@@ -173,11 +163,6 @@ The filter will announce changes to filter selections, search results, and when
|
|
|
173
163
|
|
|
174
164
|
The `d2l-filter-dimension-set` component is the main dimension type that will work for most use cases. Used alongside the [d2l-filter-dimension-set-value](#filter-dimension%3A-set-value-%5Bd2l-filter-dimension-set-value%5D), this will give you a selectable list of filter values.
|
|
175
165
|
|
|
176
|
-
<!-- docs: start hidden content -->
|
|
177
|
-
Set dimension on mobile:
|
|
178
|
-

|
|
179
|
-
<!-- docs: end hidden content -->
|
|
180
|
-
|
|
181
166
|
<!-- docs: demo live name:d2l-filter-dimension-set align:start autoOpen:true autoSize:false size:large -->
|
|
182
167
|
```html
|
|
183
168
|
<script type="module">
|
|
@@ -145,8 +145,6 @@ get validationMessage() {
|
|
|
145
145
|
|
|
146
146
|
**5. Prevent tooltip overlap:**
|
|
147
147
|
|
|
148
|
-

|
|
149
|
-
|
|
150
148
|
Now that we have the validation logic for the parent and nested custom form elements, we need to make sure their validation tooltips don't overlap. To do this we will hide the tooltip using the `childErrors` `Map` which will tell us if any of the nested form elements are currently displaying validation errors.
|
|
151
149
|
|
|
152
150
|
```javascript
|
|
@@ -165,8 +163,6 @@ render() {
|
|
|
165
163
|
|
|
166
164
|
**6: Adding invalid styling for the nested custom form elements:**
|
|
167
165
|
|
|
168
|
-

|
|
169
|
-
|
|
170
166
|
Now that the tooltips no longer overlap, we want to ensure the nested `input-text` elements look invalid even if only the parent is actually invalid. To do this, we will use the `forceInvalid` property to force the nested elements to look invalid when the parent is invalid.
|
|
171
167
|
|
|
172
168
|
```javascript
|
|
@@ -18,8 +18,6 @@ Groups of inputs (like checkboxes or radios) should be wrapped in a `<fieldset>`
|
|
|
18
18
|
|
|
19
19
|
### Visible labels using the `<label>` element
|
|
20
20
|
|
|
21
|
-

|
|
22
|
-
|
|
23
21
|
Import the label styles and `RtlMixin` and include them in your component:
|
|
24
22
|
|
|
25
23
|
```javascript
|
|
@@ -55,8 +53,6 @@ Alternately, associate the `<label>` with the input using the `for` and `id` att
|
|
|
55
53
|
|
|
56
54
|
For required inputs, add the `d2l-input-label-required` CSS class to the label to get a visual indicator. Don't forget to add `aria-required="true"` to the input so that assistive technology is aware as well.
|
|
57
55
|
|
|
58
|
-

|
|
59
|
-
|
|
60
56
|
```html
|
|
61
57
|
<label for="myInput" class="d2l-input-label d2l-input-label-required">City</label>
|
|
62
58
|
<select id="myInput" aria-required="true">...</select>
|
|
@@ -2,10 +2,6 @@
|
|
|
2
2
|
|
|
3
3
|
Checkboxes are used in forms to toggle an option or preference.
|
|
4
4
|
|
|
5
|
-
<!-- docs: start hidden content -->
|
|
6
|
-

|
|
7
|
-
<!-- docs: end hidden content -->
|
|
8
|
-
|
|
9
5
|
<!-- docs: demo -->
|
|
10
6
|
```html
|
|
11
7
|
<script type="module">
|
|
@@ -35,10 +31,6 @@ Checkboxes are used in forms to toggle an option or preference.
|
|
|
35
31
|
|
|
36
32
|
The `<d2l-input-checkbox>` element can be used to get a checkbox and optional visible label.
|
|
37
33
|
|
|
38
|
-
<!-- docs: start hidden content -->
|
|
39
|
-

|
|
40
|
-
<!-- docs: end hidden content -->
|
|
41
|
-
|
|
42
34
|
<!-- docs: demo live name:d2l-input-checkbox display:block -->
|
|
43
35
|
```html
|
|
44
36
|
<script type="module">
|
|
@@ -31,10 +31,6 @@ Use the `<d2l-input-date>` component when users need to choose a single date. It
|
|
|
31
31
|
|
|
32
32
|
Note: All `*value` properties should be in ISO 8601 calendar date format (`YYYY-MM-DD`) and should be [localized to the user's timezone](#timezone) (if applicable).
|
|
33
33
|
|
|
34
|
-
<!-- docs: start hidden content -->
|
|
35
|
-

|
|
36
|
-
<!-- docs: end hidden content -->
|
|
37
|
-
|
|
38
34
|
<!-- docs: demo live name:d2l-input-date align:flex-start autoSize:false size:xlarge -->
|
|
39
35
|
```html
|
|
40
36
|
<script type="module">
|
|
@@ -81,10 +77,6 @@ Use the `<d2l-input-date-range>` component when users need to enter two dates i
|
|
|
81
77
|
|
|
82
78
|
Note: All `*value` properties should be in ISO 8601 calendar date format (`YYYY-MM-DD`) and should be [localized to the user's timezone](#timezone) (if applicable).
|
|
83
79
|
|
|
84
|
-
<!-- docs: start hidden content -->
|
|
85
|
-

|
|
86
|
-
<!-- docs: end hidden content -->
|
|
87
|
-
|
|
88
80
|
<!-- docs: demo live name:d2l-input-date-range align:flex-start autoSize:false size:xlarge -->
|
|
89
81
|
```html
|
|
90
82
|
<script type="module">
|
|
@@ -137,10 +129,6 @@ Use the `<d2l-input-time>` component when users need to enter a time, without a
|
|
|
137
129
|
|
|
138
130
|
Note: All `*value` properties should be in ISO 8601 time format (`hh:mm:ss`) and should be [localized to the user's timezone](#timezone) (if applicable).
|
|
139
131
|
|
|
140
|
-
<!-- docs: start hidden content -->
|
|
141
|
-

|
|
142
|
-
<!-- docs: end hidden content -->
|
|
143
|
-
|
|
144
132
|
<!-- docs: demo live name:d2l-input-time align:flex-start autoSize:false size:large -->
|
|
145
133
|
```html
|
|
146
134
|
<script type="module">
|
|
@@ -187,10 +175,6 @@ Use the `<d2l-input-time-range>` component when users need to enter two times in
|
|
|
187
175
|
|
|
188
176
|
Note: All `*value` properties should be in ISO 8601 time format (`hh:mm:ss`) and should be [localized to the user's timezone](#timezone) (if applicable).
|
|
189
177
|
|
|
190
|
-
<!-- docs: start hidden content -->
|
|
191
|
-

|
|
192
|
-
<!-- docs: end hidden content -->
|
|
193
|
-
|
|
194
178
|
<!-- docs: demo live name:d2l-input-time-range align:flex-start autoSize:false size:large -->
|
|
195
179
|
```html
|
|
196
180
|
<script type="module">
|
|
@@ -239,10 +223,6 @@ Use the `<d2l-input-date-time>` component when users need to enter a single dat
|
|
|
239
223
|
|
|
240
224
|
Note: All `*value` properties should be in ISO 8601 combined date and time format (`YYYY-MM-DDTHH:mm:ss.sssZ`) and in UTC time (i.e., do NOT localize to the user's timezone).
|
|
241
225
|
|
|
242
|
-
<!-- docs: start hidden content -->
|
|
243
|
-

|
|
244
|
-
<!-- docs: end hidden content -->
|
|
245
|
-
|
|
246
226
|
<!-- docs: demo live name:d2l-input-date-time align:flex-start autoSize:false size:xlarge -->
|
|
247
227
|
```html
|
|
248
228
|
<script type="module">
|
|
@@ -290,10 +270,6 @@ Use the `<d2l-input-date-time-range>` component when users need to enter two d
|
|
|
290
270
|
|
|
291
271
|
Note: All `*value` properties should be in ISO 8601 combined date and time format (`YYYY-MM-DDTHH:mm:ss.sssZ`) and in UTC time (i.e., do NOT localize to the user's timezone).
|
|
292
272
|
|
|
293
|
-
<!-- docs: start hidden content -->
|
|
294
|
-

|
|
295
|
-
<!-- docs: end hidden content -->
|
|
296
|
-
|
|
297
273
|
<!-- docs: demo live name:d2l-input-date-time-range align:flex-start autoSize:false size:xlarge -->
|
|
298
274
|
```html
|
|
299
275
|
<script type="module">
|
|
@@ -21,10 +21,6 @@ Numeric inputs allow users to input numbers. These include the more generic `d2l
|
|
|
21
21
|
|
|
22
22
|
The `<d2l-input-number>` element is similar to `<d2l-input-text>`, except it's intended for inputting numbers only.
|
|
23
23
|
|
|
24
|
-
<!-- docs: start hidden content -->
|
|
25
|
-

|
|
26
|
-
<!-- docs: end hidden content -->
|
|
27
|
-
|
|
28
24
|
<!-- docs: demo live name:d2l-input-number -->
|
|
29
25
|
```html
|
|
30
26
|
<script type="module">
|
|
@@ -103,10 +99,6 @@ To accept only integer numbers, set `max-fraction-digits` to zero:
|
|
|
103
99
|
|
|
104
100
|
The `<d2l-input-percent>` element is similar to `<d2l-input-number>`, except it provides a "%" symbol beside the number.
|
|
105
101
|
|
|
106
|
-
<!-- docs: start hidden content -->
|
|
107
|
-

|
|
108
|
-
<!-- docs: end hidden content -->
|
|
109
|
-
|
|
110
102
|
<!-- docs: demo live name:d2l-input-percent -->
|
|
111
103
|
```html
|
|
112
104
|
<script type="module">
|
|
@@ -2,10 +2,6 @@
|
|
|
2
2
|
|
|
3
3
|
Radio Buttons are used in forms to offer a single choice among mutually exclusive options.
|
|
4
4
|
|
|
5
|
-
<!-- docs: start hidden content -->
|
|
6
|
-

|
|
7
|
-
<!-- docs: end hidden content -->
|
|
8
|
-
|
|
9
5
|
<!-- docs: demo display:block -->
|
|
10
6
|
```html
|
|
11
7
|
<script type="module">
|
|
@@ -2,10 +2,6 @@
|
|
|
2
2
|
|
|
3
3
|
Search inputs allow users to input text, execute a search, and clear results. A search input may be used in conjunction with filters, sort, and/or auto-complete.
|
|
4
4
|
|
|
5
|
-
<!-- docs: start hidden content -->
|
|
6
|
-

|
|
7
|
-
<!-- docs: end hidden content -->
|
|
8
|
-
|
|
9
5
|
<!-- docs: demo -->
|
|
10
6
|
```html
|
|
11
7
|
<script type="module">
|
|
@@ -50,10 +50,6 @@ Toggling progressive disclosure is OK
|
|
|
50
50
|
|
|
51
51
|
Native `<select>` elements can be styled by importing `input-select-styles.js` into your LitElement and applying the `d2l-input-select` CSS class.
|
|
52
52
|
|
|
53
|
-
<!-- docs: start hidden content -->
|
|
54
|
-

|
|
55
|
-
<!-- docs: end hidden content -->
|
|
56
|
-
|
|
57
53
|
Note: in order for RTL to function correctly, make sure your component uses the `RtlMixin`.
|
|
58
54
|
|
|
59
55
|
<!-- docs: demo live name:d2l-test-input-select -->
|
|
@@ -49,10 +49,6 @@ Therefore in text inputs, placeholder text is a light colour (Mica), which fails
|
|
|
49
49
|
|
|
50
50
|
The `<d2l-input-text>` element is a simple wrapper around the native `<input type="text">` tag. It's intended primarily for inputting generic text, email addresses and URLs.
|
|
51
51
|
|
|
52
|
-
<!-- docs: start hidden content -->
|
|
53
|
-

|
|
54
|
-
<!-- docs: end hidden content -->
|
|
55
|
-
|
|
56
52
|
<!-- docs: demo live name:d2l-input-text -->
|
|
57
53
|
```html
|
|
58
54
|
<script type="module">
|
|
@@ -172,10 +168,6 @@ As an alternative to using the `<d2l-input-text>` custom element, you can style
|
|
|
172
168
|
|
|
173
169
|
The `<d2l-input-textarea>` is a wrapper around the native `<textarea>` element that provides auto-grow and validation behaviours. It's intended for inputting unformatted multi-line text.
|
|
174
170
|
|
|
175
|
-
<!-- docs: start hidden content -->
|
|
176
|
-

|
|
177
|
-
<!-- docs: end hidden content -->
|
|
178
|
-
|
|
179
171
|
<!-- docs: demo live name:d2l-input-textarea -->
|
|
180
172
|
```html
|
|
181
173
|
<script type="module">
|
|
@@ -258,10 +250,6 @@ To make your usage of `d2l-input-textarea` accessible, use the following propert
|
|
|
258
250
|
|
|
259
251
|
Native `<textarea>` elements can be styled by importing `input-styles.js` into your LitElement and applying the `d2l-input` CSS class.
|
|
260
252
|
|
|
261
|
-
<!-- docs: start hidden content -->
|
|
262
|
-

|
|
263
|
-
<!-- docs: end hidden content -->
|
|
264
|
-
|
|
265
253
|
<!-- docs: demo code -->
|
|
266
254
|
```html
|
|
267
255
|
<script type="module">
|
|
@@ -21,19 +21,13 @@ The following link styles are available:
|
|
|
21
21
|
|
|
22
22
|
This is the standard link style, used in most cases.
|
|
23
23
|
|
|
24
|
-

|
|
25
|
-
|
|
26
24
|
### Small
|
|
27
25
|
|
|
28
26
|
Similarly styled to the standard link, but slightly smaller and more compact.
|
|
29
27
|
|
|
30
|
-

|
|
31
|
-
|
|
32
28
|
### Main
|
|
33
29
|
|
|
34
30
|
Same size as the standard link, but bolder.
|
|
35
|
-
|
|
36
|
-

|
|
37
31
|
<!-- docs: end hidden content -->
|
|
38
32
|
|
|
39
33
|
## Link [d2l-link]
|
|
@@ -102,10 +102,6 @@ When using `d2l-list`, the `grid` attribute will enable the table-like keyboard
|
|
|
102
102
|
|
|
103
103
|
The `d2l-list` is the container to create a styled list of items using `d2l-list-item` or `d2l-list-item-button`. It provides the appropriate `list` semantics as well as options for displaying separators, etc.
|
|
104
104
|
|
|
105
|
-
<!-- docs: start hidden content -->
|
|
106
|
-

|
|
107
|
-
<!-- docs: end hidden content -->
|
|
108
|
-
|
|
109
105
|
<!-- docs: demo live name:d2l-list autoSize:false size:medium -->
|
|
110
106
|
```html
|
|
111
107
|
<script type="module">
|
|
@@ -201,10 +197,6 @@ If a `d2l-list-item` is selectable then it should have a `label` attribute that
|
|
|
201
197
|
|
|
202
198
|
The `d2l-list` supports drag & drop.
|
|
203
199
|
|
|
204
|
-
<!-- docs: start hidden content -->
|
|
205
|
-

|
|
206
|
-
<!-- docs: end hidden content -->
|
|
207
|
-
|
|
208
200
|
The `d2l-list` is simply a rendering component, so there is some light work involved in hooking up this behaviour. In order for items to be draggable, they must have their `draggable` and `key` attributes set. Optionally, the `drop-nested` attribute can be applied to items to indicate whether other items can be dropped as nested children on the item.
|
|
209
201
|
|
|
210
202
|
Reordering and re-rendering is the consuming component's responsibility. For a simple flat list, listen for the `d2l-list-item-position-change` event and call the `reorder` helper method. Alternatively, or for more complex lists such as those with nested lists, listen for the `d2l-list-items-move` event on the root list and update the consumer data using the provided source and target event detail.
|
|
@@ -272,10 +264,6 @@ If an item is draggable, the `drag-handle-text` attribute should be used to prov
|
|
|
272
264
|
|
|
273
265
|
The `d2l-list-header` component can be placed in the `d2l-list`'s `header` slot to provide a select-all checkbox, summary, a slot for `d2l-selection-action`s, and overflow-group behaviour.
|
|
274
266
|
|
|
275
|
-
<!-- docs: start hidden content -->
|
|
276
|
-

|
|
277
|
-
<!-- docs: end hidden content -->
|
|
278
|
-
|
|
279
267
|
<!-- docs: demo live name:d2l-list-header autoSize:false size:medium -->
|
|
280
268
|
```html
|
|
281
269
|
<script type="module">
|
|
@@ -320,10 +308,6 @@ The `d2l-list-header` component can be placed in the `d2l-list`'s `header` slot
|
|
|
320
308
|
|
|
321
309
|
The `d2l-list-item` provides the appropriate `listitem` semantics for children within a list. It also provides some basic layout, breakpoints for responsiveness, a navigation link for the primary action, and selection.
|
|
322
310
|
|
|
323
|
-
<!-- docs: start hidden content -->
|
|
324
|
-

|
|
325
|
-
<!-- docs: end hidden content -->
|
|
326
|
-
|
|
327
311
|
<!-- docs: demo live name:d2l-list-item autoSize:false size:small -->
|
|
328
312
|
```html
|
|
329
313
|
<script type="module">
|
|
@@ -400,10 +384,6 @@ The `d2l-list-item` provides the appropriate `listitem` semantics for children w
|
|
|
400
384
|
|
|
401
385
|
The `d2l-list-item-button` provides the same functionality as `d2l-list-item` except with button semantics for its primary action.
|
|
402
386
|
|
|
403
|
-
<!-- docs: start hidden content -->
|
|
404
|
-

|
|
405
|
-
<!-- docs: end hidden content -->
|
|
406
|
-
|
|
407
387
|
<!-- docs: demo live name:d2l-list-item-button -->
|
|
408
388
|
```html
|
|
409
389
|
<script type="module">
|
|
@@ -487,10 +467,6 @@ Where the parameters correspond to the slots of `d2l-list-item`:
|
|
|
487
467
|
|
|
488
468
|
The `d2l-list-item-content` provides additional consistent layout for primary and secondary text in item content. It may be used with or without the `illustration` and `action` slots mentioned above.
|
|
489
469
|
|
|
490
|
-
<!-- docs: start hidden content -->
|
|
491
|
-

|
|
492
|
-
<!-- docs: end hidden content -->
|
|
493
|
-
|
|
494
470
|
<!-- docs: demo live name:d2l-list-item-content -->
|
|
495
471
|
```html
|
|
496
472
|
<script type="module">
|
|
@@ -10,9 +10,6 @@ A loading spinner indicates that something is happening and we don't know how lo
|
|
|
10
10
|
|
|
11
11
|
<d2l-loading-spinner></d2l-loading-spinner>
|
|
12
12
|
```
|
|
13
|
-
<!-- docs: start hidden content -->
|
|
14
|
-

|
|
15
|
-
<!-- docs: end hidden content -->
|
|
16
13
|
|
|
17
14
|
## Best Practices
|
|
18
15
|
|