云策 WordPress 开发者社区

钩子文档

navigation_widgets_format

查看官方原文 ↗
💡 云策文档标注

概述

navigation_widgets_format 是一个 WordPress 过滤器，用于控制包含导航链接的小部件输出的 HTML 格式。它允许开发者指定使用 HTML5 或 XHTML 标记类型。

关键要点

  • 过滤器名称：navigation_widgets_format
  • 参数：$format，接受 'html5' 或 'xhtml' 字符串值
  • 用途：影响多个内置小部件的输出格式，如导航菜单、标签云、RSS 等
  • 引入版本：WordPress 5.5.0

代码示例

$format = apply_filters( 'navigation_widgets_format', $format );

注意事项

此过滤器主要用于主题或插件开发，以统一小部件的 HTML 输出标准，确保兼容性和语义化。

📄 原文内容

Filters the HTML format of widgets with navigation links.

Parameters

$formatstring
The type of markup to use in widgets with navigation links.
Accepts 'html5', 'xhtml'.

Source

$format = apply_filters( 'navigation_widgets_format', $format );

View all references View on Trac View on GitHub

Used by Description
WP_Nav_Menu_Widget::widget()wp-includes/widgets/class-wp-nav-menu-widget.php

Outputs the content for the current Navigation Menu widget instance.
WP_Widget_Tag_Cloud::widget()wp-includes/widgets/class-wp-widget-tag-cloud.php

Outputs the content for the current Tag Cloud widget instance.
WP_Widget_RSS::widget()wp-includes/widgets/class-wp-widget-rss.php

Outputs the content for the current RSS widget instance.
WP_Widget_Recent_Posts::widget()wp-includes/widgets/class-wp-widget-recent-posts.php

Outputs the content for the current Recent Posts widget instance.
WP_Widget_Recent_Comments::widget()wp-includes/widgets/class-wp-widget-recent-comments.php

Outputs the content for the current Recent Comments widget instance.
WP_Widget_Categories::widget()wp-includes/widgets/class-wp-widget-categories.php

Outputs the content for the current Categories widget instance.
WP_Widget_Archives::widget()wp-includes/widgets/class-wp-widget-archives.php

Outputs the content for the current Archives widget instance.
WP_Widget_Meta::widget()wp-includes/widgets/class-wp-widget-meta.php

Outputs the content for the current Meta widget instance.
WP_Widget_Pages::widget()wp-includes/widgets/class-wp-widget-pages.php

Outputs the content for the current Pages widget instance.

Show 4 moreShow less

Changelog

Version Description
5.5.0 Introduced.