钩子文档

customize_partial_render

💡 云策文档标注

概述

本文档介绍了 WordPress 中的 customize_partial_render 过滤器,用于过滤部分渲染的输出。该过滤器允许开发者在自定义部分渲染过程中修改渲染值。

关键要点

  • customize_partial_render 是一个 WordPress 过滤器,用于过滤部分渲染的输出值。
  • 过滤器接受三个参数:$rendered(渲染值,可以是字符串、数组或 false)、$partial(WP_Customize_Partial 实例)和 $container_context(可选容器上下文数组)。
  • 该过滤器在 WP_Customize_Partial::render() 方法中被调用,用于渲染涉及相关设置的模板部分。
  • 自 WordPress 4.5.0 版本引入。

代码示例

$rendered = apply_filters( 'customize_partial_render', $rendered, $partial, $container_context );

📄 原文内容

Filters partial rendering.

Parameters

$renderedstring|array|false
The partial value. Default false.
$partialWP_Customize_Partial
$container_contextarray
Optional array of context data associated with the target container.

Source

$rendered = apply_filters( 'customize_partial_render', $rendered, $partial, $container_context );

Changelog

Version Description
4.5.0 Introduced.