wp_add_inline_style() - WordPress 函数参考中文文档

返回介绍

wp_add_inline_style()

发布于 2017-09-11 字数3124 浏览 793 评论 0

wp_add_inline_style( string $handle,  string $data )

Add extra CSS styles to a registered stylesheet.


描述

Styles will only be added if the stylesheet in 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.


参数

$handle

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

$data

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


返回值

(bool) True on success, false on failure.


源代码

File: wp-includes/functions.wp-styles.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 );
}

更新日志

Version 描述
3.3.0 Introduced.

相关函数

Uses

  • wp-includes/functions.wp-styles.php:
    wp_styles()
  • wp-includes/class.wp-styles.php:
    WP_Styles::add_inline_style()
  • wp-includes/l10n.php:
    __()
  • wp-includes/functions.php:
    _doing_it_wrong()

User Contributed Notes

  1. Skip to note content

    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

    Contributed by Codex

    Example
    wp_add_inline_style allows you to print extra styling whenever a certain stylesheet is loaded. For instance suppose a plug-in or theme makes use of the class .mycolor in a stylesheet to set a background color. This can be over-ridden by a user chosen color, stored in the database by using wp_add_inline_style to print the extra styling.

    
    /**
     * 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.

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!