Welcome To Express's Style guide

This style guide is for vMerchant Express that is using Foundation for its core, here you will see a demonstation of the key componants that we use construct our ecommerce sites.

Colour Palette

This is the colour palette for your site, the best way to think of this is the palette is divided up into groups, so when a group is defined the first colour colourX is used to create new colours by adjusting properties like brightness, saturations & hue.

Typography

Headings are used to denote different sections of content, usually consisting of related paragraphs and other HTML elements. They range from h1 to h6 and should be styled in a clear hierarchy (i.e., largest to smallest)

Headings:

Heading 1

CSS Class: No Class

Where I get used: Default heading 1 style that get used when selected in CKEditor

Heading 1

CSS Class: preset1

Where I get used: Typically used for main page headings

Heading 1

CSS Class: preset2

Where I get used: This gets used on CMS pages ( News, Blog & Events )


Heading 2

CSS Class: No Class

Where I get used: Default heading 2 style that get used when selected in CKEditor

Heading 2

CSS Class: preset1

Where I get used: Modules heading ( More specifically carousels ).

Heading 2

CSS Class: preset3

Where I get used: Used on the product page.

Heading 2

CSS Class: preset4

Where I get used: Used on the login page.


Heading 3

CSS Class: No Class

Where I get used: Default heading 3 style that get used when selected in CKEditor.

Heading 3

CSS Class: preset1

Where I get used: Product page ( Alternative options ).

Heading 3

CSS Class: preset2

Where I get used: Used for the branch selector.


Heading 4

CSS Class: No Class

Where I get used: Default heading 4 style that get used when selected in CKEditor.


Heading 5

CSS Class: No Class

Where I get used: Default heading 5 style that get used when selected in CKEditor.


Heading 6

CSS Class: No Class

Where I get used: Default heading 6 style that get used when selected in CKEditor.

Paragraph:

Sint occaecat velit veniam voluptate labore cupidatat ad dolor minim sint. Fugiat tempor proident est occaecat. Adipisicing do enim exercitation est mollit sunt laborum occaecat. Nulla minim nostrud ipsum deserunt sit pariatur aute consequat proident excepteur do nisi. Consequat voluptate Lorem tempor labore esse in. Deserunt quis consequat occaecat amet mollit magna culpa magna. Amet reprehenderit non ad non.

Magna voluptate anim duis nulla non sint occaecat laboris reprehenderit. Culpa dolor qui sunt velit cupidatat laborum. Nulla commodo culpa est exercitation minim aliquip consequat ea magna nostrud. Mollit laboris ipsum laborum eiusmod officia amet duis ut labore labore laboris minim magna elit.

Blockquote:

Lorem ipsum ea amet aute deserunt incididunt amet cupidatat aliqua veniam irure.

Lists:

Un-ordered List

  • Duis sint voluptate anim incididunt.
  • Consectetur sint proident non qui laboris consequat.
    • Incididunt dolor nostrud reprehenderit culpa in amet velit non ullamco occaecat non.
    • Esse mollit aliqua deserunt irure duis ipsum amet veniam ad occaecat commodo Lorem.
  • Consectetur Lorem esse consequat aute.

Ordered List

  1. Elit nostrud velit et laboris nulla proident labore cupidatat.
  2. Ea nisi eu commodo ea dolor adipisicing.
    1. Dolor sit dolor enim nisi cillum laboris eiusmod adipisicing.
    2. Nisi elit velit nostrud laboris veniam et proident exercitation.
  3. Magna dolor officia culpa dolore irure laboris in dolore.

Buttons

Buttons are tied to an action of some kind, you can use these button classes on a button tag or on a anchor tag, each button class has 4 states:

Common Buttons:

These buttons are express's general purpose buttons for example on form's the submit button, lookup submission buttons & cancel buttons.

Button State Primary Secondary Tertiary Quaternary
Default
Hover
Active
Disabled

Action buttons:

These are used when you want to do a very specific action like deleting a user in manage users or amending a requisition, typically these are used in the account area of the site.

Button State Success Warning Alert
Default
Hover
Active
Disabled

Other Buttons:

Similar to common buttons you will see these on quite a few pages in places like product lists, product collections ( carousel's / grid's ) and on product pages.

Button State View Details Enquiry Login To Buy
Default
Hover
Active
Disabled

Page Button Positioning:

When positioning multiple buttons inside of a button container the action buttons get placed on the left and proceed & cancel buttons are placed on the right


If there are no action buttons the proceed & cancel buttons will remain pinned the the right.

On Page Notifications

These are area where confirmation from the server is displayed so for example if a post to the server was a successful a piece of text will be displayed confirming this action or on the product page if no items are found, these notification's come in 4 states:

Success
preset-1

Reprehenderit veniam voluptate adipisicing quis occaecat laboris consectetur minim commodo.

Warning
preset-1

Minim laborum mollit nisi nostrud anim magna ipsum reprehenderit nisi deserunt commodo est aliqua eiusmod.

Alert
preset-1

Est voluptate officia veniam id excepteur duis do aute culpa duis ullamco enim.

Disabled
preset-1

Elit et duis culpa id ea nulla dolore ut ullamco nisi consequat pariatur do aliquip.

Success
preset-2

Minim nulla dolor elit laboris pariatur Ex duis ullamco duis Labore duis deserunt ullamco consectetur.

Warning
preset-2

Esse cillum anim ea Lorem duis culpa in deserunt consequat elit eiusmod reprehenderit velit sit.Ex duis ullamco duis.

Alert
preset-2

Irure ullamco duis laborum sint pariatur ad officia qui qui Eiusmod irure laboris nostrud amet animMagna dolor officia culpa nulla ipsum officia fugiat sunt.

Nulla sit consequat officia eu do eu aliqua quis. Esse ut Lorem consequat do enim eiusmod pariatur mollit deserunt aliqua. Cillum Lorem proident eiusmod culpa. Dolor id dolor Lorem Lorem occaecat proident ipsum esse officia in. Duis id enim cupidatat ut labore commodo magna.

Disabled
preset-2

Aute nulla occaecat est ex mollit adipisicing consequat incididunt ad quis et.

Tables

HTML tables that get used in rich text editors, stock notes, basket page and account area.

Column 1 Column 2 Column 3
Date 1 Data 2 Data 3
Date 1 Data 2 Data 3
Date 1 Data 2 Data 3

CSS ClassNo Class

Where I get used:This is the table that gets created via a Rich Text Editor or in stock notes.


Column 1 Column 2 Column 3
Date 1 Data 2 Data 3
Date 1 Data 2 Data 3
Date 1 Data 2 Data 3

CSS ClassPreset 2

Where I get used:Gets used in the account area, order confirmation & Basket

Buy Boxes

Buy Boxes get used throughout the site these can appear on any page on your site, the most common places they can be seen is on the product listing pages and in product collection modules ( such as recently viewed ), Beware you may not be able to see these if your site is set to trade mode only.

Buy boxes normally consist of the following components:

  • Quantity selectors, these are configured on a site wide basis.
  • Add to basket button, this could be a button with text or a button with an icon as seen bellow,
  • Add to favourites button.

Free Text Quantity Selector

The free text option allows the end user to enter a numeric value via the keypad or the incrementor / de-increment buttons on either side of the textbox.

Qty:

Dropdown Selector

Select dropdown option allows pre-defined values to be shown to the end user.

Forms

We use forms to allow users to interact with the site and provide information to the company.

Contact Details

* Required

Server error goes here

Registering only takes a few moments and will store your delivery details for future orders.

  • Length
  • Letters
  • Numbers
  • Symbols
  • Must contain at least 8 characters

    Must contain at least 1 letter (A..Z, a..z)

    Must contain at least 1 number (0..9)

    Must contain at least one symbol (!-_#%$)

Address

* Required

Server error goes here

By ticking this box you consent to the information provided to be used in accordance with our Privacy Policy, terms and conditions and cookie policy.

Stock Indicators

Stock indicators can be used on any page when not on a product listing page or product page they will normally be in carousels like recently views which is typically located at the bottom of the page.

In Stock

140

Low Stock

3

Modals

Modals is express's popup mechanism these can be used to hold forms, cms entries, payment processes & confirmation messaging. Below is a demonstration of what confirmation modals will look like:

Accordion Tabs

Accordion Tabs are typically used on the product page when we show tab notes, these is a responsive mechansim developed by Foundation which allows us to display your data in tabs or with in an accordion this also reacts to your breakpoint as well as tabbed content doesn't normally display well on mobile devices.

Tabs Demo:



  • Tab #1

    Amet et excepteur qui do consequat consequat in amet pariatur eu aute laborum minim enim. In occaecat sint incididunt ex proident officia pariatur deserunt fugiat commodo ea. Ex do sunt ut nisi nostrud labore amet exercitation proident in est.

  • Tab #2

    Ex do sunt ut nisi nostrud labore amet exercitation proident in est.

    Col 1 Col 2 Col 3
    Row 1 Col 1Row 1 Col 2Row 1 Col 3
    Row 2 Col 1Row 2 Col 2Row 2 Col 3
    Row 3 Col 1Row 3 Col 2Row 3 Col 3

Accordion Demo:

  • Tab #1

    Amet et excepteur qui do consequat consequat in amet pariatur eu aute laborum minim enim. In occaecat sint incididunt ex proident officia pariatur deserunt fugiat commodo ea. Ex do sunt ut nisi nostrud labore amet exercitation proident in est.

  • Tab #2

    Ex do sunt ut nisi nostrud labore amet exercitation proident in est.

    Col 1 Col 2 Col 3
    Row 1 Col 1Row 1 Col 2Row 1 Col 3
    Row 2 Col 1Row 2 Col 2Row 2 Col 3
    Row 3 Col 1Row 3 Col 2Row 3 Col 3

AJAX Confirmation Icons

Often when you post things like a form to a server dynamically without having to reload the page the user will expect some sort of response and depending on whether their action has been successfully completed they may see one of these icons.

Action was successful

Action has warnings

Action failed

AJAX Content Block

When you dynamically send a request to the server the content area that you're effecting will be blocked from further access until that request has returned from the server.

Ex minim culpa dolore nulla mollit deserunt aliqua eu occaecat sit do esse enim. Enim quis velit duis nulla anim cillum et. Eu veniam laborum mollit esse do duis voluptate culpa sint eu ad. Mollit ullamco minim nulla duis fugiat quis sint. Do aute minim dolor deserunt velit non ipsum ipsum nisi nulla nisi pariatur enim in. Dolore do sit cupidatat velit laboris ipsum eu qui fugiat sit ipsum. Et dolore adipisicing nostrud ipsum.

Culpa et do laborum voluptate elit occaecat. Mollit incididunt anim incididunt magna exercitation exercitation est proident nulla esse. Nostrud exercitation consectetur do et ex tempor eu tempor reprehenderit occaecat.

Ipsum ad mollit voluptate Lorem ex est commodo esse. Nulla irure culpa dolore sit reprehenderit. Velit dolor consectetur ex laborum eiusmod qui voluptate dolor proident minim minim adipisicing. Sunt veniam commodo elit quis incididunt non voluptate aliquip amet laborum culpa labore. Occaecat ad ipsum veniam ex ex ipsum consectetur anim ut pariatur quis laboris aliqua Lorem. Magna commodo est nisi sunt dolor voluptate minim et id pariatur.

Side Callouts

You can think of Callouts as notifications they can appear from the side of the screen if a process has been completed like adding an item to your favourites or they're used if a button has been disabled the reason should display in an alert callout if the user tries to continue.

Callout Success


Ut Lorem tempor est Lorem sit aliquip nostrud minim enim.

Callout Warning


Labore nostrud reprehenderit aliquip nostrud voluptate cupidatat cupidatat anim.

Callout Alert


Cillum Lorem pariatur anim enim tempor culpa.

Header Callouts

These callouts appear at the top of your viewport and are sticky so if you scroll down they will remain in view, some of these callouts are closable but there are ones that remain in constant view like Masquerading.

You have reached your credit limit ( closable )
You have reached your credit limit ( closable )
You're amending a requisition order ( closable )
You're amending a requisition order ( non-closable )
You're masquerading as Cathy Brown ( closable )
You're masquerading as Cathy Brown ( non-closable )

The Grid

Overview

The grid is built around two key elements: grid-x and cells. grid-container create a max-width and contain the grid, and cells create the final structure. Everything on your page that you don't give a specific structural style to should be within a grid-x or cell.

Nesting

In the Grid you can nest cells down as far as you'd like. Just embed grid-x inside cells and go from there. Each embedded grid-x can contain up to 12 cells.

How to Use

Using this framework is easy. Here's how your code will look when you use a series of `<div>` tags to create cells.

4
4
4
3
6
3
2
8
2
3
9
4
8
5
7
6
6

Nesting grid-x

In the Grid you can nest cells down as far as you'd like. Just embed grid-x inside cells and go from there. Each embedded grid-x can contain up to 12 cells.

8
8 Nested
8 Nested Again
4
4
4

Small Grid

As you've probably noticed in the examples above, you have access to a small, medium, and large grid. If you know that your grid structure will be the same for small devices as it will be on large devices, just use the small grid. You can override your small grid classes by adding medium or large grid classes.

2
10, last
3
9, last

Highlighted Items

When an item is flagged as being highlighted for example a product is on a special offer a overlay can be outputted over the product image on lists and on the product page, a banner can also be displayed on the product page as well.

Highlighted

These normally appear on the product page, the required file time is PNG.

  • Special Offer

    Special Offer
  • Featured Item

    Featured Item
  • Best Seller

    Best Seller
  • Contract Item

    Contract Item
  • Previously Purchased

    Previously Purchased

Overlays

These can appear in any list, modules collection ( product carousels ), in the basket and on the product page they can be stock or group specific, they're typically provided on a transparent canvas so the PNG file format is required and the dimensions are 400x400.

  • Special Offer

    Product Image
  • Featured Item

    Product Image
  • Best Seller

    Product Image
  • Previously Purchased

    Product Image
  • Contract Item

    Product Image
  • Worst Case Scenario

    Product Image