为注册的样式表添加额外的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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
<?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>&lt;style&gt;</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/