SCSS Code Style

Create Magento App Create ScandiPWA App User Manual GitHub
Search…
SCSS Code Style
ScandiPWA follows a strict SCSS style guide for maintainability and consistency
ScandiPWA follows the BEM methodology to write styles. In addition, there are some guidelines to help you write more maintainable stylesheets.
We strongly recommend you use Stylelint to check your code style. This article was written to help you understand the code style rules we enforce and write better code.
Avoid Non-BEM Selectors
Avoid using selectors that aren't Block-Element-Modifier classes:
component/CheckoutOrderSummary/CheckoutOrderSummary.style.scss (fragment)
1
.CheckoutOrderSummary {
2
    &-CartItemDescription {
3
        margin-top: 5px;
4
​
5
        p {
6
            font-size: 1.1rem;
7
            line-height: 1.5;
8
        }
9
    }
10
}
Copied!
Potential issues:
As code becomes more complex, it can become unclear what role the p plays in the app. A well-named BEM class would describe its purpose better
Unnecessary coupling: JavaScript code is now forced to use a <p> element. If you want to rewrite the component to use a <div> instead, you would have to update the styles.
Unnecessary specificity: Having an additional selector element will increase the specificity and make the styles harder to override in .override.style.scss files.
Instead, it is recommended to assign a new BEM class to the element you want to style. Then, you can select it properly:
1
.CheckoutOrderSummary {
2
    &-CartItemDescription {
3
        margin-top: 5px;
4
    }
5
    
6
    &-CartItemDescriptionContent {
7
        font-size: 1.1rem;
8
        line-height: 1.5; 
9
    }
10
}
Copied!
Minimize Nesting
In some cases, you might need to style one Block differently depending on whether it is a child of another block.
Avoid nesting selectors - don't select a block nested inside another block:
1
.Button {
2
    margin: 5px;
3
}
4
​
5
// this is discouraged
6
.ContactForm .Button {
7
    margin: 10px;
8
}
Copied!
This is discouraged for several reasons:
Button styles now contain selectors from another component. This causes coupling, which will result in issues if the .ContactForm block is renamed
The selector has higher specificity, making it harder to override.
Instead, consider using a variable to customize your styling:
Button.style.scss
1
:root {
2
    --button-margin: 5px;
3
}
4
​
5
.Button {
6
    // by default, a value of 5px will be inherited from :root
7
    margin: var(--button-margin);
8
}
Copied!
ContactForm.style.scss
1
.ContactForm {
2
    // we can set the variable lower in the hierarchy to override it
3
    --button-margin: 10px;
4
}
Copied!
Now, each component is responsible for its own styles only, and the specificity is still low.
In this case, another possible solution would be to use a Modifier:
1
.Button {
2
    margin: 5px;
3
    
4
    &_margin_large {
5
        margin: 10px;
6
    }
7
}
Copied!
Now, the button could take a prop to specify the margin size and add it as a modifier to the Button Block. Then, the ContactForm would have to pass a value to this prop indicating that the button should have a larger margin.
Prefer Mobile-First Styling
Mobile-first styling means that you are encouraged to start with mobile styles. When mobile styles are complete, you can use the @include desktop directive and other breakpoints to adjust the styling for larger viewports.
Avoid Magic Numbers
You should avoid hard-coding numbers when their reasoning is not obvious. Make values re-usable and understandable by using CSS variables.
Avoid hard-coded values:
1
.NotificationList {
2
    position: fixed;
3
    top: 110px;
4
}
Copied!
Issues:
Unclear where the value 110 is coming from
The layout can break if some values are changed
Instead, use variables, and combine them with calc if necessary:
1
.NotificationList {
2
    position: fixed;
3
    top: calc(var(--header-height) + var(--breadcrumbs-height) + 20px);
4
}
Copied!
Advantages:
Intentions are more clear
Variable values can be safely changed to adjust the layout
Each value is re-usable.
Use Round Numbers
Unless you need to produce a pixel-perfect design, we recommend using values rounded to the nearest 5px, avoid unnecessary decimal digits, and consider how much precision browsers can actually display.
JavaScript Code Style
Next - Tutorials
Customizing Your Theme
Last modified 1yr ago
Copy link
Contents
Avoid Non-BEM Selectors
Minimize Nesting
Prefer Mobile-First Styling
Avoid Magic Numbers
Use Round Numbers