WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

pt-br:selected

Descrição

Para uso em campos select. Compara dois valores (por exemplo, uma opção salva e uma escolhida dentro do formulário) e, se forem iguais, adiciona o atributo selected à tag option.

Uso

<?php selected( $selected, $current, $echo); ?>

Parâmetros

$selected
(mixed) (required) O valor recebido que será comparado.
Default: None
$current
(mixed) (optional) O segundo valor.
Default: true
$echo
(boolean) (optional) Define se o retorno será impresso ou não.
Default: true

Retorno

(string) 
O atributo HTML selected='selected' ou uma string vazia.

Exemplo

<!-- Testando os valores com if() -->
<select name="options[foo]">
    <option value="1" <?php if ( $options['foo'] == 1 ) echo 'selected="selected"'; ?>>1</option>
    <option value="2" <?php if ( $options['foo'] == 2 ) echo 'selected="selected"'; ?>>2</option>
    <option value="3" <?php if ( $options['foo'] == 3 ) echo 'selected="selected"'; ?>>3</option>
</select>
 
<!-- Usando selected() -->
<select name="options[foo]">
    <option value="1" <?php selected( $options['foo'], 1 ); ?>>1</option>
    <option value="2" <?php selected( $options['foo'], 2 ); ?>>2</option>
    <option value="3" <?php selected( $options['foo'], 3 ); ?>>3</option>
</select>

Changelog

Since: 1.0

Arquivo fonte

A função selected() está localizada em wp-includes/general-template.php.

Relacionados

checked(), disabled()