Background

The Background field offers unmatched features not found in any other options framework.  Users will be able to present the background designs found in professionally authored pages with a few simple clicks.

background-value

Attributes

AttributesTypeRequiredDescription
idstringRequiredUnique ID identifying the field. It will be used as meta_key. Must be different from all other field IDs.
titlestringRequiredDisplays title of the option.
subtitlestringSubtitle display of the option, situated beneath the title.
descstringRequiredDescription of the option, appearing beneath the field control.
typestringRequiredValue identifying the field type. For Background field we set value background
defaultarrayOptionalArray of default values. See ‘Default Options’ below.
colintOptionalThe proportion of columns that display field on 12 columns per row.
background-colorboolOptionalFlag to display the background color picker.
Default value is true
background-repeatboolOptionalFlag to display the background repeat select field.
Default value is true
background-attachmentboolOptionalFlag to display the background attachment select field.
Default value is true
background-positionboolOptionalFlag to display the background position select field.
Default value is true
background_sizeboolOptionalFlag to display the background size select field.
Default value is true
background_image_urlstringOptionalURL string representing the default background image value.
background_image_idintOptionalUnique ID identifying the default background image value.

 Background Default Options

NameTypeDefaultDescription
background_colorstring#fffHex string representing the default background color.
background_image_idint0Unique ID identifying the default background image value.
background_image_urlstringURL string representing the default background image value.
background_repeatstringrepeatString representing the default background repeat value.
Accepts: repeat repeat-x repeat-y  no-repeat inherit initial
background_sizestringcontainString representing the default background size value.
Accepts: auto length cover contain inherit initial
background_positionstringcenter centerString representing the default background position value.
Accepts: left top left center left bottom center top  center center center bottom  right top  right center  right bottom
background_attachmentstringscrollString representing the default background attachment value.
Accepts: scroll fixed local inherit initial

Example Declaration