JavaScript файлы в WordPress

Подключение JavaScript файлов в WordPress происходит точно так же, как и подключение CSS файлов (ознакомьтесь со статьёй "CSS файлы в WordPress"). То есть через специальные функции. Рассмотрим часть из них в этой статье.
Можно подключать JS файлы через тег script, но тогда будет невозможно использовать некоторые инструменты. К примеру, плагины для минификации JS кода или объединения JS файлов в один. Поэтому метод подключения JS файлов через PHP функции WordPress более предпочтителен.
wp_register_script - регистрирует JS файл в WordPress. После чего файл вставляется в документ через функции "wp_head" или "wp_footer" или с помощью функции wp_enqueue_script.
wp_register_script( $handle, $src, $deps, $ver, $in_footer );
$handle строка Идентификатор (уникальное название). К примеру, название подключаемого JS файла (в нижнем регистре).
$src строка Путь к файлу JS. Лучше использовать относительные пути (функции "plugins_url()" для плагинов и "get_template_directory_uri()" для тем)
$deps массив Массив идентификаторов всех зарегистрированных JS файлов, которые будут подключены до этого.
$ver строка/логический Версия, которая добавляется в конец URL через параметр, к примеру, "script.js?ver=5.2.4. Если не указана, то используется версия WordPress.
$in_footer логический Место вывода JS скрипта: head или footer. Если параметр равен true (по умолчанию - false), то скрипт будет добавлен в конец тега "body", но при этом должен существовать вызов функции "wp_footer".
wp_deregister_script - снимает регистрацию скрипта и не даёт ему выводиться.
wp_deregister_script( $handle );
$handle строка Идентификатор (уникальное название). К примеру, название подключаемого файла скрипта (в нижнем регистре).
wp_dequeue_script - убирает JS скрипт из вывода, но не удаляет из зарегистрированных.
wp_dequeue_script( $handle );
$handle строка Идентификатор (уникальное название). К примеру, название подключаемого JS файла (в нижнем регистре).
wp_script_is - показывает был ли JS файл зарегистрирован, добавлен в очередь на вывод или уже выведен.
wp_script_is( $handle, $list );
$handle строка Идентификатор (уникальное название). К примеру, название подключаемого JS файла (в нижнем регистре).
$list строка Проверяемое условие. Возможные значения:
registered - файл был зарегистрирован, используя wp_register_script().
enqueued или queue - скрипты были добавлены в очередь.
to_do - скрипты еще не выведены на экран.
done - скрипты уже выведены на экран.
wp_add_inline_script - добавляет к выводу файла JS произвольный JS код.
wp_add_inline_script( $handle, $data );
$handle строка Идентификатор (уникальное название). К примеру, название подключаемого JS файла (в нижнем регистре).
$data строка Чистый JS код, который будет добавлен. Не нужно обрамлять в тег "script".
$position строка Определяет место, куда добавлять код: до вывода (значение "before") или после вывода (значение "after").
wp_enqueue_script - регистрирует и добавляет в очередь на вывод JS файл. Функция может быть использована в любом месте документа, а не только в "head" части.
wp_enqueue_script( $handle, $src, $deps, $ver, $media );
$handle строка Идентификатор (уникальное название). К примеру, название подключаемого JS файла (в нижнем регистре).
$src строка Путь к JS файлу. Лучше использовать относительные пути (функции "plugins_url()" для плагинов и "get_template_directory_uri()" для тем)
$deps массив Массив идентификаторов всех зарегистрированных JS файлов, которые будут подключены до этого.
$ver строка/логический Версия, которая добавляется в конец URL через параметр, к примеру, "script.js?ver=5.2.4. Если не указана, то используется версия WordPress.
$in_footer логический Место вывода JS скрипта: head или footer. Если параметр равен "true" (по умолчанию - "false"), то скрипт будет добавлен в конец тега "body", но при этом должен существовать вызов функции "wp_footer".
MouseDC.ru - хостинг, виртуальный хостинг, покупка доменов, проверка доменов, WHOIS, курсы создания сайтов, вебинары по созданию, курсы разработки сайтов, доработка сайтов, сопровождение сайтов, разработка сайтов, техподдержка сайтов
Была ли эта статья полезна? Есть вопрос?
Cмотрите другие статьи: