mirror of
https://github.com/WordPress/WordPress.git
synced 2024-09-12 07:38:33 +02:00
This aims to provide better context for translators and make it easier to determine that some strings contain hidden accessibility text and are not displayed in the UI. Props kebbet, mercime, pavelevap, ocean90, swissspidy, Chouby, jipmoors, afercia, desrosj, costdev, audrasjb, SergeyBiryukov. Fixes #29748. Built from https://develop.svn.wordpress.org/trunk@55276 git-svn-id: http://core.svn.wordpress.org/trunk@54809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
103 lines
3.6 KiB
PHP
103 lines
3.6 KiB
PHP
<?php
|
|
/**
|
|
* Functions and filters related to the menus.
|
|
*
|
|
* Makes the default WordPress navigation use an HTML structure similar
|
|
* to the Navigation block.
|
|
*
|
|
* @link https://make.wordpress.org/themes/2020/07/06/printing-navigation-block-html-from-a-legacy-menu-in-themes/
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Twenty_Twenty_One
|
|
* @since Twenty Twenty-One 1.0
|
|
*/
|
|
|
|
/**
|
|
* Add a button to top-level menu items that has sub-menus.
|
|
* An icon is added using CSS depending on the value of aria-expanded.
|
|
*
|
|
* @since Twenty Twenty-One 1.0
|
|
*
|
|
* @param string $output Nav menu item start element.
|
|
* @param object $item Nav menu item.
|
|
* @param int $depth Depth.
|
|
* @param object $args Nav menu args.
|
|
* @return string Nav menu item start element.
|
|
*/
|
|
function twenty_twenty_one_add_sub_menu_toggle( $output, $item, $depth, $args ) {
|
|
if ( 0 === $depth && in_array( 'menu-item-has-children', $item->classes, true ) ) {
|
|
|
|
// Add toggle button.
|
|
$output .= '<button class="sub-menu-toggle" aria-expanded="false" onClick="twentytwentyoneExpandSubMenu(this)">';
|
|
$output .= '<span class="icon-plus">' . twenty_twenty_one_get_icon_svg( 'ui', 'plus', 18 ) . '</span>';
|
|
$output .= '<span class="icon-minus">' . twenty_twenty_one_get_icon_svg( 'ui', 'minus', 18 ) . '</span>';
|
|
/* translators: Hidden accessibility text. */
|
|
$output .= '<span class="screen-reader-text">' . esc_html__( 'Open menu', 'twentytwentyone' ) . '</span>';
|
|
$output .= '</button>';
|
|
}
|
|
return $output;
|
|
}
|
|
add_filter( 'walker_nav_menu_start_el', 'twenty_twenty_one_add_sub_menu_toggle', 10, 4 );
|
|
|
|
/**
|
|
* Detects the social network from a URL and returns the SVG code for its icon.
|
|
*
|
|
* @since Twenty Twenty-One 1.0
|
|
*
|
|
* @param string $uri Social link.
|
|
* @param int $size The icon size in pixels.
|
|
* @return string
|
|
*/
|
|
function twenty_twenty_one_get_social_link_svg( $uri, $size = 24 ) {
|
|
return Twenty_Twenty_One_SVG_Icons::get_social_link_svg( $uri, $size );
|
|
}
|
|
|
|
/**
|
|
* Displays SVG icons in the footer navigation.
|
|
*
|
|
* @since Twenty Twenty-One 1.0
|
|
*
|
|
* @param string $item_output The menu item's starting HTML output.
|
|
* @param WP_Post $item Menu item data object.
|
|
* @param int $depth Depth of the menu. Used for padding.
|
|
* @param stdClass $args An object of wp_nav_menu() arguments.
|
|
* @return string The menu item output with social icon.
|
|
*/
|
|
function twenty_twenty_one_nav_menu_social_icons( $item_output, $item, $depth, $args ) {
|
|
// Change SVG icon inside social links menu if there is supported URL.
|
|
if ( 'footer' === $args->theme_location ) {
|
|
$svg = twenty_twenty_one_get_social_link_svg( $item->url, 24 );
|
|
if ( ! empty( $svg ) ) {
|
|
$item_output = str_replace( $args->link_before, $svg, $item_output );
|
|
}
|
|
}
|
|
|
|
return $item_output;
|
|
}
|
|
|
|
add_filter( 'walker_nav_menu_start_el', 'twenty_twenty_one_nav_menu_social_icons', 10, 4 );
|
|
|
|
/**
|
|
* Filters the arguments for a single nav menu item.
|
|
*
|
|
* @since Twenty Twenty-One 1.0
|
|
*
|
|
* @param stdClass $args An object of wp_nav_menu() arguments.
|
|
* @param WP_Post $item Menu item data object.
|
|
* @param int $depth Depth of menu item. Used for padding.
|
|
* @return stdClass
|
|
*/
|
|
function twenty_twenty_one_add_menu_description_args( $args, $item, $depth ) {
|
|
if ( '</span>' !== $args->link_after ) {
|
|
$args->link_after = '';
|
|
}
|
|
|
|
if ( 0 === $depth && isset( $item->description ) && $item->description ) {
|
|
// The extra <span> element is here for styling purposes: Allows the description to not be underlined on hover.
|
|
$args->link_after = '<p class="menu-item-description"><span>' . $item->description . '</span></p>';
|
|
}
|
|
|
|
return $args;
|
|
}
|
|
add_filter( 'nav_menu_item_args', 'twenty_twenty_one_add_menu_description_args', 10, 3 );
|