v10.0

v10.0 ✨

Important Note:

This release has several breaking changes, so kindly check all the below changes.

• ➕ Added: Automatic field wrapping inside DIV
• ➕ Added: Document readyState listener that initializes the library after DOM content is loaded
• ➕ Added: query value to data.src for easier data fetching
• ➕ Added: resultsList navigation auto scrolling for long lists
• ➕ Added: resultsList.tabSelect API property to control tab button behavior
• ➕ Added: events list API property that holds and assigns events to input & list (Thanks 👍 @stell) #223
• ➕ Added: close API method controls resultsList state
• ➕ Added: open API method controls resultsList state
• ➕ Added: goTo API method controls resultsList navigation by index
• ➕ Added: next API method controls resultsList navigation
• ➕ Added: previous API method controls resultsList navigation
• ➕ Added: select API method controls resultsList selection by index
• ➕ Added: search API method to avail autoComplete.js powerful engine for external use
• ➕ Added: isOpen API boolean property that holds resultsList state true opened false closed
• ➕ Added: list API property holds the entire list html element
• ➕ Added: wrapper API property holds the entire wrapper html element
• ➕ Added: cursor API property holds the index of the current selection or -1 or undefined for idle
• ➕ Added: id API property holds the current instance number
• ➕ Added: name API property that changes all the className properties accordingly
• ➕ Added: options API property that holds all the custom set config options for separation
• ➕ Added: data.src fetching error message/instance to response event detail (Thanks 👍 @folknor) #207
• 🔝 Updated: Data caching with a better mechanism
• 🔝 Updated: WAI-ARIA configurations for significantly better support
• 🔝 Updated: dataFeedback event information
• 🔧 Fixed: diacritics highlighting issue in strict mode
• 🔧 Fixed: resultsList eventEmitters unexpected behavior which was firing multiple times
• 🔧 Fixed: Empty className values do not assign any classes instead of undefined
• 🌀 Changed: The core library architecture for an improved performance and code separation
• 🌀 Changed: API to only include the used options instead of including unused ones with undefined value
• 🌀 Changed: fetch eventEmitter name to response
• 🌀 Changed: inputField API property name to input
• 🌀 Changed: dataFeedback API property name to feedback
• 🌀 Changed: trigger API property type from Object to Function formerly called trigger.condition
• 🌀 Changed: data.results API property name to data.filter
• 🌀 Changed: noResults API to accept boolean instead of Function to be replaced with resultsList.container
• 🌀 Changed: resultItem.highlight API property type from Object to accept Boolean or String formerly called resultItem.highlight.class
• 🌀 Changed: resultItem.selected API property type from Object to String formerly called resultItem.selected.class
• 🌀 Changed: resultItem.content API parameters order from (data, element) to (element, data) for consistency
• 🌀 Changed: resultItem.idName API property name to resultItem.id
• 🌀 Changed: resultItem.className API property name to resultItem.class
• 🌀 Changed: resultItem.content API property name to resultItem.element
• 🌀 Changed: resultsList.idName API property name resultsList.id
• 🌀 Changed: resultsList.className API property name resultsList.class
• 🌀 Changed: resultsList.container API property name to resultsList.element
• 🌀 Changed: Highlighted characters wrapper element to be mark instead of span (Thanks 👍 @aarongerig) #195
• 🌀 Changed: query API property type from Object to Function formerly called query.manipulate
• 🌀 Changed: observer API property name observe
• 🌀 Changed: data.key API property name data.keys
• ❗ Removed: onSelection API method to be replaced with selection eventEmitter
• ❗ Removed: resultsList.render API property to be replaced with resultsList to accept Boolean instead of Object in case of disabling list rendering
• ❗ Removed: trigger.event API property to be replaced with events
• ❗ Removed: feedback API method to be replaced with navigate event
• ❗ Removed: resultsList.navigation API method to be replaced with events
• ❗ Removed: nav API property to be replaced with events
• ❗ Removed: hook API method to be replaced with start API
• ❗ Removed: onSelection API method to be replaced with selection eventEmitter
• ❗ Removed: input property from feedback due to the existence of query already
• ❗ Removed: unInit eventEmitter

v9.1.1

v9.1.1 ✨

! Important Note:

Starting next major release:

1. "noResults" API will accept "Boolean" instead of function to be replaced with "resultsList.container"
2. "fetch" eventEmitter will be renamed to "response"
3. All "className" APIs will be renamed to "classList"

• 🔧 Fixed: Data feedback inputField value was in lowerCase instead of raw
• 🔧 Fixed: resultItem.className did not accept except one class instead of multiple
• 🔝 Updated: Code with deep refactoring & cleanup (Thanks 👍 @Pirulax) #210

v9.1.0

v9.1.0 ✨

! Important Note:

Starting next major release:

1. "noResults" API will accept "Boolean" instead of function to be replaced with "resultsList.container"
2. "fetch" eventEmitter will be renamed to "response"

• ➕ Added: New data parameter to resultsList.container method that contains (input, query, matches, results) values
• 🔝 Updated: resultsList.container.className default value to be undefined
• 🔝 Updated: Code with some refactoring & cleanup
• 🔝 Updated: Development dependencies
• 🔧 Fixed: resultsList error on Enter key press with no selection
• 🔧 Fixed: Input field aria-activedescendant was not removed on each resultsList regeneration
• 🔧 Fixed: noResults error on Enter key press
• 🔧 Fixed: Input field aria-expanded set to true even when noResults was not active
• 🔧 Fixed: resultsList on close event did not fire when noResults was active
• 🔧 Fixed: unInit method did not remove all inputField set event listeners except for input event
• 🔧 Fixed: open eventEmitter unexpected behavior that used to fire on each trigger event

v9.0.5

v9.0.5 ✨

• 🔧 Fixed: resultsList.container hierarchy comes after list rendering instead of before

v9.0.4

v9.0.4 ✨

• 🔧 Fixed: resultsList.container is removed on second input (Thanks 👍 @folknor) #206

v9.0.3

v9.0.3 ✨

• 🔧 Fixed: TAB button behavior
• 🔧 Fixed: resultsList close behavior on inputField double click

v9.0.2

v9.0.2 ✨

• 🔧 Fixed: Unexpected behavior onClick (Thanks 👍 @iNalgiev) #205

v9.0.1

v9.0.1 ✨

• 🔧 Fixed: resultItem.idName issue
• 🔝 Updated: Tab button behavior (Thanks 👍 @ronmichael @codyjames) #175 #202

v9.0.0

v9.0.0 ✨

This version has breaking changes, kindly check the list

• 🔧 Fixed: esc button not working with noResults in some cases (Thanks 👍 @sunshineplan) #157
• ➕ Added: selection & highlight custom className API methods (Thanks 👍 @jerrykan) #184
• ➕ Added: eventEmitter for resultsList fires on list close event (Thanks 👍 @yliharma) #188
• ➕ Added: event parameter to trigger.event API method (Thanks 👍 @nornes) #189
• 🌀 Changed: maxResults API moved under resultsList
• 🌀 Changed: noResults API moved under resultsList
• 🌀 Changed: highlight API moved under resultItem
• 🌀 Changed: selection API moved under resultItem with the name of selected
• 🌀 Changed: rendered eventEmitter name to open
• 🌀 Changed: navigation eventEmitter name to navigate
• 🌀 Changed: closeAllLists refactored and renamed to closeList
• 🌀 Changed: generateList stage with some refactoring
• 🌀 Changed: start stage with some refactoring
• 🌀 Changed: noResults API method with some refactoring details
• 🌀 Changed: highlight API from String to Object details
• ❗ Removed: sort API due to its redundancy data.results could be used instead
• ❗ Removed: connect eventEmitter from the preInit stage
• 🔝 Updated: Replaced Uglify with Terser
• 🔝 Updated: Development dependencies
• 🔝 Updated: Code comments
• 🔝 Updated: Documentation

v8.3.2

v8.3.2 ✨

• 🔧 Fix: selector as a function breaks when observer is true (Thanks 👍 @brunobg) #179