@spectrum-web-components/contextual-help 0.49.0-beta.0 → 0.49.0-beta.2
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 +1 -0
- package/package.json +8 -8
- package/src/ContextualHelp.dev.js.map +2 -2
- package/src/ContextualHelp.js.map +2 -2
package/README.md
CHANGED
|
@@ -6,6 +6,7 @@ A `sp-contextual-help` shows a user extra information about the state of either
|
|
|
6
6
|
|
|
7
7
|
[](https://www.npmjs.com/package/@spectrum-web-components/contextual-help)
|
|
8
8
|
[](https://bundlephobia.com/result?p=@spectrum-web-components/contextual-help)
|
|
9
|
+
[](https://webcomponents.dev/edit/collection/fO75441E1Q5ZlI0e9pgq/WPGsKF04KHJ3tVB852UD/src/index.ts)
|
|
9
10
|
|
|
10
11
|
```
|
|
11
12
|
yarn add @spectrum-web-components/contextual-help
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@spectrum-web-components/contextual-help",
|
|
3
|
-
"version": "0.49.0-beta.
|
|
3
|
+
"version": "0.49.0-beta.2",
|
|
4
4
|
"publishConfig": {
|
|
5
5
|
"access": "public"
|
|
6
6
|
},
|
|
@@ -57,12 +57,12 @@
|
|
|
57
57
|
"lit-html"
|
|
58
58
|
],
|
|
59
59
|
"dependencies": {
|
|
60
|
-
"@spectrum-web-components/action-button": "^0.49.0-beta.
|
|
61
|
-
"@spectrum-web-components/base": "^0.49.0-beta.
|
|
62
|
-
"@spectrum-web-components/dialog": "^0.49.0-beta.
|
|
63
|
-
"@spectrum-web-components/icons-workflow": "^0.49.0-beta.
|
|
64
|
-
"@spectrum-web-components/overlay": "^0.49.0-beta.
|
|
65
|
-
"@spectrum-web-components/popover": "^0.49.0-beta.
|
|
60
|
+
"@spectrum-web-components/action-button": "^0.49.0-beta.2",
|
|
61
|
+
"@spectrum-web-components/base": "^0.49.0-beta.2",
|
|
62
|
+
"@spectrum-web-components/dialog": "^0.49.0-beta.2",
|
|
63
|
+
"@spectrum-web-components/icons-workflow": "^0.49.0-beta.2",
|
|
64
|
+
"@spectrum-web-components/overlay": "^0.49.0-beta.2",
|
|
65
|
+
"@spectrum-web-components/popover": "^0.49.0-beta.2"
|
|
66
66
|
},
|
|
67
67
|
"devDependencies": {
|
|
68
68
|
"@spectrum-css/contextualhelp": "^2.1.5"
|
|
@@ -74,5 +74,5 @@
|
|
|
74
74
|
"./**/*.dev.js",
|
|
75
75
|
"./**/*.dev.js"
|
|
76
76
|
],
|
|
77
|
-
"gitHead": "
|
|
77
|
+
"gitHead": "2a8752a182e31dfd71c010b72bece20b0b5d1c9e"
|
|
78
78
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["ContextualHelp.ts"],
|
|
4
|
-
"sourcesContent": ["/*\nCopyright 2024 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport {\n CSSResultArray,\n html,\n render,\n SpectrumElement,\n TemplateResult,\n} from '@spectrum-web-components/base';\nimport '@spectrum-web-components/action-button/sp-action-button.js';\nimport '@spectrum-web-components/overlay/sp-overlay.js';\nimport '@spectrum-web-components/icons-workflow/icons/sp-icon-help-outline.js';\nimport '@spectrum-web-components/icons-workflow/icons/sp-icon-info-outline.js';\nimport { property } from '@spectrum-web-components/base/src/decorators.js';\nimport { ifDefined } from '@spectrum-web-components/base/src/directives.js';\nimport type { Placement } from '@spectrum-web-components/overlay/src/overlay-types.js';\nimport {\n removeSlottableRequest,\n SlottableRequestEvent,\n} from '@spectrum-web-components/overlay/src/slottable-request-event.js';\nimport {\n IS_MOBILE,\n MatchMediaController,\n} from '@spectrum-web-components/reactive-controllers/src/MatchMedia.js';\nimport styles from './contextual-help.css.js';\n\n/**\n * Spectrum Contextual help provides additional information about\n * the state of either an adjacent component or an entire view.\n * @element sp-contextual-help\n *\n * @slot heading - content to display as the heading of the popover\n * @slot Text content to display in the popover\n * @slot link - link to additional informations\n */\nexport class ContextualHelp extends SpectrumElement {\n public isMobile = new MatchMediaController(this, IS_MOBILE);\n\n public static override get styles(): CSSResultArray {\n return [styles];\n }\n\n /**\n * Provides an accessible name for the action button trigger.\n * @param {String} label\n */\n @property()\n public label?: string;\n\n /**\n * The `variant` property applies specific styling on the action button trigger.\n * @param {String} variant\n */\n @property()\n public variant: 'info' | 'help' = 'info';\n\n /**\n * @type {\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\"}\n * @attr\n */\n @property({ reflect: true })\n public placement?: Placement = 'bottom-start';\n\n /**\n * The `offset` property accepts either a single number, to\n * define the offset of the Popover along the main axis from\n * the action button, or 2-tuple, to define the offset along the\n * main axis and the cross axis.\n */\n @property({ type: Number })\n public offset: number | [number, number] = 0;\n\n @property({ type: Boolean })\n open = false;\n\n public get buttonAriaLabel(): string {\n if (this.label) {\n return this.label;\n } else {\n if (this.variant === 'help') {\n return 'Help';\n }\n return 'Informations';\n }\n }\n\n private renderOverlayContent(): TemplateResult {\n if (this.isMobile.matches) {\n import('@spectrum-web-components/dialog/sp-dialog-base.js');\n import('@spectrum-web-components/dialog/sp-dialog.js');\n\n return html`\n <sp-dialog-base underlay>\n <sp-dialog dismissable size=\"s\">\n <slot name=\"heading\" slot=\"heading\"></slot>\n <slot></slot>\n <slot name=\"link\"></slot>\n </sp-dialog>\n </sp-dialog-base>\n `;\n } else {\n import('@spectrum-web-components/popover/sp-popover.js');\n\n return html`\n <sp-popover class=\"popover\">\n <section>\n <slot name=\"heading\"></slot>\n <slot></slot>\n <slot name=\"link\"></slot>\n </section>\n </sp-popover>\n `;\n }\n }\n\n private handleSlottableRequest(event: SlottableRequestEvent): void {\n event.stopPropagation();\n\n if (event.data === removeSlottableRequest) {\n this.open = false;\n render(undefined, event.target as HTMLElement);\n return;\n }\n\n this.open = true;\n const template = this.renderOverlayContent();\n render(template, event.target as HTMLElement);\n }\n\n protected override render(): TemplateResult {\n const actualPlacement = this.isMobile.matches\n ? undefined\n : this.placement;\n\n return html`\n <sp-action-button\n quiet\n size=\"s\"\n id=\"trigger\"\n aria-label=${this.buttonAriaLabel}\n .active=${this.open}\n >\n ${this.variant === 'help'\n ? html`\n <sp-icon-help-outline\n slot=\"icon\"\n ></sp-icon-help-outline>\n `\n : html`\n <sp-icon-info-outline\n slot=\"icon\"\n ></sp-icon-info-outline>\n `}\n </sp-action-button>\n <sp-overlay\n trigger=\"trigger@click\"\n placement=${ifDefined(actualPlacement)}\n type=${this.isMobile.matches ? 'modal' : 'auto'}\n receives-focus=\"true\"\n .offset=${this.offset}\n @slottable-request=${this.handleSlottableRequest}\n ?open=${this.open}\n ></sp-overlay>\n `;\n }\n}\n"],
|
|
5
|
-
"mappings": ";;;;;;;;;;;AAWA;AAAA,EAEI;AAAA,EACA;AAAA,EACA;AAAA,OAEG;AACP,OAAO;AACP,OAAO;AACP,OAAO;AACP,OAAO;AACP,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAE1B;AAAA,EACI;AAAA,OAEG;AACP;AAAA,EACI;AAAA,EACA;AAAA,OACG;AACP,OAAO,YAAY;AAWZ,aAAM,uBAAuB,gBAAgB;AAAA,EAA7C;AAAA;AACH,SAAO,WAAW,IAAI,qBAAqB,MAAM,SAAS;AAkB1D,SAAO,UAA2B;AAOlC,SAAO,YAAwB;AAS/B,SAAO,SAAoC;AAG3C,gBAAO;AAAA;AAAA,EAnCP,WAA2B,SAAyB;AAChD,WAAO,CAAC,MAAM;AAAA,EAClB;AAAA,EAmCA,IAAW,kBAA0B;AACjC,QAAI,KAAK,OAAO;AACZ,aAAO,KAAK;AAAA,IAChB,OAAO;AACH,UAAI,KAAK,YAAY,QAAQ;AACzB,eAAO;AAAA,MACX;AACA,aAAO;AAAA,IACX;AAAA,EACJ;AAAA,EAEQ,uBAAuC;AAC3C,QAAI,KAAK,SAAS,SAAS;AACvB,aAAO,mDAAmD;AAC1D,aAAO,8CAA8C;AAErD,aAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASX,OAAO;AACH,aAAO,gDAAgD;AAEvD,aAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASX;AAAA,EACJ;AAAA,EAEQ,uBAAuB,OAAoC;AAC/D,UAAM,gBAAgB;AAEtB,QAAI,MAAM,SAAS,wBAAwB;AACvC,WAAK,OAAO;AACZ,aAAO,QAAW,MAAM,MAAqB;AAC7C;AAAA,IACJ;AAEA,SAAK,OAAO;AACZ,UAAM,WAAW,KAAK,qBAAqB;AAC3C,WAAO,UAAU,MAAM,MAAqB;AAAA,EAChD;AAAA,EAEmB,SAAyB;
|
|
4
|
+
"sourcesContent": ["/*\nCopyright 2024 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport {\n CSSResultArray,\n html,\n render,\n SpectrumElement,\n TemplateResult,\n} from '@spectrum-web-components/base';\nimport '@spectrum-web-components/action-button/sp-action-button.js';\nimport '@spectrum-web-components/overlay/sp-overlay.js';\nimport '@spectrum-web-components/icons-workflow/icons/sp-icon-help-outline.js';\nimport '@spectrum-web-components/icons-workflow/icons/sp-icon-info-outline.js';\nimport { property } from '@spectrum-web-components/base/src/decorators.js';\nimport { ifDefined } from '@spectrum-web-components/base/src/directives.js';\nimport type { Placement } from '@spectrum-web-components/overlay/src/overlay-types.js';\nimport {\n removeSlottableRequest,\n SlottableRequestEvent,\n} from '@spectrum-web-components/overlay/src/slottable-request-event.js';\nimport {\n IS_MOBILE,\n MatchMediaController,\n} from '@spectrum-web-components/reactive-controllers/src/MatchMedia.js';\nimport styles from './contextual-help.css.js';\n\n/**\n * Spectrum Contextual help provides additional information about\n * the state of either an adjacent component or an entire view.\n * @element sp-contextual-help\n *\n * @slot heading - content to display as the heading of the popover\n * @slot Text content to display in the popover\n * @slot link - link to additional informations\n */\nexport class ContextualHelp extends SpectrumElement {\n public isMobile = new MatchMediaController(this, IS_MOBILE);\n\n public static override get styles(): CSSResultArray {\n return [styles];\n }\n\n /**\n * Provides an accessible name for the action button trigger.\n * @param {String} label\n */\n @property()\n public label?: string;\n\n /**\n * The `variant` property applies specific styling on the action button trigger.\n * @param {String} variant\n */\n @property()\n public variant: 'info' | 'help' = 'info';\n\n /**\n * @type {\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\"}\n * @attr\n */\n @property({ reflect: true })\n public placement?: Placement = 'bottom-start';\n\n /**\n * The `offset` property accepts either a single number, to\n * define the offset of the Popover along the main axis from\n * the action button, or 2-tuple, to define the offset along the\n * main axis and the cross axis.\n */\n @property({ type: Number })\n public offset: number | [number, number] = 0;\n\n @property({ type: Boolean })\n open = false;\n\n public get buttonAriaLabel(): string {\n if (this.label) {\n return this.label;\n } else {\n if (this.variant === 'help') {\n return 'Help';\n }\n return 'Informations';\n }\n }\n\n private renderOverlayContent(): TemplateResult {\n if (this.isMobile.matches) {\n import('@spectrum-web-components/dialog/sp-dialog-base.js');\n import('@spectrum-web-components/dialog/sp-dialog.js');\n\n return html`\n <sp-dialog-base underlay>\n <sp-dialog dismissable size=\"s\">\n <slot name=\"heading\" slot=\"heading\"></slot>\n <slot></slot>\n <slot name=\"link\"></slot>\n </sp-dialog>\n </sp-dialog-base>\n `;\n } else {\n import('@spectrum-web-components/popover/sp-popover.js');\n\n return html`\n <sp-popover class=\"popover\">\n <section>\n <slot name=\"heading\"></slot>\n <slot></slot>\n <slot name=\"link\"></slot>\n </section>\n </sp-popover>\n `;\n }\n }\n\n private handleSlottableRequest(event: SlottableRequestEvent): void {\n event.stopPropagation();\n\n if (event.data === removeSlottableRequest) {\n this.open = false;\n render(undefined, event.target as HTMLElement);\n return;\n }\n\n this.open = true;\n const template = this.renderOverlayContent();\n render(template, event.target as HTMLElement);\n }\n\n protected override render(): TemplateResult {\n /* c8 ignore next 3 */\n const actualPlacement = this.isMobile.matches\n ? undefined\n : this.placement;\n\n return html`\n <sp-action-button\n quiet\n size=\"s\"\n id=\"trigger\"\n aria-label=${this.buttonAriaLabel}\n .active=${this.open}\n >\n ${this.variant === 'help'\n ? html`\n <sp-icon-help-outline\n slot=\"icon\"\n ></sp-icon-help-outline>\n `\n : html`\n <sp-icon-info-outline\n slot=\"icon\"\n ></sp-icon-info-outline>\n `}\n </sp-action-button>\n <sp-overlay\n trigger=\"trigger@click\"\n placement=${ifDefined(actualPlacement)}\n type=${this.isMobile.matches ? 'modal' : 'auto'}\n receives-focus=\"true\"\n .offset=${this.offset}\n @slottable-request=${this.handleSlottableRequest}\n ?open=${this.open}\n ></sp-overlay>\n `;\n }\n}\n"],
|
|
5
|
+
"mappings": ";;;;;;;;;;;AAWA;AAAA,EAEI;AAAA,EACA;AAAA,EACA;AAAA,OAEG;AACP,OAAO;AACP,OAAO;AACP,OAAO;AACP,OAAO;AACP,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAE1B;AAAA,EACI;AAAA,OAEG;AACP;AAAA,EACI;AAAA,EACA;AAAA,OACG;AACP,OAAO,YAAY;AAWZ,aAAM,uBAAuB,gBAAgB;AAAA,EAA7C;AAAA;AACH,SAAO,WAAW,IAAI,qBAAqB,MAAM,SAAS;AAkB1D,SAAO,UAA2B;AAOlC,SAAO,YAAwB;AAS/B,SAAO,SAAoC;AAG3C,gBAAO;AAAA;AAAA,EAnCP,WAA2B,SAAyB;AAChD,WAAO,CAAC,MAAM;AAAA,EAClB;AAAA,EAmCA,IAAW,kBAA0B;AACjC,QAAI,KAAK,OAAO;AACZ,aAAO,KAAK;AAAA,IAChB,OAAO;AACH,UAAI,KAAK,YAAY,QAAQ;AACzB,eAAO;AAAA,MACX;AACA,aAAO;AAAA,IACX;AAAA,EACJ;AAAA,EAEQ,uBAAuC;AAC3C,QAAI,KAAK,SAAS,SAAS;AACvB,aAAO,mDAAmD;AAC1D,aAAO,8CAA8C;AAErD,aAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASX,OAAO;AACH,aAAO,gDAAgD;AAEvD,aAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASX;AAAA,EACJ;AAAA,EAEQ,uBAAuB,OAAoC;AAC/D,UAAM,gBAAgB;AAEtB,QAAI,MAAM,SAAS,wBAAwB;AACvC,WAAK,OAAO;AACZ,aAAO,QAAW,MAAM,MAAqB;AAC7C;AAAA,IACJ;AAEA,SAAK,OAAO;AACZ,UAAM,WAAW,KAAK,qBAAqB;AAC3C,WAAO,UAAU,MAAM,MAAqB;AAAA,EAChD;AAAA,EAEmB,SAAyB;AAExC,UAAM,kBAAkB,KAAK,SAAS,UAChC,SACA,KAAK;AAEX,WAAO;AAAA;AAAA;AAAA;AAAA;AAAA,6BAKc,KAAK,eAAe;AAAA,0BACvB,KAAK,IAAI;AAAA;AAAA,kBAEjB,KAAK,YAAY,SACb;AAAA;AAAA;AAAA;AAAA,0BAKA;AAAA;AAAA;AAAA;AAAA,uBAIC;AAAA;AAAA;AAAA;AAAA,4BAIK,UAAU,eAAe,CAAC;AAAA,uBAC/B,KAAK,SAAS,UAAU,UAAU,MAAM;AAAA;AAAA,0BAErC,KAAK,MAAM;AAAA,qCACA,KAAK,sBAAsB;AAAA,wBACxC,KAAK,IAAI;AAAA;AAAA;AAAA,EAG7B;AACJ;AAvHW;AAAA,EADN,SAAS;AAAA,GAXD,eAYF;AAOA;AAAA,EADN,SAAS;AAAA,GAlBD,eAmBF;AAOA;AAAA,EADN,SAAS,EAAE,SAAS,KAAK,CAAC;AAAA,GAzBlB,eA0BF;AASA;AAAA,EADN,SAAS,EAAE,MAAM,OAAO,CAAC;AAAA,GAlCjB,eAmCF;AAGP;AAAA,EADC,SAAS,EAAE,MAAM,QAAQ,CAAC;AAAA,GArClB,eAsCT;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["ContextualHelp.ts"],
|
|
4
|
-
"sourcesContent": ["/*\nCopyright 2024 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport {\n CSSResultArray,\n html,\n render,\n SpectrumElement,\n TemplateResult,\n} from '@spectrum-web-components/base';\nimport '@spectrum-web-components/action-button/sp-action-button.js';\nimport '@spectrum-web-components/overlay/sp-overlay.js';\nimport '@spectrum-web-components/icons-workflow/icons/sp-icon-help-outline.js';\nimport '@spectrum-web-components/icons-workflow/icons/sp-icon-info-outline.js';\nimport { property } from '@spectrum-web-components/base/src/decorators.js';\nimport { ifDefined } from '@spectrum-web-components/base/src/directives.js';\nimport type { Placement } from '@spectrum-web-components/overlay/src/overlay-types.js';\nimport {\n removeSlottableRequest,\n SlottableRequestEvent,\n} from '@spectrum-web-components/overlay/src/slottable-request-event.js';\nimport {\n IS_MOBILE,\n MatchMediaController,\n} from '@spectrum-web-components/reactive-controllers/src/MatchMedia.js';\nimport styles from './contextual-help.css.js';\n\n/**\n * Spectrum Contextual help provides additional information about\n * the state of either an adjacent component or an entire view.\n * @element sp-contextual-help\n *\n * @slot heading - content to display as the heading of the popover\n * @slot Text content to display in the popover\n * @slot link - link to additional informations\n */\nexport class ContextualHelp extends SpectrumElement {\n public isMobile = new MatchMediaController(this, IS_MOBILE);\n\n public static override get styles(): CSSResultArray {\n return [styles];\n }\n\n /**\n * Provides an accessible name for the action button trigger.\n * @param {String} label\n */\n @property()\n public label?: string;\n\n /**\n * The `variant` property applies specific styling on the action button trigger.\n * @param {String} variant\n */\n @property()\n public variant: 'info' | 'help' = 'info';\n\n /**\n * @type {\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\"}\n * @attr\n */\n @property({ reflect: true })\n public placement?: Placement = 'bottom-start';\n\n /**\n * The `offset` property accepts either a single number, to\n * define the offset of the Popover along the main axis from\n * the action button, or 2-tuple, to define the offset along the\n * main axis and the cross axis.\n */\n @property({ type: Number })\n public offset: number | [number, number] = 0;\n\n @property({ type: Boolean })\n open = false;\n\n public get buttonAriaLabel(): string {\n if (this.label) {\n return this.label;\n } else {\n if (this.variant === 'help') {\n return 'Help';\n }\n return 'Informations';\n }\n }\n\n private renderOverlayContent(): TemplateResult {\n if (this.isMobile.matches) {\n import('@spectrum-web-components/dialog/sp-dialog-base.js');\n import('@spectrum-web-components/dialog/sp-dialog.js');\n\n return html`\n <sp-dialog-base underlay>\n <sp-dialog dismissable size=\"s\">\n <slot name=\"heading\" slot=\"heading\"></slot>\n <slot></slot>\n <slot name=\"link\"></slot>\n </sp-dialog>\n </sp-dialog-base>\n `;\n } else {\n import('@spectrum-web-components/popover/sp-popover.js');\n\n return html`\n <sp-popover class=\"popover\">\n <section>\n <slot name=\"heading\"></slot>\n <slot></slot>\n <slot name=\"link\"></slot>\n </section>\n </sp-popover>\n `;\n }\n }\n\n private handleSlottableRequest(event: SlottableRequestEvent): void {\n event.stopPropagation();\n\n if (event.data === removeSlottableRequest) {\n this.open = false;\n render(undefined, event.target as HTMLElement);\n return;\n }\n\n this.open = true;\n const template = this.renderOverlayContent();\n render(template, event.target as HTMLElement);\n }\n\n protected override render(): TemplateResult {\n const actualPlacement = this.isMobile.matches\n ? undefined\n : this.placement;\n\n return html`\n <sp-action-button\n quiet\n size=\"s\"\n id=\"trigger\"\n aria-label=${this.buttonAriaLabel}\n .active=${this.open}\n >\n ${this.variant === 'help'\n ? html`\n <sp-icon-help-outline\n slot=\"icon\"\n ></sp-icon-help-outline>\n `\n : html`\n <sp-icon-info-outline\n slot=\"icon\"\n ></sp-icon-info-outline>\n `}\n </sp-action-button>\n <sp-overlay\n trigger=\"trigger@click\"\n placement=${ifDefined(actualPlacement)}\n type=${this.isMobile.matches ? 'modal' : 'auto'}\n receives-focus=\"true\"\n .offset=${this.offset}\n @slottable-request=${this.handleSlottableRequest}\n ?open=${this.open}\n ></sp-overlay>\n `;\n }\n}\n"],
|
|
5
|
-
"mappings": "qNAWA,OAEI,QAAAA,EACA,UAAAC,EACA,mBAAAC,MAEG,gCACP,MAAO,6DACP,MAAO,iDACP,MAAO,wEACP,MAAO,wEACP,OAAS,YAAAC,MAAgB,kDACzB,OAAS,aAAAC,MAAiB,kDAE1B,OACI,0BAAAC,MAEG,kEACP,OACI,aAAAC,EACA,wBAAAC,MACG,kEACP,OAAOC,MAAY,2BAWZ,aAAM,uBAAuBN,CAAgB,CAA7C,kCACH,KAAO,SAAW,IAAIK,EAAqB,KAAMD,CAAS,EAkB1D,KAAO,QAA2B,OAOlC,KAAO,UAAwB,eAS/B,KAAO,OAAoC,EAG3C,UAAO,GAnCP,WAA2B,QAAyB,CAChD,MAAO,CAACE,CAAM,CAClB,CAmCA,IAAW,iBAA0B,CACjC,OAAI,KAAK,MACE,KAAK,MAER,KAAK,UAAY,OACV,OAEJ,cAEf,CAEQ,sBAAuC,CAC3C,OAAI,KAAK,SAAS,SACd,OAAO,mDAAmD,EAC1D,OAAO,8CAA8C,EAE9CR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gBAUP,OAAO,gDAAgD,EAEhDA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,cAUf,CAEQ,uBAAuBS,EAAoC,CAG/D,GAFAA,EAAM,gBAAgB,EAElBA,EAAM,OAASJ,EAAwB,CACvC,KAAK,KAAO,GACZJ,EAAO,OAAWQ,EAAM,MAAqB,EAC7C,MACJ,CAEA,KAAK,KAAO,GACZ,MAAMC,EAAW,KAAK,qBAAqB,EAC3CT,EAAOS,EAAUD,EAAM,MAAqB,CAChD,CAEmB,QAAyB,
|
|
4
|
+
"sourcesContent": ["/*\nCopyright 2024 Adobe. All rights reserved.\nThis file is licensed to you under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License. You may obtain a copy\nof the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under\nthe License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\nOF ANY KIND, either express or implied. See the License for the specific language\ngoverning permissions and limitations under the License.\n*/\nimport {\n CSSResultArray,\n html,\n render,\n SpectrumElement,\n TemplateResult,\n} from '@spectrum-web-components/base';\nimport '@spectrum-web-components/action-button/sp-action-button.js';\nimport '@spectrum-web-components/overlay/sp-overlay.js';\nimport '@spectrum-web-components/icons-workflow/icons/sp-icon-help-outline.js';\nimport '@spectrum-web-components/icons-workflow/icons/sp-icon-info-outline.js';\nimport { property } from '@spectrum-web-components/base/src/decorators.js';\nimport { ifDefined } from '@spectrum-web-components/base/src/directives.js';\nimport type { Placement } from '@spectrum-web-components/overlay/src/overlay-types.js';\nimport {\n removeSlottableRequest,\n SlottableRequestEvent,\n} from '@spectrum-web-components/overlay/src/slottable-request-event.js';\nimport {\n IS_MOBILE,\n MatchMediaController,\n} from '@spectrum-web-components/reactive-controllers/src/MatchMedia.js';\nimport styles from './contextual-help.css.js';\n\n/**\n * Spectrum Contextual help provides additional information about\n * the state of either an adjacent component or an entire view.\n * @element sp-contextual-help\n *\n * @slot heading - content to display as the heading of the popover\n * @slot Text content to display in the popover\n * @slot link - link to additional informations\n */\nexport class ContextualHelp extends SpectrumElement {\n public isMobile = new MatchMediaController(this, IS_MOBILE);\n\n public static override get styles(): CSSResultArray {\n return [styles];\n }\n\n /**\n * Provides an accessible name for the action button trigger.\n * @param {String} label\n */\n @property()\n public label?: string;\n\n /**\n * The `variant` property applies specific styling on the action button trigger.\n * @param {String} variant\n */\n @property()\n public variant: 'info' | 'help' = 'info';\n\n /**\n * @type {\"top\" | \"top-start\" | \"top-end\" | \"right\" | \"right-start\" | \"right-end\" | \"bottom\" | \"bottom-start\" | \"bottom-end\" | \"left\" | \"left-start\" | \"left-end\"}\n * @attr\n */\n @property({ reflect: true })\n public placement?: Placement = 'bottom-start';\n\n /**\n * The `offset` property accepts either a single number, to\n * define the offset of the Popover along the main axis from\n * the action button, or 2-tuple, to define the offset along the\n * main axis and the cross axis.\n */\n @property({ type: Number })\n public offset: number | [number, number] = 0;\n\n @property({ type: Boolean })\n open = false;\n\n public get buttonAriaLabel(): string {\n if (this.label) {\n return this.label;\n } else {\n if (this.variant === 'help') {\n return 'Help';\n }\n return 'Informations';\n }\n }\n\n private renderOverlayContent(): TemplateResult {\n if (this.isMobile.matches) {\n import('@spectrum-web-components/dialog/sp-dialog-base.js');\n import('@spectrum-web-components/dialog/sp-dialog.js');\n\n return html`\n <sp-dialog-base underlay>\n <sp-dialog dismissable size=\"s\">\n <slot name=\"heading\" slot=\"heading\"></slot>\n <slot></slot>\n <slot name=\"link\"></slot>\n </sp-dialog>\n </sp-dialog-base>\n `;\n } else {\n import('@spectrum-web-components/popover/sp-popover.js');\n\n return html`\n <sp-popover class=\"popover\">\n <section>\n <slot name=\"heading\"></slot>\n <slot></slot>\n <slot name=\"link\"></slot>\n </section>\n </sp-popover>\n `;\n }\n }\n\n private handleSlottableRequest(event: SlottableRequestEvent): void {\n event.stopPropagation();\n\n if (event.data === removeSlottableRequest) {\n this.open = false;\n render(undefined, event.target as HTMLElement);\n return;\n }\n\n this.open = true;\n const template = this.renderOverlayContent();\n render(template, event.target as HTMLElement);\n }\n\n protected override render(): TemplateResult {\n /* c8 ignore next 3 */\n const actualPlacement = this.isMobile.matches\n ? undefined\n : this.placement;\n\n return html`\n <sp-action-button\n quiet\n size=\"s\"\n id=\"trigger\"\n aria-label=${this.buttonAriaLabel}\n .active=${this.open}\n >\n ${this.variant === 'help'\n ? html`\n <sp-icon-help-outline\n slot=\"icon\"\n ></sp-icon-help-outline>\n `\n : html`\n <sp-icon-info-outline\n slot=\"icon\"\n ></sp-icon-info-outline>\n `}\n </sp-action-button>\n <sp-overlay\n trigger=\"trigger@click\"\n placement=${ifDefined(actualPlacement)}\n type=${this.isMobile.matches ? 'modal' : 'auto'}\n receives-focus=\"true\"\n .offset=${this.offset}\n @slottable-request=${this.handleSlottableRequest}\n ?open=${this.open}\n ></sp-overlay>\n `;\n }\n}\n"],
|
|
5
|
+
"mappings": "qNAWA,OAEI,QAAAA,EACA,UAAAC,EACA,mBAAAC,MAEG,gCACP,MAAO,6DACP,MAAO,iDACP,MAAO,wEACP,MAAO,wEACP,OAAS,YAAAC,MAAgB,kDACzB,OAAS,aAAAC,MAAiB,kDAE1B,OACI,0BAAAC,MAEG,kEACP,OACI,aAAAC,EACA,wBAAAC,MACG,kEACP,OAAOC,MAAY,2BAWZ,aAAM,uBAAuBN,CAAgB,CAA7C,kCACH,KAAO,SAAW,IAAIK,EAAqB,KAAMD,CAAS,EAkB1D,KAAO,QAA2B,OAOlC,KAAO,UAAwB,eAS/B,KAAO,OAAoC,EAG3C,UAAO,GAnCP,WAA2B,QAAyB,CAChD,MAAO,CAACE,CAAM,CAClB,CAmCA,IAAW,iBAA0B,CACjC,OAAI,KAAK,MACE,KAAK,MAER,KAAK,UAAY,OACV,OAEJ,cAEf,CAEQ,sBAAuC,CAC3C,OAAI,KAAK,SAAS,SACd,OAAO,mDAAmD,EAC1D,OAAO,8CAA8C,EAE9CR;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,gBAUP,OAAO,gDAAgD,EAEhDA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,cAUf,CAEQ,uBAAuBS,EAAoC,CAG/D,GAFAA,EAAM,gBAAgB,EAElBA,EAAM,OAASJ,EAAwB,CACvC,KAAK,KAAO,GACZJ,EAAO,OAAWQ,EAAM,MAAqB,EAC7C,MACJ,CAEA,KAAK,KAAO,GACZ,MAAMC,EAAW,KAAK,qBAAqB,EAC3CT,EAAOS,EAAUD,EAAM,MAAqB,CAChD,CAEmB,QAAyB,CAExC,MAAME,EAAkB,KAAK,SAAS,QAChC,OACA,KAAK,UAEX,OAAOX;AAAA;AAAA;AAAA;AAAA;AAAA,6BAKc,KAAK,eAAe;AAAA,0BACvB,KAAK,IAAI;AAAA;AAAA,kBAEjB,KAAK,UAAY,OACbA;AAAA;AAAA;AAAA;AAAA,wBAKAA;AAAA;AAAA;AAAA;AAAA,uBAIC;AAAA;AAAA;AAAA;AAAA,4BAIKI,EAAUO,CAAe,CAAC;AAAA,uBAC/B,KAAK,SAAS,QAAU,QAAU,MAAM;AAAA;AAAA,0BAErC,KAAK,MAAM;AAAA,qCACA,KAAK,sBAAsB;AAAA,wBACxC,KAAK,IAAI;AAAA;AAAA,SAG7B,CACJ,CAvHWC,EAAA,CADNT,EAAS,GAXD,eAYF,qBAOAS,EAAA,CADNT,EAAS,GAlBD,eAmBF,uBAOAS,EAAA,CADNT,EAAS,CAAE,QAAS,EAAK,CAAC,GAzBlB,eA0BF,yBASAS,EAAA,CADNT,EAAS,CAAE,KAAM,MAAO,CAAC,GAlCjB,eAmCF,sBAGPS,EAAA,CADCT,EAAS,CAAE,KAAM,OAAQ,CAAC,GArClB,eAsCT",
|
|
6
6
|
"names": ["html", "render", "SpectrumElement", "property", "ifDefined", "removeSlottableRequest", "IS_MOBILE", "MatchMediaController", "styles", "event", "template", "actualPlacement", "__decorateClass"]
|
|
7
7
|
}
|