@ogds/elements 1.0.0-alpha.7 → 1.0.0-alpha.8
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/README.md +28 -96
- package/dist/components/frameworks/react/OGDSAlert.d.ts +61 -0
- package/dist/components/frameworks/react/OGDSAlert.js +23 -0
- package/dist/components/frameworks/react/OgdsAccordionToggle.d.ts +4 -6
- package/dist/components/frameworks/react/OgdsAccordionToggle.js +1 -3
- package/dist/components/frameworks/react/{UsaHeader.d.ts → OgdsTaskList.d.ts} +4 -4
- package/dist/components/frameworks/react/{UsaHeader.js → OgdsTaskList.js} +3 -3
- package/dist/components/frameworks/react/index.d.ts +2 -1
- package/dist/components/frameworks/react/index.js +2 -1
- package/dist/components/index.cjs +14 -7
- package/dist/components/index.cjs.map +1 -1
- package/dist/components/index.d.ts +2 -1
- package/dist/components/index.js +112 -45
- package/dist/components/index.js.map +1 -1
- package/dist/components/ogds-accordion-toggle/index.d.ts +7 -4
- package/dist/components/ogds-accordion-toggle/ogds-accordion-toggle.spec.d.ts +1 -0
- package/dist/components/ogds-alert/index.d.ts +21 -0
- package/dist/components/ogds-banner/index.d.ts +1 -1
- package/dist/components/ogds-banner.cjs +1 -1
- package/dist/components/ogds-banner.js +1 -1
- package/dist/components/task-list/index.d.ts +21 -0
- package/dist/{index-DTiLuJoA.cjs → index-CC1QRihN.cjs} +2 -2
- package/dist/index-CC1QRihN.cjs.map +1 -0
- package/dist/{index-Bl2KLDbH.js → index-DDf2o6Dk.js} +6 -6
- package/dist/index-DDf2o6Dk.js.map +1 -0
- package/dist/types/custom-element-jsx.d.ts +35 -4
- package/dist/types/custom-element-solidjs.d.ts +39 -4
- package/dist/types/custom-element-svelte.d.ts +35 -4
- package/dist/types/custom-element-vuejs.d.ts +35 -4
- package/package.json +36 -21
- package/src/Globals.d.ts +3 -0
- package/src/components/index.ts +2 -1
- package/src/components/ogds-accordion/docs.mdx +31 -20
- package/src/components/ogds-accordion/ogds-accordion.stories.ts +12 -0
- package/src/components/ogds-accordion-toggle/docs.mdx +54 -0
- package/src/components/ogds-accordion-toggle/index.ts +38 -11
- package/src/components/ogds-accordion-toggle/ogds-accordion-toggle.css +31 -0
- package/src/components/ogds-accordion-toggle/ogds-accordion-toggle.spec.ts +227 -0
- package/src/components/ogds-accordion-toggle/ogds-accordion-toggle.stories.ts +95 -0
- package/src/components/ogds-alert/base-variables.css +496 -0
- package/src/components/ogds-alert/index.ts +78 -0
- package/src/components/ogds-alert/ogds-alert.css +119 -0
- package/src/components/ogds-alert/ogds-alert.stories.ts +75 -0
- package/src/components/ogds-banner/index.ts +6 -6
- package/src/components/ogds-banner/ogds-banner.spec.ts +1 -1
- package/src/components/task-list/docs.mdx +23 -0
- package/src/components/task-list/index.ts +65 -0
- package/src/components/task-list/ogds-task-list.css +34 -0
- package/src/components/task-list/ogds-task-list.stories.ts +46 -0
- package/src/core/token-styles.ts +2 -0
- package/storybook/contributing.mdx +1 -110
- package/storybook/readme.mdx +1 -1
- package/dist/components/usa-header/index.d.ts +0 -6
- package/dist/index-Bl2KLDbH.js.map +0 -1
- package/dist/index-DTiLuJoA.cjs.map +0 -1
- package/src/components/usa-header/index.ts +0 -49
- package/src/components/usa-header/usa-header.css +0 -1
package/README.md
CHANGED
|
@@ -1,8 +1,20 @@
|
|
|
1
1
|
# OGDS Elements
|
|
2
2
|
|
|
3
|
-
The Open Government Design System (OGDS) is a complement to and reimagining of the [United States Web Design System](https://designsystem.digital.gov) (USWDS). OGDS aims to ship components and styles that will feel at home in any site using USWDS
|
|
3
|
+
The Open Government Design System (OGDS) is a complement to and reimagining of the [United States Web Design System](https://designsystem.digital.gov) (USWDS). OGDS aims to ship components and styles that will feel at home in any site using USWDS. This project leverages the modern web platform to deliver the same level of reliability and accessibility as USWDS with less code.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
You can (and should!) use both OGDS components and traditional USWDS components in your project. Some of our OGDS components are **enhanced** versions of USWDS components, such as the accordion and banner components. Some of our components are entirely **new**, such as the Task List component.
|
|
6
|
+
|
|
7
|
+
The components developed in OGDS Elements use [the same design tokens as USWDS](https://designsystem.digital.gov/design-tokens/), such as colors and spacing values. These are imported from the [OGDS Tokens project](https://github.com/open-government-design-system/ogds-tokens), which makes the USWDS design tokens available in multiple formats. In this project, we use [CSS Custom Properties (CSS Variables)](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_cascading_variables/Using_CSS_custom_properties), which means we can benefit from this feature of modern browsers. CSS Custom Properties have been [widely available in all major browsers since 2017](https://caniuse.com/css-variables)). This approach helps us to avoid a css compiler (like SASS), it helps us to manage themes and overrides, and it helps us style components in a simpler way.
|
|
8
|
+
|
|
9
|
+
## Component Documentation on Storybook
|
|
10
|
+
|
|
11
|
+
Where can I see exapmles of the OGDS Elements components? How do I set this up?
|
|
12
|
+
|
|
13
|
+
For more detailed documentation, see the [OGDS Elements Storybook](https://ogds-elements.jbhutch01.workers.dev/).
|
|
14
|
+
|
|
15
|
+
## Using OGDS Elements
|
|
16
|
+
|
|
17
|
+
### Installation using node and npm
|
|
6
18
|
|
|
7
19
|
1. Install `node/npm`. In the link below you can find the install method that coincides with your operating system:
|
|
8
20
|
- Node (see [.nvmrc](https://github.com/open-government-design-system/ogds-elements/blob/develop/.nvmrc) for version number), [Installation guides](https://nodejs.org/en/download)
|
|
@@ -28,7 +40,7 @@ The `@ogds/elements` module is now installed as a dependency.
|
|
|
28
40
|
|
|
29
41
|
**Note:** We do _not_ recommend directly editing the design system files in `node_modules`. One of the benefits of using a package manager is its ease of upgrade and installation. If you make customizations to the files in the package, any upgrade or re-installation will wipe them out.
|
|
30
42
|
|
|
31
|
-
|
|
43
|
+
### Using OGDS Elements in your project
|
|
32
44
|
|
|
33
45
|
How you add a OGDS Elements component to a page might vary depending on your tools. If you use Vite, you can add components by importing them into a script that's imported elsewhere into a page:
|
|
34
46
|
|
|
@@ -47,7 +59,7 @@ import { OgdsAccordion } from "@ogds/elements";
|
|
|
47
59
|
</ogds-accordion>
|
|
48
60
|
```
|
|
49
61
|
|
|
50
|
-
|
|
62
|
+
### Style theming and tokens
|
|
51
63
|
|
|
52
64
|
Each OGDS Element provides support for theming by exposing CSS custom properties (CSS variables) that can be used to control the appearance of the component.
|
|
53
65
|
|
|
@@ -67,106 +79,26 @@ For example, the `ogds-banner` component can be customized by setting the `--ogd
|
|
|
67
79
|
|
|
68
80
|
**Note:** Please be mindful of the accessibility implications of customizing component appearance. It's **your** responsibility to ensure that your customizations meet the [accessibility requirements](https://designsystem.digital.gov/accessibility/) of the design system and pass any [WCAG 2.2](https://www.w3.org/TR/WCAG22/) or [Section 508](https://www.section508.gov/) accessibility tests.
|
|
69
81
|
|
|
70
|
-
##
|
|
71
|
-
|
|
72
|
-
For more detailed documentation, refer to the Storybook for OGDS Elements. The Storybook isn't currently available online, but you can see it either by cloning this repo and running `npm run start` or by installing the package and running the same command at the package root inside of your `node_modules` folder.
|
|
73
|
-
|
|
74
|
-
## Publishing
|
|
75
|
-
|
|
76
|
-
This repository is automatically published to NPM when a new release is created.
|
|
77
|
-
|
|
78
|
-
We use Changesets to manage changelogs, version bumps, pre-releases (alpha/beta), and automated publishing via GitHub Actions. The repository includes a pre-configured Changesets setup so you can create pre-releases (for example, `alpha`) and standard releases.
|
|
79
|
-
|
|
80
|
-
### Pre-release flow
|
|
81
|
-
|
|
82
|
-
If you're working on a pre-release version, enter pre-release mode:
|
|
83
|
-
|
|
84
|
-
```bash
|
|
85
|
-
npx @changesets/cli pre enter <tag> # for example, npx @changesets/cli pre enter alpha
|
|
86
|
-
```
|
|
87
|
-
|
|
88
|
-
This will write a `.changeset/pre.json` that configures the pre-release tag and initial version. This file should be committed to the repository.
|
|
89
|
-
|
|
90
|
-
**Note:** Once you're in pre-release mode, you don't have to enter it every time. When you're ready to exit pre-release mode, run:
|
|
91
|
-
|
|
92
|
-
```bash
|
|
93
|
-
npx @changesets/cli pre exit
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
### Version bumps, and publishing (Changesets)
|
|
97
|
-
|
|
98
|
-
1. Create a changeset describing your change(s)
|
|
99
|
-
- Run the interactive prompt and follow the questions:
|
|
100
|
-
|
|
101
|
-
```bash
|
|
102
|
-
npx @changesets/cli
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
- The command creates a file under the `.changeset/` directory that describes the packages and the release type (patch/minor/major). You can edit this file to add more details, such as a link to the issue or pull request that the change addresses. The file will automatically get a nonsensical name like `fire-penguin-annex.md`, and that's normal. These files are only in the repository for a short time, to generate changelogs and version bumps. They aren't published to NPM and are cleaned up after the release is published.
|
|
106
|
-
|
|
107
|
-
2. Bump versions locally (optional)
|
|
108
|
-
- To update package.json versions and changelogs locally before publishing:
|
|
109
|
-
|
|
110
|
-
```bash
|
|
111
|
-
npx @changesets/cli version
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
- Commit the resulting changes (package.json updates and generated changelog files):
|
|
115
|
-
|
|
116
|
-
```bash
|
|
117
|
-
git add .
|
|
118
|
-
git commit -m "chore(release): version packages and changelogs"
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
3. Publish
|
|
122
|
-
- Option A — Let the repository automation handle publishing (recommended):
|
|
123
|
-
- Push your branch to GitHub and open a PR. The CI / release automation will run and, depending on the configuration and merged changesets, will publish releases when merged to `main`.
|
|
124
|
-
- Option B — Publish locally (requires NPM credentials and appropriate tokens):
|
|
82
|
+
## Contributing to OGDS Elements
|
|
125
83
|
|
|
126
|
-
|
|
127
|
-
npm run release
|
|
128
|
-
```
|
|
84
|
+
OGDS is run by contributors, including folks from many government agencies, departments, states, and more. If you have ideas for what to contribute, we would love your support!
|
|
129
85
|
|
|
130
|
-
|
|
86
|
+
### Code of Conduct
|
|
131
87
|
|
|
132
|
-
|
|
88
|
+
Everyone who participates in this project is expected to follow the OGDS Code of Conduct (TK CoC Link)
|
|
133
89
|
|
|
134
|
-
|
|
135
|
-
- The workflow runs on pushes to `main` and uses the Changesets GitHub Action.
|
|
136
|
-
- The action can either create a release PR or publish directly to NPM depending on repository and action settings.
|
|
137
|
-
- The workflow uses repository secrets:
|
|
138
|
-
- `GITHUB_TOKEN` — standard workflow permission for the action to create PRs/commits.
|
|
139
|
-
- The action is configured to run the project’s release script (for example `npm run release`) and is run in a controlled environment; it will also disable Husky hooks during automated runs (HUSKY=0) to avoid local commit hooks blocking automation.
|
|
90
|
+
### Join the Mailing List and Slack
|
|
140
91
|
|
|
141
|
-
|
|
92
|
+
If you'd like to [join the People's Design System mailing list and Slack](https://docs.google.com/document/d/10XN6ZsRt9aAOH1PUmtfcCCEBZQUSgs1cCI5krYBOoi4/edit?tab=t.0), that is where we discuss these topics.
|
|
142
93
|
|
|
143
|
-
|
|
144
|
-
- Pre-release flows:
|
|
145
|
-
- The repository includes a `.changeset/pre.json` configuration that sets a default pre-release tag (e.g., `alpha`) and initial versions for pre-release packages. Use `npx @changesets/cli pre enter <tag>` to begin a pre-release cycle.
|
|
146
|
-
- When in pre mode, version bumps will produce pre-release identifiers (for example, `1.0.0-alpha.1`).
|
|
147
|
-
- CI vs local publish:
|
|
148
|
-
- For most contributors, pushing a properly authored changeset and opening a PR is the recommended route—automation will create the release or open the release PR for maintainers to review.
|
|
149
|
-
- If you must publish locally, make sure `NPM_TOKEN` is configured in your environment or use a CI/protected account to run the publish steps.
|
|
150
|
-
- If releases aren't being published as expected:
|
|
151
|
-
- Verify `NPM_TOKEN` exists in repository secrets and has publish scope.
|
|
152
|
-
- Ensure the commit/push to `main` contains a changeset (or the automation has been triggered by the Changesets action).
|
|
153
|
-
- Review the release workflow logs in GitHub Actions for details (it'll show the changesets step and any publishing errors).
|
|
154
|
-
- If you want to change the default pre-release tag (for example, from `alpha` to `beta`), update the `.changeset/pre.json` file and follow the pre-mode steps above.
|
|
94
|
+
### Filing a bug report
|
|
155
95
|
|
|
156
|
-
|
|
96
|
+
If you discovered a bug that no one else has reported in our [issues backlog](https://github.com/open-government-design-system/ogds-elements/issues), let us know by [submitting an issue](https://github.com/open-government-design-system/ogds-elements/issues/new).
|
|
157
97
|
|
|
158
|
-
|
|
159
|
-
2. Enter pre mode if you want pre-release tagging:
|
|
160
|
-
- `npx @changesets/cli pre enter --tag alpha`
|
|
161
|
-
3. Run `npx @changesets/cli` and follow the prompts (choose the appropriate release type).
|
|
162
|
-
4. Commit the changeset file(s), push the branch, and open a PR.
|
|
163
|
-
5. Once the PR is merged to `main`, the repository release workflow will pick up the changeset and publish the pre-release to NPM (provided `NPM_TOKEN` and workflow permissions are set).
|
|
98
|
+
### Starting a discussion
|
|
164
99
|
|
|
165
|
-
|
|
100
|
+
To share ideas, questions, or concerns with the OGDS core team and community, you can join any of our [open discussions](https://github.com/open-government-design-system/ogds-elements/discussions) or [start a new one](https://github.com/open-government-design-system/ogds-elements/discussions/new/choose).
|
|
166
101
|
|
|
167
|
-
|
|
102
|
+
### Contributing Code
|
|
168
103
|
|
|
169
|
-
|
|
170
|
-
| ---------------- | ------ |
|
|
171
|
-
| `ogds-banner` | Beta |
|
|
172
|
-
| `ogds-accordion` | Alpha |
|
|
104
|
+
See Contributing.md
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import React from "react";
|
|
2
|
+
import { OGDSAlert as OGDSAlertElement } from "../../ogds-alert.js";
|
|
3
|
+
|
|
4
|
+
export type { OGDSAlertElement };
|
|
5
|
+
|
|
6
|
+
export interface OGDSAlertProps extends Pick<
|
|
7
|
+
React.AllHTMLAttributes<HTMLElement>,
|
|
8
|
+
| "children"
|
|
9
|
+
| "dir"
|
|
10
|
+
| "hidden"
|
|
11
|
+
| "id"
|
|
12
|
+
| "lang"
|
|
13
|
+
| "slot"
|
|
14
|
+
| "style"
|
|
15
|
+
| "title"
|
|
16
|
+
| "translate"
|
|
17
|
+
| "onClick"
|
|
18
|
+
| "onFocus"
|
|
19
|
+
| "onBlur"
|
|
20
|
+
> {
|
|
21
|
+
/** undefined */
|
|
22
|
+
noIcon?: boolean;
|
|
23
|
+
|
|
24
|
+
/** The type of alert (info, warning, etc) */
|
|
25
|
+
type?: OGDSAlertElement["type"];
|
|
26
|
+
|
|
27
|
+
/** Use this attribute to hide the icon */
|
|
28
|
+
undefined?: OGDSAlertElement["undefined"];
|
|
29
|
+
|
|
30
|
+
/** A space-separated list of the classes of the element. Classes allows CSS and JavaScript to select and access specific elements via the class selectors or functions like the method `Document.getElementsByClassName()`. */
|
|
31
|
+
className?: string;
|
|
32
|
+
|
|
33
|
+
/** Contains a space-separated list of the part names of the element that should be exposed on the host element. */
|
|
34
|
+
exportparts?: string;
|
|
35
|
+
|
|
36
|
+
/** Used for labels to link them with their inputs (using input id). */
|
|
37
|
+
htmlFor?: string;
|
|
38
|
+
|
|
39
|
+
/** Used to help React identify which items have changed, are added, or are removed within a list. */
|
|
40
|
+
key?: number | string;
|
|
41
|
+
|
|
42
|
+
/** Contains a space-separated list of the part names of the element. Part names allows CSS to select and style specific elements in a shadow tree via the ::part pseudo-element. */
|
|
43
|
+
part?: string;
|
|
44
|
+
|
|
45
|
+
/** A mutable ref object whose `.current` property is initialized to the passed argument (`initialValue`). The returned object will persist for the full lifetime of the component. */
|
|
46
|
+
ref?: any;
|
|
47
|
+
|
|
48
|
+
/** Allows developers to make HTML elements focusable, allow or prevent them from being sequentially focusable (usually with the `Tab` key, hence the name) and determine their relative ordering for sequential focus navigation. */
|
|
49
|
+
tabIndex?: number;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* The ogds-alert component.
|
|
54
|
+
* ---
|
|
55
|
+
*
|
|
56
|
+
*
|
|
57
|
+
* ### **Slots:**
|
|
58
|
+
* - **heading** - Text for the heading. Make sure to specify the correct heading level (h2, h3, etc)
|
|
59
|
+
* - **body** - Body content for the alert. Can contain HTML (links, etc).
|
|
60
|
+
*/
|
|
61
|
+
export const OGDSAlert: React.ForwardRefExoticComponent<OGDSAlertProps>;
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import React, { forwardRef } from "react";
|
|
2
|
+
import "../../ogds-alert.js";
|
|
3
|
+
|
|
4
|
+
export const OGDSAlert = forwardRef((props, forwardedRef) => {
|
|
5
|
+
const { noIcon, type, ...filteredProps } = props;
|
|
6
|
+
|
|
7
|
+
return React.createElement(
|
|
8
|
+
"ogds-alert",
|
|
9
|
+
{
|
|
10
|
+
...filteredProps,
|
|
11
|
+
type: props.type,
|
|
12
|
+
noIcon: props.undefined,
|
|
13
|
+
class: props.className,
|
|
14
|
+
exportparts: props.exportparts,
|
|
15
|
+
for: props.htmlFor,
|
|
16
|
+
part: props.part,
|
|
17
|
+
tabindex: props.tabIndex,
|
|
18
|
+
"no-icon": props.noIcon ? true : undefined,
|
|
19
|
+
style: { ...props.style },
|
|
20
|
+
},
|
|
21
|
+
props.children,
|
|
22
|
+
);
|
|
23
|
+
});
|
|
@@ -21,12 +21,6 @@ export interface OgdsAccordionToggleProps extends Pick<
|
|
|
21
21
|
/** The `id` of the `<ogds-accordion>` to control. Required. */
|
|
22
22
|
controls?: OgdsAccordionToggleElement["controls"];
|
|
23
23
|
|
|
24
|
-
/** Button label when all panels are collapsed. Defaults to "Expand All". */
|
|
25
|
-
expandLabel?: OgdsAccordionToggleElement["expandLabel"];
|
|
26
|
-
|
|
27
|
-
/** Button label when one or more panels are open. Defaults to "Collapse All". */
|
|
28
|
-
collapseLabel?: OgdsAccordionToggleElement["collapseLabel"];
|
|
29
|
-
|
|
30
24
|
/** A space-separated list of the classes of the element. Classes allows CSS and JavaScript to select and access specific elements via the class selectors or functions like the method `Document.getElementsByClassName()`. */
|
|
31
25
|
className?: string;
|
|
32
26
|
|
|
@@ -54,6 +48,10 @@ export interface OgdsAccordionToggleProps extends Pick<
|
|
|
54
48
|
* ---
|
|
55
49
|
*
|
|
56
50
|
*
|
|
51
|
+
* ### **Slots:**
|
|
52
|
+
* - **expand-label** - Button label when all panels are collapsed. Defaults to "Expand All".
|
|
53
|
+
* - **collapse-label** - Button label when one or more panels are open. Defaults to "Collapse All".
|
|
54
|
+
*
|
|
57
55
|
* ### **CSS Parts:**
|
|
58
56
|
* - **button** - The toggle button.
|
|
59
57
|
*/
|
|
@@ -2,15 +2,13 @@ import React, { forwardRef } from "react";
|
|
|
2
2
|
import "../../ogds-accordion-toggle.js";
|
|
3
3
|
|
|
4
4
|
export const OgdsAccordionToggle = forwardRef((props, forwardedRef) => {
|
|
5
|
-
const { controls,
|
|
5
|
+
const { controls, ...filteredProps } = props;
|
|
6
6
|
|
|
7
7
|
return React.createElement(
|
|
8
8
|
"ogds-accordion-toggle",
|
|
9
9
|
{
|
|
10
10
|
...filteredProps,
|
|
11
11
|
controls: props.controls,
|
|
12
|
-
"expand-label": props.expandLabel || props["expand-label"],
|
|
13
|
-
"collapse-label": props.collapseLabel || props["collapse-label"],
|
|
14
12
|
class: props.className,
|
|
15
13
|
exportparts: props.exportparts,
|
|
16
14
|
for: props.htmlFor,
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import React from "react";
|
|
2
|
-
import {
|
|
2
|
+
import { OgdsTaskList as OgdsTaskListElement } from "../../ogds-task-list.js";
|
|
3
3
|
|
|
4
|
-
export type {
|
|
4
|
+
export type { OgdsTaskListElement };
|
|
5
5
|
|
|
6
|
-
export interface
|
|
6
|
+
export interface OgdsTaskListProps extends Pick<
|
|
7
7
|
React.AllHTMLAttributes<HTMLElement>,
|
|
8
8
|
| "children"
|
|
9
9
|
| "dir"
|
|
@@ -45,4 +45,4 @@ export interface UsaHeaderProps extends Pick<
|
|
|
45
45
|
* ---
|
|
46
46
|
*
|
|
47
47
|
*/
|
|
48
|
-
export const
|
|
48
|
+
export const OgdsTaskList: React.ForwardRefExoticComponent<OgdsTaskListProps>;
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import React, { forwardRef } from "react";
|
|
2
|
-
import "../../
|
|
2
|
+
import "../../ogds-task-list.js";
|
|
3
3
|
|
|
4
|
-
export const
|
|
4
|
+
export const OgdsTaskList = forwardRef((props, forwardedRef) => {
|
|
5
5
|
return React.createElement(
|
|
6
|
-
"
|
|
6
|
+
"ogds-task-list",
|
|
7
7
|
{
|
|
8
8
|
...props,
|
|
9
9
|
class: props.className,
|
|
@@ -1,8 +1,15 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const
|
|
2
|
-
`));function
|
|
3
|
-
--icon-chevron-pointing-down: url("${
|
|
4
|
-
--icon-chevron-pointing-up: url("${
|
|
5
|
-
--icon-plus: url("${
|
|
6
|
-
--icon-minus: url("${
|
|
1
|
+
"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("../index-CC1QRihN.cjs"),s=require("lit"),g=require("lit/decorators.js"),k=s.css`@layer ogds.components{.ogds-accordion,ogds-accordion{--ogds-accordion-border:.25rem solid var(--ogds-theme-color-base-lightest);--ogds-accordion-content-padding:1rem 1.25rem .75rem ;--ogds-accordion-icon-closed:var(--icon-chevron-pointing-down);--ogds-accordion-icon-open:var(--icon-chevron-pointing-up)}:is(.ogds-accordion,ogds-accordion).plus{--ogds-accordion-icon-closed:var(--icon-plus);--ogds-accordion-icon-open:var(--icon-minus)}.ogds-accordion,ogds-accordion{--accordion-icon:var(--ogds-accordion-icon-closed)}:is(.ogds-accordion,ogds-accordion) details{color:var(--ogds-theme-color-base-ink);margin-block:.5rem}:is(.ogds-accordion,ogds-accordion) details[open]{--accordion-icon:var(--ogds-accordion-icon-open)}:is(.ogds-accordion,ogds-accordion) summary{background-color:var(--ogds-theme-color-base-lightest);padding:1rem 1.25rem;font-weight:700}:is(.ogds-accordion,ogds-accordion) summary:hover{background-color:var(--ogds-color-gray-10)}:is(.ogds-accordion,ogds-accordion) summary:focus{outline:.25rem solid #2491ff}:is(.ogds-accordion,ogds-accordion).with-icon summary{align-items:center;display:flex}:is(.ogds-accordion,ogds-accordion).with-icon summary::marker{display:none}:is(.ogds-accordion,ogds-accordion).with-icon summary::-webkit-details-marker{display:none}:is(.ogds-accordion,ogds-accordion).with-icon summary:before{content:\"\";height:1.25rem;-webkit-mask-image:var(--accordion-icon);mask-image:var(--accordion-icon);background-color:currentColor;flex-shrink:0;width:1.5rem;display:block;-webkit-mask-position:50%;mask-position:50%;-webkit-mask-size:contain;mask-size:contain;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat}:is(.ogds-accordion,ogds-accordion).with-icon.right summary:before{order:2;margin-inline-start:auto}@supports selector(::details-content){:is(.ogds-accordion,ogds-accordion) details[open]::details-content{padding:var(--ogds-accordion-content-padding)}:is(.ogds-accordion,ogds-accordion).bordered details[open]::details-content{border-block-end:var(--ogds-accordion-border);border-inline-end:var(--ogds-accordion-border);border-inline-start:var(--ogds-accordion-border)}}@supports not selector(::details-content){:is(.ogds-accordion,ogds-accordion) .details-content{padding:var(--ogds-accordion-content-padding)}:is(.ogds-accordion,ogds-accordion).bordered .details-content{border-block-end:var(--ogds-accordion-border);border-inline-end:var(--ogds-accordion-border);border-inline-start:var(--ogds-accordion-border)}}}`,S="data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20width='24'%20height='24'%20viewBox='0%200%2024%2024'%3e%3cpath%20d='M19%2013h-6v6h-2v-6H5v-2h6V5h2v6h6v2z'/%3e%3c/svg%3e",w="data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20width='24'%20height='24'%20viewBox='0%200%2024%2024'%3e%3cpath%20d='M19%2013H5v-2h14v2z'/%3e%3c/svg%3e",x=s.css`:root,:host{--ogds-font-family-system:-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\";--ogds-font-family-georgia:Georgia, Cambria, \"Times New Roman\", Times, serif;--ogds-font-family-helvetica:\"Helvetica Neue\", Helvetica, Roboto, Arial, sans-serif;--ogds-font-family-monospace:\"Bitstream Vera Sans Mono\", \"Consolas\", \"Courier\", monospace;--ogds-font-size-1:.75rem;--ogds-font-size-2:.8125rem;--ogds-font-size-3:.875rem;--ogds-font-size-4:.9375rem;--ogds-font-size-5:1rem;--ogds-font-size-6:1.0625rem;--ogds-font-size-7:1.125rem;--ogds-font-size-8:1.25rem;--ogds-font-size-9:1.375rem;--ogds-font-size-10:1.5rem;--ogds-font-size-11:1.75rem;--ogds-font-size-12:2rem;--ogds-font-size-13:2.25rem;--ogds-font-size-14:2.5rem;--ogds-font-size-15:3rem;--ogds-font-size-16:3.5rem;--ogds-font-size-17:4rem;--ogds-font-size-18:5rem;--ogds-font-size-19:7.5rem;--ogds-font-size-20:8.75rem;--ogds-font-size-micro:.625rem;--ogds-line-height-1:1;--ogds-line-height-2:1.2;--ogds-line-height-3:1.35;--ogds-line-height-4:1.5;--ogds-line-height-5:1.62;--ogds-line-height-6:1.75;--ogds-measure-smaller:44ex;--ogds-measure-small:60ex;--ogds-measure-base:64ex;--ogds-measure-large:68ex;--ogds-measure-larger:72ex;--ogds-measure-largest:88ex}`,z=s.css`:root,:host{--ogds-theme-color-base-lightest:#f0f0f0;--ogds-theme-color-base-lighter:#dfe1e2;--ogds-theme-color-base-light:#a9aeb1;--ogds-theme-color-base:#71767a;--ogds-theme-color-base-dark:#565c65;--ogds-theme-color-base-darker:#3d4551;--ogds-theme-color-base-darkest:#1b1b1b;--ogds-theme-color-base-ink:#1b1b1b;--ogds-theme-color-primary-lighter:#d9e8f6;--ogds-theme-color-primary-light:#73b3e7;--ogds-theme-color-primary:#005ea2;--ogds-theme-color-primary-vivid:#0050d8;--ogds-theme-color-primary-dark:#1a4480;--ogds-theme-color-primary-darker:#162e51;--ogds-theme-color-secondary-lighter:#f3e1e4;--ogds-theme-color-secondary-light:#f2938c;--ogds-theme-color-secondary:#d83933;--ogds-theme-color-secondary-vivid:#e41d3d;--ogds-theme-color-secondary-dark:#b50909;--ogds-theme-color-secondary-darker:#8b0a03;--ogds-theme-color-accent-warm-lighter:#f2e4d4;--ogds-theme-color-accent-warm-light:#ffbc78;--ogds-theme-color-accent-warm:#fa9441;--ogds-theme-color-accent-warm-dark:#c05600;--ogds-theme-color-accent-warm-darker:#775540;--ogds-theme-color-accent-cool-lighter:#e1f3f8;--ogds-theme-color-accent-cool-light:#97d4ea;--ogds-theme-color-accent-cool:#00bde3;--ogds-theme-color-accent-cool-dark:#28a0cb;--ogds-theme-color-accent-cool-darker:#07648d;--ogds-theme-color-error-lighter:#f4e3db;--ogds-theme-color-error-light:#f39268;--ogds-theme-color-error:#d54309;--ogds-theme-color-error-dark:#b50909;--ogds-theme-color-error-darker:#6f3331;--ogds-theme-color-warning-lighter:#faf3d1;--ogds-theme-color-warning-light:#fee685;--ogds-theme-color-warning:#ffbe2e;--ogds-theme-color-warning-dark:#e5a000;--ogds-theme-color-warning-darker:#936f38;--ogds-theme-color-success-lighter:#ecf3ec;--ogds-theme-color-success-light:#70e17b;--ogds-theme-color-success:#00a91c;--ogds-theme-color-success-dark:#008817;--ogds-theme-color-success-darker:#216e1f;--ogds-theme-color-info-lighter:#e7f6f8;--ogds-theme-color-info-light:#99deea;--ogds-theme-color-info:#00bde3;--ogds-theme-color-info-dark:#009ec1;--ogds-theme-color-info-darker:#2e6276;--ogds-theme-color-disabled-lighter:#c9c9c9;--ogds-theme-color-disabled-light:#919191;--ogds-theme-color-disabled:#757575;--ogds-theme-color-disabled-dark:#454545;--ogds-theme-color-disabled-darker:#1b1b1b;--ogds-theme-color-emergency:#9c3d10;--ogds-theme-color-emergency-dark:#332d29;--ogds-theme-body-background-color:#fff;--ogds-theme-text-color:#1b1b1b;--ogds-theme-text-reverse-color:#fff;--ogds-theme-link-color:#005ea2;--ogds-theme-link-visited-color:#54278f;--ogds-theme-link-hover-color:#1a4480;--ogds-theme-link-active-color:#162e51;--ogds-theme-link-reverse-color:#dfe1e2;--ogds-theme-link-reverse-hover-color:#f0f0f0;--ogds-theme-link-reverse-active-color:#fff;--ogds-theme-focus-color:#2491ff}`,C=s.css`:root,:host{--ogds-theme-button-border-radius:.25rem;--ogds-theme-button-fill-color:#005ea2;--ogds-theme-button-font-family:-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\";--ogds-theme-button-icon-gap:.5rem;--ogds-theme-button-small-width:3rem;--ogds-theme-button-stroke-color:#005ea2;--ogds-theme-button-stroke-width:2px;--ogds-theme-button-text-color:#fff}`,A=s.css`:root,:host{--ogds-theme-border-radius-sm:2px;--ogds-theme-border-radius-md:.25rem;--ogds-theme-border-radius-lg:.5rem;--ogds-theme-column-gap-sm:2px;--ogds-theme-column-gap-md:1rem;--ogds-theme-column-gap-lg:1.5rem;--ogds-theme-column-gap-mobile:1rem;--ogds-theme-column-gap-desktop:2rem;--ogds-theme-grid-container-max-width:64rem;--ogds-theme-site-margins-breakpoint:64rem;--ogds-theme-site-margins-width:2rem;--ogds-theme-site-margins-mobile-width:1rem}`,E=s.css`:root,:host{--ogds-theme-type-scale-3xs:.8125rem;--ogds-theme-type-scale-2xs:.875rem;--ogds-theme-type-scale-xs:.9375rem;--ogds-theme-type-scale-sm:1rem;--ogds-theme-type-scale-md:1.0625rem;--ogds-theme-type-scale-lg:1.375rem;--ogds-theme-type-scale-xl:2rem;--ogds-theme-type-scale-2xl:2.5rem;--ogds-theme-type-scale-3xl:3rem;--ogds-theme-body-font-size:1rem;--ogds-theme-body-line-height:1.62;--ogds-theme-heading-line-height:1.2;--ogds-theme-display-font-size:3rem;--ogds-theme-h1-font-size:2.5rem;--ogds-theme-h2-font-size:2rem;--ogds-theme-h3-font-size:1.375rem;--ogds-theme-h4-font-size:1rem;--ogds-theme-h5-font-size:.9375rem;--ogds-theme-h6-font-size:.8125rem;--ogds-theme-lead-font-size:1.375rem;--ogds-theme-lead-line-height:1.75}`,m=new CSSStyleSheet;m.replaceSync([a.colorTokens,a.spacingTokens,x,z,C,A,E].map(i=>i.cssText).join(`
|
|
2
|
+
`));function u(){document.adoptedStyleSheets.includes(m)||(document.adoptedStyleSheets=[...document.adoptedStyleSheets,m])}var _=Object.defineProperty,f=(i,e,t,n)=>{for(var o=void 0,c=i.length-1,l;c>=0;c--)(l=i[c])&&(o=l(e,t,o)||o);return o&&_(e,t,o),o},r;const h=(r=class extends s.LitElement{constructor(){super(...arguments),this.useListSemantics=!1,this.headingLevel=0}createRenderRoot(){return this}connectedCallback(){super.connectedCallback(),u(),r._sheet||(r._sheet=new CSSStyleSheet,r._sheet.replaceSync(`ogds-accordion, .ogds-accordion {
|
|
3
|
+
--icon-chevron-pointing-down: url("${a.iconChevronDown}");
|
|
4
|
+
--icon-chevron-pointing-up: url("${a.iconChevronUp}");
|
|
5
|
+
--icon-plus: url("${S}");
|
|
6
|
+
--icon-minus: url("${w}");
|
|
7
7
|
}
|
|
8
|
-
`+
|
|
8
|
+
`+k.cssText),document.adoptedStyleSheets=[...document.adoptedStyleSheets,r._sheet]),this.detailsChildren=this.getDetailsChildren(),this.childRoles=new Map(Array.from(this.detailsChildren??[]).map(e=>[e,new Set]))}firstUpdated(){if(this.useListSemantics&&this.headingLevel!==0){console.warn("<ogds-accordion>: use-list-semantics and heading-level are mutually exclusive. Screen readers cannot reliably announce both list position and heading level on the same element. Remove one attribute.");return}this.addListSemantics(),this.addHeadingSemantics(),this.applyChildRoles()}getDetailsChildren(){const e=this.getElementsByTagName("details");if(e.length>0)return e;console.error("<ogds-accordion>: This component expects to have at least one details element as a child")}addListSemantics(){this.useListSemantics&&this.detailsChildren&&(Array.from(this.detailsChildren).forEach(e=>this.childRoles.get(e)?.add("listitem")),this.setAttribute("role","list"))}addHeadingSemantics(){const e=this.headingLevel;e!==0&&this.detailsChildren&&Array.from(this.detailsChildren).forEach(t=>{const n=t.querySelector("summary");n&&(n.setAttribute("role","heading"),n.setAttribute("aria-level",String(e)))})}applyChildRoles(){this.childRoles.forEach((e,t)=>{e.size>0&&t.setAttribute("role",Array.from(e).join(" "))})}render(){return s.nothing}},r._sheet=null,r);f([g.property({type:Boolean,attribute:"use-list-semantics"})],h.prototype,"useListSemantics");f([g.property({type:Number,attribute:"heading-level"})],h.prototype,"headingLevel");let b=h;a.defineCustomElement("ogds-accordion",b);const O=s.css`@layer ogds.components{ogds-accordion-toggle::part(button){appearance:none;background-color:var(--ogds-theme-button-fill-color);border-radius:var(--ogds-theme-button-border-radius);border-color:#0000;border-width:var(--ogds-theme-button-stroke-width);color:var(--ogds-theme-button-text-color);cursor:pointer;font-family:var(--ogds-theme-button-font-family);font-size:var(--ogds-theme-type-scale-md);padding:var(--ogds-spacing-105) var(--ogds-spacing-205);font-weight:700}ogds-accordion-toggle::part(button):hover{background-color:color-mix(in srgb,var(--ogds-theme-button-fill-color),black 20%)}ogds-accordion-toggle::part(button):focus{outline-offset:.25rem;outline:.25rem solid #2491ff}}`;var T=Object.defineProperty,y=(i,e,t,n)=>{for(var o=void 0,c=i.length-1,l;c>=0;c--)(l=i[c])&&(o=l(e,t,o)||o);return o&&T(e,t,o),o},d;const p=(d=class extends s.LitElement{constructor(){super(...arguments),this.controls="",this._anyOpen=!1,this._observer=null}connectedCallback(){if(super.connectedCallback(),u(),d._sheet||(d._sheet=new CSSStyleSheet,d._sheet.replaceSync(O.cssText),document.adoptedStyleSheets=[...document.adoptedStyleSheets,d._sheet]),this.controls==""){console.error("<ogds-accordion-toggle>: Component must have a controls attribute with the IDof an <ogds-accordion> component");return}this._anyOpen=this.checkOpen(),this._observer=new MutationObserver(()=>{this._anyOpen=this.checkOpen()});const e=document.getElementById(this.controls);e&&this._observer.observe(e,{subtree:!0,attributeFilter:["open"]})}disconnectedCallback(){super.disconnectedCallback(),this._observer?.disconnect(),this._observer=null}checkOpen(){return!!document.getElementById(this.controls)?.querySelector("details[open]")}toggleAll(){const e=document.getElementById(this.controls);if(!e){console.error("<ogds-accordion-toggle>: Unable to get an accordion component with the ID specfied in the controls attribute");return}const t=Array.from(e.getElementsByTagName("details")),n=t.some(o=>o.hasAttribute("open"));n?t.forEach(o=>o.toggleAttribute("open",!1)):t.forEach(o=>o.toggleAttribute("open",!0)),this._anyOpen=!n}render(){return s.html`
|
|
9
|
+
<button @click="${this.toggleAll}" part="button">
|
|
10
|
+
<slot name="expand-label" ?hidden="${this._anyOpen}">Expand All</slot>
|
|
11
|
+
<slot name="collapse-label" ?hidden="${!this._anyOpen}"
|
|
12
|
+
>Collapse All</slot
|
|
13
|
+
>
|
|
14
|
+
</button>
|
|
15
|
+
`}},d._sheet=null,d);y([g.property({type:String,attribute:"controls"})],p.prototype,"controls");y([g.state()],p.prototype,"_anyOpen");let v=p;a.defineCustomElement("ogds-accordion-toggle",v);exports.OgdsBanner=a.OgdsBanner;exports.OgdsAccordion=b;exports.OgdsAccordionToggle=v;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs","sources":["../../src/shared/icons/add.svg","../../src/shared/icons/remove.svg","../../src/core/token-styles.ts","../../src/components/ogds-accordion/index.ts"],"sourcesContent":["export default \"data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20width='24'%20height='24'%20viewBox='0%200%2024%2024'%3e%3cpath%20d='M19%2013h-6v6h-2v-6H5v-2h6V5h2v6h6v2z'/%3e%3c/svg%3e\"","export default \"data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20width='24'%20height='24'%20viewBox='0%200%2024%2024'%3e%3cpath%20d='M19%2013H5v-2h14v2z'/%3e%3c/svg%3e\"","import colorTokens from \"@ogds/tokens/styles/css/colors.css\";\nimport spacingTokens from \"@ogds/tokens/styles/css/spacing.css\";\nimport typographyTokens from \"@ogds/tokens/styles/css/typography.css\";\nimport themeColorTokens from \"@ogds/tokens/styles/css/theme-color.css\";\nimport themeSpacingTokens from \"@ogds/tokens/styles/css/theme-spacing.css\";\nimport themeTypographyTokens from \"@ogds/tokens/styles/css/theme-typography.css\";\n\nconst sheet = new CSSStyleSheet();\nsheet.replaceSync(\n [\n colorTokens,\n spacingTokens,\n typographyTokens,\n themeColorTokens,\n themeSpacingTokens,\n themeTypographyTokens,\n ]\n .map((s) => s.cssText)\n .join(\"\\n\"),\n);\n\nexport function adoptTokenStyles() {\n if (!document.adoptedStyleSheets.includes(sheet)) {\n document.adoptedStyleSheets = [...document.adoptedStyleSheets, sheet];\n }\n}\n","import { LitElement, nothing } from \"lit\";\n\nimport styles from \"./ogds-accordion.css\";\nimport iconChevronDown from \"../../shared/icons/expand_more.svg\";\nimport iconChevronUp from \"../../shared/icons/expand_less.svg\";\nimport iconPlus from \"../../shared/icons/add.svg\";\nimport iconMinus from \"../../shared/icons/remove.svg\";\n\nimport { adoptTokenStyles } from \"../../core/token-styles\";\nimport { defineCustomElement } from \"../../utils\";\nimport { property } from \"lit/decorators.js\";\n\n/**\n * @summary The ogds-accordion component.\n *\n * Apply these classes to `<ogds-accordion>` to enable variants:\n * - `bordered` — adds a border to expanded content\n * - `with-icon` — shows a chevron icon on each summary\n * - `with-icon plus` — uses plus/minus icons instead of chevrons\n * - `with-icon right` — aligns the icon to the right\n *\n * @cssprop --ogds-accordion-border - Border used in the bordered variant.\n * @cssprop --ogds-accordion-content-padding - Padding for the expanded content area.\n * @cssprop --ogds-accordion-icon-closed - Icon shown when a panel is closed. Defaults to a chevron pointing down. CSS-only users must set this to a url() value pointing to their own icon asset.\n * @cssprop --ogds-accordion-icon-open - Icon shown when a panel is open. Defaults to a chevron pointing up. CSS-only users must set this to a url() value pointing to their own icon asset.\n * @attribute {boolean} use-list-semantics - Adds `role=\"list\"` to the component and `role=\"listitem\"` to each `<details>` child, conveying the accordion as a list to assistive technologies. Mutually exclusive with `heading-level`.\n * @attribute {number} heading-level - Sets a heading level for each accordion panel by adding `role=\"heading\"` and the corresponding `aria-level` to each `<summary>` element. Has no effect when set to `0` (the default). Mutually exclusive with `use-list-semantics`.\n *\n * @slot - The default (only) slot for the <ogds-accordion> expects one or more plain HTML <details> elements.\n * @element ogds-accordion\n */\nexport class OgdsAccordion extends LitElement {\n /** @ignore */\n private static _sheet: CSSStyleSheet | null = null;\n\n @property({ type: Boolean, attribute: \"use-list-semantics\" })\n useListSemantics = false;\n\n @property({ type: Number, attribute: \"heading-level\" })\n headingLevel = 0;\n\n declare detailsChildren: HTMLCollectionOf<HTMLDetailsElement> | undefined;\n declare childRoles: Map<HTMLDetailsElement, Set<string>>;\n\n override createRenderRoot() {\n return this;\n }\n\n override connectedCallback() {\n super.connectedCallback();\n adoptTokenStyles();\n if (!OgdsAccordion._sheet) {\n OgdsAccordion._sheet = new CSSStyleSheet();\n OgdsAccordion._sheet.replaceSync(\n `ogds-accordion, .ogds-accordion {\n --icon-chevron-pointing-down: url(\"${iconChevronDown}\");\n --icon-chevron-pointing-up: url(\"${iconChevronUp}\");\n --icon-plus: url(\"${iconPlus}\");\n --icon-minus: url(\"${iconMinus}\");\n }\\n` + styles.cssText,\n );\n document.adoptedStyleSheets = [\n ...document.adoptedStyleSheets,\n OgdsAccordion._sheet,\n ];\n }\n this.detailsChildren = this.getDetailsChildren();\n this.childRoles = new Map(\n Array.from(this.detailsChildren ?? []).map((el) => [el, new Set()]),\n );\n }\n\n override firstUpdated() {\n if (this.useListSemantics && this.headingLevel !== 0) {\n console.warn(\n \"<ogds-accordion>: use-list-semantics and heading-level are mutually exclusive. \" +\n \"Screen readers cannot reliably announce both list position and heading level \" +\n \"on the same element. Remove one attribute.\",\n );\n return;\n }\n this.addListSemantics();\n this.addHeadingSemantics();\n this.applyChildRoles();\n }\n\n getDetailsChildren() {\n const detailsEls = this.getElementsByTagName(\"details\");\n if (detailsEls.length > 0) {\n return detailsEls;\n } else {\n console.error(\n \"<ogds-accordion>: This component expects to have at least one details element as a child\",\n );\n }\n }\n\n addListSemantics() {\n if (this.useListSemantics && this.detailsChildren) {\n Array.from(this.detailsChildren).forEach((el) =>\n this.childRoles.get(el)?.add(\"listitem\"),\n );\n this.setAttribute(\"role\", \"list\");\n }\n }\n\n addHeadingSemantics() {\n const headingLevel = this.headingLevel;\n\n if (headingLevel !== 0 && this.detailsChildren) {\n Array.from(this.detailsChildren).forEach((el) => {\n const summary = el.querySelector(\"summary\");\n if (summary) {\n summary.setAttribute(\"role\", \"heading\");\n summary.setAttribute(\"aria-level\", String(headingLevel));\n }\n });\n }\n }\n\n applyChildRoles() {\n this.childRoles.forEach((roles, el) => {\n if (roles.size > 0) el.setAttribute(\"role\", Array.from(roles).join(\" \"));\n });\n }\n\n render() {\n return nothing;\n }\n}\n\ndefineCustomElement(\"ogds-accordion\", OgdsAccordion);\n"],"names":["iconPlus","iconMinus","sheet","colorTokens","spacingTokens","typographyTokens","themeColorTokens","themeSpacingTokens","themeTypographyTokens","s","adoptTokenStyles","_OgdsAccordion","_a","LitElement","iconChevronDown","iconChevronUp","styles","el","detailsEls","headingLevel","summary","roles","nothing","__decorateClass","property","OgdsAccordion","defineCustomElement"],"mappings":"0lFAAAA,EAAe,4LCAfC,EAAe,g2KCOTC,EAAQ,IAAI,cAClBA,EAAM,YACJ,CACEC,EAAAA,YACAC,EAAAA,cACAC,EACAC,EACAC,EACAC,CAAA,EAEC,IAAKC,GAAMA,EAAE,OAAO,EACpB,KAAK;AAAA,CAAI,CACd,EAEO,SAASC,GAAmB,CAC5B,SAAS,mBAAmB,SAASR,CAAK,IAC7C,SAAS,mBAAqB,CAAC,GAAG,SAAS,mBAAoBA,CAAK,EAExE,sICMO,MAAMS,GAANC,EAAA,cAA4BC,YAAW,CAAvC,aAAA,CAAA,MAAA,GAAA,SAAA,EAKL,KAAA,iBAAmB,GAGnB,KAAA,aAAe,CAAA,CAKN,kBAAmB,CAC1B,OAAO,IACT,CAES,mBAAoB,CAC3B,MAAM,kBAAA,EACNH,EAAA,EACKE,EAAc,SACjBA,EAAc,OAAS,IAAI,cAC3BA,EAAc,OAAO,YACnB;AAAA,+CACuCE,iBAAe;AAAA,6CACjBC,eAAa;AAAA,8BAC5Bf,CAAQ;AAAA,+BACPC,CAAS;AAAA;AAAA,EACzBe,EAAO,OAAA,EAEhB,SAAS,mBAAqB,CAC5B,GAAG,SAAS,mBACZJ,EAAc,MAAA,GAGlB,KAAK,gBAAkB,KAAK,mBAAA,EAC5B,KAAK,WAAa,IAAI,IACpB,MAAM,KAAK,KAAK,iBAAmB,CAAA,CAAE,EAAE,IAAKK,GAAO,CAACA,EAAI,IAAI,GAAK,CAAC,CAAA,CAEtE,CAES,cAAe,CACtB,GAAI,KAAK,kBAAoB,KAAK,eAAiB,EAAG,CACpD,QAAQ,KACN,wMAAA,EAIF,MACF,CACA,KAAK,iBAAA,EACL,KAAK,oBAAA,EACL,KAAK,gBAAA,CACP,CAEA,oBAAqB,CACnB,MAAMC,EAAa,KAAK,qBAAqB,SAAS,EACtD,GAAIA,EAAW,OAAS,EACtB,OAAOA,EAEP,QAAQ,MACN,0FAAA,CAGN,CAEA,kBAAmB,CACb,KAAK,kBAAoB,KAAK,kBAChC,MAAM,KAAK,KAAK,eAAe,EAAE,QAASD,GACxC,KAAK,WAAW,IAAIA,CAAE,GAAG,IAAI,UAAU,CAAA,EAEzC,KAAK,aAAa,OAAQ,MAAM,EAEpC,CAEA,qBAAsB,CACpB,MAAME,EAAe,KAAK,aAEtBA,IAAiB,GAAK,KAAK,iBAC7B,MAAM,KAAK,KAAK,eAAe,EAAE,QAASF,GAAO,CAC/C,MAAMG,EAAUH,EAAG,cAAc,SAAS,EACtCG,IACFA,EAAQ,aAAa,OAAQ,SAAS,EACtCA,EAAQ,aAAa,aAAc,OAAOD,CAAY,CAAC,EAE3D,CAAC,CAEL,CAEA,iBAAkB,CAChB,KAAK,WAAW,QAAQ,CAACE,EAAOJ,IAAO,CACjCI,EAAM,KAAO,GAAGJ,EAAG,aAAa,OAAQ,MAAM,KAAKI,CAAK,EAAE,KAAK,GAAG,CAAC,CACzE,CAAC,CACH,CAEA,QAAS,CACP,OAAOC,EAAAA,OACT,CACF,EAhGEV,EAAe,OAA+B,KAFzCA,GAKLW,EAAA,CADCC,EAAAA,SAAS,CAAE,KAAM,QAAS,UAAW,qBAAsB,CAAA,EAJjDb,EAKX,UAAA,kBAAA,EAGAY,EAAA,CADCC,EAAAA,SAAS,CAAE,KAAM,OAAQ,UAAW,gBAAiB,CAAA,EAP3Cb,EAQX,UAAA,cAAA,EARK,IAAMc,EAANd,EAoGPe,EAAAA,oBAAoB,iBAAkBD,CAAa"}
|
|
1
|
+
{"version":3,"file":"index.cjs","sources":["../../src/shared/icons/add.svg","../../src/shared/icons/remove.svg","../../src/core/token-styles.ts","../../src/components/ogds-accordion/index.ts","../../src/components/ogds-accordion-toggle/index.ts"],"sourcesContent":["export default \"data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20width='24'%20height='24'%20viewBox='0%200%2024%2024'%3e%3cpath%20d='M19%2013h-6v6h-2v-6H5v-2h6V5h2v6h6v2z'/%3e%3c/svg%3e\"","export default \"data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20width='24'%20height='24'%20viewBox='0%200%2024%2024'%3e%3cpath%20d='M19%2013H5v-2h14v2z'/%3e%3c/svg%3e\"","import colorTokens from \"@ogds/tokens/styles/css/colors.css\";\nimport spacingTokens from \"@ogds/tokens/styles/css/spacing.css\";\nimport typographyTokens from \"@ogds/tokens/styles/css/typography.css\";\nimport themeColorTokens from \"@ogds/tokens/styles/css/theme-color.css\";\nimport themeComponentTokens from \"@ogds/tokens/styles/css/theme-components.css\";\nimport themeSpacingTokens from \"@ogds/tokens/styles/css/theme-spacing.css\";\nimport themeTypographyTokens from \"@ogds/tokens/styles/css/theme-typography.css\";\n\nconst sheet = new CSSStyleSheet();\nsheet.replaceSync(\n [\n colorTokens,\n spacingTokens,\n typographyTokens,\n themeColorTokens,\n themeComponentTokens,\n themeSpacingTokens,\n themeTypographyTokens,\n ]\n .map((s) => s.cssText)\n .join(\"\\n\"),\n);\n\nexport function adoptTokenStyles() {\n if (!document.adoptedStyleSheets.includes(sheet)) {\n document.adoptedStyleSheets = [...document.adoptedStyleSheets, sheet];\n }\n}\n","import { LitElement, nothing } from \"lit\";\n\nimport styles from \"./ogds-accordion.css\";\nimport iconChevronDown from \"../../shared/icons/expand_more.svg\";\nimport iconChevronUp from \"../../shared/icons/expand_less.svg\";\nimport iconPlus from \"../../shared/icons/add.svg\";\nimport iconMinus from \"../../shared/icons/remove.svg\";\n\nimport { adoptTokenStyles } from \"../../core/token-styles\";\nimport { defineCustomElement } from \"../../utils\";\nimport { property } from \"lit/decorators.js\";\n\n/**\n * @summary The ogds-accordion component.\n *\n * Apply these classes to `<ogds-accordion>` to enable variants:\n * - `bordered` — adds a border to expanded content\n * - `with-icon` — shows a chevron icon on each summary\n * - `with-icon plus` — uses plus/minus icons instead of chevrons\n * - `with-icon right` — aligns the icon to the right\n *\n * @cssprop --ogds-accordion-border - Border used in the bordered variant.\n * @cssprop --ogds-accordion-content-padding - Padding for the expanded content area.\n * @cssprop --ogds-accordion-icon-closed - Icon shown when a panel is closed. Defaults to a chevron pointing down. CSS-only users must set this to a url() value pointing to their own icon asset.\n * @cssprop --ogds-accordion-icon-open - Icon shown when a panel is open. Defaults to a chevron pointing up. CSS-only users must set this to a url() value pointing to their own icon asset.\n * @attribute {boolean} use-list-semantics - Adds `role=\"list\"` to the component and `role=\"listitem\"` to each `<details>` child, conveying the accordion as a list to assistive technologies. Mutually exclusive with `heading-level`.\n * @attribute {number} heading-level - Sets a heading level for each accordion panel by adding `role=\"heading\"` and the corresponding `aria-level` to each `<summary>` element. Has no effect when set to `0` (the default). Mutually exclusive with `use-list-semantics`.\n *\n * @slot - The default (only) slot for the <ogds-accordion> expects one or more plain HTML <details> elements.\n * @element ogds-accordion\n */\nexport class OgdsAccordion extends LitElement {\n /** @ignore */\n private static _sheet: CSSStyleSheet | null = null;\n\n @property({ type: Boolean, attribute: \"use-list-semantics\" })\n useListSemantics = false;\n\n @property({ type: Number, attribute: \"heading-level\" })\n headingLevel = 0;\n\n declare detailsChildren: HTMLCollectionOf<HTMLDetailsElement> | undefined;\n declare childRoles: Map<HTMLDetailsElement, Set<string>>;\n\n override createRenderRoot() {\n return this;\n }\n\n override connectedCallback() {\n super.connectedCallback();\n adoptTokenStyles();\n if (!OgdsAccordion._sheet) {\n OgdsAccordion._sheet = new CSSStyleSheet();\n OgdsAccordion._sheet.replaceSync(\n `ogds-accordion, .ogds-accordion {\n --icon-chevron-pointing-down: url(\"${iconChevronDown}\");\n --icon-chevron-pointing-up: url(\"${iconChevronUp}\");\n --icon-plus: url(\"${iconPlus}\");\n --icon-minus: url(\"${iconMinus}\");\n }\\n` + styles.cssText,\n );\n document.adoptedStyleSheets = [\n ...document.adoptedStyleSheets,\n OgdsAccordion._sheet,\n ];\n }\n this.detailsChildren = this.getDetailsChildren();\n this.childRoles = new Map(\n Array.from(this.detailsChildren ?? []).map((el) => [el, new Set()]),\n );\n }\n\n override firstUpdated() {\n if (this.useListSemantics && this.headingLevel !== 0) {\n console.warn(\n \"<ogds-accordion>: use-list-semantics and heading-level are mutually exclusive. \" +\n \"Screen readers cannot reliably announce both list position and heading level \" +\n \"on the same element. Remove one attribute.\",\n );\n return;\n }\n this.addListSemantics();\n this.addHeadingSemantics();\n this.applyChildRoles();\n }\n\n getDetailsChildren() {\n const detailsEls = this.getElementsByTagName(\"details\");\n if (detailsEls.length > 0) {\n return detailsEls;\n } else {\n console.error(\n \"<ogds-accordion>: This component expects to have at least one details element as a child\",\n );\n }\n }\n\n addListSemantics() {\n if (this.useListSemantics && this.detailsChildren) {\n Array.from(this.detailsChildren).forEach((el) =>\n this.childRoles.get(el)?.add(\"listitem\"),\n );\n this.setAttribute(\"role\", \"list\");\n }\n }\n\n addHeadingSemantics() {\n const headingLevel = this.headingLevel;\n\n if (headingLevel !== 0 && this.detailsChildren) {\n Array.from(this.detailsChildren).forEach((el) => {\n const summary = el.querySelector(\"summary\");\n if (summary) {\n summary.setAttribute(\"role\", \"heading\");\n summary.setAttribute(\"aria-level\", String(headingLevel));\n }\n });\n }\n }\n\n applyChildRoles() {\n this.childRoles.forEach((roles, el) => {\n if (roles.size > 0) el.setAttribute(\"role\", Array.from(roles).join(\" \"));\n });\n }\n\n render() {\n return nothing;\n }\n}\n\ndefineCustomElement(\"ogds-accordion\", OgdsAccordion);\n","import { LitElement, html } from \"lit\";\nimport { adoptTokenStyles } from \"../../core/token-styles\";\nimport { defineCustomElement } from \"../../utils\";\n\nimport { property, state } from \"lit/decorators.js\";\nimport styles from \"./ogds-accordion-toggle.css\";\n\n/**\n * @summary A button that expands or collapses all panels in an associated `<ogds-accordion>`.\n *\n * @attribute {string} controls - The `id` of the `<ogds-accordion>` to control. Required.\n *\n * @slot expand-label - Button label when all panels are collapsed. Defaults to \"Expand All\".\n * @slot collapse-label - Button label when one or more panels are open. Defaults to \"Collapse All\".\n *\n * @csspart button - The toggle button.\n *\n * @element ogds-accordion-toggle\n */\nexport class OgdsAccordionToggle extends LitElement {\n /** @ignore */\n private static _sheet: CSSStyleSheet | null = null;\n\n @property({ type: String, attribute: \"controls\" })\n controls = \"\";\n\n @state()\n private _anyOpen = false;\n\n private _observer: MutationObserver | null = null;\n\n override connectedCallback() {\n super.connectedCallback();\n adoptTokenStyles();\n if (!OgdsAccordionToggle._sheet) {\n OgdsAccordionToggle._sheet = new CSSStyleSheet();\n OgdsAccordionToggle._sheet.replaceSync(styles.cssText);\n document.adoptedStyleSheets = [\n ...document.adoptedStyleSheets,\n OgdsAccordionToggle._sheet,\n ];\n }\n if (this.controls == \"\") {\n console.error(\n \"<ogds-accordion-toggle>: Component must have a controls attribute with the ID\" +\n \"of an <ogds-accordion> component\",\n );\n return;\n }\n this._anyOpen = this.checkOpen();\n this._observer = new MutationObserver(() => {\n this._anyOpen = this.checkOpen();\n });\n const accordionEl = document.getElementById(this.controls);\n if (accordionEl) {\n this._observer.observe(accordionEl, {\n subtree: true,\n attributeFilter: [\"open\"],\n });\n }\n }\n\n override disconnectedCallback() {\n super.disconnectedCallback();\n this._observer?.disconnect();\n this._observer = null;\n }\n\n checkOpen() {\n const accordionEl = document.getElementById(this.controls);\n const openDetails = accordionEl?.querySelector(\"details[open]\");\n return !!openDetails;\n }\n\n toggleAll() {\n const accordionEl = document.getElementById(this.controls);\n if (!accordionEl) {\n console.error(\n \"<ogds-accordion-toggle>: Unable to get an accordion component with the ID\" +\n \" specfied in the controls attribute\",\n );\n return;\n }\n\n const detailsEls = Array.from(accordionEl.getElementsByTagName(\"details\"));\n const anyOpen = detailsEls.some((d) => d.hasAttribute(\"open\"));\n if (!anyOpen) {\n detailsEls.forEach((d) => d.toggleAttribute(\"open\", true));\n } else {\n detailsEls.forEach((d) => d.toggleAttribute(\"open\", false));\n }\n this._anyOpen = !anyOpen;\n }\n\n protected override render(): unknown {\n return html`\n <button @click=\"${this.toggleAll}\" part=\"button\">\n <slot name=\"expand-label\" ?hidden=\"${this._anyOpen}\">Expand All</slot>\n <slot name=\"collapse-label\" ?hidden=\"${!this._anyOpen}\"\n >Collapse All</slot\n >\n </button>\n `;\n }\n}\n\ndefineCustomElement(\"ogds-accordion-toggle\", OgdsAccordionToggle);\n"],"names":["iconPlus","iconMinus","sheet","colorTokens","spacingTokens","typographyTokens","themeColorTokens","themeComponentTokens","themeSpacingTokens","themeTypographyTokens","s","adoptTokenStyles","_OgdsAccordion","_a","LitElement","iconChevronDown","iconChevronUp","styles","el","detailsEls","headingLevel","summary","roles","nothing","__decorateClass","property","OgdsAccordion","defineCustomElement","_OgdsAccordionToggle","accordionEl","anyOpen","d","html","state","OgdsAccordionToggle"],"mappings":"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"}
|