wp_add_inline_style() WordPress Function

The wp_add_inline_style() function allows you to add inline CSS to a WordPress generated page. This is useful if you want to add custom CSS to a specific page or post, without having to edit your theme's stylesheet.

wp_add_inline_style( string $handle, string $data ) #

Add extra CSS styles to a registered stylesheet.


Description

Styles will only be added if the stylesheet is already in the queue. Accepts a string $data containing the CSS. If two or more CSS code blocks are added to the same stylesheet $handle, they will be printed in the order they were added, i.e. the latter added styles can redeclare the previous.

Top ↑

See also


Top ↑

Parameters

$handle

(string)(Required)Name of the stylesheet to add the extra styles to.

$data

(string)(Required)String containing the CSS styles to be added.


Top ↑

Return

(bool) True on success, false on failure.


Top ↑

Source

File: wp-includes/functions.wp-styles.php

function wp_add_inline_style( $handle, $data ) {
	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle );

	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 );
}


Top ↑

Changelog

Changelog
VersionDescription
3.3.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.