Defaults

The defaults feature allows you to apply classes and control panel CSS/badges to elements that have no custom style set. Multiple sets of styles are supported, and you can select the one you want to use per Bard field in the field configuration. The standard set will be used by default.

• Defining Defaults
  • Multiple Defaults Groups
• Options
• Feature Support
• Compatibility

#Defining Defaults

Open config/statamic/bard_texstyle.php to add your defaults:

'defaults' => [
 
    'heading_1' => [
        'class'    => 'head-1',
        'cp_css'   => null,
        'cp_badge' => true,
    ],
    'paragraph' => [
        'class'    => 'para',
        'cp_css'   => 'color: darkgray',
        'cp_badge' => false,
    ],
 
],
'defaults' => [
 
    'heading_1' => [
        'class'    => 'head-1',
        'cp_css'   => null,
        'cp_badge' => true,
    ],
    'paragraph' => [
        'class'    => 'para',
        'cp_css'   => 'color: darkgray',
        'cp_badge' => false,
    ],
 
],

#Multiple Defaults Groups

It's possible configure multiple groups of defaults to use with different Bard fields. To do this you must define a standard group that will be used by default, plus your additional groups.

'defaults' => [
 
    'standard' => [
        'heading_1' => [
            'class'    => 'head-1',
            'cp_css'   => null,
            'cp_badge' => true,
        ],
        'paragraph' => [
            'class'    => 'para',
            'cp_css'   => 'color: darkgray',
            'cp_badge' => false,
        ],
    ],
 
    'article' => [
        // ...
    ],
 
],
'defaults' => [
 
    'standard' => [
        'heading_1' => [
            'class'    => 'head-1',
            'cp_css'   => null,
            'cp_badge' => true,
        ],
        'paragraph' => [
            'class'    => 'para',
            'cp_css'   => 'color: darkgray',
            'cp_badge' => false,
        ],
    ],
 
    'article' => [
        // ...
    ],
 
],

Once configured a new Texstyle Defaults field will appear in the Bard field configuration where you can select one of your additional groups.

#Options

Defaults can have the following options:

• class (string)
  The default class name that will be applied for this type on the frontend.
• cp_css (string, array)
  The default CSS properties that will be added to the control panel for this type. Can either be a string, or an array where the keys are selectors and the values are properties. An & in the selector will be replaced with the type's root selector.
• cp_badge (boolean)
  Whether to display a bage next to default elements of this type.

#Feature Support

The following options are supported for each element type.

#Compatibility

Default classes are not compatible with Bard's save_html option and may cause unexpected results.