概述

wp_enqueue_global_styles_custom_css() 是一个已弃用的 WordPress 函数，用于将 theme.json 中定义的全局样式自定义 CSS 入队。自 6.7.0 版本起，建议使用 wp_enqueue_global_styles() 替代。

关键要点

• 函数 wp_enqueue_global_styles_custom_css() 已弃用，从 6.7.0 版本开始，应改用 wp_enqueue_global_styles()。
• 该函数仅对块主题（block theme）生效，通过 wp_is_block_theme() 检查。
• 函数会移除 Customizer 的自定义 CSS 回调，并合并 theme.json 和保存的自定义 CSS 内容，通过 wp_add_inline_style() 添加到全局样式中。

代码示例

function wp_enqueue_global_styles_custom_css() {
    _deprecated_function( __FUNCTION__, '6.7.0', 'wp_enqueue_global_styles' );
    if ( ! wp_is_block_theme() ) {
        return;
    }

    // Don't enqueue Customizer's custom CSS separately.
    remove_action( 'wp_head', 'wp_custom_css_cb', 101 );

    $custom_css  = wp_get_custom_css();
    $custom_css .= wp_get_global_styles_custom_css();

    if ( ! empty( $custom_css ) ) {
        wp_add_inline_style( 'global-styles', $custom_css );
    }
}

注意事项

• 使用此函数前需确保主题是块主题，否则函数会提前返回。
• 函数内部调用了多个相关函数，如 wp_get_global_styles_custom_css() 和 wp_get_custom_css()，用于获取 CSS 内容。
• 弃用信息通过 _deprecated_function() 记录，开发者应更新代码以避免未来兼容性问题。