YUI Library Examples: Button Control: Checkbox Buttons
Button Control: Checkbox Buttons
This example demonstrates different ways to create a Button that functions like an HTML checkbox (<input type="checkbox"/>).
Creating Checkbox Buttons
A Checkbox Button can be instantiated three different ways:
- Using an existing
<input type="checkbox"/>element - Using pre-defined Button Control HTML
- Using no existing HTML
Using an existing <input type="checkbox"/> element
A Checkbox Button can be created using an existing <input type="checkbox"/> 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.
| 1 | <input id="checkbutton1" type="checkbox" name="checkboxfield1" value="1" checked> |
| view plain | print | ? |
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.
| 1 | var oCheckButton1 = new YAHOO.widget.Button("checkbutton1", { label:"One" }); |
| view plain | print | ? |
Using pre-defined Button Control HTML
A Checkbox Button can also be instantiated using pre-defined Button Control HTML: An element with a class of "yui-button" and "yui-checkbox-button" containing a element with a class of "first-child" containing a <button/> element:
| 1 | <span id="checkbutton5" class="yui-button yui-checkbox-button"> |
| 2 | <span class="first-child"> |
| 3 | <button type="button" name="checkboxfield2">One</button> |
| 4 | </span> |
| 5 | </span> |
| view plain | print | ? |
To instantiate a Checkbox Button using the Button Control HTML, pass the id of the Button's root element (the element with the classes "yui-button" and "yui-checkbox-button" applied) as the first argument to constructor and any additional configuration attributes as the second argument via an object literal.
| 1 | var oCheckButton5 = new YAHOO.widget.Button("checkbutton5", { |
| 2 | type:"checkbox", |
| 3 | value:"1", |
| 4 | checked:true }); |
| view plain | print | ? |
Using no existing HTML
To build a Checkbox Button without any existing HTML, pass a set of configuration attributes as a single argument to the constructor using an object literal.
| 1 | var oCheckButton9 = new YAHOO.widget.Button({ |
| 2 | type: "checkbox", |
| 3 | label: "One", |
| 4 | id: "checkbutton9", |
| 5 | name: "checkboxfield3", |
| 6 | value: "1", |
| 7 | container: "checkboxbuttonsfromjavascript", |
| 8 | checked: true }); |
| view plain | print | ? |
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.
Configuration for This Example
You can load the necessary JavaScript and CSS for this example from Yahoo's servers. Click here to load the YUI Dependency Configurator with all of this example's dependencies preconfigured.
YUI Logger Output:
Logger Console
INFO 233ms (+1) 9:08:16 PM:
Button checkbutton8
Initialization completed.
INFO 232ms (+0) 9:08:16 PM:
Button null
Setting attribute "name" using source element's attribute value of "checkboxfield2"
INFO 232ms (+0) 9:08:16 PM:
Button null
Building the button using an existing HTML element as a source element.
INFO 232ms (+0) 9:08:16 PM:
Button checkbutton7
Initialization completed.
INFO 232ms (+0) 9:08:16 PM:
Button null
Setting attribute "name" using source element's attribute value of "checkboxfield2"
INFO 232ms (+0) 9:08:16 PM:
Button null
Building the button using an existing HTML element as a source element.
INFO 232ms (+0) 9:08:16 PM:
Button checkbutton6
Initialization completed.
INFO 232ms (+0) 9:08:16 PM:
Button null
Setting attribute "name" using source element's attribute value of "checkboxfield2"
INFO 232ms (+1) 9:08:16 PM:
Button null
Building the button using an existing HTML element as a source element.
INFO 231ms (+0) 9:08:16 PM:
Button checkbutton5
Initialization completed.
INFO 231ms (+0) 9:08:16 PM:
Button null
Setting attribute "name" using source element's attribute value of "checkboxfield2"
INFO 231ms (+0) 9:08:16 PM:
Button null
Building the button using an existing HTML element as a source element.
INFO 231ms (+1) 9:08:16 PM:
Button checkbutton4
Initialization completed.
INFO 230ms (+0) 9:08:16 PM:
Button null
Source element could not be used as is. Creating a new HTML element for the button.
INFO 230ms (+0) 9:08:16 PM:
Button null
Setting attribute "value" using source element's attribute value of "4"
INFO 230ms (+0) 9:08:16 PM:
Button null
Setting attribute "name" using source element's attribute value of "checkboxfield1"
INFO 230ms (+0) 9:08:16 PM:
Button null
Setting attribute "type" using source element's attribute value of "checkbox"
INFO 230ms (+0) 9:08:16 PM:
Button null
Building the button using an existing HTML element as a source element.
INFO 230ms (+0) 9:08:16 PM:
Button checkbutton3
Initialization completed.
INFO 230ms (+1) 9:08:16 PM:
Button null
Source element could not be used as is. Creating a new HTML element for the button.
INFO 229ms (+0) 9:08:16 PM:
Button null
Setting attribute "value" using source element's attribute value of "3"
INFO 229ms (+0) 9:08:16 PM:
Button null
Setting attribute "name" using source element's attribute value of "checkboxfield1"
INFO 229ms (+0) 9:08:16 PM:
Button null
Setting attribute "type" using source element's attribute value of "checkbox"
INFO 229ms (+0) 9:08:16 PM:
Button null
Building the button using an existing HTML element as a source element.
INFO 229ms (+0) 9:08:16 PM:
Button checkbutton2
Initialization completed.
INFO 229ms (+0) 9:08:16 PM:
Button null
Source element could not be used as is. Creating a new HTML element for the button.
INFO 229ms (+0) 9:08:16 PM:
Button null
Setting attribute "value" using source element's attribute value of "2"
INFO 229ms (+0) 9:08:16 PM:
Button null
Setting attribute "name" using source element's attribute value of "checkboxfield1"
INFO 229ms (+0) 9:08:16 PM:
Button null
Setting attribute "type" using source element's attribute value of "checkbox"
INFO 229ms (+0) 9:08:16 PM:
Button null
Building the button using an existing HTML element as a source element.
INFO 229ms (+1) 9:08:16 PM:
Button checkbutton1
Initialization completed.
INFO 228ms (+0) 9:08:16 PM:
Button null
Source element could not be used as is. Creating a new HTML element for the button.
INFO 228ms (+0) 9:08:16 PM:
Button null
Setting attribute "value" using source element's attribute value of "1"
INFO 228ms (+0) 9:08:16 PM:
Button null
Setting attribute "name" using source element's attribute value of "checkboxfield1"
INFO 228ms (+0) 9:08:16 PM:
Button null
Setting attribute "type" using source element's attribute value of "checkbox"
INFO 228ms (+1) 9:08:16 PM:
Button null
Building the button using an existing HTML element as a source element.
INFO 227ms (+1) 9:08:16 PM:
Button loggerLink
Initialization completed.
INFO 226ms (+0) 9:08:16 PM:
Button null
Setting attribute "href" using source element's attribute value of "btn_example03.html"
INFO 226ms (+19) 9:08:16 PM:
Button null
Building the button using an existing HTML element as a source element.
INFO 207ms (+37) 9:08:16 PM:
LogReader instance0
LogReader initialized
INFO 170ms (+0) 9:08:16 PM:
Button checkbutton12
Initialization completed.
INFO 170ms (+0) 9:08:16 PM:
Button null
No source HTML element. Building the button using the set of configuration attributes.
INFO 170ms (+0) 9:08:16 PM:
Button checkbutton11
Initialization completed.
INFO 170ms (+0) 9:08:16 PM:
Button null
No source HTML element. Building the button using the set of configuration attributes.
INFO 170ms (+1) 9:08:16 PM:
Button checkbutton10
Initialization completed.
INFO 169ms (+0) 9:08:16 PM:
Button null
No source HTML element. Building the button using the set of configuration attributes.
INFO 169ms (+3) 9:08:16 PM:
Button checkbutton9
Initialization completed.
INFO 166ms (+166) 9:08:16 PM:
Button null
No source HTML element. Building the button using the set of configuration attributes.
INFO 0ms (+0) 9:08:15 PM:
global
Logger initialized
Note: You are viewing this example in debug mode with logging enabled. This can significantly slow performance.
Button Control Examples:
- Push Buttons
- Link Buttons
- Checkbox Buttons
- Radio Buttons
- Submit Buttons
- Reset Buttons
- Menu Buttons
- Split Buttons
- Simple Calendar Menu Button
- Calendar Menu Button with Date on Button Face
- Color Picker Button
- Fixed Width Menu Button
- Glowing Button
- Slider Button
- Using the Button ARIA Plugin
- Using A Menu Button To Replace A <select> Element
- Replacing the content of a Button's Menu
- Combobox, with CSS for Multiple Stacked Instances (included with examples for AutoComplete Control)
- Showing, Hiding, and Reordering Columns. (included with examples for DataTable Control)
- Getting CSS Style Sheets (included with examples for Get Utility)
- Complex Application (included with examples for Layout Manager)
More Button Control Resources:
- User's Guide (external)
- API Documentation
- Cheat Sheet PDF (external)
- Yahoo! UI Library
- Home (external)
- YUIBlog (external)
- YUI Discussion Forum (external)
- YUI on GitHub
- API Documentation
- Functional Examples
- YUI Theater (external)
- YUI License (external)
- YUI Functional Examples
- Animation
- AutoComplete
- Browser History Manager
- Button
- Calendar
- Carousel
- Charts
- Color Picker
- Cookie
- Connection Manager
- Container
- DataTable
- Dom
- Drag & Drop
- Event
- Get
- ImageCropper
- ImageLoader
- JSON
- Layout Manager
- Logger
- Menu
- Paginator
- Profiler
- ProfilerViewer
- ProgressBar
- Resize
- Rich Text Editor
- Selector
- Slider
- Storage
- SWF
- SWFStore
- Stylesheet
- TabView
- TreeView
- Uploader (experimental)
- YAHOO Global Object
- YUI Loader
- YUI Test
- Reset CSS
- Base CSS
- Fonts CSS
- Grids CSS
- YUI Articles on the YUI Website
- YUI FAQ (external)
- Graded Browser Support (external)
- Bug Reports/Feature Requests (external)
- Serving YUI Files from Yahoo! (external)
- Security Best Practices (external)
Copyright © 2010 Yahoo! Inc. All rights reserved.
Privacy Policy - Terms of Service - Copyright Policy - Job Openings