概述

wp_add_inline_style() 函数用于向已注册的样式表添加额外的 CSS 样式。它仅在样式表已入队时生效，支持按添加顺序覆盖样式，并返回操作成功与否的布尔值。

关键要点

• 函数作用：向指定样式表添加内联 CSS 样式，增强样式控制灵活性。
• 参数要求：必需参数 $handle（样式表名称）和 $data（CSS 字符串），确保样式表已通过 wp_enqueue_style() 注册。
• 执行条件：样式表必须已在队列中，否则添加操作无效。
• 样式覆盖：同一 $handle 的多个 CSS 块按添加顺序输出，后添加的样式可覆盖先前的声明。
• 返回值：成功返回 true，失败返回 false，便于错误处理。
• 底层实现：内部调用 WP_Styles::add_inline_style()，并包含安全检查和错误提示机制。

代码示例

/**
 * Add color styling from theme
 */
function wpdocs_styles_method() {
    wp_enqueue_style(
        'custom-style',
        get_template_directory_uri() . '/css/custom_script.css'
    );
    $color = get_theme_mod( 'my-custom-color' ); //E.g. #FF0000
    $custom_css = "
        .mycolor{
            background: {$color};
        }";
    wp_add_inline_style( 'custom-style', $custom_css );
}
add_action( 'wp_enqueue_scripts', 'wpdocs_styles_method' );

注意事项

• 避免在 $data 中包含