@nectary/components 2.8.6 → 2.8.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nectary/components",
-  "version": "2.8.6",
+  "version": "2.8.7",
   "files": [
     "**/*/*.css",
     "**/*/*.json",

package/select-menu/index.js

@@ -41,6 +41,7 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
     this.#$search.addEventListener('-change', this.#onSearchChange, options);
     this.#$searchClear.addEventListener('-click', this.#onSearchClearClick, options);
     this.#$optionSlot.addEventListener('slotchange', this.#onOptionSlotChange, options);
+    this.addEventListener('-search-change', this.#onSearchChangeReactHandler, options);
     this.addEventListener('-change', this.#onChangeReactHandler, options);
     subscribeContext(this, 'keydown', this.#onContextKeyDown, this.#controller.signal);
     subscribeContext(this, 'visibility', this.#onContextVisibility, this.#controller.signal);
@@ -52,7 +53,7 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
     this.#controller = null;
   }
   static get observedAttributes() {
-    return ['value', 'rows', 'multiple'];
+    return ['value', 'rows', 'multiple', 'search-placeholder'];
   }
   attributeChangedCallback(name, oldVal, newVal) {
     switch (name) {
@@ -75,6 +76,11 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
           });
           break;
         }
+      case 'search-placeholder':
+        {
+          updateAttribute(this.#$search, 'placeholder', newVal);
+          break;
+        }
     }
   }
   set value(value) {
@@ -95,6 +101,12 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
   get multiple() {
     return getBooleanAttribute(this, 'multiple');
   }
+  set 'search-placeholder'(placeholder) {
+    updateAttribute(this.#$search, 'placeholder', placeholder);
+  }
+  get 'search-placeholder'() {
+    return getAttribute(this.#$search, 'placeholder', '');
+  }
   get focusable() {
     return true;
   }
@@ -128,15 +140,22 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
   };
   #updateSearch = () => {
     const searchValue = this.#$search.value.toLowerCase();
-    const $options = this.#getOptionElements();
-    let someFound = false;
-    for (const $opt of $options) {
-      const isHidden = searchValue.length > 0 && !$opt.matchesSearch(searchValue);
-      someFound ||= !isHidden;
-      setClass($opt, 'hidden', isHidden);
+    const searchChangedEvent = new CustomEvent('-search-change', {
+      detail: searchValue,
+      cancelable: true
+    });
+    this.dispatchEvent(searchChangedEvent);
+    if (!searchChangedEvent.defaultPrevented) {
+      const $options = this.#getOptionElements();
+      let someFound = false;
+      for (const $opt of $options) {
+        const isHidden = searchValue.length > 0 && !$opt.matchesSearch(searchValue);
+        someFound ||= !isHidden;
+        setClass($opt, 'hidden', isHidden);
+      }
+      setClass(this.#$notFound, 'active', !someFound);
+      this.#selectOption(null);
     }
-    setClass(this.#$notFound, 'active', !someFound);
-    this.#selectOption(null);
   };
   #onContextKeyDown = e => {
     this.#handleKeydown(e.detail);
@@ -179,7 +198,10 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
     }
   }
   #onOptionSlotChange = () => {
-    const isSearchActive = this.#$optionSlot.assignedElements().length >= NUM_ITEMS_SEARCH;
+    const hasSearchableAttribute = this.hasAttribute('searchable');
+    const options = this.#$optionSlot.assignedElements();
+    const isEnoughOptions = options.length >= NUM_ITEMS_SEARCH;
+    const isSearchActive = isEnoughOptions || hasSearchableAttribute;
     if (!isSearchActive) {
       updateAttribute(this.#$search, 'value', null);
     }
@@ -304,4 +326,7 @@ defineCustomElement('sinch-select-menu', class extends NectaryElement {
   #onChangeReactHandler = e => {
     getReactEventHandler(this, 'on-change')?.(e);
   };
+  #onSearchChangeReactHandler = e => {
+    getReactEventHandler(this, 'on-search-change')?.(e);
+  };
 });

package/select-menu/types.d.ts

@@ -6,8 +6,14 @@ export type TSinchSelectMenuElement = HTMLElement & {
     rows: number | null;
     /** Allows multiple selection */
     multiple: boolean;
+    /** Enforce the search bar appearing, by default it appears above a certain number of options  */
+    searchable: boolean;
+    /** Text for search bar's placeholder */
+    'search-placeholder': string;
     /** Change value event */
     addEventListener(type: '-change', listener: (e: CustomEvent<string>) => void): void;
+    /** Change value event */
+    addEventListener(type: '-search-change', listener: (e: CustomEvent<string>) => void): void;
     /** Selected value, CSV when multiple */
     setAttribute(name: 'value', value: string): void;
     /** How many rows to show and scroll the rest */
@@ -22,8 +28,14 @@ export type TSinchSelectMenuReact = TSinchElementReact<TSinchSelectMenuElement>
     rows?: number;
     /** Allows multiple selection */
     multiple?: boolean;
+    /** Enforce the search bar appearing, by default it appears above a certain number of options  */
+    searchable?: boolean;
+    /** Text for search bar's placeholder */
+    'search-placeholder'?: string;
     /** Label that is used for a11y */
     'aria-label': string;
     /** Change value handler */
+    'on-search-change'?: (e: CustomEvent<string>) => void;
+    /** Change value handler */
     'on-change'?: (e: CustomEvent<string>) => void;
 };