[ Index ] |
PHP Cross Reference of WordPress Trunk (Updated Daily) |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * Functions and filters related to the menus. 4 * 5 * Makes the default WordPress navigation use an HTML structure similar 6 * to the Navigation block. 7 * 8 * @link https://make.wordpress.org/themes/2020/07/06/printing-navigation-block-html-from-a-legacy-menu-in-themes/ 9 * 10 * @package WordPress 11 * @subpackage Twenty_Twenty_One 12 * @since Twenty Twenty-One 1.0 13 */ 14 15 /** 16 * Add a button to top-level menu items that has sub-menus. 17 * An icon is added using CSS depending on the value of aria-expanded. 18 * 19 * @since Twenty Twenty-One 1.0 20 * 21 * @param string $output Nav menu item start element. 22 * @param object $item Nav menu item. 23 * @param int $depth Depth. 24 * @param object $args Nav menu args. 25 * @return string Nav menu item start element. 26 */ 27 function twenty_twenty_one_add_sub_menu_toggle( $output, $item, $depth, $args ) { 28 if ( 0 === $depth && in_array( 'menu-item-has-children', $item->classes, true ) ) { 29 30 // Add toggle button. 31 $output .= '<button class="sub-menu-toggle" aria-expanded="false" onClick="twentytwentyoneExpandSubMenu(this)">'; 32 $output .= '<span class="icon-plus">' . twenty_twenty_one_get_icon_svg( 'ui', 'plus', 18 ) . '</span>'; 33 $output .= '<span class="icon-minus">' . twenty_twenty_one_get_icon_svg( 'ui', 'minus', 18 ) . '</span>'; 34 /* translators: Hidden accessibility text. */ 35 $output .= '<span class="screen-reader-text">' . esc_html__( 'Open menu', 'twentytwentyone' ) . '</span>'; 36 $output .= '</button>'; 37 } 38 return $output; 39 } 40 add_filter( 'walker_nav_menu_start_el', 'twenty_twenty_one_add_sub_menu_toggle', 10, 4 ); 41 42 /** 43 * Detects the social network from a URL and returns the SVG code for its icon. 44 * 45 * @since Twenty Twenty-One 1.0 46 * 47 * @param string $uri Social link. 48 * @param int $size The icon size in pixels. 49 * @return string 50 */ 51 function twenty_twenty_one_get_social_link_svg( $uri, $size = 24 ) { 52 return Twenty_Twenty_One_SVG_Icons::get_social_link_svg( $uri, $size ); 53 } 54 55 /** 56 * Displays SVG icons in the footer navigation. 57 * 58 * @since Twenty Twenty-One 1.0 59 * 60 * @param string $item_output The menu item's starting HTML output. 61 * @param WP_Post $item Menu item data object. 62 * @param int $depth Depth of the menu. Used for padding. 63 * @param stdClass $args An object of wp_nav_menu() arguments. 64 * @return string The menu item output with social icon. 65 */ 66 function twenty_twenty_one_nav_menu_social_icons( $item_output, $item, $depth, $args ) { 67 // Change SVG icon inside social links menu if there is supported URL. 68 if ( 'footer' === $args->theme_location ) { 69 $svg = twenty_twenty_one_get_social_link_svg( $item->url, 24 ); 70 if ( ! empty( $svg ) ) { 71 $item_output = str_replace( $args->link_before, $svg, $item_output ); 72 } 73 } 74 75 return $item_output; 76 } 77 78 add_filter( 'walker_nav_menu_start_el', 'twenty_twenty_one_nav_menu_social_icons', 10, 4 ); 79 80 /** 81 * Filters the arguments for a single nav menu item. 82 * 83 * @since Twenty Twenty-One 1.0 84 * 85 * @param stdClass $args An object of wp_nav_menu() arguments. 86 * @param WP_Post $item Menu item data object. 87 * @param int $depth Depth of menu item. Used for padding. 88 * @return stdClass 89 */ 90 function twenty_twenty_one_add_menu_description_args( $args, $item, $depth ) { 91 if ( '</span>' !== $args->link_after ) { 92 $args->link_after = ''; 93 } 94 95 if ( 0 === $depth && isset( $item->description ) && $item->description ) { 96 // The extra <span> element is here for styling purposes: Allows the description to not be underlined on hover. 97 $args->link_after = '<p class="menu-item-description"><span>' . $item->description . '</span></p>'; 98 } 99 100 return $args; 101 } 102 add_filter( 'nav_menu_item_args', 'twenty_twenty_one_add_menu_description_args', 10, 3 );
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
Generated : Fri May 10 08:20:01 2024 | Cross-referenced by PHPXref |