wp_nav_menu()

wp_nav_menu( array $args = array() ): void|string|false

<?php
$args = array(
    'menu' => 'primary-menu',
    'menu_class' => 'menu-class',
    'menu_id' => 'menu-id',
    'container' => 'nav',
    'container_class' => 'menu-container',
    'container_id' => 'menu-container-id',
    'container_aria_label' => 'Primary Menu',
    'fallback_cb' => false,
    'before' => '<span>Before</span>',
    'after' => '<span>After</span>',
    'link_before' => '<span>Link Before</span>',
    'link_after' => '<span>Link After</span>',
    'echo' => true,
    'depth' => 0,
    'walker' => new My_Custom_Walker(),
    'theme_location' => 'primary',
    'items_wrap' => '<ul id="%1$s" class="%2$s">%3$s</ul>',
    'item_spacing' => 'preserve'
);
wp_nav_menu( $args );
?>

$args = array(
    'menu' => 'primary-menu',
    'echo' => false
);
$menu = wp_nav_menu($args);
echo $menu;

$args = array(
    'menu' => 'primary-menu',
    'menu_class' => 'custom-menu',
    'menu_id' => 'custom-menu-id',
    'echo' => false
);
$menu = wp_nav_menu($args);
echo $menu;

$args = array(
    'menu' => 'primary-menu',
    'container' => 'nav',
    'echo' => false
);
$menu = wp_nav_menu($args);
echo $menu;

$args = array(
    'menu' => 'primary-menu',
    'container' => 'nav',
    'container_class' => 'custom-container',
    'container_id' => 'custom-container-id',
    'container_aria_label' => 'Primary Menu',
    'echo' => false
);
$menu = wp_nav_menu($args);
echo $menu;

$args = array(
    'menu' => 'primary-menu',
    'fallback_cb' => 'my_custom_menu',
    'echo' => false
);
$menu = wp_nav_menu($args);
echo $menu;
function my_custom_menu() {
    echo 'No menu found.';
}

Вопросы и ответы

Как создать и настроить меню в WordPress?

Для создания и настройки меню в WordPress используется функция wp_nav_menu(). Она позволяет отобразить навигационное меню на сайте.

Для создания меню необходимо передать массив аргументов в функцию wp_nav_menu(). В этом массиве можно указать следующие параметры:

• menu: идентификатор, слаг, название или объект меню.
• menu_class: CSS-класс для элемента ul, который формирует меню. По умолчанию — «menu».
• menu_id: ID, применяемый к элементу ul, который формирует меню. По умолчанию — слаг меню с инкрементом.
• container: обернуть ли элемент ul и каким тегом. По умолчанию — «div».
• container_class: класс, применяемый к контейнеру. По умолчанию — «menu-{slug меню}-container».
• container_id: ID, применяемый к контейнеру.
• container_aria_label: значение атрибута aria-label, применяемого к контейнеру, если он является элементом nav.
• fallback_cb: функция обратного вызова, которая будет вызвана, если меню не существует. По умолчанию — ‘wp_page_menu’. Установите значение false, чтобы отключить резервное меню.
• before: текст перед разметкой ссылки.
• after: текст после разметки ссылки.
• link_before: текст перед текстом ссылки.
• link_after: текст после текста ссылки.
• echo: выводить ли меню или возвращать его. По умолчанию — true.
• depth: количество уровней иерархии, которые должны быть включены. 0 означает все уровни. По умолчанию — 0.
• walker: экземпляр пользовательского класса walker.
• theme_location: местоположение темы, которое будет использоваться. Должно быть зарегистрировано с помощью функции register_nav_menu(), чтобы быть доступным для выбора пользователем.
• items_wrap: как обернуть элементы списка. Использует формат printf() с номерованными заполнителями. По умолчанию — ul с id и классом.
• item_spacing: сохранять ли пробелы в HTML меню. Принимает значения «preserve» или «discard». По умолчанию — «preserve».

Как добавить классы CSS к меню в WordPress?

Для добавления классов CSS к меню в WordPress можно использовать параметры menu_class и container_class функции wp_nav_menu().

Параметр menu_class позволяет указать CSS-класс для элемента ul, который формирует меню. Например, чтобы добавить класс «my-menu» к меню, нужно передать аргумент 'menu_class' => 'my-menu'.

Параметр container_class позволяет указать класс, который будет применен к контейнеру меню. Например, чтобы добавить класс «menu-container» к контейнеру, нужно передать аргумент 'container_class' => 'menu-container'.

Как изменить разметку HTML меню в WordPress?

Для изменения разметки HTML меню в WordPress можно использовать параметр items_wrap функции wp_nav_menu().

Параметр items_wrap позволяет указать, как обернуть элементы списка. Он использует формат printf() с номерованными заполнителями. По умолчанию, меню оборачивается в ul с id и классом. Например, чтобы изменить разметку на div с классом «my-menu», нужно передать аргумент 'items_wrap' => '<div class="my-menu">%3$s</div>'.

Как добавить иконки к пунктам меню в WordPress?

Для добавления иконок к пунктам меню в WordPress с помощью функции wp_nav_menu(), необходимо использовать CSS классы. В параметре menu_class можно указать классы, которые будут применены к элементу ul, формирующему меню. Для добавления иконок к пунктам меню, можно использовать псевдоэлементы ::before или ::after и применить стили к соответствующим классам пунктов меню.

$args = array(
    'menu_class' => 'menu',
);
wp_nav_menu($args);

Как добавить атрибуты aria-label к меню в WordPress?

Для добавления атрибута aria-label к меню в WordPress с помощью функции wp_nav_menu(), необходимо использовать параметр container_aria_label. В этом параметре можно указать значение атрибута aria-label, которое будет применено к контейнеру меню, если он является элементом nav.

$args = array(
    'container_aria_label' => 'Main Menu',
);
wp_nav_menu($args);

Как изменить порядок пунктов меню в WordPress?

Для изменения порядка пунктов меню в WordPress с помощью функции wp_nav_menu(), необходимо использовать параметр menu. В этом параметре можно указать идентификатор, слаг, имя или объект меню, которое будет отображаться. Пункты меню будут отображаться в том порядке, в котором они указаны в меню в административной панели WordPress.

$args = array(
    'menu' => 'main-menu',
);
wp_nav_menu($args);

Как добавить подменю в WordPress?

Для добавления подменю в WordPress с помощью функции wp_nav_menu() необходимо использовать параметр 'theme_location'. Этот параметр позволяет указать местоположение меню, которое будет отображаться. Местоположение меню должно быть зарегистрировано с помощью функции register_nav_menu().

Пример кода:

$args = array(
    'theme_location' => 'primary',
);
wp_nav_menu($args);

Как изменить количество уровней иерархии меню в WordPress?

Для изменения количества уровней иерархии меню в WordPress с помощью функции wp_nav_menu() необходимо использовать параметр 'depth'. Этот параметр позволяет указать количество уровней, которые будут включены в меню.

Пример кода:

$args = array(
    'depth' => 2,
);
wp_nav_menu($args);

Как изменить разделитель между пунктами меню в WordPress?

Для изменения разделителя между пунктами меню в WordPress с помощью функции wp_nav_menu() необходимо использовать параметр 'items_wrap'. Этот параметр позволяет указать, как обернуть элементы списка меню.

Пример кода:

$args = array(
    'items_wrap' => '<ul id="%1$s" class="%2$s">%3$s</ul>',
);
wp_nav_menu($args);

Функция wp_nav_menu() в WordPress позволяет отображать навигационное меню. Она принимает массив аргументов, которые позволяют настроить различные аспекты меню, такие как местоположение, количество уровней иерархии и разделитель между пунктами меню. Функция возвращает либо пустоту, либо строку с HTML-кодом меню, в зависимости от значения параметра 'echo'.