Redux

# Using the output Argument

Using the output argument in fields that support it is a great way to generate dynamic CSS for those fields on the front-end of your WordPress site. Redux will take the values for those fields, generate the appropriate CSS selectors, elements, and values and place them at the bottom of the page's <HEAD> section. This ensures your CSS will take priority over any other CSS used in your theme.

Table of Contents

TIP

Before adding the output argument to one of the indicated fields, you will need to know which CSS selectors (opens new window) in which to apply to the field's value. These will be selectors from your theme's CSS you wish to change dynamically via values from fields that offer output. All that now need be done is assign them to the output argument in an array without the chosen field array, as shown below. Multiple selectors are permitted.

Supported Field Types

background | border | color | color_gradient | color_rgba | dimensions | link_color | spacing | typography

DANGER

If you are looking to use CSS variables or to have Redux generate variables to run through a LESS/SCSS compiler, you will want to look at the output_variables argument instead.

# Example Config

For this example, we'll use the border field, found in the sample-config.php (opens new window).

array(
    'id'        => 'opt-header-border',
    'type'      => 'border',
    'title'     => esc_html__('Header Border Option', 'your-textdomain-here'),
    'subtitle'  => esc_html__('Subtitle goes here', 'your-textdomain-here'),
    'output'    => array('.site-header'), // An array of CSS selectors
    'desc'      => esc_html__('This is the description field.', 'your-textdomain-here'),
    'default'   => array(
        'border-color'  => '#1e73be', 
        'border-style'  => 'solid', 
        'border-top'    => '3px', 
        'border-right'  => '3px', 
        'border-bottom' => '3px', 
        'border-left'   => '3px'
    )
),

TIP

Redux will output the CSS in a single line. The example below is expanded for display purposes only.

.site-header {
    border-top: 3px solid #1e73be;
    border-right: 3px solid #1e73be;
    border-bottom: 3px solid #1e73be;
    border-left: 3px solid #1e73be;
}

# Additional Example: Setting Color Properties

The color and color_rgba fields can be used exactly as shown above for the default CSS element of color. If you wish to choose a different element (or mode), it can be specified in the output array value as a key/pair. For example, let suppose you want to output a color field as background-color, instead of color. The following output array in key/pair format would accomplish this:

array(
    'id'        => 'opt-color-demo',
    'type'      => 'color',
    'title'     => esc_html__('Background Color', 'your-textdomain-here'),
    'subtitle'  => esc_html__('Pick a background color.', 'your-textdomain-here'),
    'default'   => '#dd9933',
    'output'    => array('background-color' => '.site-header')
),

Alternatively, multiple elements could be specified for different selectors.

array(
    'id'        => 'opt-color-demo',
    'type'      => 'color',
    'title'     => esc_html__('Background Color', 'your-textdomain-here'),
    'subtitle'  => esc_html__('Pick a background color.', 'your-textdomain-here'),
    'default'   => '#dd9933',
    'output'    => array(
        'background-color' => '.site-header', 
        'color'            => '.site-footer'
    )
),

Multiple selectors are also supported. Separate them with commas.

array(
    'id'        => 'opt-color-demo',
    'type'      => 'color',
    'title'     => esc_html__('Background Color', 'your-textdomain-here'),
    'subtitle'  => esc_html__('Pick a background color.', 'your-textdomain-here'),
    'default'   => '#dd9933',
    'output'    => array('background-color' => '.site-header, .site-footer')
),

# Using output with the required Argument

If a field is not "visible" due to an unmet required statement, the generated CSS for fields in this state will not be appended to the page. By so doing overrides based by other fields do not affect the site. Be mindful when using these two arguments together.

← Permissions →