123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294 |
- /*!
- * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
- * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-beta.97
- */
- import { h } from "@stencil/core";
- import { getSlotted, toAriaBoolean } from "../../utils/dom";
- import { CSS, SLOTS, TEXT } from "./resources";
- import { connectConditionalSlotComponent, disconnectConditionalSlotComponent } from "../../utils/conditionalSlot";
- /**
- * Cards do not include a grid or bounding container
- * - cards will expand to fit the width of their container
- */
- /**
- * @slot - A slot for adding subheader/description content.
- * @slot thumbnail - A slot for adding a thumbnail to the component.
- * @slot title - A slot for adding a title.
- * @slot subtitle - A slot for adding a subtitle or short summary.
- * @slot footer-leading - A slot for adding a leading footer.
- * @slot footer-trailing - A slot for adding a trailing footer.
- */
- export class Card {
- constructor() {
- //--------------------------------------------------------------------------
- //
- // Public Properties
- //
- //--------------------------------------------------------------------------
- /** When `true`, a busy indicator is displayed. */
- this.loading = false;
- /** When `true`, the component is selected. */
- this.selected = false;
- /** When `true`, the component is selectable. */
- this.selectable = false;
- /**
- * Accessible name when the component is loading.
- *
- * @default "Loading"
- */
- this.intlLoading = TEXT.loading;
- /**
- * When `selectable` is `true`, the accessible name for the component's checkbox for selection.
- *
- * @default "Select"
- */
- this.intlSelect = TEXT.select;
- /**
- * When `selectable` is `true`, the accessible name for the component's checkbox for deselection.
- *
- * @default "Deselect"
- */
- this.intlDeselect = TEXT.deselect;
- /** Sets the placement of the thumbnail defined in the `thumbnail` slot. */
- this.thumbnailPosition = "block-start";
- //--------------------------------------------------------------------------
- //
- // Private State/Props
- //
- //--------------------------------------------------------------------------
- //--------------------------------------------------------------------------
- //
- // Private Methods
- //
- //--------------------------------------------------------------------------
- this.cardSelectClick = () => {
- this.selectCard();
- };
- this.cardSelectKeyDown = (event) => {
- switch (event.key) {
- case " ":
- case "Enter":
- this.selectCard();
- event.preventDefault();
- break;
- }
- };
- }
- // --------------------------------------------------------------------------
- //
- // Lifecycle
- //
- // --------------------------------------------------------------------------
- connectedCallback() {
- connectConditionalSlotComponent(this);
- }
- disonnectedCallback() {
- disconnectConditionalSlotComponent(this);
- }
- render() {
- const thumbnailInline = this.thumbnailPosition.startsWith("inline");
- const thumbnailStart = this.thumbnailPosition.endsWith("start");
- return (h("div", { class: { "calcite-card-container": true, inline: thumbnailInline } }, this.loading ? (h("div", { class: "calcite-card-loader-container" }, h("calcite-loader", { active: true, label: this.intlLoading }))) : null, thumbnailStart && this.renderThumbnail(), h("section", { "aria-busy": toAriaBoolean(this.loading), class: { [CSS.container]: true } }, this.selectable ? this.renderCheckbox() : null, this.renderHeader(), h("div", { class: "card-content" }, h("slot", null)), this.renderFooter()), !thumbnailStart && this.renderThumbnail()));
- }
- selectCard() {
- this.selected = !this.selected;
- this.calciteCardSelect.emit();
- }
- renderThumbnail() {
- return getSlotted(this.el, SLOTS.thumbnail) ? (h("section", { class: CSS.thumbnailWrapper }, h("slot", { name: SLOTS.thumbnail }))) : null;
- }
- renderCheckbox() {
- const checkboxLabel = this.selected ? this.intlDeselect : this.intlSelect;
- return (h("calcite-label", { class: CSS.checkboxWrapper, onClick: this.cardSelectClick, onKeyDown: this.cardSelectKeyDown }, h("calcite-checkbox", { checked: this.selected, label: checkboxLabel })));
- }
- renderHeader() {
- const { el } = this;
- const title = getSlotted(el, SLOTS.title);
- const subtitle = getSlotted(el, SLOTS.subtitle);
- const hasHeader = title || subtitle;
- return hasHeader ? (h("header", { class: CSS.header }, h("slot", { name: SLOTS.title }), h("slot", { name: SLOTS.subtitle }))) : null;
- }
- renderFooter() {
- const { el } = this;
- const leadingFooter = getSlotted(el, SLOTS.footerLeading);
- const trailingFooter = getSlotted(el, SLOTS.footerTrailing);
- const hasFooter = leadingFooter || trailingFooter;
- return hasFooter ? (h("footer", { class: CSS.footer }, h("slot", { name: SLOTS.footerLeading }), h("slot", { name: SLOTS.footerTrailing }))) : null;
- }
- static get is() { return "calcite-card"; }
- static get encapsulation() { return "shadow"; }
- static get originalStyleUrls() {
- return {
- "$": ["card.scss"]
- };
- }
- static get styleUrls() {
- return {
- "$": ["card.css"]
- };
- }
- static get properties() {
- return {
- "loading": {
- "type": "boolean",
- "mutable": false,
- "complexType": {
- "original": "boolean",
- "resolved": "boolean",
- "references": {}
- },
- "required": false,
- "optional": false,
- "docs": {
- "tags": [],
- "text": "When `true`, a busy indicator is displayed."
- },
- "attribute": "loading",
- "reflect": true,
- "defaultValue": "false"
- },
- "selected": {
- "type": "boolean",
- "mutable": true,
- "complexType": {
- "original": "boolean",
- "resolved": "boolean",
- "references": {}
- },
- "required": false,
- "optional": false,
- "docs": {
- "tags": [],
- "text": "When `true`, the component is selected."
- },
- "attribute": "selected",
- "reflect": true,
- "defaultValue": "false"
- },
- "selectable": {
- "type": "boolean",
- "mutable": false,
- "complexType": {
- "original": "boolean",
- "resolved": "boolean",
- "references": {}
- },
- "required": false,
- "optional": false,
- "docs": {
- "tags": [],
- "text": "When `true`, the component is selectable."
- },
- "attribute": "selectable",
- "reflect": true,
- "defaultValue": "false"
- },
- "intlLoading": {
- "type": "string",
- "mutable": false,
- "complexType": {
- "original": "string",
- "resolved": "string",
- "references": {}
- },
- "required": false,
- "optional": true,
- "docs": {
- "tags": [{
- "name": "default",
- "text": "\"Loading\""
- }],
- "text": "Accessible name when the component is loading."
- },
- "attribute": "intl-loading",
- "reflect": false,
- "defaultValue": "TEXT.loading"
- },
- "intlSelect": {
- "type": "string",
- "mutable": false,
- "complexType": {
- "original": "string",
- "resolved": "string",
- "references": {}
- },
- "required": false,
- "optional": false,
- "docs": {
- "tags": [{
- "name": "default",
- "text": "\"Select\""
- }],
- "text": "When `selectable` is `true`, the accessible name for the component's checkbox for selection."
- },
- "attribute": "intl-select",
- "reflect": false,
- "defaultValue": "TEXT.select"
- },
- "intlDeselect": {
- "type": "string",
- "mutable": false,
- "complexType": {
- "original": "string",
- "resolved": "string",
- "references": {}
- },
- "required": false,
- "optional": false,
- "docs": {
- "tags": [{
- "name": "default",
- "text": "\"Deselect\""
- }],
- "text": "When `selectable` is `true`, the accessible name for the component's checkbox for deselection."
- },
- "attribute": "intl-deselect",
- "reflect": false,
- "defaultValue": "TEXT.deselect"
- },
- "thumbnailPosition": {
- "type": "string",
- "mutable": false,
- "complexType": {
- "original": "LogicalFlowPosition",
- "resolved": "\"block-end\" | \"block-start\" | \"inline-end\" | \"inline-start\"",
- "references": {
- "LogicalFlowPosition": {
- "location": "import",
- "path": "../interfaces"
- }
- }
- },
- "required": false,
- "optional": false,
- "docs": {
- "tags": [],
- "text": "Sets the placement of the thumbnail defined in the `thumbnail` slot."
- },
- "attribute": "thumbnail-position",
- "reflect": true,
- "defaultValue": "\"block-start\""
- }
- };
- }
- static get events() {
- return [{
- "method": "calciteCardSelect",
- "name": "calciteCardSelect",
- "bubbles": true,
- "cancelable": false,
- "composed": true,
- "docs": {
- "tags": [],
- "text": "Fires when `selectable` is `true` and the component is selected."
- },
- "complexType": {
- "original": "void",
- "resolved": "void",
- "references": {}
- }
- }];
- }
- static get elementRef() { return "el"; }
- }
|