selected()
Виводить рядок ” selected='selected'
“, тобто збігаються два перші параметри функції.
Потрібна для використання у списку <select> , в тезі <option> .
У списках select часто доводиться перевіряти значення і ставити прапор selected
для тієї опції, яка зараз встановлена. Для зручності такої перевірки створено цю функцію.
Це одна з функцій-помічників для форм: wp_readonly() .
При порівнянні значень вони попередньо наводяться до одного типу (рядок), а потім порівнюються:
(string) $one === (string) $two
Таким чином не точний збіг все одно спрацьовуватиме, наприклад:
- число
1
дорівнюватиме рядку'1'
. true
буде одно1
або'1'
.false
буде одно0
або'0'
.- і т.д.
__checked_selected_helper()
Хуків немає.
Повертає
Строку
. Функція виводить на екран selected='selected'
або порожній рядок ''
.
Якщо останній параметр $echo дорівнює false, функція поверне значення, а не виведе на екран.
Використання
selected ($ val1, $ val2, $ echo);
-
$val1
(рядок/число/логічний) (обов’язковий) - Перше значення, яке слід порівняти з другим.
-
$val2
(рядок/число/логічний) -
Друге значення, яке слід порівняти з першим.
Типово: true -
$echo
(логічний) -
Виводити значення на екран (true) чи повернути для обробки (false).
Типово: true
Приклади
#1 Приклад використання selected()
Звичайна перевірка:
<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>
Така сама перевірка з функцією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>
#2 Використання checked()
Звичайна перевірка:
<input type='checkbox' name='options[postlink]' value='1' <?php if ( 1 == $options['postlink'] ) echo 'checked="checked"'; ?> />
З використанням checked() :
<input type="checkbox" name="options[postlink]" value="1" <?php checked( $options['postlink'], 1 ); ?> />
#3 Використання disabled() (з версії 3.0)
<input type="radio" name="attachments" value="<?php echo $value; ?>" <?php disabled( $value, false ); ?> />
Виглядає помітно компактніше.
Рекомендую хороший блог про WordPress: mojwp.ru .
список змін
З версії 1.0.0 | Введено. |
Код selected() selected WP 6.0.2
function selected( $selected, $current = true, $echo = true ) { return __checked_selected_helper( $selected, $current, $echo, 'selected' ); }