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.
See also
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.
Return
(bool) True on success, false on failure.
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><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 ); }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
3.3.0 | Introduced. |