dropdown.js 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433
  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, h, Host } from '@stencil/core/internal/client';
  7. import { t as toAriaBoolean, f as focusElement } from './dom.js';
  8. import { a as defaultMenuPlacement, f as filterComputedPlacements, C as CSS, u as updatePopper, c as createPopper, p as popperMenuComputedPlacements } from './popper.js';
  9. import { c as createObserver } from './observers.js';
  10. import { u as updateHostInteraction } from './interactive.js';
  11. const SLOTS = {
  12. dropdownTrigger: "dropdown-trigger"
  13. };
  14. const dropdownCss = "@-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:-ms-inline-flexbox;display:inline-flex;-ms-flex:0 1 auto;flex:0 1 auto}:host([disabled]){pointer-events:none;cursor:default;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;opacity:var(--calcite-ui-opacity-disabled)}:host([disabled]) ::slotted([calcite-hydrated][disabled]),:host([disabled]) [calcite-hydrated][disabled]{opacity:1}:host .calcite-dropdown-wrapper{display:block;position:absolute;z-index:900;-webkit-transform:scale(0);transform:scale(0);visibility:hidden;pointer-events:none}.calcite-dropdown-wrapper .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}.calcite-dropdown-wrapper[data-popper-placement^=bottom] .calcite-popper-anim{-webkit-transform:translateY(-5px);transform:translateY(-5px)}.calcite-dropdown-wrapper[data-popper-placement^=top] .calcite-popper-anim{-webkit-transform:translateY(5px);transform:translateY(5px)}.calcite-dropdown-wrapper[data-popper-placement^=left] .calcite-popper-anim{-webkit-transform:translateX(5px);transform:translateX(5px)}.calcite-dropdown-wrapper[data-popper-placement^=right] .calcite-popper-anim{-webkit-transform:translateX(-5px);transform:translateX(-5px)}.calcite-dropdown-wrapper[data-popper-placement] .calcite-popper-anim--active{opacity:1;visibility:visible;-webkit-transform:translate(0);transform:translate(0)}:host([active]) .calcite-dropdown-wrapper{pointer-events:initial;visibility:visible}:host .calcite-dropdown-content{width:auto;overflow-y:auto;overflow-x:hidden;background-color:var(--calcite-ui-foreground-1);max-height:90vh;width:var(--calcite-dropdown-width)}.calcite-dropdown-trigger-container{position:relative;display:-ms-flexbox;display:flex;-ms-flex:1 1 auto;flex:1 1 auto}:host([width=s]){--calcite-dropdown-width:12rem}:host([width=m]){--calcite-dropdown-width:14rem}:host([width=l]){--calcite-dropdown-width:16rem}";
  15. const Dropdown = /*@__PURE__*/ proxyCustomElement(class extends HTMLElement {
  16. constructor() {
  17. super();
  18. this.__registerHost();
  19. this.__attachShadow();
  20. this.calciteDropdownSelect = createEvent(this, "calciteDropdownSelect", 7);
  21. this.calciteDropdownOpen = createEvent(this, "calciteDropdownOpen", 7);
  22. this.calciteDropdownClose = createEvent(this, "calciteDropdownClose", 7);
  23. //--------------------------------------------------------------------------
  24. //
  25. // Public Properties
  26. //
  27. //--------------------------------------------------------------------------
  28. /** Opens or closes the dropdown */
  29. this.active = false;
  30. /**
  31. allow the dropdown to remain open after a selection is made
  32. if the selection-mode of the selected item's containing group is "none", the dropdown will always close
  33. */
  34. this.disableCloseOnSelect = false;
  35. /** is the dropdown disabled */
  36. this.disabled = false;
  37. /**
  38. specify the maximum number of calcite-dropdown-items to display before showing the scroller, must be greater than 0 -
  39. this value does not include groupTitles passed to calcite-dropdown-group
  40. */
  41. this.maxItems = 0;
  42. /** Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value. */
  43. this.overlayPositioning = "absolute";
  44. /**
  45. * Determines where the dropdown will be positioned relative to the button.
  46. * @default "bottom-leading"
  47. */
  48. this.placement = defaultMenuPlacement;
  49. /** specify the scale of dropdown, defaults to m */
  50. this.scale = "m";
  51. /**
  52. * **read-only** The currently selected items
  53. *
  54. * @readonly
  55. */
  56. this.selectedItems = [];
  57. /** specify whether the dropdown is opened by hover or click of a trigger element */
  58. this.type = "click";
  59. /** specify the width of dropdown, defaults to m */
  60. this.width = "m";
  61. this.items = [];
  62. this.groups = [];
  63. this.activeTransitionProp = "visibility";
  64. this.mutationObserver = createObserver("mutation", () => this.updateItems());
  65. this.resizeObserver = createObserver("resize", () => this.setMaxScrollerHeight());
  66. //--------------------------------------------------------------------------
  67. //
  68. // Private Methods
  69. //
  70. //--------------------------------------------------------------------------
  71. this.setFilteredPlacements = () => {
  72. const { el, flipPlacements } = this;
  73. this.filteredFlipPlacements = flipPlacements
  74. ? filterComputedPlacements(flipPlacements, el)
  75. : null;
  76. };
  77. this.updateTriggers = (event) => {
  78. this.triggers = event.target.assignedElements({
  79. flatten: true
  80. });
  81. this.reposition();
  82. };
  83. this.updateItems = () => {
  84. this.items = this.groups
  85. .map((group) => Array.from(group === null || group === void 0 ? void 0 : group.querySelectorAll("calcite-dropdown-item")))
  86. .reduce((previousValue, currentValue) => [...previousValue, ...currentValue], []);
  87. this.updateSelectedItems();
  88. this.reposition();
  89. };
  90. this.updateGroups = (event) => {
  91. const groups = event.target
  92. .assignedElements({ flatten: true })
  93. .filter((el) => el === null || el === void 0 ? void 0 : el.matches("calcite-dropdown-group"));
  94. this.groups = groups;
  95. this.updateItems();
  96. };
  97. this.setMaxScrollerHeight = () => {
  98. const { active, scrollerEl } = this;
  99. if (!scrollerEl || !active) {
  100. return;
  101. }
  102. this.reposition();
  103. const maxScrollerHeight = this.getMaxScrollerHeight();
  104. scrollerEl.style.maxHeight = maxScrollerHeight > 0 ? `${maxScrollerHeight}px` : "";
  105. this.reposition();
  106. };
  107. this.setScrollerEl = (scrollerEl) => {
  108. this.resizeObserver.observe(scrollerEl);
  109. this.scrollerEl = scrollerEl;
  110. };
  111. this.transitionEnd = (event) => {
  112. if (event.propertyName === this.activeTransitionProp) {
  113. this.active ? this.calciteDropdownOpen.emit() : this.calciteDropdownClose.emit();
  114. }
  115. };
  116. this.setReferenceEl = (el) => {
  117. this.referenceEl = el;
  118. };
  119. this.setMenuEl = (el) => {
  120. this.menuEl = el;
  121. };
  122. this.keyDownHandler = (e) => {
  123. const target = e.target;
  124. if (target !== this.referenceEl) {
  125. return;
  126. }
  127. const key = e.key;
  128. if (this.active && (key === "Escape" || (e.shiftKey && key === "Tab"))) {
  129. this.closeCalciteDropdown();
  130. return;
  131. }
  132. switch (key) {
  133. case " ":
  134. case "Enter":
  135. this.openCalciteDropdown();
  136. break;
  137. case "Escape":
  138. this.closeCalciteDropdown();
  139. break;
  140. }
  141. };
  142. this.focusOnFirstActiveOrFirstItem = () => {
  143. this.getFocusableElement(this.items.find((item) => item.active) || this.items[0]);
  144. };
  145. this.toggleOpenEnd = () => {
  146. this.focusOnFirstActiveOrFirstItem();
  147. this.el.removeEventListener("calciteDropdownOpen", this.toggleOpenEnd);
  148. };
  149. this.openCalciteDropdown = () => {
  150. this.active = !this.active;
  151. if (this.active) {
  152. this.el.addEventListener("calciteDropdownOpen", this.toggleOpenEnd);
  153. }
  154. };
  155. }
  156. activeHandler() {
  157. if (!this.disabled) {
  158. this.reposition();
  159. return;
  160. }
  161. this.active = false;
  162. }
  163. handleDisabledChange(value) {
  164. if (!value) {
  165. this.active = false;
  166. }
  167. }
  168. flipPlacementsHandler() {
  169. this.setFilteredPlacements();
  170. }
  171. maxItemsHandler() {
  172. this.setMaxScrollerHeight();
  173. }
  174. placementHandler() {
  175. this.reposition();
  176. }
  177. //--------------------------------------------------------------------------
  178. //
  179. // Lifecycle
  180. //
  181. //--------------------------------------------------------------------------
  182. connectedCallback() {
  183. var _a;
  184. (_a = this.mutationObserver) === null || _a === void 0 ? void 0 : _a.observe(this.el, { childList: true, subtree: true });
  185. this.createPopper();
  186. this.setFilteredPlacements();
  187. }
  188. componentDidLoad() {
  189. this.reposition();
  190. }
  191. componentDidRender() {
  192. updateHostInteraction(this);
  193. }
  194. disconnectedCallback() {
  195. var _a, _b;
  196. (_a = this.mutationObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
  197. (_b = this.resizeObserver) === null || _b === void 0 ? void 0 : _b.disconnect();
  198. this.destroyPopper();
  199. }
  200. render() {
  201. const { active } = this;
  202. return (h(Host, null, h("div", { class: "calcite-dropdown-trigger-container", onClick: this.openCalciteDropdown, onKeyDown: this.keyDownHandler, ref: this.setReferenceEl }, h("slot", { "aria-expanded": toAriaBoolean(active), "aria-haspopup": "true", name: SLOTS.dropdownTrigger, onSlotchange: this.updateTriggers })), h("div", { "aria-hidden": toAriaBoolean(!active), class: "calcite-dropdown-wrapper", ref: this.setMenuEl }, h("div", { class: {
  203. ["calcite-dropdown-content"]: true,
  204. [CSS.animation]: true,
  205. [CSS.animationActive]: active
  206. }, onTransitionEnd: this.transitionEnd, ref: this.setScrollerEl }, h("div", { hidden: !this.active }, h("slot", { onSlotchange: this.updateGroups }))))));
  207. }
  208. //--------------------------------------------------------------------------
  209. //
  210. // Public Methods
  211. //
  212. //--------------------------------------------------------------------------
  213. /** Updates the position of the component. */
  214. async reposition() {
  215. const { popper, menuEl, placement } = this;
  216. const modifiers = this.getModifiers();
  217. popper
  218. ? await updatePopper({
  219. el: menuEl,
  220. modifiers,
  221. placement,
  222. popper
  223. })
  224. : this.createPopper();
  225. }
  226. closeCalciteDropdownOnClick(e) {
  227. if (!this.active || e.composedPath().includes(this.el)) {
  228. return;
  229. }
  230. this.closeCalciteDropdown(false);
  231. }
  232. closeCalciteDropdownOnEvent() {
  233. this.closeCalciteDropdown();
  234. }
  235. closeCalciteDropdownOnOpenEvent(e) {
  236. if (e.composedPath().includes(this.el)) {
  237. return;
  238. }
  239. this.active = false;
  240. }
  241. mouseEnterHandler() {
  242. if (this.type === "hover") {
  243. this.openCalciteDropdown();
  244. }
  245. }
  246. mouseLeaveHandler() {
  247. if (this.type === "hover") {
  248. this.closeCalciteDropdown();
  249. }
  250. }
  251. calciteDropdownItemKeyEvent(e) {
  252. const { keyboardEvent } = e.detail;
  253. // handle edge
  254. const target = keyboardEvent.target;
  255. const itemToFocus = target.nodeName !== "A" ? target : target.parentNode;
  256. const isFirstItem = this.itemIndex(itemToFocus) === 0;
  257. const isLastItem = this.itemIndex(itemToFocus) === this.items.length - 1;
  258. switch (keyboardEvent.key) {
  259. case "Tab":
  260. if (isLastItem && !keyboardEvent.shiftKey) {
  261. this.closeCalciteDropdown();
  262. }
  263. else if (isFirstItem && keyboardEvent.shiftKey) {
  264. this.closeCalciteDropdown();
  265. }
  266. else if (keyboardEvent.shiftKey) {
  267. this.focusPrevItem(itemToFocus);
  268. }
  269. else {
  270. this.focusNextItem(itemToFocus);
  271. }
  272. break;
  273. case "ArrowDown":
  274. this.focusNextItem(itemToFocus);
  275. break;
  276. case "ArrowUp":
  277. this.focusPrevItem(itemToFocus);
  278. break;
  279. case "Home":
  280. this.focusFirstItem();
  281. break;
  282. case "End":
  283. this.focusLastItem();
  284. break;
  285. }
  286. e.stopPropagation();
  287. }
  288. handleItemSelect(event) {
  289. this.updateSelectedItems();
  290. event.stopPropagation();
  291. this.calciteDropdownSelect.emit();
  292. if (!this.disableCloseOnSelect ||
  293. event.detail.requestedDropdownGroup.selectionMode === "none") {
  294. this.closeCalciteDropdown();
  295. }
  296. }
  297. getModifiers() {
  298. const flipModifier = {
  299. name: "flip",
  300. enabled: true
  301. };
  302. flipModifier.options = {
  303. fallbackPlacements: this.filteredFlipPlacements || popperMenuComputedPlacements
  304. };
  305. const eventListenerModifier = {
  306. name: "eventListeners",
  307. enabled: this.active
  308. };
  309. return [flipModifier, eventListenerModifier];
  310. }
  311. createPopper() {
  312. this.destroyPopper();
  313. const { menuEl, referenceEl, placement, overlayPositioning } = this;
  314. const modifiers = this.getModifiers();
  315. this.popper = createPopper({
  316. el: menuEl,
  317. modifiers,
  318. overlayPositioning,
  319. placement,
  320. referenceEl
  321. });
  322. }
  323. destroyPopper() {
  324. const { popper } = this;
  325. if (popper) {
  326. popper.destroy();
  327. }
  328. this.popper = null;
  329. }
  330. updateSelectedItems() {
  331. this.selectedItems = this.items.filter((item) => item.active);
  332. }
  333. getMaxScrollerHeight() {
  334. const { maxItems } = this;
  335. let itemsToProcess = 0;
  336. let maxScrollerHeight = 0;
  337. let groupHeaderHeight;
  338. this.groups.forEach((group) => {
  339. if (maxItems > 0 && itemsToProcess < maxItems) {
  340. Array.from(group.children).forEach((item, index) => {
  341. if (index === 0) {
  342. if (isNaN(groupHeaderHeight)) {
  343. groupHeaderHeight = item.offsetTop;
  344. }
  345. maxScrollerHeight += groupHeaderHeight;
  346. }
  347. if (itemsToProcess < maxItems) {
  348. maxScrollerHeight += item.offsetHeight;
  349. itemsToProcess += 1;
  350. }
  351. });
  352. }
  353. });
  354. return maxScrollerHeight;
  355. }
  356. closeCalciteDropdown(focusTrigger = true) {
  357. this.active = false;
  358. if (focusTrigger) {
  359. focusElement(this.triggers[0]);
  360. }
  361. }
  362. focusFirstItem() {
  363. const firstItem = this.items[0];
  364. this.getFocusableElement(firstItem);
  365. }
  366. focusLastItem() {
  367. const lastItem = this.items[this.items.length - 1];
  368. this.getFocusableElement(lastItem);
  369. }
  370. focusNextItem(e) {
  371. const index = this.itemIndex(e);
  372. const nextItem = this.items[index + 1] || this.items[0];
  373. this.getFocusableElement(nextItem);
  374. }
  375. focusPrevItem(e) {
  376. const index = this.itemIndex(e);
  377. const prevItem = this.items[index - 1] || this.items[this.items.length - 1];
  378. this.getFocusableElement(prevItem);
  379. }
  380. itemIndex(e) {
  381. return this.items.indexOf(e);
  382. }
  383. getFocusableElement(item) {
  384. if (!item) {
  385. return;
  386. }
  387. const target = item.attributes.isLink
  388. ? item.shadowRoot.querySelector("a")
  389. : item;
  390. focusElement(target);
  391. }
  392. get el() { return this; }
  393. static get watchers() { return {
  394. "active": ["activeHandler"],
  395. "disabled": ["handleDisabledChange"],
  396. "flipPlacements": ["flipPlacementsHandler"],
  397. "maxItems": ["maxItemsHandler"],
  398. "placement": ["placementHandler"]
  399. }; }
  400. static get style() { return dropdownCss; }
  401. }, [1, "calcite-dropdown", {
  402. "active": [1540],
  403. "disableCloseOnSelect": [516, "disable-close-on-select"],
  404. "disabled": [516],
  405. "flipPlacements": [16],
  406. "maxItems": [2, "max-items"],
  407. "overlayPositioning": [1, "overlay-positioning"],
  408. "placement": [513],
  409. "scale": [513],
  410. "selectedItems": [1040],
  411. "type": [513],
  412. "width": [513],
  413. "reposition": [64]
  414. }, [[8, "click", "closeCalciteDropdownOnClick"], [0, "calciteDropdownCloseRequest", "closeCalciteDropdownOnEvent"], [8, "calciteDropdownOpen", "closeCalciteDropdownOnOpenEvent"], [1, "mouseenter", "mouseEnterHandler"], [1, "mouseleave", "mouseLeaveHandler"], [0, "calciteDropdownItemKeyEvent", "calciteDropdownItemKeyEvent"], [0, "calciteDropdownItemSelect", "handleItemSelect"]]]);
  415. function defineCustomElement() {
  416. if (typeof customElements === "undefined") {
  417. return;
  418. }
  419. const components = ["calcite-dropdown"];
  420. components.forEach(tagName => { switch (tagName) {
  421. case "calcite-dropdown":
  422. if (!customElements.get(tagName)) {
  423. customElements.define(tagName, Dropdown);
  424. }
  425. break;
  426. } });
  427. }
  428. defineCustomElement();
  429. export { Dropdown as D, defineCustomElement as d };