checked()
Використовується у checkbox та radio полях форми. Зроблено для зручності, перевіряє два значення і якщо вони збігаються виводить атрибут checked='checked'для поточного поля форми.
Це з функцій-помічників для форм: checked(), wp_readonly() .
На початку рядка є пробіл: “checked=’checked'” .
При порівнянні значень вони попередньо наводяться до одного типу (рядок), а потім порівнюються:
(string) $one === (string) $two
Таким чином не точний збіг все одно спрацьовуватиме, наприклад:
- число
1дорівнюватиме рядку'1'. trueбуде одно1або'1'.falseбуде одно0або'0'.- і т.д.
Працює на основі:
__checked_selected_helper()
__checked_selected_helper()
1 раз – 0.000001 сек
(швидкість світла) | 50000 разів – 0.01 сек
(швидкість світла) |
PHP 7.3.12, WP 5.3.2
(швидкість світла) | 50000 разів – 0.01 сек
(швидкість світла) |
PHP 7.3.12, WP 5.3.2
Хуків немає.
Повертає
Строку. Виводить на екран:
checked='checked'– коли передані значення рівні між собою''(порожній рядок) – коли передані значення не дорівнюють.
Якщо третій параметр ($echo) встановити в false, функція нічого не виведе на екран.
Використання
<?php checked($checked, $current, $echo); ?>
-
$checked
(рядок/число/логічний) (обов’язковий) - Перше з порівнюваних значень.
-
$current
(рядок/число/логічний) -
Друге з порівнюваних значень. Заповнювати не обов’язково, потрібно просто перевірити наявність першого параметра.
Типово: true -
$echo
(логічний) -
Виводити результат на екран (true) чи повертати для обробки (false).
Типово: true
Приклади
#1 Демонстрація використання
Дивіться, що виводить функція в залежності від введення різних параметрів.
checked( 1 ); // checked='checked'
checked(0); // ''
checked('1'); // checked='checked'
checked('0'); // ''
checked (true); // checked='checked'
checked (false); // ''
checked( 1, '1'); // checked='checked'
checked (true, '1'); // checked='checked'
checked (true, 'str'); // ''
checked(2); // ''
checked('str'); // ''
checked (array ()); // ''
checked (array (true)); // ''
checked (array (1)); // ''#2 Приклад використання checked() у коді
<?php
// Отримаємо опцію з бази даних. Значення налаштування - це масив.
$option = get_option('slug_option');
// Отримаємо значення необхідної нам опції
$checked = $option['self-destruct']; // очікується що тут або true або 1
?>
<input name="slug_option[self-destruct]" value="1"<?php checked( $checked ); ?>/>#3 Порівняємо виведення PHP і за допомогою checked()
Варіант з if() :
<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.0.0 | Введено. |
Код checked() checked WP 6.0.2
function checked( $checked, $current = true, $echo = true ) {
return __checked_selected_helper( $checked, $current, $echo, 'checked' );
}