# 全局样式过滤器

WordPress 6.1 引入了一些服务端过滤器，用于挂接到不同数据层提供的 `theme.json` 数据：

- `wp_theme_json_data_default`：挂接到 WordPress 提供的默认数据
- `wp_theme_json_data_blocks`：挂接到区块提供的数据
- `wp_theme_json_data_theme`：挂接到主题提供的数据
- `wp_theme_json_data_user`：挂接到用户提供的数据

每个过滤器都会接收到一个包含对应层级数据的 `WP_Theme_JSON_Data` 类实例。要提供新数据，过滤器回调函数需要使用 `update_with( $new_data )` 方法，其中 `$new_data` 是有效的类 `theme.json` 结构。与任何 `theme.json` 一样，新数据需要声明所使用的 `theme.json` 的 `version`，以便在版本不同时能正确迁移到运行时版本。

_示例：_

以下是如何为主题传递新调色板并禁用文本颜色用户界面的方法：

```php
function wpdocs_filter_theme_json_theme( $theme_json ){
	$new_data = array(
		'version'  => 2,
		'settings' => array(
			'color' => array(
				'text'       => false,
				'palette'    => array( /* 新调色板 */
					array(
						'slug'  => 'foreground',
						'color' => 'black',
						'name'  => __( '前景色', 'theme-domain' ),
					),
					array(
						'slug'  => 'background',
						'color' => 'white',
						'name'  => __( '背景色', 'theme-domain' ),
					),
				),
			),
		),
	);

	return $theme_json->update_with( $new_data );
}
add_filter( 'wp_theme_json_data_theme', 'wpdocs_filter_theme_json_theme' );
```