Документация WordPress

wp_add_inline_script

Функция wp_add_inline_script в WordPress используется для добавления встроенного JavaScript-кода непосредственно после скрипта, который уже был зарегистрирован или поставлен в очередь для загрузки. Функция нужна, когда необходимо добавить небольшой кусок JavaScript-кода, зависящий от конкретного скрипта, и гарантировать, что этот код будет загружен сразу после основного скрипта.

wp_add_inline_script( $handle, $data, $position = 'after' );

  • $handle (строка, обязательный): Уникальный идентификатор (handle) скрипта, после которого нужно вставить встроенный код.
  • $data (строка, обязательный): JavaScript-код, который нужно вставить.
  • $position (строка, необязательный): Позиция, где должен быть вставлен код относительно основного скрипта. Возможные значения:
    • 'after' (по умолчанию) — вставить код после основного скрипта.
    • 'before' — вставить код перед основным скриптом.

Пример работы функции

  1. Добавление встроенного скрипта после основного скрипта:

В этом примере мы регистрируем и ставим в очередь основной скрипт my-script.js, затем добавляем встроенный JavaScript-код, который выводит сообщение в консоль браузера, сразу после основного скрипта.

  1. Добавление встроенного скрипта перед основным скриптом:

В этом примере встроенный скрипт, который определяет переменную myVar, будет добавлен перед загрузкой основного скрипта.

Подробное объяснение

  • $handle: Этот параметр связывает встроенный скрипт с определенным зарегистрированным скриптом. Это гарантирует, что встроенный код будет загружен только при загрузке указанного основного скрипта.
  • $data: Здесь указывается сам JavaScript-код, который будет встроен. Код может быть любым, от простого объявления переменной до сложного функционала.
  • $position: Определяет, где именно будет вставлен код относительно основного скрипта. Обычно используется значение 'after', но если необходимо, можно вставить код и перед основным скриптом, указав 'before'.

Функция wp_add_inline_script нужна, когда необходимо добавить динамический или специфичный JavaScript-код, который должен быть загружен вместе с определенным скриптом. Это может быть важно в плагинах и темах, когда требуется подключить небольшие скрипты или конфигурации, которые зависят от основного JavaScript-файла.

Функция wp_add_inline_script отличный инструмент для управления JavaScript-кодом в WordPress. Она позволяет эффективно добавлять встроенные скрипты, обеспечивая их правильное подключение и исполнение в нужный момент. Это особенно важно для сайтов, где требуется высокая степень кастомизации и точное управление порядком загрузки скриптов.

theme

Функции WordPress