钩子文档

wp_mediaelement_fallback

💡 云策文档标注

概述

wp_mediaelement_fallback 是一个 WordPress 过滤器钩子,用于修改在无 JavaScript 环境下 MediaElement 的备用输出内容。它允许开发者自定义音频或视频文件的备用显示方式。

关键要点

  • 过滤器名称:wp_mediaelement_fallback
  • 主要用途:过滤无 JavaScript 时的 MediaElement 备用输出
  • 参数:$output(备用输出字符串)和 $url(媒体文件 URL)
  • 相关函数:wp_mediaelement_fallback() 位于 wp-includes/media.php
  • 引入版本:WordPress 3.6.0

代码示例

return apply_filters( 'wp_mediaelement_fallback', sprintf( '%1$s', esc_url( $url ) ), $url );

📄 原文内容

Filters the MediaElement fallback output for no-JS.

Parameters

$outputstring
Fallback output for no-JS.
$urlstring
Media file URL.

Source

return apply_filters( 'wp_mediaelement_fallback', sprintf( '<a href="%1$s">%1$s</a>', esc_url( $url ) ), $url );

Changelog

Version Description
3.6.0 Introduced.