[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-includes/blocks/ -> navigation-submenu.php (summary)

Server-side rendering of the `core/navigation-submenu` block.

File Size: 317 lines (11 kb)
Included or required:0 times
Referenced: 0 times
Includes or requires: 2 files
 wp-includes/blocks/navigation-link/shared/render-submenu-icon.php
 wp-includes/blocks/navigation-link/shared/item-should-render.php

Defines 4 functions

  block_core_navigation_submenu_render_submenu_icon()
  block_core_navigation_submenu_get_submenu_visibility()
  render_block_core_navigation_submenu()
  register_block_core_navigation_submenu()

Functions
Functions that are not part of a class:

block_core_navigation_submenu_render_submenu_icon()   X-Ref
Renders the submenu icon SVG for the Navigation Submenu block.

return: string SVG markup for the submenu icon.

block_core_navigation_submenu_get_submenu_visibility( $context )   X-Ref
Returns the submenu visibility value with backward compatibility
for the deprecated openSubmenusOnClick attribute.

This function centralizes the migration logic from the boolean
openSubmenusOnClick to the new submenuVisibility enum.

Backward compatibility handling:
- Legacy blocks (saved before migration, never opened in editor):
Have openSubmenusOnClick in database. Parent Navigation block passes it via context.
We prioritize openSubmenusOnClick to preserve the original behavior.

- Migrated blocks (opened in editor after migration):
JavaScript deprecation removes openSubmenusOnClick and sets submenuVisibility.
We use submenuVisibility since openSubmenusOnClick is null.

- New blocks (created after migration):
Only have submenuVisibility, openSubmenusOnClick is null.
We use submenuVisibility.

return: string The visibility mode: 'hover', 'click', or 'always'.
param: array $context Block context from parent Navigation block.

render_block_core_navigation_submenu( $attributes, $content, $block )   X-Ref
Renders the `core/navigation-submenu` block.

return: string Returns the post content with the legacy widget added.
param: array    $attributes The block attributes.
param: string   $content    The saved content.
param: WP_Block $block      The parsed block.

register_block_core_navigation_submenu()   X-Ref
Register the navigation submenu block.




Generated : Mon Jul 6 08:20:14 2026 Cross-referenced by PHPXref