Question

wp_style_add_data( string $handle,  string $key,  mixed $value )

Add metadata to a CSS stylesheet.

---

description

Works only if the stylesheet has already been added.

Possible values for $key and $value: ‘conditional’ string Comments for IE 6, lte IE 7 etc. ‘rtl’ bool|string To declare an RTL stylesheet. ‘suffix’ string Optional suffix, used in combination with RTL. ‘alt’ bool For rel="alternate stylesheet". ‘title’ string For preferred/alternate stylesheets.

---

参数

$handle

(string) (Required) Name of the stylesheet.

$key

(string) (Required) Name of data point for which we're storing a value. Accepts 'conditional', 'rtl' and 'suffix', 'alt' and 'title'.

$value

(mixed) (Required) String containing the CSS data to be added.

---

返回值

(bool) True on success, false on failure.

---

源代码

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

function wp_style_add_data( $handle, $key, $value ) {
	return wp_styles()->add_data( $handle, $key, $value );
}

---

更新日志

Version	description
3.6.0	Introduced.

---

相关函数

Uses

• wp-includes/functions.wp-styles.php: wp_styles()

---

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 Aamer Shahzad

   Enqueue IE-specific stylesheets with conditional comments

   	
   /**
    * Enqueue styles conditionally using {@see wp_style_add_data()}.
    *
    * Example taken from the Twenty Fifteen theme and is used to load
    * stylesheets specifically for IE8 and below. IE10 and above does
    * not support conditional comments in standards mode.
    *
    * @link     https://msdn.microsoft.com/en-us/library/ms537512(v=vs.85).aspx
    * @internal Called from 'wp_enqueue_scripts' action.
    */
   function wpdocs_enqueue_scripts() {
   	// Load the Internet Explorer specific stylesheet.
   	wp_enqueue_style( 'twentyfifteen-ie', get_template_directory_uri() . '/css/ie.css', array( 'twentyfifteen-style' ), '20141010' );
   	wp_style_add_data( 'twentyfifteen-ie', 'conditional', 'lt IE 9' );
   
   	// Load the Internet Explorer 7 specific stylesheet.
   	wp_enqueue_style( 'twentyfifteen-ie7', get_template_directory_uri() . '/css/ie7.css', array( 'twentyfifteen-style' ), '20141010' );
   	wp_style_add_data( 'twentyfifteen-ie7', 'conditional', 'lt IE 8' );
   }
   
   add_action( 'wp_enqueue_scripts', 'wpdocs_enqueue_scripts' );