Shows text over an input that disappears when the user clicks into it. The text remains hidden if the user adds a value.

• Online Tutorial/Demo

• Options, Events, Class.Binds

new OverText(input[, options]);

1. input - (mixed) a DOM Element (or its id) that should receive the hover text
2. options - (object, optional) a key/value set of options

• positionOptions - (object) data passed to Element.position
• poll - (boolean) whether to periodically re-evaluate the input to set their overtext element's position and visibility (useful for login in fields that are often populated by remembered usernames and passwords by the browser); defaults to false.
• pollInterval - (integer) the duration between polling in milliseconds; defaults to 250

• onTextHide - (function) callback fired when an overtext element is hidden (passed the overtext element and the input element as arguments)
• onTextShow - (function) callback fired when an overtext element is shown (passed the overtext element and the input element as arguments)

Hides the overtext element for a given input.

myOverText.hide();

• (object) - This instance of OverText

Shows the overtext element for a given input.

myOverText.show();

• (object) - This instance of OverText

Focuses the input and hides the overtext.

• (object) - This instance of OverText

Repositions the overtext element over a the input.

myOverText.reposition();

• (object) - This instance of OverText

Begins repeatedly polling the input to position and show (or hide) the over text. Useful for login fields that are often autofilled by browsers.

• (object) - This instance of OverText

Cancels the polling of the input.

• (object) - This instance of OverText

This method calls OverText.reposition for all running instances of OverText. This allows you to manually re-assert the positioning and visibility of all the OverTexts on the page.

OverText.update();

This method is NOT a method on the instance. Rather it is on the namespace. So:

var myOverText_1 = new OverText(...);
var myOverText_2 = new OverText(...);
//...later
OverText.update(); //updates all the instances of OverText

• nothing

Extends the native Element object with a reference to its OverText instance.

myInput.retrieve('OverText'); //the instance of OverText for the element