Leitgedanken/msd2/wordpress/wp-content/plugins/amp/includes/sanitizers/class-amp-nav-menu-toggle-sanitizer.php
2023-01-23 11:03:31 +01:00

153 lines
4.2 KiB
PHP

<?php
/**
* Class AMP_Nav_Menu_Toggle_Sanitizer
*
* @package AMP
*/
/**
* Class AMP_Nav_Menu_Toggle_Sanitizer
*
* Handles state for navigation menu toggles, based on theme support.
*
* @since 1.1.0
*/
class AMP_Nav_Menu_Toggle_Sanitizer extends AMP_Base_Sanitizer {
/**
* Default args.
*
* @since 1.1.0
* @var array
*/
protected $DEFAULT_ARGS = array(
'nav_container_id' => '',
'nav_container_xpath' => '', // Alternative for 'nav_container_id', if no ID available.
'menu_button_id' => '',
'menu_button_xpath' => '', // Alternative for 'menu_button_id', if no ID available.
'nav_container_toggle_class' => '',
'menu_button_toggle_class' => '', // Optional.
'nav_menu_toggle_state_id' => 'navMenuToggledOn',
);
/**
* XPath.
*
* @since 1.1.0
* @var DOMXPath
*/
protected $xpath;
/**
* AMP_Nav_Menu_Toggle_Sanitizer constructor.
*
* @since 1.1.0
*
* @param DOMDocument $dom DOM.
* @param array $args Args.
*/
public function __construct( $dom, $args = array() ) {
parent::__construct( $dom, $args );
// Ensure the state ID is always set.
if ( empty( $this->args['nav_menu_toggle_state_id'] ) ) {
$this->args['nav_menu_toggle_state_id'] = $this->DEFAULT_ARGS['nav_menu_toggle_state_id'];
}
}
/**
* If supported per the constructor arguments, inject `amp-state` and bind dynamic classes accordingly.
*
* @since 1.1.0
*/
public function sanitize() {
$this->xpath = new DOMXPath( $this->dom );
$nav_el = $this->get_nav_container();
$button_el = $this->get_menu_button();
// If no navigation element or no toggle class provided, bail.
if ( ! $nav_el || empty( $this->args['nav_container_toggle_class'] ) ) {
if ( $button_el ) {
// Remove the button since it won't be used.
$button_el->parentNode->removeChild( $button_el );
}
return;
}
if ( ! $button_el ) {
return;
}
$state_id = 'navMenuToggledOn';
$expanded = false;
$nav_el->setAttribute(
AMP_DOM_Utils::get_amp_bind_placeholder_prefix() . 'class',
sprintf(
"%s + ( $state_id ? %s : '' )",
wp_json_encode( $nav_el->getAttribute( 'class' ) ),
wp_json_encode( ' ' . $this->args['nav_container_toggle_class'] )
)
);
$state_el = $this->dom->createElement( 'amp-state' );
$state_el->setAttribute( 'id', $state_id );
$script_el = $this->dom->createElement( 'script' );
$script_el->setAttribute( 'type', 'application/json' );
$script_el->appendChild( $this->dom->createTextNode( wp_json_encode( $expanded ) ) );
$state_el->appendChild( $script_el );
$nav_el->parentNode->insertBefore( $state_el, $nav_el );
$button_on = sprintf( "tap:AMP.setState({ $state_id: ! $state_id })" );
$button_el->setAttribute( 'on', $button_on );
$button_el->setAttribute( 'aria-expanded', 'false' );
$button_el->setAttribute( AMP_DOM_Utils::get_amp_bind_placeholder_prefix() . 'aria-expanded', "$state_id ? 'true' : 'false'" );
if ( ! empty( $this->args['menu_button_toggle_class'] ) ) {
$button_el->setAttribute(
AMP_DOM_Utils::get_amp_bind_placeholder_prefix() . 'class',
sprintf( "%s + ( $state_id ? %s : '' )", wp_json_encode( $button_el->getAttribute( 'class' ) ), wp_json_encode( ' ' . $this->args['menu_button_toggle_class'] ) )
);
}
}
/**
* Retrieves the navigation container element.
*
* @since 1.1.0
*
* @return DOMElement|null Navigation container element, or null if not provided or found.
*/
protected function get_nav_container() {
if ( ! empty( $this->args['nav_container_id'] ) ) {
return $this->dom->getElementById( $this->args['nav_container_id'] );
}
if ( ! empty( $this->args['nav_container_xpath'] ) ) {
return $this->xpath->query( $this->args['nav_container_xpath'] )->item( 0 );
}
return null;
}
/**
* Retrieves the navigation menu button element.
*
* @since 1.1.0
*
* @return DOMElement|null Navigation menu button element, or null if not provided or found.
*/
protected function get_menu_button() {
if ( ! empty( $this->args['menu_button_id'] ) ) {
return $this->dom->getElementById( $this->args['menu_button_id'] );
}
if ( ! empty( $this->args['menu_button_xpath'] ) ) {
return $this->xpath->query( $this->args['menu_button_xpath'] )->item( 0 );
}
return null;
}
}