@adapt-retail/banner-style v1.1.1

@adapt-retail/banner-style

Micro style framework for building banners.

Banner helper is a micro sass framework for helping you out creating web banners.

The micro framework includes

• Smart grid using flexbox.
• Bomb logic element

Quick install

NPM

npm install @adapt-retail/banner-style

YARN

yarn add @adapt-retail/banner-style

Good starting point

For a good starting point of creating ads see the Adapt banner template.

Grid

The framework includes a micro grid system. To activate it, just add the @include banner-grid mixin where you want your grid to show.

Usage

Each column will by default take equally space of the width

<div class="grid">
    <div class="column"></div>
    <div class="column"></div>
</div>

Add .is-vertical to the grid if you want it to flow downwards.

<div class="grid is-vertical"></div>

.grid.is-vertical

Changes the flex direction of the grid to go top to bottom instead of left to right

.grid.is-vcentered

Position children based on center

.grid.is-vbottom

Position children from bottom to top

Special columns

We have a couple of special classes for columns. This is to help distribute the objects if you want it to fill the container or just use the space it needs.

.column.is-narrow

The .column.is-narrow class does not take up any more space that the children needs.

Warning: Do not use anythings that calculates by the height of the column. This is because calculating height need to have a set parent height. This means that the .is-narrow parent and child will be in conflict. Ignoring this will cause height flickering in some cases.

.column.is-filled

If you use is narrow, and you need to have a child calculate 100% height, you should use .is-cilled. .column.is-filled is actually a css hack and will set the first child as height 100% of the container.

If not using this class you will have trouble filling the children height of 100%.

<div class="grid">
    <div class="column is-filled">
        <div> <!-- Height is 100% -->
            ... Your content ...
        </div>
    </div>
</div>

Clearfix

.clearfix is another css hack, and helps setting the correct height of elements that uses float attibute.

To turn on clearfix include the @include clearfix mixin.

Mixins

Mixins contains css logics and this framework has som nice helpers for help you write DRY code.

Google fonts

We include the sass-google-fonts to make it easy to get the google fonts.

@include google-font( 'Lobster' );

Background

If you want to use a background image, this mixin is for you.

.background {

    @include background-image;
    // background-size: contain;
    // background-repeat: no-repeat;
    // background-position: center;

    @include background-image( red, bottom left, cover );
    // background: red;
    // background-size: cover;
    // background-repeat: no-repeat;
    // background-position: bottom left;

}

Bomb

Bomb mixin helps you create logic for centereing content inside a box.

SASS

.bomb {
    @include bomb;
    background-color: red;
    border-radius: 50%;
}

// Create oval bomb
.bomb {
    @include bomb( 50% );
    background-color: red;
    border-radius: 50%;
}

HTML element

<div class="bomb">
    499
</div>