Walker_Nav_Menu{}
Клас ядра WordPress, який генерує HTML-код списку елементів навігаційного меню WordPress.
Дивіться wp_nav_menu() .
Працює на основі:
Walker()
Walker()
Хуки із класу
$walker = новий Walker_Nav_Menu;
$ args = array (
'walker' => $walker,
// ... інші параметри меню
);
wp_nav_menu ($ args);
Методи
- public end_el( &$output, $data_object, $depth = 0, $args = null )
- public end_lvl( &$output, $depth = 0, $args = null )
- public start_el( &$output, $data_object, $depth = 0, $args = null, $current_object_id = 0 )
- public start_lvl( &$output, $depth = 0, $args = null )
Приклади
#1 Приклад Створення HTML-коду для wp_nav_menu()
Приклад розширення класу Walker_Nav_Menu для створення свого довільного HTML коду який виводиться функцією wp_nav_menu() . Наш HTML-код буде написаний спеціально для нашої теми.
Нижче є код свого довільного класу, який будує меню. Він додає глибину меню та парні/непарні CSS класи до елементів меню (обом ul і li):
Щоб не винаходити велосипед, копіюємо код класу Walker_Nav_Menu {} і просто змінюємо його, як нам потрібно.
// свій клас побудови меню:
class My_Walker_Nav_Menu extends Walker_Nav_Menu {
// add classes to ul sub-menus
function start_lvl( &$output, $depth = 0, $args = NULL ) {
// depth dependent classes
$indent = ( $depth > 0 ? str_repeat( "t", $depth ) : ''); //code indent
$display_depth = ($ depth + 1); // because it counts the first submenu as 0
$classes = array(
'sub-menu',
( $display_depth % 2 ? 'menu-odd' : 'menu-even' ),
( $display_depth >=2 ? 'sub-sub-menu' : '' ),
'menu-depth-'. $display_depth
);
$class_names = implode('', $classes);
// build html
$output .= "n" . $indent. '<ul class="' . $class_names . '">' . "n";
}
// add main/sub classes to li's and links
function start_el( &$output, $data_object, $depth = 0, $args = null, $current_object_id = 0 ) {
global $wp_query;
// Зберігає більше script, specific name for use withthis method.
$item = $data_object;
$indent = ( $depth > 0 ? str_repeat( "t", $depth ) : ''); //code indent
// depth dependent classes
$depth_classes = array(
( $depth == 0 ? 'main-menu-item' : 'sub-menu-item' ),
( $depth >=2 ? 'sub-sub-menu-item' : '' ),
( $depth % 2 ? 'menu-item-odd' : 'menu-item-even' ),
'menu-item-depth-'. $depth
);
$depth_class_names = esc_attr( implode( ' ', $depth_classes ) );
// passed classes
$classes = empty( $item->classes )? array() : (array) $item->classes;
$class_names = esc_attr( implode( ' ', apply_filters( 'nav_menu_css_class', array_filter( $classes ), $item ) ) );
// build html
$output.=$indent. '<li id="nav-menu-item-'. $item->ID . '" class="' . $depth_class_names . ' ' . $class_names . '">';
// link attributes
$attributes = ! empty($item->attr_title)? 'title="' . esc_attr( $item->attr_title ) .'"' : '';
$attributes .= ! empty($item->target)? ' target="' . esc_attr( $item->target ) .'"' : '';
$attributes .= ! empty($item->xfn)? ' rel="' . esc_attr( $item->xfn ) .'"' : '';
$attributes .= ! empty($item->url)? ' href="' . esc_attr( $item->url ) .'"' : '';
$attributes .= ' class="menu-link ' . ( $depth > 0 ? 'sub-menu-link' : 'main-menu-link' ) . '"';
$item_output = sprintf( '%1$s<a%2$s>%3$s%4$s%5$s</a>%6$s',
$args->before,
$attributes,
$args->link_before,
apply_filters( 'the_title', $item->title, $item->ID ),
$args->link_after,
$args->after
);
// build html
$output .= apply_filters( 'walker_nav_menu_start_el', $item_output, $item, $depth, $args);
}
}
Тепер, коли клас готовий, використовуємо його функції wp_nav_menu() . Для цього потрібно вказати екземпляр нашого класу у параметрі walker.
function my_nav_menu( $args ) {
$ args = array_merge ([
'container' => 'div',
'container_id' => 'top-navigation-primary',
'container_class' => 'top-navigation',
'menu_class' => 'menu main-menu menu-depth-0 menu-even',
'echo' => false,
'items_wrap' => '<ul id="%1$s" class="%2$s">%3$s</ul>',
'depth' => 10,
'walker' => new My_Walker_Nav_Menu()
], $ args);
echo wp_nav_menu( $args );
}Тепер там, де потрібно виводити меню, використовуємо нашу функцію:
my_nav_menu( [ 'theme_location' => 'navigation_menu_primary' ] );
нотатки
- Дивіться: Walker
список змін
| З версії 3.0.0 | Введено. |