WordPress 載入 CSS 函式:wp_enqueue_style

函式說明

將 CSS 樣式檔案加入佇列。

函式用法

<?php wp_enqueue_style( $handle, $src, $deps, $ver, $media ) ?>

引數說明

$handle

（字串）（必需） 樣式表檔名。

預設值：None

$src

（字串）（可選）WordPress 根目錄下的樣式表路徑

示例： 『/css/mystyle.css』 。

預設值：false

$deps

（陣列）（可選） 樣式表所依靠的控制程式碼組成的陣列；載入該樣式表前需要載入的其它樣式表。若沒有依賴關係，返回 false 。

預設值：array()

$ver

（字串）（可選） 指明樣式表版本號的字串 （若存在版本號） 。預設為 false 。該引數可確保即使在啟用快取的狀態下，傳送給客戶端的仍然是正確版本，因此如果版本號可用且對樣式表有意義，包含該版本號。

預設值：false

$media

（布林型）（可選） 字串，該字串指定了為樣式表而定義的媒體。示例：』all』, 『screen』, 『handheld』, 『print』 。

預設值：false

返回的值

（空）

該函式不返回任何值。

示例

使用鉤子 （hook）

<?php

/*
* 該例項執行於 WordPress 2.7
*/

/*
* 註冊鉤子 'wp_print_styles'
*/
add_action('wp_print_styles', 'add_my_stylesheet');

/*
* Enqueue style-file, if it exists.
*/

function add_my_stylesheet() {
    $myStyleUrl = WP_PLUGIN_URL . '/myPlugin/style.css';
    $myStyleFile = WP_PLUGIN_DIR . '/myPlugin/style.css';
    if ( file_exists($myStyleFile) ) {
        wp_register_style('myStyleSheets', $myStyleUrl);
        wp_enqueue_style( 'myStyleSheets');
    }
}

?>

只在外掛頁面載入樣式表
<?php

/*
* 該例項執行於 WordPress 2.6.3+,
* 在更舊版本也有可能執行.
*/

add_action('admin_init', 'my_plugin_admin_init');
add_action('admin_menu', 'my_plugin_admin_menu');

function my_plugin_admin_init()
{
    /* Register our stylesheet. */
    wp_register_style('myPluginStylesheet', WP_PLUGIN_URL . '/myPlugin/stylesheet.css');
}

function my_plugin_admin_menu()
{
	/*註冊外掛頁面 */
	$page = add_submenu_page( 'edit.php',
	__('My Plugin', 'myPlugin'),
	__('My Plugin', 'myPlugin'), 9, __FILE__,
	'my_plugin_manage_menu');

	/* 在註冊的外掛頁面新增樣式 */
	add_action('admin_print_styles-' . $page, 'my_plugin_admin_styles');
}

function my_plugin_admin_styles()
{
	/*
	* 只在外掛頁面載入該樣式
	*/
	wp_enqueue_style('myPluginStylesheet');
}

function my_plugin_manage_menu()
{
	/* 輸出管理頁面 */
}

?>

註釋

• 參見 WP_Styles::add(), WP_Styles::enqueue()
• 使用全域性變數：（未知型別）$wp_styles

歷史記錄

始見於 2.1 版本 （BackPress 版本：r79）

原始檔

wp_enqueue_style() 位於 wp-includes/functions.wp-styles.php 。