File: autocomplete.md | Updated: 11/15/2025
5-day Mini-Course
Short, tactical video lessons from the creator of Tailwind CSS, delivered directly to your inbox every day for a week.
A commercial license is required to use Tailwind Plus Elements. Purchase Tailwind Plus to obtain a license.
The <el-autocomplete> component is a text input that allows users to enter arbitrary values or select from a list of filtered suggestions. It behaves like a native<datalist>, but offers greater control over styling.
The main autocomplete component that manages form integration, filtering, and coordinates with its child components
| | |
| --- | --- |
| CSS variables (Read-only) | |
| --input-width | Provides the width of the input element. |
| --button-width | Provides the width of the button element. |
The options container that handles the popover behavior.
| | |
| --- | --- |
| Attributes | |
| popover | Required to enable the popover behavior. |
| anchor | Configures the way the options are anchored to the button. |
| anchor-strategy | Sets the position CSS property of the popover to eitherabsolute (default) or fixed. |
| CSS variables | |
| --anchor-gap | Sets the gap between the anchor and the popover. |
| --anchor-offset | Sets the distance that the popover should be nudged from its original position. |
| Data attributes (Read-only) | |
| data-closed | Present before transitioning in, and when transitioning out. |
| data-enter | Present when transitioning in. |
| data-leave | Present when transitioning out. |
| data-transition | Present when transitioning in or out. |
| Methods | |
| togglePopover() | Toggles the options visibility. |
| showPopover() | Shows the options. |
| hidePopover() | Hides the options. |
Individual selectable option within the autocomplete.
| | |
| --- | --- |
| Attributes | |
| value | The value of the option (required for selection). |
| disabled | Whether the option is disabled. |
| ARIA attributes (Read-only) | |
| aria-selected | Present when the option is selected. |
To view the complete documentation, you must own a Tailwind Plus license and be signed in .
To view the complete documentation, you must own a Tailwind Plus license and be signed in .
To view the complete documentation, you must own a Tailwind Plus license and be signed in .
To view the complete documentation, you must own a Tailwind Plus license and be signed in .
To view the complete documentation, you must own a Tailwind Plus license and be signed in .