@spectrum-web-components/action-button 0.8.0 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@spectrum-web-components/action-button",
-    "version": "0.8.0",
+    "version": "0.8.1",
     "publishConfig": {
         "access": "public"
     },
@@ -44,10 +44,10 @@
         "lit-html"
     ],
     "dependencies": {
-        "@spectrum-web-components/base": "^0.5.3",
-        "@spectrum-web-components/button": "^0.17.0",
-        "@spectrum-web-components/icon": "^0.11.4",
-        "@spectrum-web-components/icons-ui": "^0.8.4",
+        "@spectrum-web-components/base": "^0.5.4",
+        "@spectrum-web-components/button": "^0.17.1",
+        "@spectrum-web-components/icon": "^0.11.5",
+        "@spectrum-web-components/icons-ui": "^0.8.5",
         "tslib": "^2.0.0"
     },
     "devDependencies": {
@@ -58,5 +58,5 @@
     "sideEffects": [
         "./sp-*.js"
     ],
-    "gitHead": "57aba8030b6af96af4015a0aa830e342a17dc219"
+    "gitHead": "caf12727e7f91dcf961e1fadacc727eea9ece27b"
 }

package/sp-action-button.d.ts

@@ -0,0 +1,6 @@
+import { ActionButton } from './src/ActionButton.js';
+declare global {
+    interface HTMLElementTagNameMap {
+        'sp-action-button': ActionButton;
+    }
+}

package/sp-action-button.js

@@ -0,0 +1,14 @@
+/*
+Copyright 2020 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+import { ActionButton } from './src/ActionButton.js';
+customElements.define('sp-action-button', ActionButton);
+//# sourceMappingURL=sp-action-button.js.map

package/sp-action-button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sp-action-button.js","sourceRoot":"","sources":["sp-action-button.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,cAAc,CAAC,MAAM,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC","sourcesContent":["/*\nCopyright 2020 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*/\n\nimport { ActionButton } from './src/ActionButton.js';\n\ncustomElements.define('sp-action-button', ActionButton);\n\ndeclare global {\n    interface HTMLElementTagNameMap {\n        'sp-action-button': ActionButton;\n    }\n}\n"]}

package/src/ActionButton.d.ts

@@ -0,0 +1,63 @@
+import { CSSResultArray, PropertyValues, TemplateResult } from '@spectrum-web-components/base';
+import { ButtonBase } from '@spectrum-web-components/button';
+import '@spectrum-web-components/icons-ui/icons/sp-icon-corner-triangle300.js';
+export declare type LongpressEvent = {
+    source: 'pointer' | 'keyboard';
+};
+declare const ActionButton_base: typeof ButtonBase & {
+    new (...args: any[]): import("@spectrum-web-components/base").SizedElementInterface;
+    prototype: import("@spectrum-web-components/base").SizedElementInterface;
+};
+/**
+ * @element sp-action-button
+ *
+ * @slot - text label of the Action Button
+ * @slot icon - The icon to use for Action Button
+ * @fires change - Announces a change in the `selected` property of an action button
+ * @fires longpress - Synthesizes a "longpress" interaction that signifies a
+ * `pointerdown` event that is >=300ms or a keyboard event wher code is `Space` or code is `ArrowDown`
+ * while `altKey===true`.
+ */
+export declare class ActionButton extends ActionButton_base {
+    static get styles(): CSSResultArray;
+    emphasized: boolean;
+    holdAffordance: boolean;
+    quiet: boolean;
+    role: string;
+    /**
+     * Whether an Action Button with `role='button'`
+     * should also be `aria-pressed='true'`
+     */
+    selected: boolean;
+    /**
+     * Whether to automatically manage the `selected`
+     * attribute on interaction and whether `aria-pressed="false"`
+     * should be used when `selected === false`
+     */
+    toggles: boolean;
+    variant?: 'white' | 'black';
+    get value(): string;
+    set value(value: string);
+    private _value;
+    /**
+     * @private
+     */
+    get itemText(): string;
+    constructor();
+    private onClick;
+    private onPointerdown;
+    private onPointerup;
+    /**
+     * @private
+     */
+    protected handleKeydown(event: KeyboardEvent): void;
+    protected handleKeyup(event: KeyboardEvent): void;
+    protected get buttonContent(): TemplateResult[];
+    protected updated(changes: PropertyValues): void;
+}
+declare global {
+    interface GlobalEventHandlersEventMap {
+        longpress: CustomEvent<LongpressEvent>;
+    }
+}
+export {};

package/src/ActionButton.js

@@ -0,0 +1,202 @@
+/*
+Copyright 2020 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+import { __decorate } from "tslib";
+import { html, SizedMixin, } from '@spectrum-web-components/base';
+import { property } from '@spectrum-web-components/base/src/decorators.js';
+import { ButtonBase } from '@spectrum-web-components/button';
+import buttonStyles from './action-button.css.js';
+import cornerTriangleStyles from '@spectrum-web-components/icon/src/spectrum-icon-corner-triangle.css.js';
+import '@spectrum-web-components/icons-ui/icons/sp-icon-corner-triangle300.js';
+const holdAffordanceClass = {
+    s: 'spectrum-UIIcon-CornerTriangle75',
+    m: 'spectrum-UIIcon-CornerTriangle100',
+    l: 'spectrum-UIIcon-CornerTriangle200',
+    xl: 'spectrum-UIIcon-CornerTriangle300',
+};
+const LONGPRESS_DURATION = 300;
+let LONGPRESS_TIMEOUT;
+/**
+ * @element sp-action-button
+ *
+ * @slot - text label of the Action Button
+ * @slot icon - The icon to use for Action Button
+ * @fires change - Announces a change in the `selected` property of an action button
+ * @fires longpress - Synthesizes a "longpress" interaction that signifies a
+ * `pointerdown` event that is >=300ms or a keyboard event wher code is `Space` or code is `ArrowDown`
+ * while `altKey===true`.
+ */
+export class ActionButton extends SizedMixin(ButtonBase) {
+    constructor() {
+        super();
+        this.emphasized = false;
+        this.holdAffordance = false;
+        this.quiet = false;
+        this.role = 'button';
+        /**
+         * Whether an Action Button with `role='button'`
+         * should also be `aria-pressed='true'`
+         */
+        this.selected = false;
+        /**
+         * Whether to automatically manage the `selected`
+         * attribute on interaction and whether `aria-pressed="false"`
+         * should be used when `selected === false`
+         */
+        this.toggles = false;
+        this._value = '';
+        this.onClick = () => {
+            if (!this.toggles) {
+                return;
+            }
+            this.selected = !this.selected;
+            const applyDefault = this.dispatchEvent(new Event('change', {
+                cancelable: true,
+            }));
+            if (!applyDefault) {
+                this.selected = !this.selected;
+            }
+        };
+        this.addEventListener('click', this.onClick);
+        this.addEventListener('pointerdown', this.onPointerdown);
+    }
+    static get styles() {
+        return [buttonStyles, cornerTriangleStyles];
+    }
+    get value() {
+        return this._value || this.itemText;
+    }
+    set value(value) {
+        if (value === this._value) {
+            return;
+        }
+        this._value = value || '';
+        if (this._value) {
+            this.setAttribute('value', this._value);
+        }
+        else {
+            this.removeAttribute('value');
+        }
+    }
+    /**
+     * @private
+     */
+    get itemText() {
+        return (this.textContent || /* c8 ignore next */ '').trim();
+    }
+    onPointerdown() {
+        this.addEventListener('pointerup', this.onPointerup);
+        this.addEventListener('pointercancel', this.onPointerup);
+        LONGPRESS_TIMEOUT = setTimeout(() => {
+            this.dispatchEvent(new CustomEvent('longpress', {
+                bubbles: true,
+                composed: true,
+                detail: {
+                    source: 'pointer',
+                },
+            }));
+        }, LONGPRESS_DURATION);
+    }
+    onPointerup() {
+        clearTimeout(LONGPRESS_TIMEOUT);
+        this.removeEventListener('pointerup', this.onPointerup);
+        this.removeEventListener('pointercancel', this.onPointerup);
+    }
+    /**
+     * @private
+     */
+    handleKeydown(event) {
+        if (!this.holdAffordance) {
+            return super.handleKeydown(event);
+        }
+        const { code, altKey } = event;
+        if (code === 'Space' || (altKey && code === 'ArrowDown')) {
+            event.preventDefault();
+            if (code === 'ArrowDown') {
+                event.stopPropagation();
+                event.stopImmediatePropagation();
+            }
+            this.addEventListener('keyup', this.handleKeyup);
+            this.active = true;
+        }
+    }
+    handleKeyup(event) {
+        if (!this.holdAffordance) {
+            return super.handleKeyup(event);
+        }
+        const { code, altKey } = event;
+        if (code === 'Space' || (altKey && code === 'ArrowDown')) {
+            event.stopPropagation();
+            this.dispatchEvent(new CustomEvent('longpress', {
+                bubbles: true,
+                composed: true,
+                detail: {
+                    source: 'keyboard',
+                },
+            }));
+            this.active = false;
+        }
+    }
+    get buttonContent() {
+        const buttonContent = super.buttonContent;
+        if (this.holdAffordance) {
+            buttonContent.unshift(html `
+                <sp-icon-corner-triangle300
+                    class="hold-affordance ${holdAffordanceClass[this.size]}"
+                ></sp-icon-corner-triangle300>
+            `);
+        }
+        return buttonContent;
+    }
+    updated(changes) {
+        super.updated(changes);
+        const isButton = this.role === 'button';
+        const canBePressed = isButton && (this.selected || this.toggles);
+        if (changes.has('selected') || changes.has('role')) {
+            // When role !== 'button' then the Action Button is within
+            // an Action Group that manages selects which means the
+            // Action Button is a "checkbox" or "radio" and cannot
+            // accept the `aria-pressed` attribute.
+            if (canBePressed) {
+                this.setAttribute('aria-pressed', this.selected ? 'true' : 'false');
+            }
+            else {
+                // When !this.toggles the lack of "aria-pressed" is inconsequential.
+                this.removeAttribute('aria-pressed');
+            }
+        }
+    }
+}
+__decorate([
+    property({ type: Boolean, reflect: true })
+], ActionButton.prototype, "emphasized", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true, attribute: 'hold-affordance' })
+], ActionButton.prototype, "holdAffordance", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], ActionButton.prototype, "quiet", void 0);
+__decorate([
+    property({ reflect: true })
+], ActionButton.prototype, "role", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], ActionButton.prototype, "selected", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], ActionButton.prototype, "toggles", void 0);
+__decorate([
+    property({ reflect: true })
+], ActionButton.prototype, "variant", void 0);
+__decorate([
+    property({ type: String })
+], ActionButton.prototype, "value", null);
+//# sourceMappingURL=ActionButton.js.map

package/src/ActionButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionButton.js","sourceRoot":"","sources":["ActionButton.ts"],"names":[],"mappings":"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","sourcesContent":["/*\nCopyright 2020 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*/\n\nimport {\n    CSSResultArray,\n    DefaultElementSize,\n    html,\n    PropertyValues,\n    SizedMixin,\n    TemplateResult,\n} from '@spectrum-web-components/base';\nimport { property } from '@spectrum-web-components/base/src/decorators.js';\nimport { ButtonBase } from '@spectrum-web-components/button';\nimport buttonStyles from './action-button.css.js';\nimport cornerTriangleStyles from '@spectrum-web-components/icon/src/spectrum-icon-corner-triangle.css.js';\nimport '@spectrum-web-components/icons-ui/icons/sp-icon-corner-triangle300.js';\n\nconst holdAffordanceClass = {\n    s: 'spectrum-UIIcon-CornerTriangle75',\n    m: 'spectrum-UIIcon-CornerTriangle100',\n    l: 'spectrum-UIIcon-CornerTriangle200',\n    xl: 'spectrum-UIIcon-CornerTriangle300',\n};\n\nconst LONGPRESS_DURATION = 300;\nlet LONGPRESS_TIMEOUT: ReturnType<typeof setTimeout>;\n\nexport type LongpressEvent = {\n    source: 'pointer' | 'keyboard';\n};\n\n/**\n * @element sp-action-button\n *\n * @slot - text label of the Action Button\n * @slot icon - The icon to use for Action Button\n * @fires change - Announces a change in the `selected` property of an action button\n * @fires longpress - Synthesizes a \"longpress\" interaction that signifies a\n * `pointerdown` event that is >=300ms or a keyboard event wher code is `Space` or code is `ArrowDown`\n * while `altKey===true`.\n */\nexport class ActionButton extends SizedMixin(ButtonBase) {\n    public static get styles(): CSSResultArray {\n        return [buttonStyles, cornerTriangleStyles];\n    }\n\n    @property({ type: Boolean, reflect: true })\n    public emphasized = false;\n\n    @property({ type: Boolean, reflect: true, attribute: 'hold-affordance' })\n    public holdAffordance = false;\n\n    @property({ type: Boolean, reflect: true })\n    public quiet = false;\n\n    @property({ reflect: true })\n    public role = 'button';\n\n    /**\n     * Whether an Action Button with `role='button'`\n     * should also be `aria-pressed='true'`\n     */\n    @property({ type: Boolean, reflect: true })\n    public selected = false;\n\n    /**\n     * Whether to automatically manage the `selected`\n     * attribute on interaction and whether `aria-pressed=\"false\"`\n     * should be used when `selected === false`\n     */\n    @property({ type: Boolean, reflect: true })\n    public toggles = false;\n\n    @property({ reflect: true })\n    public variant?: 'white' | 'black';\n\n    @property({ type: String })\n    public get value(): string {\n        return this._value || this.itemText;\n    }\n    public set value(value: string) {\n        if (value === this._value) {\n            return;\n        }\n        this._value = value || '';\n        if (this._value) {\n            this.setAttribute('value', this._value);\n        } else {\n            this.removeAttribute('value');\n        }\n    }\n    private _value = '';\n\n    /**\n     * @private\n     */\n    public get itemText(): string {\n        return (this.textContent || /* c8 ignore next */ '').trim();\n    }\n\n    constructor() {\n        super();\n        this.addEventListener('click', this.onClick);\n        this.addEventListener('pointerdown', this.onPointerdown);\n    }\n\n    private onClick = (): void => {\n        if (!this.toggles) {\n            return;\n        }\n        this.selected = !this.selected;\n        const applyDefault = this.dispatchEvent(\n            new Event('change', {\n                cancelable: true,\n            })\n        );\n        if (!applyDefault) {\n            this.selected = !this.selected;\n        }\n    };\n\n    private onPointerdown(): void {\n        this.addEventListener('pointerup', this.onPointerup);\n        this.addEventListener('pointercancel', this.onPointerup);\n        LONGPRESS_TIMEOUT = setTimeout(() => {\n            this.dispatchEvent(\n                new CustomEvent<LongpressEvent>('longpress', {\n                    bubbles: true,\n                    composed: true,\n                    detail: {\n                        source: 'pointer',\n                    },\n                })\n            );\n        }, LONGPRESS_DURATION);\n    }\n\n    private onPointerup(): void {\n        clearTimeout(LONGPRESS_TIMEOUT);\n        this.removeEventListener('pointerup', this.onPointerup);\n        this.removeEventListener('pointercancel', this.onPointerup);\n    }\n\n    /**\n     * @private\n     */\n    protected handleKeydown(event: KeyboardEvent): void {\n        if (!this.holdAffordance) {\n            return super.handleKeydown(event);\n        }\n        const { code, altKey } = event;\n        if (code === 'Space' || (altKey && code === 'ArrowDown')) {\n            event.preventDefault();\n            if (code === 'ArrowDown') {\n                event.stopPropagation();\n                event.stopImmediatePropagation();\n            }\n            this.addEventListener('keyup', this.handleKeyup);\n            this.active = true;\n        }\n    }\n\n    protected handleKeyup(event: KeyboardEvent): void {\n        if (!this.holdAffordance) {\n            return super.handleKeyup(event);\n        }\n        const { code, altKey } = event;\n        if (code === 'Space' || (altKey && code === 'ArrowDown')) {\n            event.stopPropagation();\n            this.dispatchEvent(\n                new CustomEvent<LongpressEvent>('longpress', {\n                    bubbles: true,\n                    composed: true,\n                    detail: {\n                        source: 'keyboard',\n                    },\n                })\n            );\n            this.active = false;\n        }\n    }\n\n    protected get buttonContent(): TemplateResult[] {\n        const buttonContent = super.buttonContent;\n        if (this.holdAffordance) {\n            buttonContent.unshift(html`\n                <sp-icon-corner-triangle300\n                    class=\"hold-affordance ${holdAffordanceClass[\n                        this.size as DefaultElementSize\n                    ]}\"\n                ></sp-icon-corner-triangle300>\n            `);\n        }\n        return buttonContent;\n    }\n\n    protected updated(changes: PropertyValues): void {\n        super.updated(changes);\n        const isButton = this.role === 'button';\n        const canBePressed = isButton && (this.selected || this.toggles);\n        if (changes.has('selected') || changes.has('role')) {\n            // When role !== 'button' then the Action Button is within\n            // an Action Group that manages selects which means the\n            // Action Button is a \"checkbox\" or \"radio\" and cannot\n            // accept the `aria-pressed` attribute.\n            if (canBePressed) {\n                this.setAttribute(\n                    'aria-pressed',\n                    this.selected ? 'true' : 'false'\n                );\n            } else {\n                // When !this.toggles the lack of \"aria-pressed\" is inconsequential.\n                this.removeAttribute('aria-pressed');\n            }\n        }\n    }\n}\n\ndeclare global {\n    interface GlobalEventHandlersEventMap {\n        longpress: CustomEvent<LongpressEvent>;\n    }\n}\n"]}

package/src/action-button.css.d.ts

@@ -0,0 +1,2 @@
+declare const styles: import("@spectrum-web-components/base").CSSResult;
+export default styles;