View our Christmas opening hours here

Introduction

Theme documentation

This documentation acts a guide to theme customisation for theme developers.

There's a lot to an Evance theme. So, we have completely refactored this theme's code to deliver a highly configurable theme with consistent terminology and succinct reusable code. Our aim is to offer better theme design for developers and users alike.


Text

Text sizes & variations

This theme comes pre-built with the following text sizes/variations.

All font sizes on this theme scale between minimum and maximum sizes - based on rem units, where 1rem is equal to 16px. This allows us to have large bold headings on desktop that scale gracefully for mobile devices. Since we now use clamp() to control font scaling, we can utilize CSS variables succinctly without the need for media queries.

Some text size modifier classes use em to allow the font to scale relative to the parent element's font size. These are noted below.

To avoid CSS bloating, this theme only uses the size variations below.

Heading 1

<h1> / .heading-1 --heading-1-size

Heading 2

<h2> / .heading-2 --heading-2-size

Heading 3

<h3> / .heading-3 --heading-3-size

Heading 4

<h4> / .heading-4 --heading-4-size
Heading 5
<h5> / .heading-5 --heading-5-size
Heading 6
<h6> / .heading-6 --heading-6-size

Eyebrow

.text-eyebrow --text-eyebrow-size

Subtitle

.text-subtitle --text-subtitle-size

Large

.text-large - scales relative to parent font-size. --text-large-size

Medium

Default --text-size

Small

.text-small - scales relative to parent font-size. --text-small-size
100m2 <sup>
100m2 <sub>

Lists

Ordered & unordered lists

Unordered lists (default)
<ul>

  • List item 1
  • List item 2
  • List item 3
  • List item 4

Tick lists
<ul class="list-ticks">

  • Tick List item 1
  • Tick List item 2
  • Tick List item 3
  • Tick List item 4

Ordered lists
<ol>

  1. List item 1
  2. List item 2
  3. List item 3
  4. List item 4

Icons

Default icon font pack

We use icon fonts throughout this theme. Icons should default to a size of 24px x 24px and use the .icon class. If you require a different size use a .size-* modifier class. If you wish to change the pre-built sizes, you can modify the CSS variable values.

~/theme/common/fonts/spark-icons/selection.json contains all icon data which can be managed via IcoMoon. To make changes load the selection.json file into IcoMoon, load/change your icons. Then, import the resulting web fonts into Evance and modify the style.css file as required.

  • .woff2 files/types should be relabelled as .woff due to a temporary issue in Evance.
  • When importing new SVGs into IcoMoon be sure to reset any fill properties to currentColor unless the design requires coloured icons.
.size-small --icon-size-small
Default --icon-size
.size-large --icon-size-large
.size-xl --icon-size-xl

You can wrap icons within an .spaced-group class to space them.

Note, SVG icons may be added using the new <ev:icon> tag, however this is not fully implemented.


Brands

Brand/social icons font

This theme currently uses icon fonts for .brand-icon, which also respect the .size-* modifier classes. If you require a different size use a modifier class, unless the size change is global to the theme.

You can wrap icons within an .spaced-group class to space them.


Buttons

Buttons & icon buttons

Some buttons are associated with Evance's built-in <ev:button>, which are used for Forms and Checkout. However, some are custom to this theme.

Evance's built-in <ev:button> styles support buttons as <button> or as a <a> depending on whether an href attribute is supplied. Below, we output both so you can ensure styling for both tag types is identical in appearance.

<button> <a>
Subtle button

.button-subtle
Should typically have a transparent idle state. Therefore is useful for secondary actions, or navigational icons.

Default button

.button
The default button style is used in most cases for linking between pages where the action is not impactful enough to be the primary action for the viewable area. Also the default style for <ev:button>

Action button

.button-primary
Use a primary button to call attention to an action on a form or to highlight the strongest call to action on a page or viewable area.

Proceed button
Danger button

.button-danger
Represents an irreversible/destructive action such as deleting. Very rarely used on websites.


Round buttons using the .shape-round modifier are intended for use with icons, or numbering (e.g. with pagination).

 

Using a .size-* modifier.

 

Use the .is-loading modifier only with <ev:button> when implementing load interactions.


Forms

Form fields

Input fields MUST have a minimum font-size of 16px/1rem to avoid zoom-in on focus on mobile devices.

<ev:textfield>
Text fields should default to full-width of their available space and should have the same size variations as <ev:button>.

Hellohello

<ev:textarea>
Text areas should have the same border and highlights as <ev:textfield>.

255 Characters remaining

<ev:switch>

<ev:checkbox>

<ev:radio>

<ev:select>

Untitled Button

EV Icons

EV Icon Test

SVG fill color has been changed to "currentColor"

General Icons

Arrow Icons

Brand Icons

Miscellaneous Icons

Reviews Icons

Wishlist Icons


EV Buttons containing Icons

EV Buttons containing Icons test

<ev:button class="button-subtle" icon-start="cart" icon-end="cart" />

<ev:button icon-start="cart" icon-end="user" />

<ev:button class="button-primary" icon-start="cart" icon-end="user" />

<ev:button class="button-danger" icon-start="cart" icon-end="close" />

EV Primary Buttons Shape Round

Social Icons Partial

All social icons have been set to appear within the partial using, for example, <?ev website.links.facebook = true;?> , NOT via the CMS.

Share Icons Partial

<?ev:bubble?> test

  • First item in bubble
  • Second item in bubble
  • Third item in bubble