wp_nav_menu_container_allowedtags
Дозволяє доповнити список HTML тегів, які можна вказати в параметрі ‘container’ під час виведення меню функцією wp_nav_menu() . Фільтрує список тегів – контейнерів меню.
Контейнер меню вказується для функції wp_nav_menu() у параметрі container :
wp_nav_menu( array( 'container' => 'div', )));
За промовчанням можна вказати лише теги div і nav. Цей фільтр дозволяє розширити цей перелік.
Використання
add_filter( 'wp_nav_menu_container_allowedtags', 'wp_kama_nav_menu_container_allowedtags_filter'); /** * Function for `wp_nav_menu_container_allowedtags` filter-hook. * * @param string[] $tags Примітні HTML tags для використання як menu containers. * * @return string[] */ function wp_kama_nav_menu_container_allowedtags_filter( $tags ){ // Filter... return $tags; }
-
$tags
(масив) -
Допустимі HTML теги для використання в якості контейнерів меню.
За замовчуванням: використовується масив, що містить ‘div’ та ‘nav’
Приклади
#1 Додамо у вибір допустимих тегів тег section
// Додаємо тег section у набір допустимих тегів для вибору add_filter( 'wp_nav_menu_container_allowedtags', function ( $allowed_tags ) { $allowed_tags[] = 'section'; return $allowed_tags; } ); // Виводимо меню wp_nav_menu([ 'theme_location' => 'mainmenu', 'container' => 'section', ]);
Отримаємо:
<section class="menu-mainmenu-container"> <ul id="menu-mainmenu" class="menu"> <li id="menu-item-268" class="menu-item menu-item-type-post_type menu-item-object-post menu-item-268"> <a href="http://wp-test.ru/2018/03/25/post-105/">Запис 1</a> </li> <li id="menu-item-269" class="menu-item menu-item-type-post_type menu-item-object-post menu-item-269"> <a href="http://wp-test.ru/2018/03/25/post-104/">Запис 2</a> </li> <li id="menu-item-270" class="menu-item menu-item-type-post_type menu-item-object-post menu-item-270"> <a href="http://wp-test.ru/2018/03/25/post-103/">Запис 3</a> </li> </ul> </section>
список змін
З версії 3.0.0 | Введено. |
Де викликається хук
Де використовується хук у WordPress
Використання не знайдено.