PATTERN LIBRARIES

CSSPATTERN

LIBRARIES

Whois this guy?

Began in the web in 1995Full CSS sites in 2002 Skills: UX, front-end dev, trainingRecently: CSS pattern libraries

I have helped develop HTML/CSS pattern libraries for very large sites (media and university sites) and complex applications (banking applications).

In some cases, there are literally hundreds of CSS, SCSS or LESS files to review and optimise as part of the process.

pages

Moving away from

A few years ago, many front end developers approached websites and web applications as a series of “pages”.

Pages were often designed and built as complete entities. This meant that page components were often closely tied to their relevant pages.

More recently, the focus has shifted from full page layouts to re-usable components.

A re-usable component could be a layout grid structure, a button, an input, a drop-down, a menu, a heading, a table, or even a pullquote.

pattern libraries HTML/CSS

HTML/CSS pattern libraries are used to resolve commonly used interface components. These components are created as HTML and CSS code and documented, so that they can be easily re-used as needed.

The terms “style guide” and “pattern library” are often used interchangeably.

A style guide is a set of standards for implementing the overall design, and can include corporate branding, color schemes, layout and more.

Style guides are used to ensure uniformity of the design or “brand” across all aspects of the website or application.

On the other hand, HTML/CSS pattern libraries generally document code components for all aspects of the website or application.

On larger web projects, style guides and HTML/CSS pattern libraries are generally separate entities.

For smaller web projects, style guides and pattern libraries are often combined into one overall entity.

cons?

Pros and

Why use a pattern library at all?!

Easier to build sitesEasier to maintain sitesEasier to hand overBetter workflowShared vocabularyPromotes consistency

What are the downsides?!

Time-consuming to writeOften done post-projectServe current need only

Pre-existingpattern libraries

There are a wide range of pre-existing pattern libraries available today.

Some of these pattern libraries have a simple purpose - such as responsive grid systems.

Grid-based CSS libraries

1140 CSS Grid Mueller Grid System

Responsive Grid SystemResponsive Grid System

Less Framework960 Grid System

Susy 320 and up

http://cssgrid.net/http://www.muellergridsystem.com/http://www.responsivegridsystem.com/http://responsive.gs/http://lessframework.com/http://960.gs/http://susy.oddbird.net/https://github.com/malarkey/320andup

Others are considered full “frameworks” that offer a wide range of components.

These can include:!

Reset stylesGrid systemsTypography stylesBrowser fixesCommon user-interface component styles

Complex CSS libraries

BootstrapFoundation

SkeletonYAML

InuitKraken

GumbyFramework

http://twitter.github.com/bootstrap/http://foundation.zurb.com/http://www.getskeleton.com/http://www.yaml.de/https://github.com/csswizardry/inuit.css/https://github.com/cferdinandi/krakenhttp://gumbyframework.com/

There are some great benefits to using an existing framework:!

ready-to-use solutioncan pick & choose componentseasy implementationquick prototyping great for teams

There may also be some downsides:!

may not suit your projectno need for a complex librarysomeone else’s conventions generic look

Bootstrap

Bootstrap vs. mid-range website

Bootstrap vs. University data site

Bootstrap vs. Banking application

Should you use a pre-existing framework? It depends on the needs of the site and your team. There is no one answer.

Assuming you want to create your own CSS pattern library, how do you go about it?

abstractionUnderstanding

Abstraction is essential to any CSS pattern library.

The process involves:!

looking for components that may be repeated within the layoutdefining their characteristics creating HTML/CSS patterns for them

1. !

2. 3.

An example: coloured boxes

These boxes look like they have similar characteristics. If they were resolved into a pattern, this would make our HTML and CSS more efficient.

What are the key things to keep in mind when creating any pattern?

Avoid using IDs

All patterns needs to be class-based so they can appear as many times as needed within an HTML document.

/* avoid */!#signup-box { }!

Avoid naming based on content

We should avoid naming patterns based on the content, as we want to reuse these patterns often within the layout.

/* avoid */!.signup { }!.member { }!.member-news { }!.wiki { }!.support { }!.database { }!!/* preferred */!.box { }

Avoid location-based styles

All patterns should work regardless of where they’re placed within the layout.

/* avoid */!.sidebar .box { }!.main .box { }!!/* preferred */!.box { }

Avoid widths

Ideally, patterns should avoid defining widths. Patterns should be allowed to spread to the width of any parent container.

/* avoid */!.box-wide { width: 500px; }!.box-medium { width: 240px; }!.box-small { width: 120px; }!!/* preferred */!.box { /* no width defined */ }

Keep patterns as simple as possible

Patterns should be defined as simply as possible. Otherwise they can become restrictive.

.box!{!! border-bottom: 5px solid #C8C8C8;!! background-color: #e6e6e6;!! /* may not be suitable */!! margin-bottom: 1em;!}

Don’t undo

Patterns should not be written to undo other rules. For example, the <h3> element:

We could be tempted to style the <h3> element with a coloured background - as it looks like this is the “default” appearance for all <h3> elements.

/* default style */!h3!{!! padding: 1em;!! color: white;!! background-color: red;!}

But what happens if we needed to use an <h3> element later, and it doesn’t have a background-color? We might have to write a rule to undo our previous one.

/* default style */!h3!{!! padding: 1em;!! color: white;!! background-color: red;!}!!/* undoing default style */!.no-background !{!! padding: 0;!! color: #000;!! background-color: none;!}!

It is best to avoid over-styling elements or patterns so that they do not have to be undone later.

/* default style */!h3!{!}!!/* only when background needed */!.class-name!{!! padding: 1em;!! color: white;!! background-color: red;!}!

Avoid dependency on HTML structure

Patterns should not rely on the HTML structure. What happens if the structure changes in some instances - like a different heading level being used?

<div class="box">!! <h3></h3>!<div>!!<div class="box">!! <h4></h4>!<div>!!!/* avoid if possible */!.box h3, .box h4!{!! padding: 10px; !! background-color: orange; !}!!

It is always better to create a class-based pattern for any specific styling needs.

<div class="box">!! <h3 class="box-heading"></h3>!<div>!!<div class="box">!! <h4 class="box-heading"></h4>!<div>!!!/* preferred */!.box-heading!{!! padding: 10px; !! background-color: orange; !}!

Modules,modifiers & descendants

How can we let developers know that our new class called “box-heading” relates to the “box” class?

<div class="box">!! <h3 class="box-heading"></h3>!<div>!

We could use a naming convention that was originally defined as part of BEM:!http://bem.info/

And then extended by Nicolas Gallagher:!http://nicolasgallagher.com/about-html-semantics-front-end-architecture/

And then modified slightly again by Harry Roberts:!http://csswizardry.com/2013/01/mindbemding-getting-your-head-round-bem-syntax/

This naming convention is based on the idea that page layouts can be broken down into a series of re-usable “modules”.

If a module needs to be modified or extended, a “module modifier” would be used.

If a module has child elements that need to be styled, a “module descendant” could be used.

These different types of class names need to be relatable and recognisable.

/* Module */!.module-name {}!!/* Module modifier*/!.module-name--modifier-name {}!!/* Module descendant*/!.module-name__descendant-name {}!!/* Module descendant modifier*/!.module-name__descendant--modifier {}!

<!-- Module -->!<div class="box"></div>!!<!-- Module modifier -->!<div class="box box--alt"></div>!!<!-- Module descendant -->!<div class="box">!! <h3 class="box__heading"></h3>!</div>!!<!-- Module descendant modifier -->!<div class="box">!! <h3 class="box__content box__content--alt"></h3>!</div>!

Module descendants

With this naming convention, we can now add two “module descendants” to our HTML markup:

<!-- Module -->!<div class="box">!!! <!-- Module descendant -->!! <h3 class="box__heading"></h3>!!! <!-- Module descendant -->!! <div class="box__content"></div>!</div>!

.box!{!! margin-bottom: 1em;!! border-bottom: 5px solid #C8C8C8;!! background-color: #e6e6e6;!}!!.box__heading!{!! margin: 0;!! padding: 10px 15px;!! text-transform: uppercase;!}!!.box__content { margin: 15px; }!

Module modifiers

But what about the boxes that are very similar, but have some unique characteristics - like the decorative cog image?

If we needed to modify or extend the original module, we would create a modifier class name.

<!-- Module modifier -->!<div class="box box--alt">!! <h3 class="box__heading"></h3>!! <div class="box__content"></div>!</div>!

However, in this case, we need to modify the “box__content” class. We need to create a “module descendant modifier”.

<!-- Module modifier -->!<div class="box">!! <h3 class="box__heading"></h3>!! <div class="box__content box__content—cog"></div>!</div>!

.box__content--cog!{!! padding-right: 100px;!! background-image: url(cog.png);!! background-repeat: no-repeat;!! background-position: 100% 0;!}!

Helperclasses

In one of the boxes, there is a piece of text that is aligned to the right. How do we solve this?

We could make it another module descendant - and apply this to the link.

.box__link {}!!!!<div class="box">!! <h3 class="box__heading"></h3>!! <div class="box__content">!! ! <p class="box__link"></p>!! </div>!</div>!!

Or we could use a different type of class, called a “helper” or “utility” class.

Nicolas Gallagher’s SUIT CSS includes a set of classes called “utilities”.!https://github.com/suitcss/suit

/* Utility classes */!.u-utilityName {}!!!<!-- example markup --> !<article class="Tweet">!! <a class="u-floatRight"></a>!! <div class="u-sizeFill">!! ! <a class="u-linkComplex"></a>!! </div>!</article>!

Bootstrap also uses these types of classes, but calls them “helper” classes.!http://getbootstrap.com/css/#helper-classes

/* Utility classes */!.text-muted { color: #777; } !.text-primary { color: #428bca; }!.text-success { color: #3c763d; }!!!<!-- example markup --> !<p class="text-muted">...</p>!<p class="text-primary">...</p>!<p class="text-success">...</p>

These types of classes are designed to be added to elements where needed, without having to resort to styling elements individually.

/* Helper classes */!.h-text-right { text-align: right; }!!!!!<!-- example markup --> !<p class="h-text-right">!! <a href="#">More</a>!</p>!

For front-end developers who grew up in the “keep your markup clean” era, these classes could be considered the work of Satan.

I’ve found them to be invaluable - when you need to add a single function to an element without having to create a specific class.

Theme classes

In 2011, Jonathan Snook introduced SMACSS. One of the key principles is to categorise CSS rules into five different categories.!https://smacss.com/

Base - HTML elementsLayout - gridsModule - reusable componentsState - states of modules etcTheme - theming modules etc

These categories are a great way to break up huge chunks of CSS rules into manageable sections.

We could use one of these categories - theme styles - to define the background-colors on our headings.

<h3 class="box__heading bgcolor-red"></h3>!<h3 class="box__heading bgcolor-blue"></h3>!<h3 class="box__heading bgcolor-orange"></h3>!<h4 class="box__heading bgcolor-grey"></h4>!

.bgcolor-red, .bgcolor-blue, .bgcolor-orange, .bgcolor-grey { color: #fff; }!!.bgcolor-red !{ background-color: #B21F24; }!!.bgcolor-blue !{ background-color: #1D5980; }!!.bgcolor-orange !{ background-color: #C56F00; }!!.bgcolor-grey !{ background-color: #444445; }

TipsPattern library

Here are some tips on the overall approach to CSS pattern libraries.

Smallest to largest

In mid 2013, Brad Frost introduced Atomic Design - a methodology for creating design systems with five distinct levels in atomic design.!http://bradfrostweb.com/blog/post/atomic-web-design/

Atoms - HTML elementsMolecules - groups of atomsOrganisms - groups of moleculesTemplates - groups of organismsPages - instances of templates

Atomic design defines the process as starting from smallest components and building to largest.

Ideally, large components should not need to be defined in a pattern library as they should be build up, like lego, from smaller components.

Class names

Establish a class naming convention as early as possible in the process. Then document this convention and enforce it!

Intuitive class names

Make sure any class naming convention is easy for others to follow. I have worked on projects where teams are constantly changing, so quick take-up is critical.

Keep it simple

I’ve worked on projects where the LESS architecture needs to be mapped out in spreadsheets in order for teams to understand. In almost all cases, this was unnecessary. Keep it as simple as possible.

Finalthoughts?

Bottom line: HTML/CSS pattern libraries are an important tool for anyone doing CSS today no matter how large or small your website. Get out there and get busy!

Russ WeakleyMax Design!Site: maxdesign.com.auTwitter: twitter.com/russmaxdesignSlideshare: slideshare.net/maxdesignLinkedin: linkedin.com/in/russweakley