Arguments for Background Field

Name	Type	Default	Description
id	string		A unique ID. This ID will be used to get the value.
type	string	background	Type of the field.
title	string		Title of the field.
default	array		Default value to return if the option does not exist in the database
subtitle	string		Subtitle to display below the title.
desc	string		Description to display after the field.
help	string		Text to display on right-corner (as hover / popup) the field.
class	string		Extra CSS classes (space separated) to append to the field.
before	string		Content to display before the field.
after	string		Content to display after the field.
dependency	array		Define field visibility depending on other field value.
attributes	array		Extra HTML attributes to append to the field.
sanitize	string		Callback function for sanitizing value.
validate	string		Callback function for validating value.
EXTRAS
background_color	bool	true	Flag to display background-color of the field
background_image	bool	true	Flag to display background-image of the field
background_position	bool	true	Flag to display background-position of the field
background_repeat	bool	true	Flag to display background-repeat of the field
background_attachment	bool	true	Flag to display background-attachment of the field
background_size	bool	true	Flag to display background-size of the field
background-origin	bool	false	Flag to display background-origin of the field
background-clip	bool	false	Flag to display background-clip of the field
background_blend_mode	bool	false	Flag to display background blend mode of the field
background_gradient	bool	false	Flag to display background-gradient of the field.
background_image_preview	bool	true	Flag to display background-image-preview of the field
output	array|string		CSS elements selector
output_important	bool	false	Flat to add !important rule on output css

Default Arguments

Name	Type	Description
background-color	string	Hex string representing the default background color (#ffbc00, rgba(255,0,0,0.25)
background-position	string	String representing the default background position value. ( left top left center left bottom center top center center center bottom right top right center right bottom)
background-repeat	string	String representing the default background repeat value. ( repeat repeat-x repeat-y no-repeat)
background-attachment	string	String representing the default background attachment value. ( scroll fixed)
background-size	string	String representing the default background size value (cover contain)
background-origin	string	String representing the default background origin value ( padding-box border-box content-box)
background-clip	string	String representing the default background clip value ( padding-box border-box content-box)
background-blend-mode	string	String representing the default background blend mode value ( normal multiply screen overlay darken lighten color-dodge saturation color luminosity)
background-gradient-color	string	String representing the default gradient color value ( #ffbc00, rgba(255,0,0,0.25) )
background-gradient-direction	string	String representing the default gradient direction value ( to bottom to right 135deg -135deg)

Simple Background Field Example

array(
  'id' => 'example-background',
  'type' => 'background',
  'title' => 'Example Background',
),

Advanced Background Field Example

array(
  'id' => 'example-background',
  'type' => 'background',
  'title' => 'Example Background',
  'background_gradient' => true,
  'background_origin' => true,
  'background_clip' => true,
  'background_blend_mode' => true,
  'default' => array(
    'background-color' => '#111111',
    'background-gradient-color' => '#555555',
    'background-gradient-direction' => 'to bottom',
    'background-size' => 'cover',
    'background-position' => 'center center',
    'background-repeat' => 'repeat',
  ),
),