Merge pull request #123 from samueldjack/dropdown-events

Dropdown events

README.md

@@ -523,6 +523,16 @@ example.passedElement.addEventListener('addItem', function(event) {
 
 **Usage:** Triggered when a user types into an input to search choices.
 
+### showDropdown
+**Arguments:** - **Input types affected:** `select-one`, `select-multiple`
+
+**Usage:** Triggered when the dropdown is shown.
+
+### hideDropdown
+**Arguments:** - **Input types affected:** `select-one`, `select-multiple`
+
+**Usage:** Triggered when the dropdown is hidden.
+
 ## Methods
 Methods can be called either directly or by chaining:
 

assets/scripts/src/choices.js

@@ -653,6 +653,8 @@ class Choices {
       this.input.focus();
     }
 
+    triggerEvent(this.passedElement, "showDropdown", {});
+
     return this;
   }
 
@@ -678,6 +680,8 @@ class Choices {
       this.input.blur();
     }
 
+    triggerEvent(this.passedElement, "hideDropdown", {});
+
     return this;
   }
 

tests/spec/choices_spec.js

@@ -386,6 +386,52 @@ describe('Choices', () => {
       expect(document.activeElement === this.choices.input && container.classList.contains(openState)).toBe(false);
     });
 
+    it('should trigger showDropdown on dropdown opening', function() {
+      this.choices = new Choices(this.input);
+      const container = this.choices.containerOuter;
+      
+      const showDropdownSpy = jasmine.createSpy('showDropdownSpy');
+      const passedElement = this.choices.passedElement;
+
+      passedElement.addEventListener('showDropdown', showDropdownSpy);
+
+      this.choices.input.focus();
+
+      this.choices._onClick({
+        target: container,
+        ctrlKey: false,
+        preventDefault: () => {}
+      });
+
+      expect(showDropdownSpy).toHaveBeenCalled();
+    });
+
+it('should trigger hideDropdown on dropdown closing', function() {
+      this.choices = new Choices(this.input);
+      const container = this.choices.containerOuter;
+      
+      const hideDropdownSpy = jasmine.createSpy('hideDropdownSpy');
+      const passedElement = this.choices.passedElement;
+
+      passedElement.addEventListener('hideDropdown', hideDropdownSpy);
+
+      this.choices.input.focus();
+
+      this.choices._onClick({
+        target: container,
+        ctrlKey: false,
+        preventDefault: () => {}
+      });
+
+      this.choices._onClick({
+        target: container,
+        ctrlKey: false,
+        preventDefault: () => {}
+      });
+
+      expect(hideDropdownSpy).toHaveBeenCalled();
+    });
+
     it('should filter choices when searching', function() {
       this.choices = new Choices(this.input);