popover.js 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434
  1. /*!
  2. * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  3. * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
  4. * v1.0.0-beta.82
  5. */
  6. import { proxyCustomElement, HTMLElement, createEvent, forceUpdate, h, Host } from '@stencil/core/internal/client';
  7. import { d as defaultOffsetDistance, f as filterComputedPlacements, u as updatePopper, c as createPopper, C as CSS$1 } from './popper.js';
  8. import { g as guid } from './guid.js';
  9. import { q as queryElementsRoots, t as toAriaBoolean, c as queryElementRoots } from './dom.js';
  10. import { H as Heading } from './Heading.js';
  11. import { d as defineCustomElement$3 } from './action.js';
  12. import { d as defineCustomElement$2 } from './icon.js';
  13. import { d as defineCustomElement$1 } from './loader.js';
  14. const CSS = {
  15. container: "container",
  16. arrow: "arrow",
  17. imageContainer: "image-container",
  18. closeButtonContainer: "close-button-container",
  19. closeButton: "close-button",
  20. content: "content",
  21. hasHeader: "has-header",
  22. header: "header",
  23. headerContent: "header-content",
  24. heading: "heading"
  25. };
  26. const TEXT = {
  27. close: "Close"
  28. };
  29. const defaultPopoverPlacement = "auto";
  30. const ARIA_CONTROLS = "aria-controls";
  31. const ARIA_EXPANDED = "aria-expanded";
  32. const HEADING_LEVEL = 2;
  33. class PopoverManager {
  34. constructor() {
  35. // --------------------------------------------------------------------------
  36. //
  37. // Private Properties
  38. //
  39. // --------------------------------------------------------------------------
  40. this.registeredElements = new WeakMap();
  41. this.registeredElementCount = 0;
  42. // --------------------------------------------------------------------------
  43. //
  44. // Private Methods
  45. //
  46. // --------------------------------------------------------------------------
  47. this.queryPopover = (composedPath) => {
  48. const { registeredElements } = this;
  49. const registeredElement = composedPath.find((pathEl) => registeredElements.has(pathEl));
  50. return registeredElements.get(registeredElement);
  51. };
  52. this.clickHandler = (event) => {
  53. const composedPath = event.composedPath();
  54. const popover = this.queryPopover(composedPath);
  55. if (popover) {
  56. popover.toggle();
  57. return;
  58. }
  59. queryElementsRoots(event.target, "calcite-popover")
  60. .filter((popover) => popover.autoClose && popover.open && !composedPath.includes(popover))
  61. .forEach((popover) => popover.toggle(false));
  62. };
  63. }
  64. // --------------------------------------------------------------------------
  65. //
  66. // Public Methods
  67. //
  68. // --------------------------------------------------------------------------
  69. registerElement(referenceEl, popover) {
  70. this.registeredElementCount++;
  71. this.registeredElements.set(referenceEl, popover);
  72. if (this.registeredElementCount === 1) {
  73. this.addListeners();
  74. }
  75. }
  76. unregisterElement(referenceEl) {
  77. if (this.registeredElements.delete(referenceEl)) {
  78. this.registeredElementCount--;
  79. }
  80. if (this.registeredElementCount === 0) {
  81. this.removeListeners();
  82. }
  83. }
  84. addListeners() {
  85. document.addEventListener("pointerdown", this.clickHandler, { capture: true });
  86. }
  87. removeListeners() {
  88. document.removeEventListener("pointerdown", this.clickHandler, { capture: true });
  89. }
  90. }
  91. const popoverCss = "@-webkit-keyframes in{0%{opacity:0}100%{opacity:1}}@keyframes in{0%{opacity:0}100%{opacity:1}}@-webkit-keyframes in-down{0%{opacity:0;-webkit-transform:translate3D(0, -5px, 0);transform:translate3D(0, -5px, 0)}100%{opacity:1;-webkit-transform:translate3D(0, 0, 0);transform:translate3D(0, 0, 0)}}@keyframes in-down{0%{opacity:0;-webkit-transform:translate3D(0, -5px, 0);transform:translate3D(0, -5px, 0)}100%{opacity:1;-webkit-transform:translate3D(0, 0, 0);transform:translate3D(0, 0, 0)}}@-webkit-keyframes in-up{0%{opacity:0;-webkit-transform:translate3D(0, 5px, 0);transform:translate3D(0, 5px, 0)}100%{opacity:1;-webkit-transform:translate3D(0, 0, 0);transform:translate3D(0, 0, 0)}}@keyframes in-up{0%{opacity:0;-webkit-transform:translate3D(0, 5px, 0);transform:translate3D(0, 5px, 0)}100%{opacity:1;-webkit-transform:translate3D(0, 0, 0);transform:translate3D(0, 0, 0)}}@-webkit-keyframes in-scale{0%{opacity:0;-webkit-transform:scale3D(0.95, 0.95, 1);transform:scale3D(0.95, 0.95, 1)}100%{opacity:1;-webkit-transform:scale3D(1, 1, 1);transform:scale3D(1, 1, 1)}}@keyframes in-scale{0%{opacity:0;-webkit-transform:scale3D(0.95, 0.95, 1);transform:scale3D(0.95, 0.95, 1)}100%{opacity:1;-webkit-transform:scale3D(1, 1, 1);transform:scale3D(1, 1, 1)}}:root{--calcite-animation-timing:calc(150ms * var(--calcite-internal-duration-factor));--calcite-internal-duration-factor:var(--calcite-duration-factor, 1);--calcite-internal-animation-timing-fast:calc(100ms * var(--calcite-internal-duration-factor));--calcite-internal-animation-timing-medium:calc(200ms * var(--calcite-internal-duration-factor));--calcite-internal-animation-timing-slow:calc(300ms * var(--calcite-internal-duration-factor))}.calcite-animate{opacity:0;-webkit-animation-fill-mode:both;animation-fill-mode:both;-webkit-animation-duration:var(--calcite-animation-timing);animation-duration:var(--calcite-animation-timing)}.calcite-animate__in{-webkit-animation-name:in;animation-name:in}.calcite-animate__in-down{-webkit-animation-name:in-down;animation-name:in-down}.calcite-animate__in-up{-webkit-animation-name:in-up;animation-name:in-up}.calcite-animate__in-scale{-webkit-animation-name:in-scale;animation-name:in-scale}:root{--calcite-popper-transition:var(--calcite-animation-timing)}:host([hidden]){display:none}:host{display:block;position:absolute;z-index:900;-webkit-transform:scale(0);transform:scale(0)}.calcite-popper-anim{position:relative;z-index:1;-webkit-transition:var(--calcite-popper-transition);transition:var(--calcite-popper-transition);visibility:hidden;-webkit-transition-property:visibility, opacity, -webkit-transform;transition-property:visibility, opacity, -webkit-transform;transition-property:transform, visibility, opacity;transition-property:transform, visibility, opacity, -webkit-transform;opacity:0;-webkit-box-shadow:0 0 16px 0 rgba(0, 0, 0, 0.16);box-shadow:0 0 16px 0 rgba(0, 0, 0, 0.16);border-radius:0.25rem}:host([data-popper-placement^=bottom]) .calcite-popper-anim{-webkit-transform:translateY(-5px);transform:translateY(-5px)}:host([data-popper-placement^=top]) .calcite-popper-anim{-webkit-transform:translateY(5px);transform:translateY(5px)}:host([data-popper-placement^=left]) .calcite-popper-anim{-webkit-transform:translateX(5px);transform:translateX(5px)}:host([data-popper-placement^=right]) .calcite-popper-anim{-webkit-transform:translateX(-5px);transform:translateX(-5px)}:host([data-popper-placement]) .calcite-popper-anim--active{opacity:1;visibility:visible;-webkit-transform:translate(0);transform:translate(0)}:host([data-popper-placement][data-popper-reference-hidden]){pointer-events:none;opacity:0}.arrow,.arrow::before{position:absolute;width:8px;height:8px;z-index:-1}.arrow::before{content:\"\";--tw-shadow:0 4px 8px -1px rgba(0, 0, 0, 0.08), 0 2px 4px -1px rgba(0, 0, 0, 0.04);--tw-shadow-colored:0 4px 8px -1px var(--tw-shadow-color), 0 2px 4px -1px var(--tw-shadow-color);-webkit-box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000), var(--tw-ring-shadow, 0 0 #0000), var(--tw-shadow);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000), var(--tw-ring-shadow, 0 0 #0000), var(--tw-shadow);-webkit-transform:rotate(45deg);transform:rotate(45deg);background:var(--calcite-ui-foreground-1)}:host([data-popper-placement^=top]) .arrow{bottom:-4px}:host([data-popper-placement^=bottom]) .arrow{top:-4px}:host([data-popper-placement^=left]) .arrow{right:-4px}:host([data-popper-placement^=right]) .arrow{left:-4px}:host{pointer-events:none}:host([open]){pointer-events:initial}.calcite-popper-anim{border-radius:0.25rem;border-width:1px;border-style:solid;border-color:var(--calcite-ui-border-3);background-color:var(--calcite-ui-foreground-1)}.arrow::before{outline:1px solid var(--calcite-ui-border-3)}.header{display:-ms-flexbox;display:flex;-ms-flex:1 1 auto;flex:1 1 auto;-ms-flex-align:stretch;align-items:stretch;-ms-flex-pack:start;justify-content:flex-start;border-width:0px;border-bottom-width:1px;border-style:solid;background-color:var(--calcite-ui-foreground-1);border-bottom-color:var(--calcite-ui-border-3)}.heading{margin:0px;display:block;-ms-flex:1 1 auto;flex:1 1 auto;-ms-flex-item-align:center;align-self:center;white-space:normal;padding-left:1rem;padding-right:1rem;padding-top:0.75rem;padding-bottom:0.75rem;font-size:var(--calcite-font-size-0);line-height:1.375;font-weight:var(--calcite-font-weight-medium);color:var(--calcite-ui-text-1);word-wrap:break-word;word-break:break-word}.container{position:relative;display:-ms-flexbox;display:flex;height:100%;-ms-flex-direction:row;flex-direction:row;-ms-flex-wrap:nowrap;flex-wrap:nowrap;border-radius:0.25rem;background-color:var(--calcite-ui-foreground-1);color:var(--calcite-ui-text-1)}.container.has-header{-ms-flex-direction:column;flex-direction:column}.content{display:-ms-flexbox;display:flex;height:100%;width:100%;-ms-flex-direction:column;flex-direction:column;-ms-flex-wrap:nowrap;flex-wrap:nowrap;-ms-flex-item-align:center;align-self:center;word-wrap:break-word;word-break:break-word}.close-button-container{display:-ms-flexbox;display:flex;overflow:hidden;-ms-flex:0 0 auto;flex:0 0 auto;border-start-end-radius:0.25rem;border-end-end-radius:0.25rem}::slotted(calcite-panel),::slotted(calcite-flow){height:100%}";
  92. const manager = new PopoverManager();
  93. const Popover = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
  94. constructor() {
  95. super();
  96. this.__registerHost();
  97. this.__attachShadow();
  98. this.calcitePopoverClose = createEvent(this, "calcitePopoverClose", 7);
  99. this.calcitePopoverOpen = createEvent(this, "calcitePopoverOpen", 7);
  100. // --------------------------------------------------------------------------
  101. //
  102. // Properties
  103. //
  104. // --------------------------------------------------------------------------
  105. /**
  106. * Automatically closes any currently open popovers when clicking outside of a popover.
  107. */
  108. this.autoClose = false;
  109. /**
  110. * Display a close button within the Popover.
  111. * @deprecated use dismissible instead.
  112. */
  113. this.closeButton = false;
  114. /**
  115. * Display a close button within the Popover.
  116. */
  117. this.dismissible = false;
  118. /**
  119. * Prevents flipping the popover's placement when it starts to overlap its reference element.
  120. */
  121. this.disableFlip = false;
  122. /**
  123. * Removes the caret pointer.
  124. */
  125. this.disablePointer = false;
  126. /**
  127. * Offset the position of the popover away from the reference element.
  128. * @default 6
  129. */
  130. this.offsetDistance = defaultOffsetDistance;
  131. /**
  132. * Offset the position of the popover along the reference element.
  133. */
  134. this.offsetSkidding = 0;
  135. /**
  136. * Display and position the component.
  137. */
  138. this.open = false;
  139. /** Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value. */
  140. this.overlayPositioning = "absolute";
  141. /**
  142. * Determines where the component will be positioned relative to the referenceElement.
  143. * @see [PopperPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/popper.ts#L25)
  144. */
  145. this.placement = defaultPopoverPlacement;
  146. /** Text for close button.
  147. * @default "Close"
  148. */
  149. this.intlClose = TEXT.close;
  150. this.guid = `calcite-popover-${guid()}`;
  151. this.activeTransitionProp = "opacity";
  152. // --------------------------------------------------------------------------
  153. //
  154. // Private Methods
  155. //
  156. // --------------------------------------------------------------------------
  157. this.setFilteredPlacements = () => {
  158. const { el, flipPlacements } = this;
  159. this.filteredFlipPlacements = flipPlacements
  160. ? filterComputedPlacements(flipPlacements, el)
  161. : null;
  162. };
  163. this.setUpReferenceElement = () => {
  164. this.removeReferences();
  165. this.effectiveReferenceElement = this.getReferenceElement();
  166. const { el, referenceElement, effectiveReferenceElement } = this;
  167. if (referenceElement && !effectiveReferenceElement) {
  168. console.warn(`${el.tagName}: reference-element id "${referenceElement}" was not found.`, {
  169. el
  170. });
  171. }
  172. this.addReferences();
  173. this.createPopper();
  174. };
  175. this.getId = () => {
  176. return this.el.id || this.guid;
  177. };
  178. this.setExpandedAttr = () => {
  179. const { effectiveReferenceElement, open } = this;
  180. if (!effectiveReferenceElement) {
  181. return;
  182. }
  183. effectiveReferenceElement.setAttribute(ARIA_EXPANDED, toAriaBoolean(open));
  184. };
  185. this.addReferences = () => {
  186. const { effectiveReferenceElement } = this;
  187. if (!effectiveReferenceElement) {
  188. return;
  189. }
  190. const id = this.getId();
  191. effectiveReferenceElement.setAttribute(ARIA_CONTROLS, id);
  192. manager.registerElement(effectiveReferenceElement, this.el);
  193. this.setExpandedAttr();
  194. };
  195. this.removeReferences = () => {
  196. const { effectiveReferenceElement } = this;
  197. if (!effectiveReferenceElement) {
  198. return;
  199. }
  200. effectiveReferenceElement.removeAttribute(ARIA_CONTROLS);
  201. effectiveReferenceElement.removeAttribute(ARIA_EXPANDED);
  202. manager.unregisterElement(effectiveReferenceElement);
  203. };
  204. this.hide = () => {
  205. this.open = false;
  206. };
  207. this.transitionEnd = (event) => {
  208. if (event.propertyName === this.activeTransitionProp) {
  209. this.open ? this.calcitePopoverOpen.emit() : this.calcitePopoverClose.emit();
  210. }
  211. };
  212. }
  213. flipPlacementsHandler() {
  214. this.setFilteredPlacements();
  215. }
  216. offsetDistanceOffsetHandler() {
  217. this.reposition();
  218. }
  219. offsetSkiddingHandler() {
  220. this.reposition();
  221. }
  222. openHandler() {
  223. this.reposition();
  224. this.setExpandedAttr();
  225. }
  226. placementHandler() {
  227. this.reposition();
  228. }
  229. referenceElementHandler() {
  230. this.setUpReferenceElement();
  231. }
  232. // --------------------------------------------------------------------------
  233. //
  234. // Lifecycle
  235. //
  236. // --------------------------------------------------------------------------
  237. connectedCallback() {
  238. this.setFilteredPlacements();
  239. }
  240. componentWillLoad() {
  241. this.setUpReferenceElement();
  242. }
  243. componentDidLoad() {
  244. this.reposition();
  245. }
  246. disconnectedCallback() {
  247. this.removeReferences();
  248. this.destroyPopper();
  249. }
  250. // --------------------------------------------------------------------------
  251. //
  252. // Public Methods
  253. //
  254. // --------------------------------------------------------------------------
  255. /** Updates the position of the component. */
  256. async reposition() {
  257. const { popper, el, placement } = this;
  258. const modifiers = this.getModifiers();
  259. popper
  260. ? await updatePopper({
  261. el,
  262. modifiers,
  263. placement,
  264. popper
  265. })
  266. : this.createPopper();
  267. }
  268. /** Sets focus on the component. */
  269. async setFocus(focusId) {
  270. var _a;
  271. const { closeButtonEl } = this;
  272. if (focusId === "close-button" && closeButtonEl) {
  273. forceUpdate(closeButtonEl);
  274. closeButtonEl.setFocus();
  275. return;
  276. }
  277. (_a = this.el) === null || _a === void 0 ? void 0 : _a.focus();
  278. }
  279. /** Toggles the popover's open property. */
  280. async toggle(value = !this.open) {
  281. this.open = value;
  282. }
  283. getReferenceElement() {
  284. const { referenceElement, el } = this;
  285. return ((typeof referenceElement === "string"
  286. ? queryElementRoots(el, { id: referenceElement })
  287. : referenceElement) || null);
  288. }
  289. getModifiers() {
  290. const { arrowEl, disableFlip, disablePointer, offsetDistance, offsetSkidding, filteredFlipPlacements } = this;
  291. const flipModifier = {
  292. name: "flip",
  293. enabled: !disableFlip
  294. };
  295. if (filteredFlipPlacements) {
  296. flipModifier.options = {
  297. fallbackPlacements: filteredFlipPlacements
  298. };
  299. }
  300. const arrowModifier = {
  301. name: "arrow",
  302. enabled: !disablePointer
  303. };
  304. if (arrowEl) {
  305. arrowModifier.options = {
  306. element: arrowEl
  307. };
  308. }
  309. const offsetModifier = {
  310. name: "offset",
  311. enabled: true,
  312. options: {
  313. offset: [offsetSkidding, offsetDistance]
  314. }
  315. };
  316. const eventListenerModifier = {
  317. name: "eventListeners",
  318. enabled: this.open
  319. };
  320. return [arrowModifier, flipModifier, offsetModifier, eventListenerModifier];
  321. }
  322. createPopper() {
  323. this.destroyPopper();
  324. const { el, placement, effectiveReferenceElement: referenceEl, overlayPositioning } = this;
  325. const modifiers = this.getModifiers();
  326. this.popper = createPopper({
  327. el,
  328. modifiers,
  329. overlayPositioning,
  330. placement,
  331. referenceEl
  332. });
  333. }
  334. destroyPopper() {
  335. const { popper } = this;
  336. if (popper) {
  337. popper.destroy();
  338. }
  339. this.popper = null;
  340. }
  341. // --------------------------------------------------------------------------
  342. //
  343. // Render Methods
  344. //
  345. // --------------------------------------------------------------------------
  346. renderCloseButton() {
  347. const { dismissible, closeButton, intlClose } = this;
  348. return dismissible || closeButton ? (h("div", { class: CSS.closeButtonContainer }, h("calcite-action", { class: CSS.closeButton, onClick: this.hide, ref: (closeButtonEl) => (this.closeButtonEl = closeButtonEl), text: intlClose }, h("calcite-icon", { icon: "x", scale: "m" })))) : null;
  349. }
  350. renderHeader() {
  351. const { heading, headingLevel } = this;
  352. const headingNode = heading ? (h(Heading, { class: CSS.heading, level: headingLevel || HEADING_LEVEL }, heading)) : null;
  353. return headingNode ? (h("div", { class: CSS.header }, headingNode, this.renderCloseButton())) : null;
  354. }
  355. render() {
  356. const { effectiveReferenceElement, heading, label, open, disablePointer } = this;
  357. const displayed = effectiveReferenceElement && open;
  358. const hidden = !displayed;
  359. const arrowNode = !disablePointer ? (h("div", { class: CSS.arrow, ref: (arrowEl) => (this.arrowEl = arrowEl) })) : null;
  360. return (h(Host, { "aria-hidden": toAriaBoolean(hidden), "aria-label": label, "calcite-hydrated-hidden": hidden, id: this.getId(), role: "dialog" }, h("div", { class: {
  361. [CSS$1.animation]: true,
  362. [CSS$1.animationActive]: displayed
  363. }, onTransitionEnd: this.transitionEnd }, arrowNode, h("div", { class: {
  364. [CSS.hasHeader]: !!heading,
  365. [CSS.container]: true
  366. } }, this.renderHeader(), h("div", { class: CSS.content }, h("slot", null)), !heading ? this.renderCloseButton() : null))));
  367. }
  368. get el() { return this; }
  369. static get watchers() { return {
  370. "flipPlacements": ["flipPlacementsHandler"],
  371. "offsetDistance": ["offsetDistanceOffsetHandler"],
  372. "offsetSkidding": ["offsetSkiddingHandler"],
  373. "open": ["openHandler"],
  374. "placement": ["placementHandler"],
  375. "referenceElement": ["referenceElementHandler"]
  376. }; }
  377. static get style() { return popoverCss; }
  378. }, [1, "calcite-popover", {
  379. "autoClose": [516, "auto-close"],
  380. "closeButton": [516, "close-button"],
  381. "dismissible": [516],
  382. "disableFlip": [516, "disable-flip"],
  383. "disablePointer": [516, "disable-pointer"],
  384. "flipPlacements": [16],
  385. "heading": [1],
  386. "headingLevel": [2, "heading-level"],
  387. "label": [1],
  388. "offsetDistance": [514, "offset-distance"],
  389. "offsetSkidding": [514, "offset-skidding"],
  390. "open": [1540],
  391. "overlayPositioning": [1, "overlay-positioning"],
  392. "placement": [513],
  393. "referenceElement": [1, "reference-element"],
  394. "intlClose": [1, "intl-close"],
  395. "effectiveReferenceElement": [32],
  396. "reposition": [64],
  397. "setFocus": [64],
  398. "toggle": [64]
  399. }]);
  400. function defineCustomElement() {
  401. if (typeof customElements === "undefined") {
  402. return;
  403. }
  404. const components = ["calcite-popover", "calcite-action", "calcite-icon", "calcite-loader"];
  405. components.forEach(tagName => { switch (tagName) {
  406. case "calcite-popover":
  407. if (!customElements.get(tagName)) {
  408. customElements.define(tagName, Popover);
  409. }
  410. break;
  411. case "calcite-action":
  412. if (!customElements.get(tagName)) {
  413. defineCustomElement$3();
  414. }
  415. break;
  416. case "calcite-icon":
  417. if (!customElements.get(tagName)) {
  418. defineCustomElement$2();
  419. }
  420. break;
  421. case "calcite-loader":
  422. if (!customElements.get(tagName)) {
  423. defineCustomElement$1();
  424. }
  425. break;
  426. } });
  427. }
  428. defineCustomElement();
  429. export { Popover as P, defineCustomElement as d };