Packs
Discover our innovative range of efficient refrigeration packs designed to meet your cooling needs whilst maintaining a low environmental impact.
Introduction
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
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
Unordered lists (default)
<ul>
Tick lists
<ul class="list-ticks">
Ordered lists
<ol>
Icons
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.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
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
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 |
|
|
| Default button |
|
|
| Action button |
|
|
| Proceed button | ||
| Danger button |
|
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
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>.
<ev:textarea>
Text areas should have the same border and highlights as <ev:textfield>.
<ev:switch>
<ev:checkbox>
<ev:radio>
<ev:select>
EV Icons
SVG fill color has been changed to "currentColor"
EV Buttons containing Icons
<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" />
All social icons have been set to appear within the partial using, for example, <?ev website.links.facebook = true;?> , NOT via the CMS.
This tabbed carousel will traverse the first two descendant levels of "/products". The first child level will appear as clickable tabs, The second will appear as a carousel.