为注册的样式表添加额外的CSS样式。
原型
wp_add_inline_style( string $handle, string $data )
描述
只有样式表已经在队列中时才会添加样式。接受包含CSS的字符串$数据。如果将两个或多个CSS代码块添加到相同的样式表$ handle中,它们将按照添加的顺序打印,即后者添加的样式可以重新声明前一个。
参考:
- WP_Styles::add_inline_style()
参数
$handle
(string)
(Required)
要添加额外样式的样式表的名称。
$data
(string)
(Required)
包含要添加的CSS样式的字符串。
返回值
(bool)
成功时是真的,失败时是假的。
源文件
路径:wp-includes/functions.wp-styles.php
<?php
...
function wp_add_inline_style( $handle, $data ) {
_wp_scripts_maybe_doing_it_wrong( __FUNCTION__ );
if ( false !== stripos( $data, '</style>' ) ) {
_doing_it_wrong( __FUNCTION__, sprintf(
/* translators: 1: <style>, 2: wp_add_inline_style() */
__( 'Do not pass %1$s tags to %2$s.' ),
'<code><style></code>',
'<code>wp_add_inline_style()</code>'
), '3.7.0' );
$data = trim( preg_replace( '#<style[^>]*>(.*)</style>#is', '$1', $data ) );
}
return wp_styles()->add_inline_style( $handle, $data );
}
...
?>
其他
英文文档:https://developer.wordpress.org/reference/functions/wp_add_inline_style/