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 。

WordPress 加載 CSS 函數:wp_enqueue_style