# nudeui/awesomplete

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/nudeui-awesomplete).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

6,965 stars · 595 forks · JavaScript · MIT

## Links

- GitHub: https://github.com/nudeui/awesomplete
- Homepage: https://nudeui.github.io/awesomplete/
- awesome-repositories: https://awesome-repositories.com/repository/nudeui-awesomplete.md

## Description

Awesomplete is a lightweight autocomplete widget for text inputs, written in plain JavaScript with no external dependencies. As the user types, it opens a dropdown of matching suggestions beneath the field, drawn from a configured list. The dropdown is an accessible combobox: it uses combobox and listbox roles plus a live status message that announces result counts to screen readers, and suggestions can be chosen with the arrow keys, Enter, Tab, and Escape.

A widget can be set up entirely in markup or created from script. Adding a class to an input and setting HTML data attributes activates it automatically, while instantiating it in code allows finer control through options, instance methods, and events. Suggestions can come from a native datalist element, an inline list, a selector, an element reference, or a plain array of strings, so the input keeps basic native autocomplete if the script never loads. Labels shown in the dropdown can differ from the values inserted into the input.

Matching, sorting, item markup, and value replacement are each separate functions that can be overridden. Behavior options include the minimum number of characters before suggestions appear, the maximum number of items shown, and automatic selection of the first match. The widget fires prefixed custom events for opening, closing, highlighting, and selecting, and a handler can cancel a selection before it is applied. The suggestion list can also be replaced after the widget is created.

A ready-made theme styles the dropdown with highlighted matching text, hover and selected colors, and animated opening and closing. The package ships a script and a stylesheet and can be installed through a package manager.

## Tags

### User Interface & Experience

- [Autocomplete Inputs](https://awesome-repositories.com/f/user-interface-experience/text-input-widgets/autocomplete-inputs.md) — Adds a dropdown of matching suggestions to a text input as the user types, using plain JavaScript with no external dependencies.
- [As-You-Type Suggestion Interfaces](https://awesome-repositories.com/f/user-interface-experience/as-you-type-suggestion-interfaces.md) — Opens a dropdown of matching suggestions as the user types, with matches filtered, sorted, and highlighted for quick selection.
- [Text Input Suggesters](https://awesome-repositories.com/f/user-interface-experience/autocomplete-suggestion-engines/search-keyword-suggesters/text-input-suggesters.md) — Narrows suggestions to entries containing or starting with the typed text and ranks matches by criteria such as length. ([source](https://github.com/nudeui/awesomplete/blob/gh-pages/awesomplete.min.js.map))
- [Combobox Components](https://awesome-repositories.com/f/user-interface-experience/combobox-components.md) — Implements a text input paired with a listbox using combobox roles and a live status message so screen readers follow changing results.
- [Keyboard-Accessible Autocomplete](https://awesome-repositories.com/f/user-interface-experience/keyboard-based-accessibility/keyboard-accessible-autocomplete.md) — Lets users navigate and choose suggestions with arrow keys, Enter, Tab, and Escape, with combobox roles and live announcements for screen readers.
- [Screen Reader Live Regions](https://awesome-repositories.com/f/user-interface-experience/screen-reader-live-regions.md) — Uses combobox and listbox roles plus a live status message that announces result counts so screen readers can follow changing suggestions. ([source](https://github.com/nudeui/awesomplete/blob/gh-pages/awesomplete.min.js.map))
- [Autocomplete Suggestion Popups](https://awesome-repositories.com/f/user-interface-experience/styled-properties/popup-styling/contextual-popups/spelling-suggestion-popups/autocomplete-suggestion-popups.md) — Shows a dropdown of matching suggestions beneath a text input as the user types, drawn from a configured data list. ([source](https://github.com/nudeui/awesomplete/blob/gh-pages/awesomplete.min.js.map))
- [Autocomplete Suggestion Engines](https://awesome-repositories.com/f/user-interface-experience/autocomplete-suggestion-engines.md) — Accepts suggestions from an inline attribute, datalist, selector, element reference, or plain array of strings. ([source](https://github.com/nudeui/awesomplete/blob/gh-pages/index.html))
- [Keyboard Controls](https://awesome-repositories.com/f/user-interface-experience/autocomplete-suggestion-engines/search-keyword-suggesters/keyboard-controls.md) — Moves through suggestions with arrow keys, selects with Enter or Tab and closes the list with Escape, with no mouse needed. ([source](https://github.com/nudeui/awesomplete/blob/gh-pages/awesomplete.min.js.map))
- [Customizable Suggestion Renderers](https://awesome-repositories.com/f/user-interface-experience/autocomplete-suggestion-engines/search-keyword-suggesters/text-input-suggesters/customizable-suggestion-renderers.md) — Lets pages override data, item and replace functions so each suggestion is converted, rendered and inserted exactly as needed. ([source](https://github.com/nudeui/awesomplete/blob/gh-pages/CHANGELOG.md))
- [Cancelable Widget Lifecycle Events](https://awesome-repositories.com/f/user-interface-experience/cancelable-widget-lifecycle-events.md) — Fires prefixed custom events for open, close, highlight and select, and lets handlers cancel a selection before it is applied. ([source](https://github.com/nudeui/awesomplete/blob/gh-pages/awesomplete.min.js.map))
- [Declarative and Scripted Widget Setup](https://awesome-repositories.com/f/user-interface-experience/declarative-and-scripted-widget-setup.md) — Supports setup entirely in markup through a class and data attributes, or from script with options, instance methods and events. ([source](https://github.com/nudeui/awesomplete#readme))
- [Accessible Combobox Form Integrations](https://awesome-repositories.com/f/user-interface-experience/form-field-extensions/accessible-combobox-form-integrations.md) — Applies combobox and listbox roles plus a live status message announcing result counts so screen readers can follow changing suggestions.
- [Pluggable Filter, Sort and Render Functions](https://awesome-repositories.com/f/user-interface-experience/pluggable-filter-sort-and-render-functions.md) — Allows the filter, sort, item markup, container and replace steps to be overridden with custom functions to control how suggestions are matched and shown. ([source](https://nudeui.github.io/awesomplete/))
- [Pluggable Matching and Rendering Functions](https://awesome-repositories.com/f/user-interface-experience/pluggable-matching-and-rendering-functions.md) — Lets callers override matching, sorting, item markup, and value replacement through separate functions without touching the core.
- [Prefixed Widget Events](https://awesome-repositories.com/f/user-interface-experience/prefixed-widget-events.md) — Fires prefixed custom events for opening, closing, highlighting, and selecting, and lets handlers cancel a selection before it is applied.
- [Suggestion Behaviors](https://awesome-repositories.com/f/user-interface-experience/suggestion-behaviors.md) — Tunes the popup through data attributes or script properties, covering minimum characters, maximum items, first-item auto-selection, tab selection, and list label. ([source](https://nudeui.github.io/awesomplete/))

### Development Tools & Productivity

- [Declarative Configuration](https://awesome-repositories.com/f/development-tools-productivity/declarative-configuration.md) — Activates the widget on any input with a marker class and configures it entirely through HTML data attributes, with no script needed. ([source](https://github.com/nudeui/awesomplete/blob/gh-pages/README.md))
- [Search Match Highlighting](https://awesome-repositories.com/f/development-tools-productivity/search-match-highlighting.md) — Marks the part of each suggestion matching the typed text with a distinct background color so users see why it was suggested. ([source](https://github.com/nudeui/awesomplete/blob/gh-pages/awesomplete.css.map))

### Web Development

- [Vanilla JavaScript Utilities](https://awesome-repositories.com/f/web-development/vanilla-javascript-utilities.md) — Delivers a self-contained component in plain browser JavaScript with no external libraries, keeping the download small and easy to embed.
- [Dependency-Free Frontend Libraries](https://awesome-repositories.com/f/web-development/dependency-free-frontend-libraries.md) — Delivers a lightweight autocomplete component in plain JavaScript that needs no external libraries or frameworks.
- [Configuration Attributes](https://awesome-repositories.com/f/web-development/element-attributes/configuration-attributes.md) — Reads options such as minimum characters and maximum items from HTML data attributes so behavior is configured in markup without script.
- [Progressive Form Enhancements](https://awesome-repositories.com/f/web-development/progressive-enhancement/progressive-form-enhancements.md) — Upgrades ordinary text inputs with suggestion behavior using only a class and HTML attributes, keeping native datalist autocomplete if the script fails.

### Data & Databases

- [Suggestion List Sources](https://awesome-repositories.com/f/data-databases/search-suggestions/suggestion-list-sources.md) — Loads suggestions from a string array, element, selector or comma-separated string and accepts items in several label and value formats. ([source](https://nudeui.github.io/awesomplete/))
