📍 Bolt Help / Products / Bolt Ignite / API V3 Implementation / Styling / Component Styling - Version 3

Component Styling - Version 3

Style Bolt's payment fields and other components to match your branding.

Page Contents

Click to expand.

This guide will help you style the Payment Fields components for the Bolt Accounts product.

Bolt’s on-page components use a psuedoclass styling methodology to apply styling at the element-level. This will assist in more consistent styling across components and give more granular control to styles as shoppers interact with your components.

Default Styling

To access our default Bolt theme, you do not need to apply any styles to the component code or scripts.

How Bolt Component Styling Works

Explanation of the structure

--bolt-<target>_<variant>_<sentiment>_<intent>_<transientState>-<subtarget>-<property>

Token Piece	Required	Definition	Examples
`--bolt`	Yes	Targets Bolt component.	N/A
`-target`	Yes	Applies styles to named element.	`-input`, `-button`, `content`
`_variant`	No	Allows the targeting of elements with multiple variations, such as buttons.	For buttons: `_primary`, `_secondary`, `_tertiary`.
`_sentiment`	No	Similar to `variant`, allows the targeting of elements with multiple variations of mood, such as warning messages.	`_neutral`, `_warning`, `_critical`, `_informative`
`_intent`	No	Allows the targeting of an element based on its current display state.	For checkboxes: `_checked` or `_unchecked` For menu items: `_selected` or null For input fields: `_empty` or `_filled`
`_transientState`	No	Allows the application of styling basd on the end-user’s interaction with the element.	`_enabled`, `_hover`, `_pressed`, `_active`, `_focus`, `_focus-visible`, `_disabled`
`-subtarget`	No	Applies styles to the named child element of the named `-target`.	For input fields: `-label`, `-placeholder`, and -`helpText`
`-property`	Yes	Specifies the CSS property where the styling will apply.	Any CSS property, formatted in `camelCase`, such as: `-backgroundColor` or `-fontFamily`

Implementation

You may implement styling in the way that best suits your use case.

This option will, in the future, allow you to carry styles to other on-page components as they become available.

Bolt.configureOnPageStyles({
    version: 3,
    "--bolt-input-fontFamily": "Sans Serif",
    "--bolt-input-fontSize": "14px",
});

This option allows you to initialize the Payment Fields Component and specify its styles on creation.

const paymentComponent = Bolt.create("payment_component", {
    styles: {
        version: 3,
        "--bolt-input-fontFamily": "Sans Serif",
        "--bolt-input-fontSize": "14px"
    }
});

This option allows you to mount styling after you have already initialized the component.

paymentComponent.setStyles({
    version: 3,
    "--bolt-input-fontFamily": "Sans Serif",
    "--bolt-input-fontSize": "14px"
});

Sample Constructions

--bolt-input_neutral-backgroundColor
// Target: Input Field
// Sentiment: Neutral
// Property: Background color

--bolt-input_critical-backgroundColor
// Target: Input Field
// Sentiment: Critical
// Property: Background color

--bolt-input_critical-label-color
// Target: Input Field
// Sentiment: Critical
// Subtarget: Label on Input Field
// Property: (Text) color

Token Priority Logic

Tokens are ranked according to their specificity in targeting an element or variation of an element.

For example, --bolt-input_empty_enabled-color will override --bolt-input_empty-color because it more clearly defines where the override is needed.

Additional Rules

These rules are meant to save you some time testing styling issues you may encounter, as Bolt’s component design includes some nuance that impact your token construction.

The properties fontFamily, padding, borderWidth, and borderRadius are only defined for input and not for their child elements (named in our token as subtarget). Therefore, only simple tokens for these properties, such as --bolt-input-borderRadius are valid. A construction such as --bolt-input_filled-borderRadius would be redundant and therefore not allowed.
The transientState of placeholder only defines color and can only be defined once. For example, --bolt-input-placeholder-color is allowed, while --bolt-input_filled-placeholder-fontFamily is not allowed. The placeholder’s fontFamily can be defined by a constuction such as --bolt-input-fontFamily.
The transientState of hover only changes with borderColor or backgroundColor. Whether it is borderColor or backgroundColor depends on the sentiment. For example, --bolt-input_neutral_hover-borderColor and --bolt-input_neutral-borderColor are allowed, while --bolt-input_filled_hover-borderColor is not allowed.
The subtarget of label does not change with intent. For example --bolt-input_filled-label-color is not allowed.
The subtarget of helpText can only have its color changed by sentiment (as opposed to intent or transientState). Additionally, fontSize and margin only declared once for helpText. For example, --bolt-input_neutral-helpText-color, --bolt-input-helpText-fontSize, and --bolt-input-helpText-margin are allowed, while --bolt-input_hover-helpText-color is not.
For warning and critical sentiments, focus will not change styling. Only neutral and filled states will change on focus. However, disabled can target input and label (the subtarget). For example, --bolt-input_disabled-borderColor and --bolt-input_disabled-label-color are allowed, while --bolt-input_warning_disabled-borderColor and --bolt-input_warning_disabled-color are not.

Common Design Tokens

Use Case: Underlined Input Fields

To create underlined input fields, we recommend constructing and modifying the following tokens:

Bolt.configureOnPageStyles({
    version: 3,
    "--bolt-input-borderRadius": "0px", 
    "--bolt-input-borderWidth": "0 0 1px"
    });

Collection of Input Variations

The possibilities are endless - you can completely customize just about any piece of an on-page Bolt component.

Basic Input Styling

--bolt-input-fontSize
--bolt-input-fontFamily

--bolt-input-padding

--bolt-input-borderRadius
--bolt-input-borderWidth

--bolt-input-placeholder-color

--bolt-input-helpText-fontSize
--bolt-input-helpText-margin

--bolt-input-borderColor
--bolt-input-backgroundColor
--bolt-input-color

Input Status Variations

// ENABLED INPUT FIELD STYLING
--bolt-input_enabled-borderColor
--bolt-input_enabled-backgroundColor
--bolt-input_enabled-color

// FOCUSED INPUT FIELD STYLING
--bolt-input_focus-borderColor
--bolt-input_focus-backgroundColor
--bolt-input_focus-color

// EMPTY INPUT FIELD STYLING
--bolt-input_empty-borderColor
--bolt-input_empty-backgroundColor
--bolt-input_empty-color
--bolt-input_empty_enabled-borderColor
--bolt-input_empty_enabled-backgroundColor
--bolt-input_empty_enabled-color
--bolt-input_empty_focus-borderColor
--bolt-input_empty_focus-backgroundColor
--bolt-input_empty_focus-color

// FILLED INPUT FIELD STYLING
--bolt-input_filled-borderColor
--bolt-input_filled-backgroundColor
--bolt-input_filled-color
--bolt-input_filled_enabled-borderColor
--bolt-input_filled_enabled-backgroundColor
--bolt-input_filled_enabled-color
--bolt-input_filled_focus-borderColor
--bolt-input_filled_focus-backgroundColor
--bolt-input_filled_focus-color

// NEUTRAL INPUT FIELD STYLING
--bolt-input_neutral-borderColor
--bolt-input_neutral-backgroundColor
--bolt-input_neutral-color
--bolt-input_neutral_enabled-borderColor
--bolt-input_neutral_enabled-backgroundColor
--bolt-input_neutral_enabled-color
--bolt-input_neutral_focus-borderColor
--bolt-input_neutral_focus-backgroundColor
--bolt-input_neutral_focus-color
--bolt-input_neutral_empty-borderColor
--bolt-input_neutral_empty-backgroundColor
--bolt-input_neutral_empty-color
--bolt-input_neutral_empty_enabled-borderColor
--bolt-input_neutral_empty_enabled-backgroundColor
--bolt-input_neutral_empty_enabled-color
--bolt-input_neutral_empty_focus-borderColor
--bolt-input_neutral_empty_focus-backgroundColor
--bolt-input_neutral_empty_focus-color
--bolt-input_neutral_filled-borderColor
--bolt-input_neutral_filled-backgroundColor
--bolt-input_neutral_filled-color
--bolt-input_neutral_filled_enabled-borderColor
--bolt-input_neutral_filled_enabled-backgroundColor
--bolt-input_neutral_filled_enabled-color
--bolt-input_neutral_filled_focus-borderColor
--bolt-input_neutral_filled_focus-backgroundColor
--bolt-input_neutral_filled_focus-color

// CRITICAL INPUT FIELD STYLING
--bolt-input_critical-borderColor
--bolt-input_critical-backgroundColor
--bolt-input_critical-color
--bolt-input_critical_enabled-borderColor
--bolt-input_critical_enabled-backgroundColor
--bolt-input_critical_enabled-color
--bolt-input_critical_empty-borderColor
--bolt-input_critical_empty-backgroundColor
--bolt-input_critical_empty-color
--bolt-input_critical_empty_enabled-borderColor
--bolt-input_critical_empty_enabled-backgroundColor
--bolt-input_critical_empty_enabled-color
--bolt-input_critical_filled-borderColor
--bolt-input_critical_filled-backgroundColor
--bolt-input_critical_filled-color
--bolt-input_critical_filled_enabled-borderColor
--bolt-input_critical_filled_enabled-backgroundColor
--bolt-input_critical_filled_enabled-color

// WARNING INPUT FIELD STYLING
--bolt-input_warning-borderColor
--bolt-input_warning-backgroundColor
--bolt-input_warning-color
--bolt-input_warning_enabled-borderColor
--bolt-input_warning_enabled-backgroundColor
--bolt-input_warning_enabled-color
--bolt-input_warning_empty-borderColor
--bolt-input_warning_empty-backgroundColor
--bolt-input_warning_empty-color
--bolt-input_warning_empty_enabled-borderColor
--bolt-input_warning_empty_enabled-backgroundColor
--bolt-input_warning_empty_enabled-color
--bolt-input_warning_filled-borderColor
--bolt-input_warning_filled-backgroundColor
--bolt-input_warning_filled-color
--bolt-input_warning_filled_enabled-borderColor
--bolt-input_warning_filled_enabled-backgroundColor
--bolt-input_warning_filled_enabled-color

Hover on Input Styling

--bolt-input_hover-borderColor
--bolt-input_hover-backgroundColor

--bolt-input_neutral_hover-borderColor
--bolt-input_neutral_hover-backgroundColor

--bolt-input_critical_hover-borderColor
--bolt-input_critical_hover-backgroundColor

--bolt-input_warning_hover-borderColor
--bolt-input_warning_hover-backgroundColor

Input Label Styling

--bolt-input-label-color
--bolt-input_enabled-label-color
--bolt-input_focus-label-color
--bolt-input_neutral-label-color
--bolt-input_neutral_enabled-label-color
--bolt-input_neutral_focus-label-color

--bolt-input_critical-label-color
--bolt-input_critical_enabled-label-color
--bolt-input_critical_focus-label-color

--bolt-input_warning-label-color
--bolt-input_warning_enabled-label-color
--bolt-input_warning_focus-label-color

--bolt-input-label-margin
--bolt-input-label-fontWeight
--bolt-input-label-fontSize

--bolt-input_enabled-label-margin
--bolt-input_enabled-label-fontWeight
--bolt-input_enabled-label-fontSize
--bolt-input_focus-label-margin
--bolt-input_focus-label-fontWeight
--bolt-input_focus-label-fontSize
--bolt-input-helpText-color
--bolt-input_neutral-helpText-color
--bolt-input_critical-helpText-color
--bolt-input_warning-helpText-color
--bolt-input_disabled-borderColor
--bolt-input_disabled-backgroundColor
--bolt-input_disabled-color
--bolt-input_disabled-label-color