get_background_color()

💡 云策文档标注

概述

get_background_color() 函数用于检索 WordPress 主题的自定义背景颜色值。它通过 get_theme_mod() 获取设置，并支持默认值回退。

$background_color = get_background_color();
echo 'Current background color for your theme: #' . $background_color;

📄 原文内容

Retrieves value for custom background color.

string

function get_background_color() {
	return get_theme_mod( 'background_color', get_theme_support( 'custom-background', 'default-color' ) );
}

Uses	Description
get_theme_support()`wp-includes/theme.php`	Gets the theme support arguments passed when registering that support.
get_theme_mod()`wp-includes/theme.php`	Retrieves theme modification value for the active theme.

Used by	Description
Custom_Background::admin_page()`wp-admin/includes/class-custom-background.php`	Displays the custom background page.
background_color()`wp-includes/theme.php`	Displays background color value.
_custom_background_cb()`wp-includes/theme.php`	Default custom background callback.
get_body_class()`wp-includes/post-template.php`	Retrieves an array of the class names for the body element.

Version	Description
3.0.0	Introduced.