Codex

Function Reference/checked

Contents

Description

Compares two given values (for example, a saved option vs. one chosen in a form) and, if the values are the same, adds the checked attribute to the current radio button or checkbox.

This is essentially the same as comparing values with if(), but results in more concise code.

Parameters

$checked
(mixed) (required) One of the values to compare.
Default: None
$current
(mixed) (optional) The other value to compare if not just true.
Default: true
$echo
(boolean) (optional) Whether to echo or just return the string. This function will always return the result regardless.
Default: true

Returns

(string) 
HTML attribute (checked='checked') or empty string.

Usage

Testing the value with if(): 

<input type='checkbox' name='options[postlink]' value='1' <?php if ( 1 == $options['postlink'] ) echo 'checked="checked"'; ?> />

Using checked() instead: 

<input type="checkbox" name="options[postlink]" value="1" <?php checked( $options['postlink'], 1 ); ?> />

Changelog

Since: 1.0

Source File

checked() is located in wp-includes/general-template.php.

Related

selected(), disabled()

Retrieved from "http://codex.wordpress.org/Function_Reference/checked"

Codex Resources