@bolt/components-action-blocks

bolt/action-blocks

Stylistic block layout for displaying actionable icon and text. Part of the Bolt “Components” CSS framework that powers the Bolt Design System.

Demo

<bolt-action-blocks bolt-component>
  <ul class="c-bolt-action-blocks c-bolt-action-blocks--item-max-6 c-bolt-action-blocks--vertical-align-start c-bolt-action-blocks--bordered">
    <li class="c-bolt-action-blocks__item">
      <bolt-action-block bolt-component>
        <a href="http://google.com" class="c-bolt-action-block">
          <div class="c-bolt-action-block__item">
            <bolt-icon name="download" background="circle" size="large"></bolt-icon>
          </div>
          <div class="c-bolt-action-block__item">
            Item 1, Proin Quis Tortor Orci Etiam At Risus Et Justo Dignissim.
          </div>
        </a>
      </bolt-action-block>
    </li>
  </ul>
</bolt-action-blocks>

---

Table of Contents

• Cheat Sheet
• Getting Started
• Further Reading

Cheat Sheet

Install via NPM

npm install @bolt/action-blocks

---

Getting Started

The best way to start using Bolt is via the Bolt Starterkit (coming soon), a pre-assembled front-end boilerplate designed to get you up and running as quickly as possible.

You can also use the full Bolt Core CSS framework on its own, or, install just the parts you need and fold the different ITCSS layers of Bolt into your existing codebase.

Installing Bolt’s Action Blocks component is as easy as running NPM install:

npm install @bolt/action-blocks

TIP:: Don’t have a package.json file? Need a little help getting started? Check out our Getting Started guide for some tips to help get you up to speed.

Usage

Once installed, you should @import the main Sass partial into your project’s main .scss file to make the included variables available to the rest of your code.

// Settings
@import '@bolt/settings-global';
@import '@bolt/settings-spacing';
@import '@bolt/settings-colors';
@import '@bolt/settings-font-size';
@import '@bolt/settings-font-weight';

// Tools
@import '@bolt/tools-font-size';
@import '@bolt/tools-font-weight';
@import '@bolt/tools-spacing';
@import '@bolt/tools-color-palette';

Since Bolt’s CSS architecture is based on ITCSS (Inverted Triangle CSS)¹, what Sass partials you import, and in what order, makes a whole world of difference. That’s why importing any Settings packages from Bolt in your project’s Settings layer (prior to any Sass mixins, resets, base HTML element styles, etc) is so important.

Compiling

We recommend using Bolt’s Gulp-based front-end build tools to compile your Sass as we’re pre-packaging many of the latest tools and add-ons to help you write your very best: LibSass, Autoprefixer, PostCSS, CleanCSS, Sassdoc, Stylelint, Gulp Plumber, npm-sass, and BrowserSync live reloading.

---

Further Reading:

1. Learn more about ITCSS

• Harry Roberts - Managing CSS Projects with ITCSS - YouTube
• ITCSS: Scalable and Maintainable CSS Architecture - Xfive
• Manage large CSS projects with ITCSS | Creative Bloq
• How I Shrank my CSS by 84kb by Refactoring with ITCSS