In order to access this site you need to enable JavaScript!

You are here: Reference > HTML > tags > input:checkbox

input:checkbox element

Browser support:

Creates a check box control.

The checkbox element allows the user to make multiple selections from a number of options. If you want to prohibit multiple selections, use the input:radio element.

This control is one of the form controls.

The state of the control can be submitted to a server if the following conditions are met:

A form element must contain the checkbox element.
The action attribute of the container form must be set to the URL of the server.
The name attribute of the check box must be specified and non-empty.

If the control is in checked state when the container form is submitted, the name of the check box is sent with the value of the value attribute. If the control is not checked, no information belonging to the check box is sent with the form. The default value of the value attribute is 'on' for check boxes, but the attribute is writable. Therefore, it is generally better not to use the 'on' constant value on the server side to examine the state of the check box. Check for only the existence of the parameter specified by the name of the checkbox and do not use its value.

If you want to see the HTML tags by categories, please visit this page.

This element cannot have a closing tag.

JavaScript page for this element: input:checkbox.

Possible members:

Attributes

Events

Styles

Pseudos

accessKey

Sets an access key to an element.

CHECKED

Specifies the initial state of a check box or a radio button.

class

Sets the style class or classes that belong to the element.

contentEditable

	3

Sets whether the contents of the object are editable.

dir

Sets the text direction as related to the lang attribute.

DISABLED

Sets the state of an object for user interaction.

HIDEFOCUS

Specifies whether a dotted rectangle (focus rectangle) is drawn around an object while it has focus.

hSpace

Specifies the number of pixels to use as a margin at the left and right sides of the object.

Sets a unique identifier for the object.

lang

Specifies the language of the element.

language

Sets the scripting language for the current element. Use it only for the script element.

name

Sets the name of a form control that affects the contents of the message submitted to the server.

size

Specifies the width of a control, in characters.

style

Sets an inline style associated with an element.

tabIndex

Specifies the tabbing order for keyboard navigation using the TAB key.

title

Specifies a tooltip for an element.

type

Sets the type of the input element.

value

Specifies the initial value for a control element.

vSpace

Specifies the number of pixels to use as a margin at the top and bottom sides of an object.

onActivate

Occurs when an element becomes active.

onBeforeActivate

Occurs before an element becomes active.

onBeforeCopy

Occurs before the selection is copied to the clipboard and before the oncopy event.

onBeforeCut

Occurs before the selection is cut from the document and provides a possibility to enable the Cut menu item.

onBeforeDeActivate

Occurs on the active element before it loses the active state.

onBeforeEditFocus

Occurs before an input:file, input:password, input:text or textarea element or an element in an editable region becomes a UI-activated.

onBeforePaste

Occurs before the contents of the clipboard are pasted into the document and provides a possibility to enable the Paste menu item.

onBlur

Occurs when an element loses focus.

onChange

Occurs when the selection, the checked state or the contents of an element have changed. In some cases, it only occurs when the element loses the focus.

onClick

Occurs when the user clicks on an element.

onContextMenu

Occurs when the right mouse button is clicked on an element and the context menu is shown.

onControlSelect

Occurs before a control is selected in an editable region.

onCopy

Occurs before the selection is copied to the clipboard.

onCut

Occurs before the selection is cut from the document and added to the clipboard.

onDblClick

Occurs when the user double clicks on an element.

onDeActivate

Occurs on the active element when it loses the active state.

onDrag

	3

Occurs periodically on the source element during the drag operation.

onDragEnd

	3

Occurs on the source element when the user has finished the drag operation.

onDragEnter

Occurs on an element when the user moves the mouse pointer into it during a drag operation.

onDragLeave

	3.5

Occurs on an element when the user moves the mouse pointer out of it during a drag operation.

onDragOver

Occurs periodically on an element while the mouse pointer is over it during a drag operation.

onDragStart

	3.5

Occurs on the source element when the user starts the drag operation.

onDrop

	3.5

Occurs on a possible target element when the dragged data is dropped on it.

onFilterChange

Occurs after a filter has changed or finished a transition.

onFocus

Occurs when an element receives focus.

onFocusIn

Occurs before an element receives focus.

onFocusOut

Occurs after an element loses focus.

onHelp

Occurs after the user has pressed the F1 key.

onInput

9

Occurs when the text content of an element is changed through the user interface.

onKeyDown

Occurs on an element that has the focus when a key is pressed down and occurs periodically until the key is released.

onKeyPress

Occurs on an element that has the focus when a key is pressed down and occurs periodically until the key is released.

onKeyUp

Occurs on an element that has the focus when the user releases a key.

onLoseCapture

Occurs when the object loses the mouse capture.

onMouseDown

Occurs when the user presses a mouse button over an element.

onMouseEnter

Occurs when the user moves the mouse pointer into the area of an element.

onMouseLeave

Occurs when the user moves the mouse pointer out of the element.

onMouseMove

Occurs when the user moves the mouse over the element.

onMouseOut

Occurs when the user moves the mouse pointer out of the element.

onMouseOver

Occurs when the user moves the mouse pointer into the element.

onMouseUp

Occurs when the user releases a mouse button over an element.

onMouseWheel

Occurs when the mouse wheel rolls.

onMove

Occurs when the position of an element's top-left corner is changed.

onMoveEnd

Occurs when the user stops dragging an absolute or relative positioned element in an editable region.

onMoveStart

Occurs when the user starts dragging an absolute or relative positioned element in an editable region.

onPaste

Occurs before the contents of the clipboard are pasted into the document.

onPropertyChange

Occurs every time when the value of an element's property is changed.

onReadyStateChange

Occurs when the load state of the data that belongs to an element or a HTML document changes.

onResize

Occurs when the size of an object has changed.

onResizeEnd

Occurs when the user stops resizing an element in an editable region.

onResizeStart

Occurs when the user starts to resize an element in an editable region.

onSelectStart

Occurs at the start of a selection process.

-moz-background-clip

Sets which part of background is visible.

-moz-background-inline-policy

Specifies how the background-image of an inline element is determined when the contents of the inline element wrap onto multiple lines.

-moz-background-origin

Specifies how the background-position property is determined, i.e. it defines the reference point that the background-image is relative to.

-moz-binding

Sets the URL of the XBL (Extensible Binding Language) file containing the binding.

-moz-border-bottom-colors

Sets the border colors for the bottom edge. You can specify as many color values as you want. All specified colors will appear as a 1px thick line.

-moz-border-end

Specifies the color, style and width properties for the end of the element's border, in a shorthand form. Use the border-left property instead.

-moz-border-end-color

Sets the color of the element's border end. Use the border-left-color property instead.

-moz-border-end-style

Sets the style of the element's border end. Use the border-left-style property instead.

-moz-border-end-width

Sets the width of the element's border end. Use the border-left-width property instead.

-moz-border-image

	3.5

Specifies an image to use as the border of the element. The image is sliced into 9 pieces along the four diagonals specified with the length units.

-moz-border-left-colors

Sets the border colors for the left edge. You can specify as many color values as you want. All specified colors will appear as a 1px thick line.

-moz-border-radius

Sets the rounding of the corners of the border.

-moz-border-radius-bottomleft

Sets the rounding of the lower left corner of the border.

-moz-border-radius-bottomright

Sets the rounding of the lower right corner of the border.

-moz-border-radius-topleft

Sets the rounding of the upper left corner of the border.

-moz-border-radius-topright

Sets the rounding of the upper right corner of the border.

-moz-border-right-colors

Sets the border colors for the right edge. You can specify as many color values as you want. All specified colors will appear as a 1px thick line.

-moz-border-start

Specifies the color, style and width properties for the start of the element's border. Use the border-right property instead.

-moz-border-start-color

Specifies the color of the element's border start. Use the border-right-color property instead.

-moz-border-start-style

Specifies the style of the element's border start. Use the border-right-style property instead.

-moz-border-start-width

Specifies the width of the element's border start. Use the border-right-width property instead.

-moz-border-top-colors

Sets the border colors for the top edge. You can specify as many color values as you want. All specified colors will appear as a 1px thick line.

-moz-float-edge

Specifies whether the height and width properties of the element include the margin, border, or padding thickness.

-moz-margin-end

Specifies the width of the left or the right margin, depends on the writing direction.

-moz-margin-start

Specifies the width of the left or the right margin, depends on the writing direction.

-moz-opacity

Sets the opacity level. For a cross-browser solution, use the opacity property in Firefox, Google Chrome, Safari and Opera, and the filter property ('filter:Alpha(opacity=50)') in Internet Explorer.

-moz-outline


	3.6

Sets the outline of the element.

-moz-outline-color


	3.6

Sets the color of the outline.

-moz-outline-offset


	3.6

Sets the amount of space between the outline and the border or the edge of the element.

-moz-outline-radius

Sets the rounding of the outline corners.

-moz-outline-radius-bottomleft

Sets the rounding of the lower left outline corner.

-moz-outline-radius-bottomright

Sets the rounding of the lower right outline corner.

-moz-outline-radius-topleft

Sets the rounding of the upper left outline corner.

-moz-outline-radius-topright

Sets the rounding of the upper right outline corner.

-moz-outline-style


	3.6

Sets the style of the left, right, top, and bottom borders of the object.

-moz-outline-width


	3.6

Sets the width of the outline.

-moz-padding-end

Specifies the space between an element's left or right border and its contents, depending on the writing direction.

-moz-padding-start

Specifies the space between an element's left or right border and its contents, depending on the writing direction.

-moz-transform

Specifies the two-dimensional linear transformation applied to an element. The origin of the transformation is specified by the -moz-transform-origin property.

-moz-transform-origin

Specifies the origin of two-dimensional linear transformations specified with the -moz-transform property.

-o-background-size

Sets the size of the background image.

-webkit-appearance

Specifies theme rendering mode for an element. Allows you to make an element look like a standard user interface element.

-webkit-background-clip

Sets which part of background is visible.

-webkit-background-composite

Sets the compositing style for an element's background image and color.

-webkit-background-origin

Specifies how the background-position property is determined, ergo it defines the reference point that the background-image is relative to.

-webkit-background-size

Sets the size of the background image.

-webkit-border-bottom-left-radius

Sets the rounding of the lower left corner of the border.

-webkit-border-bottom-right-radius

Sets the rounding of the lower right corner of the border.

-webkit-border-horizontal-spacing

Specifies the amount of horizontal space between cells in a table.

-webkit-border-image

Specifies an image to use as the border of the element. The image is sliced into 9 pieces along the four diagonals specified with the length units.

-webkit-border-radius

Sets the rounding of the corners of the border.

-webkit-border-top-left-radius

Sets the rounding of the upper left corner of the border.

-webkit-border-top-right-radius

Sets the rounding of the upper right corner of the border.

-webkit-border-vertical-spacing

Specifies the amount of vertical space between cells in a table.

-webkit-margin-bottom-collapse

Specifies whether the top and bottom margins can be shared between adjacent elements.

-webkit-margin-collapse

Specifies whether the top and bottom margins can be shared between adjacent elements.

-webkit-margin-start

Specifies the width of the left or the right margin, depends on the writing direction.

-webkit-margin-top-collapse

Specifies whether the top and bottom margins can be shared between adjacent elements.

-webkit-padding-start

Specifies the space between an element's left or right border and its contents, depends on the writing direction.

-webkit-transform

Specifies the two-dimensional linear transformation applied to an element. The origin of the transformation is specified by the -moz-transform-origin property.

-webkit-transform-origin

Specifies the origin of the two-dimensional linear transformations specified with the -moz-transform property.

background

Specifies up to five separate background properties, in a shorthand form.

background-attachment

Specifies whether the background-image should scroll with the contents of the object or not.

background-color

Specifies the color to use for the background of the object.

background-image

Specifies the image to use as the background of the object.

background-position

Sets the position of the background-image within the element.

background-position-x

Specifies the horizontal coordinate of the background-image relative to the upper-left corner of the container object.

background-position-y

Specifies the vertical-coordinate of the background-image relative to the upper-left corner of the container object.

background-repeat

Specifies how to tile the background-image relative to the upper-left corner of the container object.

behavior

Sets the URL of a behavior file.

border

Sets up to three separate border properties, in a shorthand form.

border-bottom

Sets the color, style and width properties for the element's bottom border, in a shorthand form.

border-bottom-color

Specifies the color of the element's bottom border.

border-bottom-style

Specifies the style of the element's bottom border.

border-bottom-width

Specifies the width of the element's bottom border.

border-color

Specifies the color of the element's border.

border-left

Specifies the color, style and width properties for the element's left border, in a shorthand form.

border-left-color

Specifies the color of the element's left border.

border-left-style

Specifies the style of the element's left border.

border-left-width

Specifies the width of the element's left border.

border-right

Specifies the color, style and width properties for the element's right border, in a shorthand form.

border-right-color

Specifies the color of the element's right border.

border-right-style

Specifies the style of the element's right border.

border-right-width

Specifies the width of the element's right border.

border-style

Specifies the style of the element's border.

border-top

Specifies the color, style and width properties for the element's top border, in a shorthand form.

border-top-color

Specifies the color of the element's top border.

border-top-style

Specifies the style of the element's top border.

border-top-width

Specifies the width of the element's top border.

border-width

Specifies the width of the element's border.

bottom

Specifies the bottom coordinate of a positioned element.

clip

Specifies which part of a positioned element is visible.

cursor

Specifies the type of cursor to display for the pointing device (mouse).

direction

Specifies the text direction.

display

Specifies the element's display type.

filter

Specifies the filter or collection of filters applied to the object.

float

Specifies the horizontal alignment of the object.

height

Specifies the height of the visible area for an element.

layout-flow

Specifies the flow and direction of the content in an element.

layout-grid

Specifies up to four separate layout-grid properties that specify the layout of text characters.

layout-grid-mode

Specifies whether the text layout grid uses one or two dimensions.

left

Specifies the left coordinate of a positioned element.

margin

Specifies a shorthand property for setting the top, right, bottom and left margins, in that order.

margin-bottom

Specifies the bottom margin of the object.

margin-left

Specifies the left margin of the object.

margin-right

Specifies the right margin of the object.

margin-top

Specifies the top margin of the object.

opacity

9

Sets the transparency level of an element. For Internet Explorer, use filter with 'Alpha(opacity=percent)'.

outline

8

Specifies a shorthand form for all outline properties at once. Outline is a line around an element, but different from the border property.

outline-color

8

Specifies the color for the outline for an element.

outline-offset

Sets the amount of space between the outline and the border or the edge of the element.

outline-style

8

Specifies the style for an element's outline.

outline-width

8

Specifies the width for an element's outline.

padding

Specifies a shorthand property for setting the top, right, bottom and left spaces between an element's border and its contents, in that order.

padding-bottom

Specifies the space between an element's bottom border and its contents.

padding-left

Specifies the space between an element's left border and its contents.

padding-right

Specifies the space between an element's right border and its contents.

padding-top

Specifies the space between an element's top border and its contents.

position

Specifies what type of positioning method is used to render the current element.

right

Specifies the right coordinate of a positioned element.

top

Specifies the top coordinate of a positioned element.

unicode-bidi

Specifies whether the text should be overridden to support multiple languages in the same document. Use with the direction property.

visibility

Specifies whether the element is visible.

width

Specifies the width of the visible area for an element.

z-index

Specifies the stack level of positioned objects.

zoom

Specifies the zoom level of the element's content.

Example HTML code 1:

This example illustrates the use of the check box element:

<form method="post" action="#URL#">
    <input type="checkbox" name="acceptAgreement" id="acceptAgreement" /> 
    <label for="acceptAgreement">I accept the User Agreement and Privacy Policy</label>
    <br /><br />
    <input type="submit" value="Register" />
</form>

Copy Code

Preview

Syntax Highlighter

Did you find this example helpful? yes no

input:radio

External links:

input type='checkbox' element (MSDN)
input type='checkbox' element (Safari Reference Library)
input type='checkbox' element (W3C)

Digg Del.icio.us Reddit Facebook Twitter Diigo

User Contributed Comments

input:checkbox element

Possible members:

Example HTML code 1:

Related pages:

External links:

Post Content