wp_script_is()
Визначає, чи був файл скрипту зареєстрований / доданий у чергу на виведення / виведений на екран.
Функція може стати в нагоді при написанні плагіна, коли потрібно перевірити чи була зроблена вказана дія над зазначеним скриптом. Вона допоможе уникнути конфліктів із підключенням однакових скриптів у різних плагінах.
wp_style_is() — Така сама перевірка для файлу стилів.
(дуже швидко) | 50000 разів – 0.09 сек
(швидкість світла) |
PHP 7.0.5, WP 4.5.2
Хуків немає.
Повертає
true|false. true/false, залежно від цього виконується умова чи ні.
Використання
wp_script_is ($ handle, $ list);
-
$handle
(рядок) (обов’язковий) - Ідентифікатор (назва) скрипта, що перевіряється. У нижньому регістрі.
-
$list
(рядок) Якого роду перевірку проводити. Допускаються такі значення:
registered– Скрипт був зареєстрований через функцію wp_register_script();enqueuedабоqueue– скрипт був доданий у чергу на висновок;done– Скрипт вже оброблений (був виведений на екран);to_do– Скрипт ще не був оброблений (очікує виведення на екран).
За замовчуванням: ‘enqueued’
Приклади
#1 Підключення скрипта з перевіркою
Цей приклад показує як підключити скрипт /js/fluidvids.min.js , попередньо перевіривши, чи цей скрипт вже підключений і доданий в чергу на висновок. Якщо скрипт вже додано до черги, код нічого не зробить. Якщо скрипт ще не доданий, то він буде підключений та доданий у чергу на обробку:
if ( ! wp_script_is( 'fluid_vids', 'enqueued' ) ) {
wp_register_script( 'fluid_vids', plugin_dir_url(__FILE__).'js/fluidvids.min.js');
wp_enqueue_script( 'fluid_vids');
}
список змін
| З версії 2.8.0 | Введено. |
| З версії 3.5.0 | ‘enqueued’ added as alias of the ‘queue’ list. |
Код wp_script_is() wp script is WP 6.0.2
function wp_script_is( $handle, $list = 'enqueued' ) {
_wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle );
return (bool) wp_scripts()->query( $handle, $list );
}