Функция wp_unique_id() в WordPress генерирует уникальный идентификатор (ID) для использования в течение одного PHP-процесса. Этот идентификатор создается с помощью статической переменной, которая увеличивается при каждом вызове функции. Опционально можно указать префикс, который будет добавлен к ID.
Это аналог функции uniqueId из библиотеки JavaScript Underscore.js, но реализован на PHP.
wp_unique_id( string $prefix = '' ): string
Параметры
$prefix(строка) — Опциональный. Префикс для возвращаемого идентификатора. По умолчанию: пустая строка.
Возвращаемое значение
Функция возвращает уникальную строку, состоящую из префикса (если указан) и уникального целого числа.
Пример 1: Генерация уникальных ID без префикса
Если вызвать wp_unique_id() без указания префикса, функция будет просто возвращать уникальные числовые идентификаторы, которые увеличиваются с каждым вызовом:
echo wp_unique_id(); // Пример результата: 1
echo wp_unique_id(); // Пример результата: 2
echo wp_unique_id(); // Пример результата: 3
Пример 2: Генерация ID с префиксом
Для создания ID с определенным префиксом передайте его в качестве аргумента:
echo wp_unique_id('item_'); // Пример результата: item_4
echo wp_unique_id('field_'); // Пример результата: field_5
echo wp_unique_id('custom_'); // Пример результата: custom_6
Каждое возвращаемое значение будет уникальным в пределах одного PHP-процесса, что удобно для идентификации элементов на странице.
Пример 3: Использование wp_unique_id() для HTML-элементов
Эта функция часто используется для генерации уникальных идентификаторов для элементов HTML, например, связки <label> и <input>. Это особенно полезно в формах для удобства пользователям и доступности интерфейса:
$unique_id = wp_unique_id('input_');
echo sprintf('<label for="%s">Введите значение:</label>', $unique_id);
echo sprintf('<input id="%s" type="text" name="user_input">', $unique_id);
/* Пример HTML результата:
<label for="input_7">Введите значение:</label>
<input id="input_7" type="text" name="user_input">
*/
Пример 4: Генерация ID для элементов JavaScript
Функция также полезна для генерации уникальных идентификаторов при создании динамических элементов через JavaScript:
$button_id = wp_unique_id('button_');
echo sprintf('<button id="%s" onclick="myFunction()">Нажми меня</button>', $button_id);
/* Пример HTML результата:
<button id="button_8" onclick="myFunction()">Нажми меня</button>
*/
Теперь можно с легкостью использовать button_8 в JavaScript для выполнения конкретных действий:
function myFunction() {
alert("Вы нажали кнопку с уникальным ID!");
}Заключение
Функция wp_unique_id() проста в использовании и позволяет легко создавать уникальные идентификаторы, которые можно применять в интерфейсах, HTML-структурах, а также для динамических элементов на страницах WordPress.