Creating Reset Buttons

A Reset Button can be instantiated three different ways:

• Using an existing <input type="reset"/> or <button type="reset"/> element
• Using pre-defined Button Control HTML
• Using no existing HTML

Using an existing <input type="reset"/> or <button type="reset"/> element

A Reset Button can be created using an existing <input type="reset"/> or <button type="reset"/> element as a source element, the attributes of which are captured and used for the creation of a new element that replaces the source element inline.

Pass the id of the source element as the first argument to the Button's constructor. Additional configuration attributes for a Button can be set at instantiation time by specifying them in an object literal that is passed as the second argument to the Button's constructor. Note: the value of configuration attributes passed to the Button constructor will trump those of the corresponding HTML attributes of the original source element.

The Button's constructor will look for the existing <input type="reset"/> or <button type="reset"/> element and, once it is found, it will be swapped out for the newly created element via the DOM's replaceChild method.

Using pre-defined Button Control HTML

A Reset Button can also be instantiated using pre-defined Button Control HTML: An element with a class of "yui-button" and "yui-reset-button" containing a element with a class of "first-child" containing either a <input type="reset"/> or <button type="button"/> element:

To instantiate a Reset Button using the Button Control HTML, pass the id of the Button's root element (the element with the classes "yui-button" and "yui-reset-button" applied) as the first argument to constructor and any additional configuration attributes as the second argument via an object literal.

Using no existing HTML

To build a Reset Button without any existing HTML, pass a set of configuration attributes as a single argument to the constructor using an object literal.

In most cases, it is necessary to specify the button's id, type, label and container (the HTML element that the button should be appended to once created). If an id is not specified for the button, one will be generated using the generateId method of the Dom utility. Similarly, if the "type" attribute is omitted, the default type of "button" will be applied.