---
title: "StyleHelper"

doc_type: static
doc_category: static
doc_version: v20260901
source_url:
  html: 'https://developer.shopline.com/docs/apps/checkout/checkout-ui-customizer/component-utilities/style-helper'
  md: 'https://developer.shopline.com/docs/apps/checkout/checkout-ui-customizer/component-utilities/style-helper.md'
---
# StyleHelper

<code data-code-gray>StyleHelper</code> is a utility tool designed for defining conditional values for component property styles. You can write complex conditional styles concisely based on one or more conditions, such as viewport size.

## StyleHelper methods
| **Method** | | **Description** |
| --- | --- | --- |
| <code data-code-gray>default</code> | <code data-code-gray>\<T\>(defaultValue: T) => [ConditionalStyle](#conditionalstyle)\<T, [Conditions](#conditions)\></code> | The default style value to be used when no other conditions are met. |
| <code data-code-gray>when</code> | <code data-code-gray>\<T\>(conditions: [Conditions](#conditions), value: T) => [ConditionalStyle](#conditionalstyle)\<T, [Conditions](#conditions)></code> | Conditional rules for component styles. All conditions, represented in object form, must be satisfied to apply the corresponding value. <br/>The <code data-code-gray>when</code> method can be chained to construct more complex styles. |


## Example 
The following example demonstrates how the <code data-code-gray>[View](https://developer.shopline.com/docs/apps/checkout/checkout-ui-customizer/ui-components/structure/view.md)</code> component responsively adjusts its layout based on [viewport breakpoints](#viewport-breakpoints): when the viewport width is greater than <code data-code-gray>small</code>, the layout switches from a single column to a double column.

```jsx
<Grid
  rows={['1fr', 'auto']}
  columns={StyleHelper.default(['1fr'])
    .when(
      {
        viewportInlineSize: {
          min: 'extraSmall',
        },
      },
      ['1fr'],
    )
    .when(
      {
        viewportInlineSize: {
          min: 'small',
        },
      },
      ['1fr'],
    )
    .when(
      {
        viewportInlineSize: {
          min: 'medium',
        },
      },
      ['1fr', '1fr'],
    )
    .when(
      {
        viewportInlineSize: {
          min: 'large',
        },
      },
      ['1fr', '1fr'],
    )}
  spacing="loose"
  padding="loose"
>
  <View>View1</View>
  <View>View2</View>
  <View>View3</View>
  <View>View4</View>
</Grid>
```

## Type descriptions
### Conditions
Conditional styling supports the following conditions.

Multiple conditions can be set within the same <code data-code-gray>when</code> method.

| **Name** | **Type** | **Description** |
| --- | --- | --- |
| <code data-code-gray>viewportInlineSize</code> | <code data-code-gray>\{min: "extraSmall" \| "small" \| "medium" \| "large"\}</code> | Configure the [viewport breakpoint](#viewport-breakpoints) value. <br/>When the device's viewport width falls within a certain breakpoint range, the condition is met. |

### ConditionalStyle
| **Name** | **Type** | **Description** |
| --- | --- | --- |
| <code data-code-gray>conditionals</code> | <code data-code-gray>[ConditionalValue](#conditionalvalue)\<T, AcceptedConditions\>[]</code> | An array of conditional values. |
| <code data-code-gray>default</code> | <code data-code-gray>T</code> | Default value applied when none of the specified conditional values are met. |

### ConditionalValue
| **Name** | **Type** | **Description** |
| --- | --- | --- |
| <code data-code-gray>conditions</code> | <code data-code-gray>AcceptedConditions</code> | Conditions that must be satisfied to apply the given value. At least one condition must be specified. |
| <code data-code-gray>value</code> | <code data-code-gray>T</code> | The value to be applied when conditions are met. |

## Viewport breakpoints
Viewport breakpoints are critical criteria for evaluating conditions. When the viewport width falls within the following ranges, the corresponding value will be triggered. For example, when the viewport width is <code data-code-gray>450px</code>, <code data-code-gray>StyleHelper</code> will recognize it as the <code data-code-gray>base</code> breakpoint.

- <code data-code-gray>base</code>: <code data-code-gray>0px</code> ≤ viewport width < <code data-code-gray>580px</code>
- <code data-code-gray>extraSmall</code>: <code data-code-gray>580px</code> ≤ viewport width < <code data-code-gray>750px</code>
- <code data-code-gray>small</code>: <code data-code-gray>750px</code> ≤ viewport width < <code data-code-gray>1000px</code>
- <code data-code-gray>medium</code>: <code data-code-gray>1000px</code> ≤ viewport width < <code data-code-gray>1200px</code>
- <code data-code-gray>large</code>: viewport width ≥ <code data-code-gray>1200px</code>
