# Zebra ClearInput  [](https://twitter.com/intent/tweet?text=A+tiny+high-performance+jQuery+plugin+for+enhancing+web+forms+by+allowing+users+to+easily+clear+input+field+values&url=https://github.com/stefangabos/Zebra_ClearInput&via=stefangabos&hashtags=jquery,javascript) *A tiny, high-performance jQuery plugin for enhancing web forms by allowing users to easily clear input field values* [](https://www.npmjs.com/package/zebra_clearinput) [](https://www.npmjs.com/package/zebra_clearinput) [](https://www.npmjs.com/package/zebra_clearinput) [](https://www.jsdelivr.com/package/npm/zebra_clearinput) [](https://github.com/stefangabos/Zebra_ClearInput/blob/master/LICENSE.md) Zebra ClearInput is a lightweight, optimized jQuery plugin that enhances form usability by adding an intuitive clear button to input fields. When users click this button, it instantly erases the input content and returns focus to the field for immediate re-entry. The clear button appears automatically when users start typing and intelligently manages its visibility: it shows immediately on focus or hover, and gracefully hides when the field is empty or loses focus. ## Features - works out of the box with sensible defaults and minimal configuration - optimized performance with event delegation - supports multiple independent instances with isolated namespacing - dynamically handles inputs added after initialization via `update()` method - responsive layout preservation - graceful error handling and memory leak prevention - `destroy()` method for complete cleanup - really tiny - weighs ~2KB uncompressed and ~800 bytes gzipped - works in all modern browsers - Firefox, Chrome, Safari, Edge, Opera ## 🎂 Support the development of this project Your support means a lot and it keeps me motivated to keep working on open source projects.
If you like this project please ⭐ it by clicking on the star button at the top of the page.
If you are feeling generous, you can buy me a coffee by donating through PayPal, or you can become a sponsor.
Either way - **Thank you!** 🎉 [](https://github.com/stefangabos/Zebra_ClearInput) [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=LLXP492Y7VYZJ) [](https://github.com/sponsors/stefangabos) ## Demo See the [demos](https://stefangabos.github.io/Zebra_ClearInput/) ## Requirements Zebra ClearInput has no dependencies other than jQuery 1.7.0+ ## Installation Zebra ClearInput is available as a [npm package](https://www.npmjs.com/package/zebra_clearinput). To install it use: ```bash # the "--save" argument adds the plugin as a dependency in packages.json npm install zebra_clearinput --save ``` ## How to use First, load jQuery from a CDN and provide a fallback to a local source like: ```html ``` Load the Zebra ClearInput jQuery plugin: ```html ``` Alternatively, you can load Zebra ClerInput from [JSDelivr CDN](https://www.jsdelivr.com/package/npm/zebra_clearinput) like this: ```html ``` Load the style sheet file from a local source ```html ``` ...or from [JSDelivr CDN](https://www.jsdelivr.com/package/npm/zebra_clearinput) ```html ``` Now, within the DOM-ready event do ```javascript $(document).ready(function() { // apply to all text input elements new $.Zebra_ClearInput('input[type=text]'); // apply to certain text input elements new $.Zebra_ClearInput('input.myClass'); // apply to all text input elements and // add the default CSS class name for the buttons and a custom one new $.Zebra_ClearInput('input[type="text"]', { button_class_name: 'Zebra_ClearInput myCustomStyles' }); }); ``` ## Configuration options ## Properties

Property	Type	Default	Description
container_class_name	string	Zebra_ClearInput_Container	The CSS class(es) to be applied to the container DIV that will wrap the target text input element
button_class_name	string	Zebra_ClearInput	The CSS class(es) to be applied to the button associated with the text input element
button_content	string	×	The HTML content to display inside the clear button (can be text, HTML entities, or icon markup)
enable_on_password	boolean	false	Whether to enable the clear button on password input fields.
debounce_delay	integer	150	Delay in milliseconds for debouncing keyup events. Reduces show() calls during rapid typing. Set to 0 to disable debouncing.

## Methods ### `destroy()` Removes a previously created instance of the plugin. This method cleans up all event handlers, removes buttons, unwraps containers and clears data attributes. ```javascript // apply to all text input elements var clearInput = new $.Zebra_ClearInput('input[type="text"]'); // remove plugin clearInput.destroy(); ``` ### `update()` Updates the plugin to initialize clear input buttons on dynamically added inputs. This method scans the original selector for any new input elements that weren't present during initial plugin initialization and adds clear buttons to them. ```javascript // apply to all text input elements var clearInput = new $.Zebra_ClearInput('input[type="text"]'); // add new inputs dynamically $('body').append(''); // update to initialize the new inputs clearInput.update(); ``` ## Sponsors Cross browser/device testing is done with [](https://www.browserstack.com/)