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-
WP_Customize_Setting instance.
$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. |