Global Configuration

variables

$mqs

Since 1.0.0
$mqs: true !default;
View source

Description

Whether or not to print media queries in your stylesheet. If you set this to false, it will print media queries in the order they are declared so that desktop styles will always override mobile styles, regardless of screen size. This is mostly useful for browsers which do not support media queries.

Used by

$xs

Since 1.2.0
$xs: 500px !default;
View source

Description

The window width at which extra small styles will begin. By default, this is set to target most large phones.

$sm

Since 1.2.0
$sm: 768px !default;
View source

Description

The window width at which small styles will begin. By default, this is set to target most small tablets and iPads in vertical orientation.

Used by

$md

Since 1.2.0
$md: 992px !default;
View source

Description

The window width at which medium styles will begin. By default, this is set to target older desktops and iPads in horizontal orientation.

Used by

$lg

Since 1.2.0
$lg: 1200px !default;
View source

Description

The window width at which large styles will begin. By default, this is set to target most laptops.

Used by

$xl

Since 1.2.0
$xl: 1500px !default;
View source

Description

The window width at which extra large styles will begin. By default, this is set to target most modern desktops.

$lte-ie8-target-width

Since 2.0.0
$lte-ie8-target-width: $lg !default;
View source

Description

The window width to target for IE8 and below. Because older versions of IE don't support media queries, we use this width to target the most likely browser width an older IE user will be viewing the site in.

Used by

$margin

Since 2.0.0
$margin: 30px !default;
View source

Description

The base margin to use sitewide. All margins are based on this number. Larger margins will be a multiple of this, smaller margins will be a fraction of this, except in cases of UI or typography where margin should be related to font size.

$margin-small

Since 2.0.0
$margin-small: $margin / 2 !default;
View source

Description

The base margin to use for content sitewide. This affects floated content in the WordPress editor, and would be good for any sort of floated content you may add in a custom theme, like a floated callout.

$margin-large

Since 2.0.0
$margin-large: $margin * 2 !default;
View source

Description

The base margin to use for large spacing sitewide. This affects elements like the banner, section tags, and any other larger elements.

$padding

Since 2.0.0
$padding: 30px !default;
View source

Description

The base padding to use sitewide. All padding is based on this number. Larger padding will be a multiple of this, smaller padding will be a fraction of this.

$padding-small

Since 2.0.0
$padding-small: $padding / 2 !default;
View source

Description

A padding variable for situations where you need a smaller amount of padding.

$padding-large

Since 2.0.0
$padding-large: $padding * 2 !default;
View source

Description

A padding variable for situations where you need a larger amount of padding.

$tint-hue

Since 2.0.0
$tint-hue: none !default;
View source

Description

A color to tint your grays with. Affects grayscale variables. Try cool colors, like blues. Accepts any valid color.

Type

Color

Used by

$tint-saturation

Since 2.0.0
$tint-saturation: 15% !default;
View source

Description

The amount to tint your grays, from 0-100%. This will affect the maximum saturation of your tint.

Used by

$color-grayscale-0

Since 1.0.0
$color-grayscale-0: tint-gray( #000 );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a plain black. Overriding this variable is not supported.

Used by

$color-grayscale-1

Since 1.0.0
$color-grayscale-1: tint-gray( #111 );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a very dark gray suitable for text. Overriding this variable is not supported.

$color-grayscale-2

Since 1.0.0
$color-grayscale-2: tint-gray( #222 );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a very dark gray suitable for text. Overriding this variable is not supported.

$color-grayscale-3

Since 1.0.0
$color-grayscale-3: tint-gray( #333 );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a dark gray suitable for text or backgrounds. Overriding this variable is not supported.

$color-grayscale-4

Since 1.0.0
$color-grayscale-4: tint-gray( #444 );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a dark gray suitable for backgrounds or metadata. Overriding this variable is not supported.

$color-grayscale-5

Since 1.0.0
$color-grayscale-5: tint-gray( #555 );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a dark gray suitable for backgrounds. Overriding this variable is not supported.

$color-grayscale-6

Since 1.0.0
$color-grayscale-6: tint-gray( #666 );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a middle gray suitable for backgrounds or large typography. Overriding this variable is not supported.

$color-grayscale-7

Since 1.0.0
$color-grayscale-7: tint-gray( #777 );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a middle gray suitable for backgrounds or large typography. Overriding this variable is not supported.

Used by

$color-grayscale-8

Since 1.0.0
$color-grayscale-8: tint-gray( #888 );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a middle gray suitable for backgrounds or large typography. Overriding this variable is not supported.

$color-grayscale-9

Since 1.0.0
$color-grayscale-9: tint-gray( #999 );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a middle gray suitable for backgrounds or large typography. Overriding this variable is not supported.

$color-grayscale-a

Since 1.0.0
$color-grayscale-a: tint-gray( #aaa );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a middle gray suitable for backgrounds. Overriding this variable is not supported.

$color-grayscale-b

Since 1.0.0
$color-grayscale-b: tint-gray( #bbb );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a light gray suitable for backgrounds. Overriding this variable is not supported.

$color-grayscale-c

Since 1.0.0
$color-grayscale-c: tint-gray( #ccc );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a light gray suitable for backgrounds, borders, and metadata. Overriding this variable is not supported.

$color-grayscale-d

Since 1.0.0
$color-grayscale-d: tint-gray( #ddd );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a light gray suitable for backgrounds. Overriding this variable is not supported.

Used by

$color-grayscale-e

Since 1.0.0
$color-grayscale-e: tint-gray( #eee );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a light gray suitable for backgrounds. Overriding this variable is not supported.

$color-grayscale-f0

Since 1.0.0
$color-grayscale-f0: tint-gray( #f0f0f0 );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a near-white gray suitable for backgrounds. Overriding this variable is not supported.

$color-grayscale-f5

Since 1.0.0
$color-grayscale-f5: tint-gray( #f5f5f5 );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a near-white gray suitable for backgrounds. Overriding this variable is not supported.

$color-grayscale-f

Since 1.0.0
$color-grayscale-f: tint-gray( #fff );
View source

Description

A grayscale variable that takes advantage of the tint system. Produces a plain white. Overriding this variable is not supported.

$color-hub

Since 2.0.0
$color-hub: #767676;
View source

Description

A grayscale variable for hover state of the BU Hub webfont. Not intended for editing.

Type

Color

$border

Since 1.2.0
$border: 1px solid $color-grayscale-d !default;
View source

Description

The default border style.

$font-family-form

Since 1.0.0
$font-family-form: $font-family-sans-serif !default;
View source

Description

Controls the font family used in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-legend-border

Since 1.0.0
$form-legend-border: $border !default;
View source

Description

Controls the border on the legend in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-legend-margin

Since 1.0.0
$form-legend-margin: 0 0 $margin !default;
View source

Description

Controls the margin on the legend in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-legend-padding

Since 1.0.0
$form-legend-padding: 0 0 0.5em !default;
View source

Description

Controls the padding on the legend in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-fieldset-border

Since 1.0.0
$form-fieldset-border: 0 !default;
View source

Description

Controls the border on fieldsets in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-fieldset-margin

Since 1.0.0
$form-fieldset-margin: $margin 0 !default;
View source

Description

Controls the margin on the fieldset in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-fieldset-padding

Since 1.0.0
$form-fieldset-padding: 0 !default;
View source

Description

Controls the padding on the fieldset in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-label-margin

Since 1.0.0
$form-label-margin: 0.5em 0 !default;
View source

Description

Controls the margin on labels in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-row-margin

Since 1.0.0
$form-row-margin: 0 0 $margin-small !default;
View source

Description

Controls the margin on rows in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-input-margin

Since 1.0.0
$form-input-margin: 0 0 $margin-small !default;
View source

Description

Controls the margin on inputs in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-input-padding

Since 1.0.0
$form-input-padding: 0.5em !default;
View source

Description

Controls the padding on inputs in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-input-border

Since 1.0.0
$form-input-border: $border !default;
View source

Description

Controls the border on inputs in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-input-shadow

Since 1.0.0
$form-input-shadow: inset 0 1px 3px $color-grayscale-e !default;
View source

Description

Controls the inner shadow on inputs in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-input-border-radius

Since 1.0.0
$form-input-border-radius: 0 !default;
View source

Description

Controls the border radius on inputs in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$form-input-focus-shadow

Since 1.0.0
$form-input-focus-shadow: 0 0 4px 0 rgba( 18, 159, 234, 0.2 ) !default;
View source

Description

Controls the shadow on focused inputs. This is important for accessibility. Always test with a keyboard if you change this style to ensure it is still clear which item is keyboard focused afterwards. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$color-input-focus-border

Since 1.0.0
$color-input-focus-border: #129fea !default;
View source

Description

Controls the border on focused inputs. This is important for accessibility. Always test with a keyboard if you change this style to ensure it is still clear which item is keyboard focused afterwards. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

$font-family-button

Since 1.0.0
$font-family-button: $font-family-sans-serif !default;
View source

Description

Controls the font used on all buttons and things that looks like buttons across the site.

Used by

$font-size-button

Since 1.0.0
$font-size-button: inherit !default;
View source

Description

Controls the font size used on all buttons and things that looks like buttons across the site.

Used by

$color-button-bg

Since 1.0.0
$color-button-bg: $color-grayscale-e !default;
View source

Description

Controls the background color used on default buttons and things that looks like buttons across the site.

Used by

$color-button-text

Since 1.0.0
$color-button-text: $color-grayscale-4 !default;
View source

Description

Controls the text color used on default buttons and things that looks like buttons across the site.

Used by

$color-button-primary-bg

Since 1.0.0
$color-button-primary-bg: #0074E0 !default;
View source

Description

Controls the background color used on primary buttons and things that looks like buttons across the site.

Used by

$color-button-primary-text

Since 1.0.0
$color-button-primary-text: $color-grayscale-f !default;
View source

Description

Controls the text color used on primary buttons and things that looks like buttons across the site.

Used by

$margin-button

Since 2.0.0
$margin-button: 0 $margin-small $margin-small 0 !default;
View source

Description

Controls the margin on buttons in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

Used by

$padding-button

Since 2.0.0
$padding-button: 0.5em 1em !default;
View source

Description

Controls the margin on buttons in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

Used by

$border-button

Since 2.0.0
$border-button: 0;
View source

Description

Controls the border on buttons.

Used by

$border-radius-button

Since 2.0.0
$border-radius-button: 2px !default;
View source

Description

Controls the rounding of edges on buttons. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.

Used by

$color-base

Since 1.0.0
$color-base: $color-grayscale-5 !default;
View source

Description

Controls the default color used for text across the site. Affects body text and anything else that isn't specifically overridden.

$margin-section

Since 2.0.0
$margin-section: $margin-large 0 0 !default;
View source

Description

Base margin for the section tag.

$min-size-headings

Since 2.0.0
$min-size-headings: $font-size-base !default;
View source

Description

The minimum font size in pixels for headings to use. Unless you're a designer and you know what you're doing, leave this at $font-size-base. Anything lower means you'll need to compensate with other design elements to preserve the visual hierarchy - think uppercasing, color, stuff like that. This directly affects the <h6> tag. It indirectly affects all other heading font sizes as well by serving as the lower limit to our scale.

$max-size-headings

Since 2.0.0
$max-size-headings: 55px !default;
View source

Description

The maximum font size in pixels for headings to use. This directly affects <h1> headings within content. Do not use a larger value, such as those you might find on a landing page or in a homepage slider, to determine this value. Be sure to test it against deeply nested pages, which tend to have longer page titles. It indirectly affects all other heading font sizes as well by serving as the upper limit to our scale.

$max-size-headings-mobile

Since 2.0.0
$max-size-headings-mobile: 36px !default;
View source

Description

The maximum font size in pixels for headings to use on mobile. This directly affects <h1> headings within content. Do not use a larger value, such as those you might find on a landing page or in a homepage slider, to determine this value. Be sure to test it against deeply nested pages, which tend to have longer page titles. It indirectly affects all other heading font sizes as well by serving as the upper limit to our scale.

$min-line-height

Since 2.0.0
$min-line-height: 1.15 !default;
View source

Description

The minimum line height ratio for headings to use. Do not use any units with this value. This value directly affects the <h1> tag and indirectly affects all other heading font sizes as well by serving as the lower limit to our scale. In typography, the relationship between font-size and line-height is that larger font-sizes demand lower line-height values to preserve vertical rhythm.

$max-line-height

Since 2.0.0
$max-line-height: $line-height-base !default;
View source

Description

The maximum line height ratio for headings to use. Do not use any units with this value. This value directly affects the <h6> tag and indirectly affects all other heading font sizes as well by serving as the upper limit to our scale. Because we set the <h6> tag to be the same size as our body copy by default, it also gets the same line-height ratio by default.

$font-styles

Since 2.0.0
$font-styles: (
	secondary: (
	  	font-size-mobile: 12px,
	  	font-size-desktop: 16px,
		line-height: $min-line-height,
	),
	minimum: (
    	font-size-mobile: 11px,
		font-size-desktop: 13px,
		line-height: $min-line-height
	),
);
View source

Description

Holds values for font-size and line-height for all font styles. Two special case scenarios, font-size-secondary and font-size-minimum, have pixel values. Secondary is used for information in a theme that is secondary to main content, such as widgets, asides, footbars, and shortcodes, and resets the base value which headings and paragraph text uses. font-size-minimum is the lowest allowable font size in pixels - it never gets scaled, because it should never be smaller than that amount. Other values, such as those used for headings (font-size-1 for <h1>, font-size-2 for <h2>, etc) are dynamically added after we generate the headings scale. These values are used to build the font-size placeholders. You can override invidividual values and create your own custom values and placeholders by redeclaring values you want to override and adding new values in your own $font-styles-theme map.

$font-size-base

Since 1.0.0
$font-size-base: 18px !default;
View source

Description

Controls the default font size used across the site. Affects body text and anything else that isn't specifically overridden.

$line-height-base

Since 1.0.0
$line-height-base: 1.6 !default;
View source

Description

Controls the default line height used across the site. Affects body text and anything else that isn't specifically overridden.

$font-family-serif

Since 1.0.0
$font-family-serif: "TiemposText", Georgia, serif !default;
View source

Description

A serif font to use. This variable is not used by default.

$font-family-base

Since 1.0.0
$font-family-base: $font-family-sans-serif !default;
View source

Description

The default font for body copy.

functions

Since 2.0.0
@function tint-gray() { ... }
View source

Description

A tinting helper function for grayscale variables. If you're adding your own grays and want to take advantage of tinting, you can use this function to tint your grays. The actual tint is dependent on two variables: $tint-hue, which is the color to use as a tint, and $tint-saturation, which is the maximum saturation of that tint. More saturation happens with dark colors, less or none with very light colors.

Parameters

None.

Requires

Since 2.0.0
@function calc-scale($min, $max, $steps) { ... }
View source

Description

Calculates the multiplier needed for growth between a minimum and maximum value based on a given rate of growth.

Parameters

parameter Nameparameter Descriptionparameter Typeparameter Default value
$min

The minimum value to use. Units, if used, must match $max.

Int none
$max

The minimum value to use. Units, if used, must match $min.

Int none
$steps

The total number of values to calculate.

Int none

Returns

Int

A number to multiply by in an exponential equation to equal the maximum value on the last value calculated. Useful to calculate $scale for use in the calc-size function.

See

Since 2.0.0
@function calc-size($step, $rate, $scale, $min, $scaled, $base) { ... }
View source

Description

Calculates a size, relative to a base size. By default, we use $font-size-base to assist with calculating the ratio for ems. However, you can pass your own base for using with your own unit standard. You can also choose not to scale by passing 'true' to 'scaled'. You might choose to do this if your minimums and maximums are already scaled units, such as with line-height, or if you specify your min and max font-sizes in ems.

Parameters

parameter Nameparameter Descriptionparameter Typeparameter Default value
$step

The step within your scale you want to calculate.

Int none
$rate

The rate of growth at which your scale changes. Leave at 1 for even (linear) growth. Anything higher will create exponential growth.

Int none
$scale

A scaling number determined by your maximum value, if you have one. You may wish to use the calc-scale function to find this number. Leave at 1 if you do not need an upper limit.

Int none
$min

The minimum amount you need returned.

Int none
$scaled

Whether or not to return a scaled value, using $base as the base unit. By default, this will scale to ems, returning a value based on $font-size-base equalling 1 em.

Bool none
$base

A value to divide by in order to return a scaled value. The units on this value need to match $min - that is, if $min is in pixels, this needs to be in pixels as well.

Int none

Returns

Int

A unitless size.

See

css

section

Since 1.0.0
section { ... }
View source

Description

Controls spacing between section tags.

table

Since 1.0.0
table { ... }
View source

Description

Controls base styling for tables.

.table-striped tr:nth-child(2n-1), .u-odd

Since 1.0.0
.table-striped tr:nth-child(2n-1),
.u-odd { ... }
View source

Description

Adds stripes to tables.

.table-bordered

Since 1.0.0
.table-bordered { ... }
View source

Description

Adds both horizontal and vertical borders.

.table-horizontal

Since 1.0.0
.table-horizontal { ... }
View source

Description

Switches the border on tables from vertical to horizontal.

body

Since 1.0.0
body { ... }
View source

Description

Base styles and typography for all HTML elements.

a

Since 1.0.0
a { ... }
View source

Description

Controls base styling for all links.

Helpers

placeholders

%clearfix

Since 1.0.0
%clearfix { ... }
View source

Description

Clears floats on a container. Use when an element contains floated items and isn't getting the correct height because it doesn't recognize the height of the floated child items. Based on Nicolas Gallagher's micro clearfix. More info: http://nicolasgallagher.com/micro-clearfix-hack/

Example

Clear degree items in a degree programs panel so
the degree programs background is applied properly.
	.degree-programs {
	@extend %clearfix;
	background: $color-grayscale-0;
}

	.degree-item {
	@extend %col-md-quarter;
}

Used by

%hide-text

Since 1.0.0
%hide-text { ... }
View source

Description

Hides text in an element visually, but preserves width and height and screen reader visibility. Use this placeholder to hide text when you need a visual representation of the screen reader text, but the text itself isn't desirable to have in your design, such as in a logo. For example, this placeholder is used to hide the text on the BU masterplate and BUMC logo in the footer. In cases where there is no visual component to worry about, %visually-hidden is preferred because it supports right-to-left languages and will be safer if a site is ever translated. More info on this technique: http://www.zeldman.com/2012/03/01/replacing-the-9999px-hack-new-image-replacement/

Example

Hide text on a logo using a background image.
	.custom-logo {
	@extend %hide-text;
	background-image: url( "images/your-image.jpg" );
}

%visually-hidden

Since 1.0.0
%visually-hidden { ... }
View source

Description

Hides entire elements visually, but preserves visibility for screen readers. Use this placeholder when an element is only for screen readers and needs no visual representation on the site. This is the preferred method of hiding items visually as it works with right-to-left languages, making it a safer choice if a site is ever translated. More info on this technique: http://a11yproject.com/posts/how-to-hide-content/

Example

Hide a label in a button.
	.fancy-button-label {
	@extend %visually-hidden;
}

%remove-visually-hidden

Since 2.0.0
%remove-visually-hidden { ... }
View source

Description

Reverses %visually-hidden. Helpful if you want to unhide a previously hidden label.

Example

Show a previously hidden label for all users.
	.fancy-button-label {
	@extend %remove-visually-hidden;
}

%responsive-video-styles

Since 1.0.0
%responsive-video-styles { ... }
View source

Description

A placeholder for responsive video styles. Use this placeholder if you need something to support responsive video, but you need a separate, unique class from responsive-video. You may also use this to enable responsive behavior on other types of embedded media that don't have a video aspect ratio by extending this to a unique class, and adjusting the padding-bottom value on that class to match the aspect ratio you're looking for.

%resposive-table-styles

Since 1.0.0
%resposive-table-styles { ... }
View source

Description

A placeholder which controls responsive styling for tables. You may want to extend this if you can't use the responsive-table class for some reason, or if you need to make significant overrides and want to leave the base styles intact. You must wrap the class this uses around a table for it to work. It will not work if you just put it on the table.

Requires

%card-styles

Since 1.0.0
%card-styles { ... }
View source

Description

Controls card-like styles used throughout Foundation. By default, this controls single profile info styling in the sidebar, the metadata styling at the bottom of single posts, and the date summary.

Requires

mixins

@include aspect-ratio

Since 3.1.2
@mixin aspect-ratio() { ... }
View source

Description

A mixin for creating aspect ratios. Apply this mixin to the container that should be scalable in size, such as a video wrapper or an image wrapper. This will ensure the targeted element scales in size relative to its parent's width. It then absolutely positions the immediate child of this element so it fills the aspect ratio container.

Parameters

None.

Example

Adds aspect-ratio styling to a parent element and
      absolute positions its immediate child.
	$width: 200;
	$height: 150;
	.foo {
		@include aspect-ratio( $width, $height );
	}

@include border-radius

Since 1.0.0
@mixin border-radius() { ... }
View source

Description

A mixin for border-radius. Takes care of browser prefixes for you. You should always use this mixin when writing border-radius rules to ensure you're compatible with the browsers we support. Accepts arguments in the same syntax as standard CSS. More info at MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/border-radius

Parameters

None.

Example

Create a round profile image for a callout.
the degree programs background is applied properly.
	.profile-callout-image {
	@include border-radius( 50% );
}

Used by

@include box-shadow

Since 1.0.0
@mixin box-shadow() { ... }
View source

Description

A mixin for box-shadow. Takes care of browser prefixes for you. You should always use this mixin when writing box-shadow rules to ensure you're compatible with the browsers we support. Supports multiple shadows, just use the same syntax as you would CSS. More info at MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/box-shadow

Parameters

None.

Example

Create a large, subtle shadow to help a callout
stand out against a complicated background, like
a background photo.
	.feature-callout {
	@include box-shadow( 0px 0px 40px 0px rgba( 0, 0, 0, 0.25 ) );
}

Create a fancy button with an inset highlight and
a shadow around it to help it stand out on a background.
a background photo.
	.fancy-button {
	@include box-shadow(
		inset 0 2px 0px rgba( 255, 255, 255, 0.25 ),
		0px 0px 10px 0px rgba( 0, 0, 0, 0.25 )
	);
}

Used by

@include linear-gradient

Since 1.2.0
@mixin linear-gradient() { ... }
View source

Description

A mixin for linear gradients. Takes care of browser prefixes for you. You should always use this mixin when writing linear gradients rules to ensure you're compatible with the browsers we support. Always to supply a backup background color as well for browsers that do not support gradients. Does not support multiple gradients - you're on your own for that.

Parameters

None.

Example

Create a fancy button with a subtle downward gradient.
	.fancy-button {
	@include linear-gradient( transparent, darken( $your-color, 10% ) );
	background-color: $your-color;
}

Throws

  • The linear gradient mixin requires two valid colors or variables which hold colors. \a Example usage: @include linear-gradient( $from-color, $to-color);

Used by

@include opacity

Since 1.0.0
@mixin opacity() { ... }
View source

Description

A mixin for opacity. Takes care of browser prefixes for you. You should always use this mixin when writing opacity rules to ensure you're compatible with the browsers we support. Accepts arguments in the same syntax as standard CSS. More info at MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/opacity

Parameters

None.

Example

Fade a thumbnail until it's hovered over.
	.gallery-thumbnail {
	@include opacity( 0.5 );

	&:hover {
		@include opacity( 1 );
	}
}

Throws

  • Opacity must be specified as a decimal value. \a Example usage: @include opacity( 0.5 );

@include transition

Since 1.0.0
@mixin transition() { ... }
View source

Description

A mixin for transition. Takes care of browser prefixes for you. You should always use this mixin when writing transition rules to ensure you're compatible with the browsers we support. Supports multiple transitions, just use the same syntax as you would CSS. Please note: you should avoid trasition all, as it can become a significant performance issue on older devices. The cheapest properties to animate performance-wise are transform, opacity, and filter - if you're not sure what you're doing, it's best to stick to those where possible. Learn how to test animation performance: https://www.sitepoint.com/check-css-animation-performance-with-the-browsers-dev-tools/ Syntax info at MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/transition

Parameters

None.

Example

	Transition the opacity on a lightbox when it is opened.
		.lightbox-overlay {
		@include opacity( 0 );
		@include transition( opacity 250ms ease-in-out 0s );

		&.open {
			@include opacity( 1 );
			@include transition( opacity 250ms ease-in-out 0s );
		}
	}

	Transition multiple properties between hidden and visible item states
for a filter and ensure that certain properties are applied to the
animation immediately using the `step-start` timing function.
	Note the delay on opacity.
		.degree-program-hidden {
		@include opacity( 0 );
		@include scale( 1, 0 );
		z-index: 1;

		@include transition(
			opacity 250ms ease-in-out .2s,
			transform 250ms ease-in-out 0s,
			z-index 0s step-start 0s
		);
	}
		.degree-program-visible {
		@include opacity( 1 );
		@include scale( 1, 1 );
		z-index: 2;

		@include transition(
			opacity 250ms step-end .2s,
			transform 250ms ease-out 0s,
			z-index 0s step-start 0s
		);
	}

@include transform

Since 1.0.0
@mixin transform() { ... }
View source

Description

A mixin for transform. Takes care of browser prefixes for you. You should always use this mixin when writing transform rules to ensure you're compatible with the browsers we support. Supports multiple transforms, just use the same syntax as you would CSS. More info at MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/transform

Parameters

None.

Example

Move a callout.
	.callout {
	@include transform( translateX( 100px ) );
}
Move and rotate a callout.
	.callout-selected {
	@include transform(
		translateX( 100px )
		translateY( 20px )
		rotate( 20deg )
	);
}

Used by

@include rotate

Since 1.0.0
@mixin rotate() { ... }
View source

Description

A shorthand mixin for rotate. Takes care of browser prefixes for you. You could use transform as well. Accepts an amount of degrees to rotate by. More info at MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/transform

Parameters

None.

Example

Rotate a callout 90 degrees.
	.callout {
	@include rotate( 90 );
}

Requires

@include scale

Since 1.0.0
@mixin scale() { ... }
View source

Description

A shorthand mixin for scale. Takes care of browser prefixes for you. You could use transform as well. Accepts an amount of degrees to rotate by. More info at MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/transform

Parameters

None.

Example

Scale a callout to double its size.
	.callout {
	@include scale( 2 );
}
Scale the height of a filtered item from 0 to the full height when visible.
	.degree-program {
	@include scale( 0, 0 );

	&.visible {
		@include scale( 0, 1 );
	}
}

Requires

@include translate

Since 1.0.0
@mixin translate() { ... }
View source

Description

A shorthand mixin for translate. Takes care of browser prefixes for you. You could use transform as well. Accepts two arguments: an amount to translate X by, and an amount to translate Y by. More info at MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/transform

Parameters

None.

Example

Move a callout 10px to the left.
	.callout {
	@include translate( -10px, 0 );
}

Requires

@include transform-origin

Since 1.0.0
@mixin transform-origin() { ... }
View source

Description

A mixin for transform-origin. Takes care of browser prefixes for you. You should always use this mixin when writing transform-origin rules to ensure you're compatible with the browsers we support. Use with transform, rotate, scale, or translate to tell the browser where the transform should start from. Accepts any valid CSS value for transform-origin. More info at MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/transform-origin

Parameters

None.

Example

	Scale the height of a filtered item from 0 to the full height when visible
and start the transform from the top of the item.
		.degree-program {
		@include scale( 0, 0 );
		@include transform-origin( top );

		&.visible {
			@include scale( 0, 1 );
		}
	}

@include keyframes

Since 1.0.0
@mixin keyframes() { ... }
View source

Description

A mixin for keyframes. Takes care of browser prefixes for you. You should always use this mixin when writing keyframe rules to ensure you're compatible with the browsers we support. Use with animation to build complex animations that transition isn't capable of alone and to tightly control timing. Accepts any valid CSS value for keyframes. More info at MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/@keyframes

Parameters

None.

Content

This mixin allows extra content to be passed (through the @content directive).

Example

	Create an infinite loading animation which completes every 250ms
using keyframes and animation.
		@include keyframes( infinite-loader ) {
			from {
				transform: rotate( 0deg );
			}
			to {
				transform: rotate( 360deg );
			}
		}

		.loading {
		@include animation( infinite-loader 250ms infinite );
	}

@include animation

Since 1.0.0
@mixin animation() { ... }
View source

Description

A mixin for animation. Takes care of browser prefixes for you. You should always use this mixin when writing animation rules to ensure you're compatible with the browsers we support. Use with keyframes to build complex animations that transition isn't capable of alone and to tightly control timing. Accepts any valid CSS value for animation, including multiple animation declarations. More info at MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/animation

Parameters

None.

Example

	Create an infinite loading animation which completes every 250ms
using keyframes and animation.
		@include keyframes( infinite-loader ) {
			from {
				transform: rotate( 0deg );
			}
			to {
				transform: rotate( 360deg );
			}
		}

		.loading {
		@include animation( infinite-loader 250ms infinite );
	}

@include vertical-center-child-ie8

Since 1.0.0
Deprecated!

Deprecated in favor of flexbox approach in Responsive 2.0

@mixin vertical-center-child-ie8() { ... }
View source

Description

A deprecated mixin for vertical centering in IE8. This is an older approach that can be used when centering is critical for IE8, such as with branding, or lack of centering will cause usability issues. If neither of these applies, use the newer version, which is simpler, less buggy with regards to positioning, and uses flexbox. With this mixin, you can choose to center all child items, or just a specific selector. You should always try to use the specific selector option where possible to avoid performance issues. This mixin should be used on the parent element of whatever you want to center. Covers vertical centering for IE8 and above; no additional mixins are necessary.

Parameters

None.

Example

Center everything in a callout vertically (bad).
	.callout {
	@include vertical-center-child-ie8;
}
Center only the callout text in a callout vertically (good).
	.callout {
	@include vertical-center-child-ie8( ".callout-text" );
}

@include vertical-center-ie9

Since 1.0.0
Deprecated!

Deprecated in favor of flexbox approach in Responsive 2.0

@mixin vertical-center-ie9() { ... }
View source

Description

A deprecated mixin for vertical centering in IE9 and above. This is an older approach that can be used when centering is critical for IE9. Vertical centering is not available in IE8 using this approach. If this doesn't apply, use the newer version, which is simpler, less buggy with regards to positioning, and uses flexbox. This mixin should be used on the element you want to center. No parent styles are necessary.

Parameters

None.

Example

Vertically center the callout text in a callout.
	.callout {
	@include vertical-center-ie9;
}

@include center-children

Since 2.0.0
@mixin center-children($|, $|, $|, $|) { ... }
View source

Description

A mixin for vertically and horizontally centering all children in modern browsers using flexbox. Use this mixin when centering isn't critical to usability. Older browsers will gracefully degrade and not center. This mixin should be used on the parent of the elements you want to center. By default, this is set to work as-is for most use cases, but you may be interested in tweaking the parameters if you want flexbox-specific functionality.

Parameters

parameter Nameparameter Descriptionparameter Typeparameter Default value
$|

$align-content [center] - Removes the gap between multiple child items.

String none
$|

$align-items [center] - Centers child items vertically.

String none
$|

$flex-wrap [wrap] - Wraps child items so the width behaves as expected.

String none
$|

$justify-content [center] - Centers child items horizontally.

String none

Example

	Center all elements in a callout for modern browsers.
		.callout {
		@include center-children;
	}
	Center all elements in a callout for modern browsers,
but let flexbox decide the width for each child item.
		.callout {
		@include center-children( center, center, nowrap, center );
	}

@include breakpoint

Since 1.0.0
@mixin breakpoint($|) { ... }
View source

Description

A safe way to including responsive styles on old browers which do not fully support media queries, such as IE8. All media queries using this mixin are mobile-first (min-width). This mixin will take all reponsive styles up to a certain point and print them in the order they're written in the ie.css stylesheet, up until the default screen width you set to support in IE8 and below. In most cases, you won't have to change this from $lg, but you can always check Google Analytics to see what the most used screen size is for your site's older IE users if you like, and set it to that. This mixin no longer supports custom media queries like max-width as of 2.0, because those styles do not generally need to be included for old IE to be usable. Instead, you should use a plain CSS media query, which will not interfere with older browsers and degrade gracefully. By default, you'll use this mixin for all your responsive styles, and should only have a few very minor exceptions in media queries.

Parameters

parameter Nameparameter Descriptionparameter Typeparameter Default value
$|

$breakpoint - The window width to begin applying your styles. Can be any pixel value, but $xs, $sm, $md, $lg, and $xl are standard in this framework.

Variable or Number none

Content

This mixin allows extra content to be passed (through the @content directive).

Example

	Change the background of a callout from black to white
on tablets in vertical orientation and larger.
		.callout {
		background: $color-grayscale-0;

		@include breakpoint( $xs ) {
			background: $color-grayscale-f;
		}
	}
	Override the background on a callout to
white, but only on the smallest phones.
		.callout {
		@media screen and ( max-width: $xs - 1 ) {
			background: $color-grayscale-f;
		}
	}

Throws

  • The breakpoint shortcut

Requires

Used by

@include debug-map

Since 2.0.0
@mixin debug-map($|) { ... }
View source

Description

Outputs a sass map neatly in CSS for debugging purposes. Sends output to terminal on compile. From https://www.sitepoint.com/debugging-sass-maps/

Parameters

parameter Nameparameter Descriptionparameter Typeparameter Default value
$|

$map - A sass map to debug.

Map none

@include retina

Since 1.0.0
@mixin retina() { ... }
View source

Description

A shortcut media query for retina devices. Handy for including separate retina images. Accepts blocks of CSS or Sass.

Parameters

None.

Content

This mixin allows extra content to be passed (through the @content directive).

Example

Add a retina-specific logo.
	.custom-logo {
	background: url( "images/custom-logo.jpg" );

	@include retina {
		background: url( "images/custom-logo-retina.jpg" );
	}
}

@include rgba-color

Since 1.0.0
@mixin rgba-color($|, $|, $|) { ... }
View source

Description

Generates backwards-compatible RGBA color CSS by calculating a solid color that looks the same as what a user sees for IE8 and below.

Parameters

parameter Nameparameter Descriptionparameter Typeparameter Default value
$|

$attribute - The CSS attribute to apply your color to.

String none
$|

$color - The rgba color to use for modern browsers.

String none
$|

$background - The background color of the item this will sit on top of, to help calculate an accurate fallback color. Use a solid version of the same color as $color for photos.

String none

Example

	Style a darkened overlay on the bottom half of a callout with
a green background.
		.callout-overlay {
		@include rgba-color( background-color, rgba( $color-grayscale-0, 0.5 ), $green );
	}

Throws

  • The rgba-color mixin requires a valid CSS attribute to apply the color to, a valid RGBA color, and a valid background color to calculate the fallback color. \a Example usage: @include rgba-color(\

css

.responsive-video

Since 1.0.0
.responsive-video { ... }
View source

Description

The default class which enables responsive video. Wrap this around any video or iframe which is not supported by oEmbed, or if you are manually putting in HTML for a video for some reason.

.alignright

Since 1.0.0
.alignright { ... }
View source

Description

The class WordPress generates when you align something right in the visual editor.

.alignleft

Since 1.0.0
.alignleft { ... }
View source

Description

The class WordPress generates when you align something left in the visual editor.

.aligncenter

Since 1.0.0
.aligncenter { ... }
View source

Description

The class WordPress generates when you center something in the visual editor.

.wp-caption-text

Since 1.0.0
.wp-caption-text { ... }
View source

Description

The class WordPress generates for caption text on images in the visual editor.

.responsive-table

Since 1.0.0
.responsive-table { ... }
View source

Description

A class for responsive styling on tables. This class will make the table scrollable below the medium breakpoint. You must wrap the table in a div with this class. It will not work if you put it directly on the table.

.content

Since 1.0.0
.content { ... }
View source

Description

For code within the WordPress content area.

.message

Since 1.0.0
.message { ... }
View source

Description

Controls the styling for messages.

Icons

placeholders

%icon-base

Since 1.2.0
%icon-base { ... }
View source

Description

Provides base icon styles normalized across browsers and optimized for accessibility. Use this placeholder if you are loading your own font library and can't use the built-in icons because the content is different. This should go on your base element. The complimentary placeholder, %icon, needs to go on a :before or :after underneath.

%icon-content

Since 1.2.0
%icon-content { ... }
View source

Description

Provides base icon styles normalized across browsers and optimized for accessibility. Use this placeholder on :before or :after if you are loading your own font library and can't use the built-in icons because the content is different. You will also need the %icon-base placeholder on your hoverable element if you need compatibility before IE9.

Requires

Typography

placeholders

%heading-base

Since 1.0.0
%heading-base { ... }
View source

Description

Controls base styles for all heading tags.

Requires

variables

$font-family-sans-serif

Since 1.0.0
$font-family-sans-serif: "Benton-Sans", "Helvetica", sans-serif !default;
View source

Description

A sans-serif font to use sitewide. By default, this affects the site footer and label text in profiles.

$font-family-monospace

Since 1.0.0
$font-family-monospace: "Consolas", "Liberation Mono", Courier, monospace !default;
View source

Description

A monospace font to use sitewide. By default, this affects the <code> and <pre> elements.

$font-family-heading

Since 1.0.0
$font-family-heading: $font-family-sans-serif !default;
View source

Description

A font to use for headings. Affects <h1>, <h2>, etc.

Used by

$color-heading

Since 1.0.0
$color-heading: $color-grayscale-0 !default;
View source

Description

A color to use for headings. Affects <h1>, <h2>, etc.

Used by

$color-heading-small

Since 1.0.0
$color-heading-small: $color-grayscale-6 !default;
View source

Description

A font to use for small tags within headings.

Used by

$font-margin-base

Since 1.0.0
$font-margin-base: 0 0 1.5em 0 !default;
View source

Description

Base margin for HTML tags. Primarily affects <p>.

$font-padding-code

Since 1.0.0
$font-padding-code: 0.2em 0.4em !default;
View source

Description

Base padding for the <code> tag.

$font-margin-code

Since 1.0.0
$font-margin-code: $margin 0 !default;
View source

Description

Base margin for the <code> tag.

$color-code

Since 1.0.0
$color-code: $color-grayscale-6 !default;
View source

Description

Text color to use for the <code> tag.

$color-code-bg

Since 1.0.0
$color-code-bg: $color-grayscale-f5 !default;
View source

Description

Background color to use for the <code> tag.

$border-code

Since 2.0.0
$border-code: $border !default;
View source

Description

Base border for the <code> tag.

$font-margin-blockquote

Since 1.0.0
$font-margin-blockquote: 1em $margin-large !default;
View source

Description

Base margin for the <blockquote> tag.

$font-margin-list

Since 1.0.0
$font-margin-list: $font-margin-base !default;
View source

Description

Base margin for <ul> and <ol> tags.

$font-padding-list

Since 1.0.0
$font-padding-list: 0 0 0 40px !default;
View source

Description

Base padding for <ul> and <ol> tags.

$font-margin-dd

Since 1.0.0
$font-margin-dd: 0 0 0 $margin !default;
View source

Description

Base margin for <dd> tags.

css

h1

Since 1.0.0
h1 { ... }
View source

Description

Styles for all h1 tags.

h2

Since 1.0.0
h2 { ... }
View source

Description

Styles for all h2 tags.

h3

Since 1.0.0
h3 { ... }
View source

Description

Styles for all h3 tags.

h4

Since 1.0.0
h4 { ... }
View source

Description

Styles for all h4 tags.

h5

Since 1.0.0
h5 { ... }
View source

Description

Styles for all h5 tags.

h6

Since 1.0.0
h6 { ... }
View source

Description

Styles for all h6 tags.

blockquote

Since 1.0.0
blockquote { ... }
View source

Description

Styles for all blockquotes.

p, pre

Since 1.0.0
p,
pre { ... }
View source

Description

Styles for all paragraphs and preformatted content.

code, kbd, pre, samp

Since 1.0.0
code,
kbd,
pre,
samp { ... }
View source

Description

Styles for all preformatted and code content.

dd

Since 1.0.0
dd { ... }
View source

Description

Styles for definition stuff.

menu, ol, ul

Since 1.0.0
menu,
ol,
ul { ... }
View source

Description

Styles menus and lists.

nav

Since 1.0.0
nav { ... }
View source

Description

Styles for navigation.

code

Since 1.0.0
code { ... }
View source

Description

Styles for code element.

.code

Since 1.0.0
.code { ... }
View source

Description

Styles for the code wrapper class. Adding this class around a code element enables scrolling on mobile devices.

Grid

variables

$number-columns

Since 1.2.0
$number-columns: 3 !default;
View source

Description

The number of columns you would like to use in your layout. This controls the width of the content area vs. the sidebar. By default, setting this to 3 will make the sidebar take up 1 column, and the content area 2 columns. If you were to set this to 4, the sidebar would take up 1/4 of the space, while the content area would take up 3/4 of the space. By default, the number of supported widgets in your footer will match this number.

$margin-width

Since 1.2.0
$margin-width: 5.2% !default;
View source

Description

Sets the margin width for content and footbar widgets.

$column-padding-bottom

Since 1.2.0
$column-padding-bottom: 10px !default;
View source

Description

The amount of padding to add to columns on mobile.

$column-padding-bottom-large-screen

Since 1.2.0
$column-padding-bottom-large-screen: 35px !default;
View source

Description

The amount of padding to add to columns on desktop.

$sidebar-padding

Since 1.2.0
$sidebar-padding: 3.46667% !default;
View source

Description

The amount of padding to add to the sidebar. Calculated based on the number of columns by default.

$number-widgets-footbar

Since 1.2.0
$number-widgets-footbar: $number-columns !default;
View source

Description

Sets the number of supported widgets in the footbar. Matches the number of columns in the theme by default.

$width-side-nav

Since 1.2.0
$width-side-nav: 240px !default;
View source

Description

The width of the side nav, if you are using the left hand layout.

Navigation

variables

$border-masthead

Since 1.0.0
$border-masthead: $border !default;
View source

Description

The style of border to use on the masthead. This shows directly below navigation or brand depending on the layout you've chosen for your site.

$color-masthead-bg

Since 1.0.0
$color-masthead-bg: $color-grayscale-f !default;
View source

Description

The background color of the masthead. Bright colors are not recommended.

$border-width-primary-nav

Since 1.0.0
$border-width-primary-nav: 1px 0 0 0 !default;
View source

Description

The style of border used on primary navigation. By default, this border shows above primary navigation on mobile only.

$border-primary-nav-desktop

Since 1.0.0
$border-primary-nav-desktop: 0 !default;
View source

Description

The width of border used on primary navigation at desktop sizes.

$color-primary-nav-border

Since 1.0.0
$color-primary-nav-border: $color-grayscale-3 !default;
View source

Description

The color of border used on primary navigation.

$font-family-navigation

Since 1.0.0
$font-family-navigation: $font-family-sans-serif !default;
View source

Description

The font used in primary navigation.

$color-primary-nav-bg

Since 1.0.0
$color-primary-nav-bg: $color-grayscale-0 !default;
View source

Description

The color to use behind primary navigation.

$color-primary-nav-dropdown-bg

Since 1.0.0
$color-primary-nav-dropdown-bg: $color-grayscale-0 !default;
View source

Description

The color to use behind dropdown menus. Only affects non-mobile devices. This variable is not used in the left hand navigation layout as dropdowns are not supported.

$border-width-utility-nav

Since 1.0.0
$border-width-utility-nav: 1px 0 0 0 !default;
View source

Description

The width and style of border used in the utility navigation.

$font-size-utility-nav

Since 1.0.0
$font-size-utility-nav: 14px !default;
View source

Description

The font size used in the utility navigation.

$color-nav-toggle

Since 1.0.0
$color-nav-toggle: $color-grayscale-f !default;
View source

Description

Controls the color of toggles in the navigation at mobile sizes. By default, this affects both the menu and search toggles.

$color-nav-toggle-hover

Since 1.0.0
$color-nav-toggle-hover: $color-grayscale-a !default;
View source

Description

Controls the color of toggles in the navigation at mobile sizes on hover.

$color-nav-toggle-alt

Since 1.0.0
$color-nav-toggle-alt: $color-grayscale-9 !default;
View source

Description

Controls the color of toggles in the navigation at desktop sizes. By default, this affects both the menu and search toggles.

$color-nav-toggle-alt-hover

Since 1.0.0
$color-nav-toggle-alt-hover: $color-grayscale-0 !default;
View source

Description

Controls the color of toggles in the navigation at desktop sizes on hover.

$border-width-quicksearch

Since 1.0.0
$border-width-quicksearch: 1px 0 0 0 !default;
View source

Description

Controls the width of the border used on the search pane.

$color-quicksearch-border

Since 1.0.0
$color-quicksearch-border: $color-grayscale-d !default;
View source

Description

Controls the color of the border used on the search form.

$border-radius-quicksearch-input

Since 1.0.0
$border-radius-quicksearch-input: 20px 0 0 20px !default;
View source

Description

Controls how much rounding is applied to the search form field corners.

$border-radius-quicksearch-button

Since 1.0.0
$border-radius-quicksearch-button: 0 20px 20px 0 !default;
View source

Description

Controls how much rounding is applied to the search form submit button.

$color-search-bg

Since 1.0.0
$color-search-bg: $color-grayscale-f5 !default;
View source

Description

Controls the background color of the search field.

$color-search-text

Since 1.0.0
$color-search-text: $color-grayscale-0 !default;
View source

Description

Controls the color of the text in the search field.

$nav-desktop

Since 2.0.0
$nav-desktop: $sm !default;
View source

Description

The default breakpoint to switch to the desktop view in navigation.

$nav-toggle-size

Since 2.0.0
$nav-toggle-size: 60px !default;
View source

Description

Adjusts the size of the search and nav toggles in the main navigation. Also affects the top/bottom spacing around main navigation items in the nav bar.

$nav-toggle-border

Since 2.0.0
$nav-toggle-border: 4px !default;
View source

Description

Adjusts the size of border on the nav toggle icon in the main navigation. Also affects spacing of borders in this icon.

$left-nav-desktop

Since 2.0.0
$left-nav-desktop: $nav-desktop !default;
View source

Description

The breakpoint to switch to the desktop view in the left navigation layout.

$top-nav-desktop

Since 2.0.0
$top-nav-desktop: $nav-desktop !default;
View source

Description

The breakpoint to switch to the desktop view in the top navigation layout.

$no-nav-desktop

Since 2.0.0
$no-nav-desktop: $nav-desktop !default;
View source

Description

The breakpoint to switch to the desktop view in the no navigation layout.

Branding

variables

$font-family-brand

Since 1.0.0
$font-family-brand: "Whitney SSm A", "Whitney SSm B", "Helvetica", "Arial", sans-serif !default;
View source

Description

The font to use for branding. You may not change this unless you have permission from Marketing & Communications.

$font-family-brand-sponsored

Since 1.0.0
$font-family-brand-sponsored: $font-family-brand !default;
View source

Description

The font family to use for the sponsored branding type.

$font-family-brand-unbranded

Since 1.0.0
$font-family-brand-unbranded: $font-family-sans-serif !default;
View source

Description

The font family to use for the unbranded branding type.

$height-brand

Since 1.0.0
$height-brand: 120px !default;
View source

Description

The height of the branding area.

$color-brand

Since 1.0.0
$color-brand: $color-grayscale-0 !default;
View source

Description

The color used for the site name when a site is using BU branding.

$color-unbranded

Since 1.0.0
$color-unbranded: #c00;
View source

Description

The color used for the site name when a site is not using BU branding.

$image-masterplate

Since 1.0.0
$image-masterplate: "https://www.bu.edu/cdn/images/logos/masterplate112x50.png" !default;
View source

Description

The image used for the BU Masterplate. Do not change this without permission from Marketing & Communications.

$image-masterplate-retina

Since 1.0.0
$image-masterplate-retina: "https://www.bu.edu/cdn/images/logos/masterplate112x50-retina.png" !default;
View source

Description

The image used for the BU Masterplate on retina devices. Do not change this without permission from Marketing & Communications.

$image-subbrand

Since 1.0.0
$image-subbrand: "https://www.bu.edu/cdn/images/logos/subbrand49x35.png" !default;
View source

Description

The image used for the BU plate in the Signature style. Do not change this without permission from Marketing & Communications.

$image-subbrand-retina

Since 1.0.0
$image-subbrand-retina: "https://www.bu.edu/cdn/images/logos/subbrand49x35-retina.png" !default;
View source

Description

The image used for the BU plate in the Signature style on retina devices. Do not change this without permission from Marketing & Communications.

$image-bumclogo-retina

Since 1.0.0
$image-bumclogo-retina: "https://www.bu.edu/cdn/images/logos/bumclogo96x40-retina.png" !default;
View source

Description

The image used for the BUMC logo on retina devices. Do not change this without permission from Marketing & Communications.

css

.brand

Since 1.0.0
.brand { ... }
View source

Description

Controls styling for elements in the branding area, including the logo and site description.

.brand-container

Since 1.0.0
.brand-container { ... }
View source

Description

Controls styling for the logo container.

.brand-signature

Since 1.4.0
.brand-signature { ... }
View source

Description

Controls styling for the signature brand style.

.brand-unbranded

Since 1.4.0
.brand-unbranded { ... }
View source

Description

Controls styling for the unbranded brand style.

.brand-part-logotype

Since 1.4.0
.brand-part-logotype { ... }
View source

Description

Controls styling for the logotype brand part.

.brand-part-sitename

Since 1.4.0
.brand-part-sitename { ... }
View source

Description

Controls styling for the site name brand part.

.brand-part-parent

Since 1.4.0
.brand-part-parent { ... }
View source

Description

Controls styling for the parent entity brand part.

.brand-part-subparent

Since 1.4.0
.brand-part-subparent { ... }
View source

Description

Controls styling for the subparent entity brand part.

.brand-site-description

Since 1.4.0
.brand-site-description { ... }
View source

Description

Controls styling for the site description.

.brand-masterplate

Since 1.0.0
.brand-masterplate { ... }
View source

Description

Controls styling for the masterplate.

Layout

variables

$container-sm

Since 1.2.0
$container-sm: 750px !default;
View source

Description

The container width for the small (sm) breakpoint.

Used by

$container-md

Since 1.2.0
$container-md: 970px !default;
View source

Description

The container width for the medium (md) breakpoint.

Used by

$container-lg

Since 1.2.0
$container-lg: 1170px !default;
View source

Description

The container width for the large (lg) breakpoint.

Used by

$z-index-content

Since 2.0.0
$z-index-content: $z-index-1 !default;
View source

Description

A base z-index to use for interactive content in the content area that isn't an overlay. Some examples are callouts that scale up on hover, or tooltip definitions. Use this variable for your default state. Use + or - with this variable to set z-index relative to the default state - plus for above, minus for below. Change this variable to change the stacking order for all states in the site.

Example

Make sure a callout that scales up on hover is always
above the other callouts next to it.
	.callout {
	@include scale( 1 );
	z-index: $z-index-content;

	&:hover {
		@include scale( 1.2 );
		z-index: $z-index-content + 1;
	}
}

$z-index-states

Since 2.0.0
$z-index-states: $z-index-3 !default;
View source

Description

A base z-index to use for content with multiple states. A good example of this content might be a form with multiple states stacked on one another that you animate. Use this variable for your default state. Use + or - with this variable to set z-index relative to the default state - plus for above, minus for below. Change this variable to change the stacking order for all states in the site.

Example

Set z-index on a stacked form with states.
	.form-state-start,
.form-state-active {
	z-index: $z-index-states;
}

.form-state-getinfo {
	z-index: $z-index-states - 1;
}

.form-state-end {
	z-index: $z-index-states - 2;
}

$z-index-panels

Since 2.0.0
$z-index-panels: $z-index-5 !default;
View source

Description

A base z-index to use for panel-like content. Panel-like content can include panels that open and close, such as horizontal secondary navigation menus or filters, which push aside or overlap other content. Use this variable alone to set a default z-index which will play nicely with other types of interactive content on your site. Use + or - with it to set a z-index relative to all panels. Change this variable to change the default z-index for all panel-like content.

Example

Ensure two stacked filters on a degree page overlap correctly.
.degree-filter {
	z-index: $z-index-panels;
}

.degree-subfilter {
	z-index: $z-index-panels - 1;
}

$z-index-primarynav

Since 2.0.0
$z-index-primarynav: $z-index-7 !default;
View source

Description

A base z-index to use for the primary navigation. By default, this sets a z-index which will put dropdown menus above content, but below overlays. Use this variable alone to set a default z-index which will play nicely with other types of interactive content on your site. Use + or - with it to set a z-index relative to the primary navigation. Change this variable to change the stacking order of the primary navigation.

$z-index-overlays

Since 2.0.0
$z-index-overlays: $z-index-9 !default;
View source

Description

A base z-index to use for overlays and lightboxes. This z-index will always be on top unless you are using $z-index-dev. Use this variable alone to set a default z-index which will play nicely with other types of interactive content on your site. Use + or - with it to set a z-index relative to the default overlay. Change this variable to change the stacking order of all overlays. (You may want to do this if you have a fixed sticky navigation so that the sticky navigation isn't always on top, even with lightboxes.)

$z-index-dev

Since 2.0.0
$z-index-dev: $z-index-10 !default;
View source

Description

A z-index that will override all other z-indexes for development and debugging purposes only. Avoid where possible and do not commit to production code.

css

.banner-container

Since 1.0.0
.banner-container { ... }
View source

Description

General styles for all content banner positions.

.banner-container-window-width

Since 1.0.0
.banner-container-window-width { ... }
View source

Description

Styles for the window-width content banner position. Sits outside of .content-container.

.banner-container-page-width

Since 1.0.0
.banner-container-page-width { ... }
View source

Description

Styles for the page-width content banner position. Sits directly inside .content-container and just outside of .content-area.

.banner-container-content-width

Since 1.0.0
.banner-container-content-width { ... }
View source

Description

Styles for the content-width content banner position. Sits directly inside .content-area.

.content

Since 1.0.0
.content { ... }
View source

Description

Controls styling for all content, from the masthead to the site footer.

.content-container

Since 1.0.0
.content-container { ... }
View source

Description

A wrapper to contain content to a certain size. Sits just below the window width banner and just above the footbar.

.content-area

Since 1.0.0
.content-area { ... }
View source

Description

Styles for the content area (formerly styled by article[role=main]). Sits next to the sidebar.

.sidebar

Since 1.0.0
.sidebar { ... }
View source

Description

The default class for styling sidebars.

.sidebar-location-left

Since 1.2.0
.sidebar-location-left { ... }
View source

Description

Styles for the left sidebar location.

.content-container-narrow

Since 1.4.0
.content-container-narrow { ... }
View source

Description

Styles for narrow content.

.footbar

Since 1.0.0
.footbar { ... }
View source

Description

Controls styling for the footbar.

.footbar-container

Since 1.0.0
.footbar-container { ... }
View source

Description

Controls styling for the footbar container and width of widgets inside. Often used to put a maximum width on the footbar without affecting the background.

.disclaimer

Since 1.0.0
.disclaimer { ... }
View source

Description

Styles the disclaimer, which shows in the site footer.

.masthead

Since 1.0.0
.masthead { ... }
View source

Description

Controls all styling related to the masthead. This includes navigation, branding, and search.

.masthead-container

Since 1.0.0
.masthead-container { ... }
View source

Description

A wrapper for items in the masthead. Often used to restrict the masthead to a certain width without interfering with the background.

.content-container-narrow

Since 2.0.0
.content-container-narrow { ... }
View source

Description

Handles styling for narrow content container pages. Do not override this class. Instead, add or remove templates from the narrow content container PHP filter in your theme.

.error-404

Since 2.0.0
.error-404 { ... }
View source

Description

Handles styling for the 404 page.

Content

variables

$table-margin

Since 1.0.0
$table-margin: $margin 0 !default;
View source

Description

Base margin for the table tag.

$table-padding

Since 1.0.0
$table-padding: 0.5em 1em !default;
View source

Description

Base padding for the table.

$table-border

Since 1.0.0
$table-border: $border !default;
View source

Description

Default border for tables.

$color-table-head

Since 1.0.0
$color-table-head: $color-heading !default;
View source

Description

Default color for table headings.

$table-head-bg

Since 1.0.0
$table-head-bg: $color-grayscale-e !default;
View source

Description

Default background for table headings.

$table-caption-padding

Since 1.0.0
$table-caption-padding: 0 0 10px !default;
View source

Description

Default padding for table captions.

$color-table-caption

Since 1.0.0
$color-table-caption: $color-grayscale-6 !default;
View source

Description

Default color for table captions.

$table-stripes

Since 1.0.0
$table-stripes: $color-grayscale-f5 !default;
View source

Description

Default background for striped table backgrounds.

$color-collapsible-icon

Since 2.0.0
$color-collapsible-icon: $color-icons !default;
View source

Description

Controls the color of icons on collapsibles.

$color-collapsible-icon-hover

Since 2.0.0
$color-collapsible-icon-hover: $color-link !default;
View source

Description

Controls the color of icons on collapsibles when you hover.

$border-collapsible

Since 2.0.0
$border-collapsible: $border !default;
View source

Description

Controls the border between collapsibles.

$border-coursefeed

Since 2.0.0
$border-coursefeed: $border !default;
View source

Description

Controls the border between course feed items.

$margin-floated-content

Since 1.0.0
$margin-floated-content: $margin-small !default;
View source

Description

The margin to use around anything floated in the content area.

$font-family-caption

Since 1.0.0
$font-family-caption: $font-family-sans-serif !default;
View source

Description

The font to use for captions.

$color-caption

Since 1.0.0
$color-caption: $color-grayscale-6 !default;
View source

Description

The color to use for captions.

$box-shadow-table

Since 1.0.0
$box-shadow-table: inset -20px 0 20px -10px $color-grayscale-f0 !default;
View source

Description

The shadow to use in tables.

$color-banner-container

Since 1.0.0
$color-banner-container: $color-grayscale-f0 !default;
View source

Description

Controls the background color of the banner container. By default, this only affects the window width banner container.

$padding-banner

Since 3.0.2
$padding-banner: 0 !default;
View source

Description

Controls the padding on the banner container.

$padding-banner-window-width

Since 3.0.2
$padding-banner-window-width: $padding-small !default;
View source

Description

Controls the padding on the banner container when using the window-width layout.

$color-content-bg

Since 1.0.0
$color-content-bg: $color-grayscale-f !default;
View source

Description

Controls the background color of the content.

css

.bu_collapsible_container

Since 1.0.0
.bu_collapsible_container { ... }
View source

Description

Styles a collapsible item.

.bu_collapsible

Since 1.0.0
.bu_collapsible { ... }
View source

Description

Styles the header on a collapsible item.

.cf-course

Since 1.0.0
.cf-course { ... }
View source

Description

Controls the styling for a single course in a course feed.

.cf-course-title

Since 2.0.0
.cf-course-title { ... }
View source

Description

Controls the styling for the course title in a course feed.

.cf-course-id

Since 2.0.0
.cf-course-id { ... }
View source

Description

Controls the styling for the course id (college, department, and number) in a course feed. You may style each of these individually as well using .cf-course-college, .cf-course-dept, etc.

.cf-course-info

Since 2.0.0
.cf-course-info { ... }
View source

Description

Controls the styling for course credits, availability, and prerequisites.

.cf-table

Since 2.0.0
.cf-table { ... }
View source

Description

Controls the styling for the section table.

.cf-section-title

Since 2.0.0
.cf-section-title { ... }
View source

Description

Controls the styling for the section title.

.cf-section-dates

Since 2.0.0
.cf-section-dates { ... }
View source

Description

Controls the styling for the section start and end dates.

.cf-course-offered

Since 2.0.0
.cf-course-offered { ... }
View source

Description

Conditional styling to label course availability. There isn't currently a way to do this in the course template reliably.

.cf-course-prereqs

Since 2.0.0
.cf-course-prereqs { ... }
View source

Description

Conditional styling to label course prerequisites. There isn't currently a way to do this in the course template reliably.

.cf-hub-ind

Since 2.0.1
.cf-hub-ind { ... }
View source

Description

BU Hub Indicator Wrapper

.cf-hub-head

Since 2.0.1
.cf-hub-head { ... }
View source

Description

BU Hub Indicator Title

.bu-hub-iconstyles

Since 2.0.1
.bu-hub-iconstyles { ... }
View source

Description

BU Hub Indicator Title Iconstyles

.cf-hub-offerings

Since 2.0.1
.cf-hub-offerings { ... }
View source

Description

BU Hub Indicator Area

    List

.gallery

Since 1.4.0
.gallery { ... }
View source

Description

Base styles for the gallery shortcode in WordPress.

.gallery-item

Since 1.4.0
.gallery-item { ... }
View source

Description

Styles for each supported number of columns in the WordPress gallery shortcode.

.bu-slideshow-container

Since 1.0.0
.bu-slideshow-container { ... }
View source

Description

BU Slideshow styles.

.label

Since 1.0.0
.label { ... }
View source

Description

General styles for labels.

Widgets

variables

$font-family-widget-calendar-date

Since 1.0.0
$font-family-widget-calendar-date: $font-family-sans-serif !default;
View source

Description

Controls the font family used on dates in the calendar widget.

$color-widget-calendar-date

Since 1.0.0
$color-widget-calendar-date: $color-grayscale-0 !default;
View source

Description

Controls the color of dates in the calendar widget.

$font-size-widget-calendar-date-day

Since 1.0.0
$font-size-widget-calendar-date-day: 22px !default;
View source

Description

Controls the size of the day when using the graphic style in the calendar widget.

$color-widget-calendar-date-day

Since 1.0.0
$color-widget-calendar-date-day: inherit !default;
View source

Description

Controls the color of the day when using the graphic style in the calendar widget.

$font-size-widget-calendar-date-month

Since 1.0.0
$font-size-widget-calendar-date-month: 12px !default;
View source

Description

Controls the size of the month when using the graphic style in the calendar widget.

$color-widget-calendar-date-month

Since 1.0.0
$color-widget-calendar-date-month: inherit !default;
View source

Description

Controls the color of the month when using the graphic style in the calendar widget.

$border-widget-contentnav

Since 1.0.0
$border-widget-contentnav: $border !default;
View source

Description

Controls the style of border used on the content navigation list.

$font-family-widget-contentnav

Since 1.0.0
$font-family-widget-contentnav: $font-family-sans-serif !default;
View source

Description

Controls the font family used in the content navigation widget.

$color-widget-contentnav

Since 1.0.0
$color-widget-contentnav: $color-link !default;
View source

Description

Controls the color of nav items in the content navigation widget.

$color-widget-contentnav-hover

Since 1.0.0
$color-widget-contentnav-hover: $color-link !default;
View source

Description

Controls the color of nav items when you hover in the content navigation widget.

$color-widget-contentnav-active

Since 1.0.0
$color-widget-contentnav-active: $color-link-active !default;
View source

Description

Controls the active color of nav items in the content navigation widget.

$color-widget-post-meta

Since 1.0.0
$color-widget-post-meta: $color-grayscale-6 !default;
View source

Description

Controls the color of the metadata in the BU posts widget.

$widget-margin-bottom

Since 1.0.0
$widget-margin-bottom: $margin !default;
View source

Description

Controls the spacing between widgets in the sidebar.

$font-family-widget-title

Since 1.0.0
$font-family-widget-title: $font-family-sans-serif !default;
View source

Description

Controls the font family used for the widget title.

$border-widget-title

Since 1.0.0
$border-widget-title: $border !default;
View source

Description

Controls the border style used on the widget title.

$border-width-widget-title

Since 1.0.0
$border-width-widget-title: 0 0 4px 0 !default;
View source

Description

Controls the border width used on the widget title.

$color-widget-title

Since 1.0.0
$color-widget-title: $color-grayscale-0 !default;
View source

Description

Controls the color of the widget title.

$font-family-widget-heading

Since 1.0.0
$font-family-widget-heading: $font-family-sans-serif !default;
View source

Description

Controls the font family used for headings in widget content.

$border-widget-list

Since 1.0.0
$border-widget-list: $border !default;
View source

Description

Controls the style of border used between items in widgets which use a list format, such as content navigation and the calendar widget.

css

.widget-calendar-event

Since 2.0.0
.widget-calendar-event { ... }
View source

Description

Styles events in the calendar widget. Affects all formats.

.widget-calendar-date

Since 2.0.0
.widget-calendar-date { ... }
View source

Description

Styles dates in the calendar widget. Affects all formats.

.widget-calendar-event-default

Since 2.0.0
.widget-calendar-event-default { ... }
View source

Description

Styles an event in the calendar widget default format.

.widget-calendar-date-default

Since 2.0.0
.widget-calendar-date-default { ... }
View source

Description

Styles dates in the calendar widget default format.

.widget-calendar-title-default

Since 2.0.0
.widget-calendar-title-default { ... }
View source

Description

Styles titles in the calendar widget default format.

.widget-calendar-date-graphic

Since 2.0.0
.widget-calendar-date-graphic { ... }
View source

Description

Styles dates in the calendar widget graphic format.

.widget-calendar-day-graphic

Since 2.0.0
.widget-calendar-day-graphic { ... }
View source

Description

Styles the day of the month in the calendar widget graphic format.

.widget-calendar-month-graphic

Since 2.0.0
.widget-calendar-month-graphic { ... }
View source

Description

Styles the month in the calendar widget graphic format.

.widget-calendar-title-graphic

Since 2.0.0
.widget-calendar-title-graphic { ... }
View source

Description

Styles the title in the calendar widget graphic format.

.widget_bu_pages, .widget_nav_menu

Since 1.0.0
.widget_bu_pages,
.widget_nav_menu { ... }
View source

Description

Handles styling for content navigation widgets (BU Pages and Content Navigation, aka side nav).

.widget-post

Since 2.0.0
.widget-post { ... }
View source

Description

Handles styling for posts in the BU Posts widget (news widget).

.widget-post-headline

Since 2.0.0
.widget-post-headline { ... }
View source

Description

Handles styling for the post headline in the BU Posts widget (news widget).

.widget-post-meta

Since 2.0.0
.widget-post-meta { ... }
View source

Description

Handles styling for metadata in the BU Posts widget (news widget).

.widget-post-excerpt

Since 2.0.0
.widget-post-excerpt { ... }
View source

Description

Handles styling for the excerpt in the BU Posts widget (news widget).

.widget-post-thumbnail

Since 2.0.0
.widget-post-thumbnail { ... }
View source

Description

Handles styling for the thumbnail in the BU Posts widget (news widget).

.widget-post-thumbnail-title-date

Since 2.0.0
.widget-post-thumbnail-title-date { ... }
View source

Description

Handles styling for the thumbnail in the BU Posts widget (news widget) in the title and date format.

.widget

Since 1.0.0
.widget { ... }
View source

Description

Handles global widget styling.

.widget-title

Since 1.0.0
.widget-title { ... }
View source

Description

Handles title styles for all widgets.

.blogroll

Since 2.0.0
.blogroll { ... }
View source

Description

Styles the blog list in the blogroll widget.

.widget_links, .widget_archive

Since 2.0.0
.widget_links,
.widget_archive { ... }
View source

Description

Handles styling for archive and link widgets.

Forms

placeholders

%button-styles

Since 1.2.0
%button-styles { ... }
View source

Description

Controls button styles globally. Extend this class for custom buttons or for elements whose HTML and CSS you don't have control over. May be used on both form element tags and regular links to make them look like buttons.

Requires

%button-styles-input

Since 1.2.0
%button-styles-input { ... }
View source

Description

Controls button styles for input tags globally. Only to be used with form element tags.

Requires

%button-styles-primary

Since 1.2.0
%button-styles-primary { ... }
View source

Description

Styles buttons in a "primary" way so as to look more important when there are multiple buttons near each other.

Requires

css

form

Since 1.0.0
form { ... }
View source

Description

The general styles for forms.

fieldset

Since 1.0.0
fieldset { ... }
View source

Description

The general styles for the fieldset element. Wraps around sets of controls within a form. See MDN on fieldset.

legend

Since 1.0.0
legend { ... }
View source

Description

The general styles for the legend element, which holds a caption for the fieldset element. See MDN on legend.

label

Since 1.0.0
label { ... }
View source

Description

The general styles for labels on form fields. See MDN on label.

button, [type="button"], [type="reset"], [type="submit"]

Since 1.0.0
button,
[type="button"],
[type="reset"],
[type="submit"] { ... }
View source

Description

The general styles for inputs which should look like buttons.

.form-row

Since 1.0.0
.form-row { ... }
View source

Description

Styles form rows, if you are not using Gravity Forms. From Pure v0.5.0.

.form-controls

Since 1.0.0
.form-controls { ... }
View source

Description

Styles form controls, if you are not using Gravity Forms. From Pure v0.5.0.

.required

Since 1.0.0
.required { ... }
View source

Description

Styles required items, if you are not using Gravity Forms. From Pure v0.5.0.

[type="text"], [type="password"], [type="email"], [type="url"], [type="date"], [type="month"], [type="time"], [type="datetime"], [type="datetime-local"], [type="week"], [type="number"], [type="search"], [type="tel"], [type="color"], select, label, textarea

Since 1.0.0
[type="text"],
[type="password"],
[type="email"],
[type="url"],
[type="date"],
[type="month"],
[type="time"],
[type="datetime"],
[type="datetime-local"],
[type="week"],
[type="number"],
[type="search"],
[type="tel"],
[type="color"],
select,
label,
textarea { ... }
View source

Description

Styles inputs and labels in the stacked and aligned layouts, if you are not using Gravity Forms. From Pure v0.5.0.

.gform_wrapper

Since 1.0.0
.gform_wrapper { ... }
View source

Description

Styles Gravity Forms.

.button

Since 1.0.0
.button { ... }
View source

Description

The basic style for a button. Preferred over the extend if you have control over HTML and do not need any styles for your button in particular.

.button-primary, .button-selected

Since 1.0.0
.button-primary,
.button-selected { ... }
View source

Description

The basic style for a primary and selected button. Preferred over the extend if you have control over HTML and do not need any styles for your button in particular.

News

variables

$border-news-post

Since 1.0.0
$border-news-post: $border !default;
View source

Description

Controls the border style between posts on post listing templates.

$color-news-meta-em

Since 1.0.0
$color-news-meta-em: $color-grayscale-7 !default;
View source

Description

Controls the color of the separators between metadata.

$color-news-meta-before

Since 1.0.0
$color-news-meta-before: $color-grayscale-a !default;
View source

Description

Controls the shape of the separators between metadata. By default, this is set to a dot.

$comment-margin

Since 1.0.0
$comment-margin: $margin !default;
View source

Description

Controls the amount of spacing between comment threads on a post.

$comment-margin-mobile

Since 2.0.0
$comment-margin-mobile: $margin-small !default;
View source

Description

Controls the amount of spacing between comment threads on a post on mobile.

$comment-reply-margin

Since 2.0.0
$comment-reply-margin: $margin-small !default;
View source

Description

Controls the amount of spacing between comments within a thread on desktop. By default, there is no margin between comments on mobile.

$comment-reply-depth

Since 2.0.0
$comment-reply-depth: $margin-small !default;
View source

Description

Controls the amount of space a reply comment is indented from the parent.

$comment-reply-depth-mobile

Since 2.0.0
$comment-reply-depth-mobile: $comment-reply-depth / 3 !default;
View source

Description

Controls the amount of space a reply comment is indented from the parent on mobile.

$border-comment

Since 1.0.0
$border-comment: $border !default;
View source

Description

Controls the border style between comments on a post.

$border-width-comment

Since 1.0.0
$border-width-comment: 1px 1px 1px 5px !default;
View source

Description

Controls the border width between comments on a post.

$comment-padding

Since 1.0.0
$comment-padding: $padding-small !default;
View source

Description

Controls the amount of spacing within comments.

$comment-padding-mobile

Since 1.0.0
$comment-padding-mobile: $padding-small !default;
View source

Description

Controls the amount of spacing within comments on mobile.

$font-family-comment

Since 1.0.0
$font-family-comment: $font-family-sans-serif !default;
View source

Description

Controls the font family used for comments on a post.

$color-comments

Since 1.0.0
$color-comments: $color-base !default;
View source

Description

Controls the color of comments on a post.

$color-comment-reply

Since 1.0.0
$color-comment-reply: $color-grayscale-6 !default;
View source

Description

Controls the color of replies to comments on a post.

$color-comment-author-name

Since 1.0.0
$color-comment-author-name: $color-grayscale-0 !default;
View source

Description

Controls the color of the author name in a comment.

$color-comment-author-says

Since 1.0.0
$color-comment-author-says: $color-grayscale-6 !default;
View source

Description

Controls the color of the "says" text after author name in a comment.

$color-comment-form-bg

Since 1.0.0
$color-comment-form-bg: $color-grayscale-f5 !default;
View source

Description

Controls the background color of the comment submission form.

$border-comment-form

Since 1.0.0
$border-comment-form: $border !default;
View source

Description

Controls the border style on the comment submission form.

$border-width-comment-form

Since 1.0.0
$border-width-comment-form: 3px !default;
View source

Description

Controls the border width on the comment submission form.

$border-message

Since 1.0.0
$border-message: $border !default;
View source

Description

The style of the border on comments and items using the card styles.

Used by

$border-width-message

Since 1.0.0
$border-width-message: 1px 1px 1px 5px !default;
View source

Description

The width of the border on comments and items using the card styles.

Used by

$border-radius-message

Since 1.0.0
$border-radius-message: 3px !default;
View source

Description

The amount of rounding (border radius) to apply to the corners of comments.

Used by

$padding-message

Since 1.0.0
$padding-message: 20px !default;
View source

Description

The amount of padding to apply to comments.

Used by

$color-message-bg

Since 1.0.0
$color-message-bg: $color-grayscale-f0 !default;
View source

Description

The background of comments.

Used by

$color-message-border-left

Since 1.0.0
$color-message-border-left: $color-grayscale-0 !default;
View source

Description

The left border color of comments.

Used by

$padding-single-meta

Since 1.0.0
$padding-single-meta: 20px !default;
View source

Description

Controls the padding of the metadata card at the bottom of news posts on the single post template.

$border-single-meta

Since 1.0.0
$border-single-meta: $border-message !default;
View source

Description

Controls the border style on the metadata card at the bottom of news posts on the single post template.

$border-width-single-meta

Since 1.0.0
$border-width-single-meta: $border-width-message !default;
View source

Description

Controls the border width on the metadata card at the bottom of news posts on the single post template.

$border-radius-single-meta

Since 1.0.0
$border-radius-single-meta: $border-radius-message !default;
View source

Description

Controls the amount of rounding applied to corners of the metadata card at the bottom of the single post template.

$color-single-meta-bg

Since 1.0.0
$color-single-meta-bg: $color-grayscale-f0 !default;
View source

Description

Controls the background of the metadata card at the bottom of the single post template.

$color-single-meta-border-left

Since 1.0.0
$color-single-meta-border-left: $color-message-border-left !default;
View source

Description

Controls the color of the left border in the metadata card at the bottom of the single post template.

css

.paging-navigation

Since 1.0.0
.paging-navigation { ... }
View source

Description

Handles the previous and next links at the bottom of post listings.

.nav-previous

Since 1.0.0
.nav-previous { ... }
View source

Description

Handles the previous link at the bottom of post listings.

.nav-next

Since 1.0.0
.nav-next { ... }
View source

Description

Handles the next link at the bottom of post listings.

.post-part

Since 2.0.0
.post-part { ... }
View source

Description

Handles styling for posts in news listings and archive pages.

.post-headline

Since 2.0.0
.post-headline { ... }
View source

Description

Handles styling for headlines in the post template partial, usually used on post listings and archive pages.

.post-meta

Since 1.0.0
.post-meta { ... }
View source

Description

Handles styling for metadata in the post template partial, usually used on post listings and archive pages.

.post-thumb

Since 2.0.0
.post-thumb { ... }
View source

Description

Handles styling for thumbnails in the post template partial, usually used on post listings and archive pages.

.comments-area

Since 1.0.0
.comments-area { ... }
View source

Description

Controls styling for the comments section on posts.

.comments-list

Since 1.0.0
.comments-list { ... }
View source

Description

Controls styling for comment threads on posts.

.comment

Since 1.0.0
.comment { ... }
View source

Description

Controls styling for the comment container.

.comment-body

Since 1.0.0
.comment-body { ... }
View source

Description

Controls styling for individual comments on posts.

.comment-author

Since 1.0.0
.comment-author { ... }
View source

Description

Controls styling for the comment author.

.says

Since 2.0.0
.says { ... }
View source

Description

Controls styling for the "says" text after comment author.

.comment-metadata

Since 2.0.0
.comment-metadata { ... }
View source

Description

Controls styling for the date and time of comments. This was hidden in the past, but in emergency situations, comments are often used as a means of communication, both officially and unofficially. Readers need to know how recent the last reliable update was should this happen. Disable or hide only with great caution, only using the %visually-hidden placeholder.

.comment-content

Since 1.0.0
.comment-content { ... }
View source

Description

Styles the container which holds the comment content.

.comment-respond

Since 1.0.0
.comment-respond { ... }
View source

Description

Styles the comment form container.

.comment-respond-title

Since 1.0.0
.comment-respond-title { ... }
View source

Description

Styles the comment form title.

.comment-form-submit

Since 1.0.0
.comment-form-submit { ... }
View source

Description

Styles the container around the comment form submit button.

.form-tip

Since 1.0.0
.form-tip { ... }
View source

Description

Styles "view guidelines" and other helper text in the comment form.

#comment

Since 2.0.0
#comment { ... }
View source

Description

Styles the comment text area in the comments form.

.comment-submit

Since 2.0.0
.comment-submit { ... }
View source

Description

Styles the comment form submit button.

.cancel-comment-reply

Since 2.0.0
.cancel-comment-reply { ... }
View source

Description

Styles the cancel comment reply link. WordPress hides this on the comment form with an inline attribute when the comment is not a reply to another comment. To test this, hit the "Reply" link on any comment. You should be be able to see it.

.single-meta

Since 2.0.0
.single-meta { ... }
View source

Description

Handles styling for the metadata card at the bottom of posts.

.single-meta-post-title

Since 2.0.0
.single-meta-post-title { ... }
View source

Description

Handles styling for the title in the metadata card at the bottom of posts.

.single-meta-byline

Since 2.0.0
.single-meta-byline { ... }
View source

Description

Handles styling for the byline in the metadata card at the bottom of posts.

.single-meta-info

Since 2.0.0
.single-meta-info { ... }
View source

Description

Handles styling for categories and tags in the metadata card at the bottom of posts.

Calendar

variables

$color-calendar-heading-date-range

Since 1.0.0
$color-calendar-heading-date-range: $color-grayscale-6 !default;
View source

Description

Controls the color of the date range on the calendar listing template. By default, this is right after the topic.

$border-calendar-list

Since 2.0.0
$border-calendar-list: $border !default;
View source

Description

Controls the border between events on the calendar listing template.

$font-family-calendar-month-caption

Since 1.0.0
$font-family-calendar-month-caption: $font-family-sans-serif !default;
View source

Description

Controls the font used in the calendar picker in the sidebar of the calendar listing template.

$color-calendar-month-caption

Since 1.0.0
$color-calendar-month-caption: $color-grayscale-6 !default;
View source

Description

Controls the color of the selected month in the calendar picker in the sidebar of the calendar listing template.

$color-calendar-month-th-bg

Since 1.0.0
$color-calendar-month-th-bg: $color-grayscale-e !default;
View source

Description

Controls the background of day cells in the calendar picker in the sidebar of the calendar listing template.

$color-calendar-month-th

Since 1.0.0
$color-calendar-month-th: $color-grayscale-0 !default;
View source

Description

Controls the color of text in the day cells in the calendar picker in the sidebar of the calendar listing template.

$padding-calendar-month-cell

Since 1.0.0
$padding-calendar-month-cell: 0.25em !default;
View source

Description

Controls the spacing of day cells in the calendar picker in the sidebar of the calendar listing template.

$font-family-calendar-month-cell

Since 1.0.0
$font-family-calendar-month-cell: $font-family-sans-serif !default;
View source

Description

Controls the font family of day cells in the calendar picker in the sidebar of the calendar listing template.

$font-family-single-event-label

Since 1.0.0
$font-family-single-event-label: $font-family-sans-serif !default;
View source

Description

Controls the font used for labels in the sidebar of the single calendar event template.

Used by

$font-weight-calendar-label

Since 1.0.0
$font-weight-calendar-label: 700 !default;
View source

Description

Controls the font weight used for labels in the sidebar of the single calendar event template.

Used by

$color-single-event-label

Since 1.0.0
$color-single-event-label: $color-grayscale-9 !default;
View source

Description

Controls the color of labels in the sidebar of the single calendar event template.

Used by

css

.calendar-list-topic

Since 2.0.0
.calendar-list-topic { ... }
View source

Description

Handles styling for the calendar topic on the calendar listing page.

.calendar-list-range

Since 2.0.0
.calendar-list-range { ... }
View source

Description

Handles styling for the selected date range in the calendar listing page.

.calendar-list-events

Since 2.0.0
.calendar-list-events { ... }
View source

Description

Handles styling for groups of events on a given day in the calendar listing page.

.calendar-list-event

Since 2.0.0
.calendar-list-event { ... }
View source

Description

Handles styling for an individual event on a given day in the calendar listing page.

.calendar-list-event-first-at-time

Since 2.0.0
.calendar-list-event-first-at-time { ... }
View source

Description

Handles styling for the first event in a group of events at the same time in the calendar listing page.

.calendar-list-event-time

Since 2.0.0
.calendar-list-event-time { ... }
View source

Description

Handles styling for an individual event on a given day in the calendar listing page.

.widget-calendar-picker

Since 2.0.0
.widget-calendar-picker { ... }
View source

Description

Styles the BU Calendar list page date picker.

.calendar-topics

Since 2.0.0
.calendar-topics { ... }
View source

Description

Styles the BU Calendar list page topics widget.

.single-event-schedule

Since 2.0.0
.single-event-schedule { ... }
View source

Description

Handles styling for the container around start and end times on a single calendar event.

.single-event-schedule-list

Since 2.0.0
.single-event-schedule-list { ... }
View source

Description

Handles styling for the list of start and end times on a single calendar event.

.event-time-make-sentence

Since 2.0.0
.event-time-make-sentence { ... }
View source

Description

Controls whether or not to make the event time into a sentence. By default, this is visually hidden so screen readers still read it as a sentence, but it is displayed as list information. You can override this with @extend %remove-visually-hidden.

.single-event-schedule-start

Since 2.0.0
.single-event-schedule-start { ... }
View source

Description

Handles styling for start time in the schedule of a single calendar event.

.single-event-schedule-end

Since 2.0.0
.single-event-schedule-end { ... }
View source

Description

Handles styling for end time in the schedule of a single calendar event.

.single-event-schedule-allday

Since 2.0.0
.single-event-schedule-allday { ... }
View source

Description

Handles styling for all day events in the schedule of a single calendar event.

.single-event-label

Since 2.0.0
.single-event-label { ... }
View source

Description

Handles styling for all single calendar labels, specifically the event fields.

.single-event-info

Since 3.2.1
.single-event-info { ... }
View source

Description

Handles styling for additional details information in the single calendar event template (event field values).

.single-event-time

Since 2.0.0
.single-event-time { ... }
View source

Description

Handles styling for times in the single calendar event schedule.

.single-event-description

Since 2.0.0
.single-event-description { ... }
View source

Description

Handles styling for the event description in the single calendar event template.

.single-event-additional-details

Since 2.0.0
.single-event-additional-details { ... }
View source

Description

Handles styling for additional details in the single calendar event template.

placeholders

%single-event-schedule-list-item

Since 2.0.0
%single-event-schedule-list-item { ... }
View source

Description

Handles styling for list items in the schedule of a single calendar event. Use if you need to add something to the calendar schedule.

%single-event-label

Since 2.0.0
%single-event-label { ... }
View source

Description

Handles styling for all single calendar labels, specifically the event fields.

Requires

%single-event-info

Since 2.0.0
%single-event-info { ... }
View source

Description

Handles styling for additional details information in the single calendar event template (event field values).

Profiles

variables

$border-radius-profile-figure

Since 1.0.0
$border-radius-profile-figure: 50% !default;
View source

Description

Controls the shape of the profile photo. By default, this is set to a circle.

$color-profile-name

Since 1.0.0
$color-profile-name: $color-link !default;
View source

Description

Controls the color used for profile names in the profile listing template.

$color-profile-title

Since 1.0.0
$color-profile-title: $color-base !default;
View source

Description

Controls the color used for profile titles in the profile listing template.

$profiles-advanced-cols-xs

Since 2.0.0
$profiles-advanced-cols-xs: 2 !default;
View source

Description

Controls the number of profiles in a row in the advanced format. Kicks in at the extra small breakpoint.

$profiles-advanced-cols-md

Since 2.0.0
$profiles-advanced-cols-md: 3 !default;
View source

Description

Controls the number of profiles in a row in the advanced format. Kicks in at the medium breakpoint.

$profile-photo-basic-size

Since 2.0.0
$profile-photo-basic-size: $profile-photo-default-size;
View source

Description

Adjusts the size of the basic profile photo.

$profile-photo-default-size

Since 2.0.0
$profile-photo-default-size: 50px;
View source

Description

Adjusts the size of the default profile photo.

$border-profiles

Since 1.0.0
$border-profiles: $border !default;
View source

Description

Controls the style of border used on profile callouts. By default, this applies to the basic and default formats only.

$color-profile-mini-border

Since 1.0.0
$color-profile-mini-border: $color-grayscale-e !default;
View source

Description

Controls the color of the border on the mini profile format in the profiles shortcode.

$profiles-mini-cols-sm

Since 2.0.0
$profiles-mini-cols-sm: 2 !default;
View source

Description

Controls the number of profiles in a row in the mini format. Kicks in at the small breakpoint.

$color-profile-info-label

Since 1.0.0
$color-profile-info-label: $color-grayscale-6 !default;
View source

Description

Controls the color used for labels in the single profile listing template sidebar.

css

.profile-listing

Since 2.0.0
.profile-listing { ... }
View source

Description

Styles for all profile listings.

.profile-item

Since 2.0.0
.profile-item { ... }
View source

Description

Styles for all profile items in a listing.

.profile-photo

Since 2.0.0
.profile-photo { ... }
View source

Description

Styles for all profile photos.

.profile-name

Since 2.0.0
.profile-name { ... }
View source

Description

Styles for all profile names.

.profile-title

Since 2.0.0
.profile-title { ... }
View source

Description

Styles for all profile titles.

.profile-format-advanced

Since 2.0.0
.profile-format-advanced { ... }
View source

Description

Styles the advanced profile format.

.profile-item-advanced

Since 2.0.0
.profile-item-advanced { ... }
View source

Description

Styles an advanced profile item.

.profile-photo-advanced

Since 2.0.0
.profile-photo-advanced { ... }
View source

Description

Styles an advanced profile item photo.

.profile-format-basic

Since 2.0.0
.profile-format-basic { ... }
View source

Description

Styles the basic profile format.

.profile-item-basic

Since 2.0.0
.profile-item-basic { ... }
View source

Description

Styles a basic profile item.

.profile-photo-basic

Since 2.0.0
.profile-photo-basic { ... }
View source

Description

Styles a basic profile photo.

.profile-format-default

Since 2.0.0
.profile-format-default { ... }
View source

Description

Styles the default profile format.

.profile-item-default

Since 2.0.0
.profile-item-default { ... }
View source

Description

Styles a default profile item.

.profile-photo-default

Since 2.0.0
.profile-photo-default { ... }
View source

Description

Styles a default profile photo.

.profile-item-mini

Since 2.0.0
.profile-item-mini { ... }
View source

Description

Styles the mini profile format.

.profile-photo-mini

Since 2.0.0
.profile-photo-mini { ... }
View source

Description

Styles the mini profile photo.

.profile-details-mini

Since 2.0.0
.profile-details-mini { ... }
View source

Description

Styles the mini profile details.

.profile-name-mini

Since 2.0.0
.profile-name-mini { ... }
View source

Description

Styles the mini profile name.

.profile-email-mini

Since 2.0.0
.profile-email-mini { ... }
View source

Description

Styles the mini profile email.

.profile-single-name

Since 2.0.0
.profile-single-name { ... }
View source

Description

Styles the single profile name - typically the title of the page.

.profile-single-title

Since 2.0.0
.profile-single-title { ... }
View source

Description

Styles the single profile title - typically the subtitle of the page.

.profile-single-photo

Since 2.0.0
.profile-single-photo { ... }
View source

Description

Styles the single profile photo.

.profile-single-details

Since 2.0.0
.profile-single-details { ... }
View source

Description

Styles the single profile details sidebar.

.profile-details-label

Since 2.0.0
.profile-details-label { ... }
View source

Description

Styles the single profile details labels.

.profile-details-list

Since 2.0.0
.profile-details-list { ... }
View source

Description

Styles the single profile details list.

.profile-details-item

Since 2.0.0
.profile-details-item { ... }
View source

Description

Styles the single profile details items.

accessibility

functions

Since 3.2.0
@function accessible-text() { ... }
View source

Description

Returns WCAG-compliant text colors automatically, based on a desired background and foreground color, by lightening or darkening the text color until it meets compliance standards.

By default, the compliance method is set to AA, but you can pass an optional compliance method argument to support AAA.

Parameters

None.

Example

	Automatically fix a link text color to be AA compliant
based on the background color of widgets.
		.widget a {
		color: accessible-text( $widget-bg, $color-secondary );
	}

Author

  • Ashley Kolodziej

config

variables

$padding-small

Since 2.0.0
$padding-small: $padding / 2;
View source

Description

The base padding to use for content sitewide.

$padding-large

Since 2.0.0
$padding-large: $padding * 2;
View source

Description

The base padding to use for large spacing sitewide.

content

variables

css

.gallery-caption

Since 1.4.0
.gallery-caption { ... }
View source

Description

Styles for captions in the WordPress gallery shortcode.

footer

global

variables

$min-size-headings-mobile

Since 2.0.0
$min-size-headings-mobile: $min-size-headings !default;
View source

Description

The minimum font size in pixels for headings to use on mobile. Unless you're a designer and you know what you're doing, leave this at $font-size-base. Anything lower means you'll need to compensate with other design elements to preserve the visual hierarchy - think uppercasing, color, stuff like that. This directly affects the <h6> tag. It indirectly affects all other heading font sizes as well by serving as the lower limit to our scale.

placeholders

%wrapper-styles

Since 1.2.0
%wrapper-styles { ... }
View source

Description

Base styles for all wrapper elements.

%container-styles

Since 1.2.0
%container-styles { ... }
View source

Description

Base styles for all container elements. You may wish to extend this on a page where you can't use .content-container for some reason - such as on a landing page where you are overriding that class to use the full width of the screen.

Requires

%row-styles

Since 1.2.0
%row-styles { ... }
View source

Description

Base styles for containers that hold grid elements. A negative margin is included to counteract the grid item margins.

Requires

%row-child-styles

Since 1.2.0
%row-child-styles { ... }
View source

Description

Base styles for children of a row. Usually used for grid items.

Requires

grid

variables

$burf-extras

Since 2.1.11
$burf-extras: true !default;
View source

Description

Turns a number of extra classes on or off. This is really only for the tools partial - you shouldn't use it in a custom theme unless you're VERY sure you will never need it. Placeholders will still work when this is set to false. Affects friendly grid classes, utility classes,

$grid-number-columns

Since 1.2.0
$grid-number-columns: 12 !default;
View source

Description

The number of columns you would like in your grid. To use styles in burf-theme, you must set this to a number that is divisible by 2, 3, and 4.

$grid-margin-width

Since 1.2.0
$grid-margin-width: ( $margin / $container-lg ) * 100 !default;
View source

Description

The percentage you'd like a margin to take up on grid items, if you are using margins on grid items. By default, this will attempt to reproduce the default margin on a large screen in a full-width container. If you plan to use grids include a smaller container, you may need to adjust this.

Used by

$grid-breakpoints

Since 1.2.0
$grid-breakpoints: (
	xs: 		$xs, // optional
	sm: 		$sm, // required for the framework
	md: 		$md, // required for the framework
	lg: 		$lg  // optional
);
View source

Description

Choose which breakpoints you want grid classes to support. Small (sm) and medium (md) are required, everything else is optional.

$grid-supports

Since 2.0.0
$grid-supports: (
	margin: 		true, // optional
	push: 		true, // required for the framework
	pull: 		true, // required for the framework
	offset: 		true  // optional
);
View source

Description

Determines which classes to calculate and print for the theme. By default, all are on so clients can freely use these in custom CSS. However, you may choose to only support the ones you like in a custom theme.

$grid-classes

Since 1.2.0
$grid-classes: true !default;
View source

Description

Choose whether or not to print the numeric grid classes (.col-sm-5). Optional. Note that friendly placeholders (.col-quarter, .col-sm-quarter) will always print. You may wish to disable these on custom themes.

$grid-container-padding

Since 1.0.0
$grid-container-padding: $padding-small !default;
View source

Description

The amount of padding to put on the content container.

Used by

$grid-container-padding-desktop-sides

Since 1.0.0
$grid-container-padding-desktop-sides: $padding !default;
View source

Description

The amount of padding to put on the content container on desktop.

$grid-container-padding-desktop

Since 1.0.0
$grid-container-padding-desktop: $padding-large $grid-container-padding-desktop-sides !default;
View source

Description

The amount of padding to put on the content container on desktop.

Used by

$grid-row-margin

Since 1.0.0
$grid-row-margin: 0 -#{$grid-container-padding} !default;
View source

Description

Controls the margin on rows in the grid. By default, this will attempt to "pull" grid items out by the same amount as their margin, Boostrap-style.

Used by

$grid-row-margin-desktop

Since 1.0.0
$grid-row-margin-desktop: 0 -#{$grid-container-padding-desktop-sides} !default;
View source

Description

Controls the margin on rows in the grid. By default, this will attempt to "pull" grid items out by the same amount as their margin, Boostrap-style.

Used by

$grid-column-padding

Since 1.0.0
$grid-column-padding: $padding !default;
View source

Description

Controls the padding on child items of the grid. On non-margin classes, this will act like a "margin", putting space between grid items, Boostrap-style. If you need to use the padding for something else, like if you have a background color on your grid item, use the margin classes.

Used by

$grid-margin-padding

Since 2.0.0
$grid-margin-padding: $padding !default;
View source

Description

Controls the padding on child items of the grid using the -margin class. Does not affect other margin classes.

placeholders

%col-margin-parent

Since 2.0.0
%col-margin-parent { ... }
View source

Description

Styles for parents of margin grid items. Also available in breakpoint flavors, just like the grid classes - for example, .col-md-margin-parent.

Requires

icons

variables

$print-icon-classes

Since 2.0.0
$print-icon-classes: false !default;
View source

Description

Choose whether or not to print CSS classes for icons in your stylesheet. By default, this option is false for child themes, and true for the framework. Set this to true when you want to give the client flexibility to choose their own icons using CSS and custom HTML.

$font-family-icons

Since 2.0.0
$font-family-icons: "bu-default-icons" !default;
View source

Description

The font family to use for icons across the site. Change this to use a different homegrown font family.

Used by

$font-size-icon

Since 2.0.0
$font-size-icon: 21px !default;
View source

Description

The font size to use for icons across the site.

$color-icons

Since 1.0.0
$color-icons: unset !default;
View source

Description

The color to use for icons across the site. By default, this will inherit the color of the text in the container the icon lives in. Setting this will keep the color of the icons consistent everywhere.

Used by

$use-default-icons

Since 2.1.11
$use-default-icons: true !default;
View source

Description

Choose whether or not to use BU Default icons for icons in your stylesheet. By default, this option is set to true. Set to false to load your own icon font family.

$icons-positioning

Since 3.0.2
$icons-positioning: 'before' !default;
View source

Description

Controls the placement of icon content globally in placeholders and default icon classes.

$icons-responsive

Since 2.0.0
$icons-responsive: (

	// Actions

	action: "\EE00",
	ban: "\1F6AB",
	bookmark: "\1F516",
	close: "\E421",
	delete: "\2421",
	download: "\EB01",
	downloadbox: "\EB02",
	like: "\1F44D",
	like-alt: "\1F44B",
	dislike: "\1F44E",
	menu: "\E9A1",
	plus: "\002B",
	hyphen: "\002D",
	print: "\2399",
	redirect: "\21AA",
	refresh: "\21BB",
	replay: "\21BA",
	share: "\F601",
	search: "\1F50E",
	settings: "\2699",
	sync: "\EB82",
	star: "\22C6",
	tag: "\E100",
	upload: "\EB41",
	uploadcloud: "\EB40",

	// Arrows

	contract: "\EE01",
	expand: "\2922",
	scaledown: "\EE05",
	scaleup: "\EE04",
	up: "\2806",
	right: "\27A1",
	down: "\2B07",
	left: "\2B05",
	directup: "\25B4",
	directright: "\25B9",
	dropdown: "\25BE",
	directleft: "\25C3",
	navigateup: "\F500",
	navigateright: "\25BB",
	navigatedown: "\F501",
	navigateleft: "\25C5",

	// Charts

	calculator: "\E551",
	barchart: "\1F4CA",
	piechart: "\E570",
	stock: "\E579",

	// Communication

	envelope: "\2709",
	phone: "\1F4DE",
	rss: "\E310",
	rss-alt: "\E31A",
	rotaryphone: "\260E",

	// Documents

	link: "\1F51B",
	link-alt: "\F699",
	file: "\1F4C4",
	files: "\EC00",
	folder: "\1F4C1",
	index: "\E902",
	storagebox: "\E901",

	// eCommerce

	burst: "\F552",
	cart: "\E500",
	creditcard: "\1F4B3",
	emptycart: "\E507",

	// Editing

	compose: "\1F4DD",
	grid: "\E9A0",
	layers: "\E202",
	layout: "\E202",
	list: "\ED50",
	flag: "\2691",
	reply: "\21A9",
	thumbnails: "\E9A3",
	write: "\270E",

	// Location

	compass: "\E671",
	crosshair: "\2316",
	globe: "\1F310",
	location: "\E6D0",
	map: "\E673",
	navigate: "\E670",
	signpost: "\E672",

	// Media

	play: "\25B6",
	pause: "\E8A0",
	stop: "\25A0",
	rewind: "\23EA",
	fastforward: "\29E3",
	skipback: "\23EE",
	skipforward: "\23ED",
	record: "\25CF",
	volume: "\1F508",
	camera: "\1F4F7",
	headphones: "\1F3A7",
	mic: "\1F3A4",
	music: "\266B",
	picture: "\1F304",
	video: "\1F4F9",

	// Objects

	book: "\1F4D5",
	box: "\1F4E6",
	briefcase: "\1F4BC",
	bug: "\1F41B",
	chat: "\1F4AC",
	clipboard: "\1F4CB",
	code: "\E780",
	contacts: "\1F4C7",
	dashboard: "\F000",
	flask: "\F4C0",
	heart: "\2665",
	home: "\2302",
	key: "\1F511",
	lightbulb: "\1F4A1",
	lightning: "\2607",
	lock: "\1F512",
	unlock: "\1F513",
	notebook: "\1F4D3",
	notifications: "\1F514",
	pin: "\1F4CD",
	pinboard: "\F654",
	planet: "\F280",
	poo: "\1F4A9",
	puzzle: "\E710",
	recycle: "\267B",
	recycle-alt: "\267C",
	screwdriver: "\F037",
	thermometer: "\F201",
	toolbox: "\F030",
	user: "\1F464",
	users: "\1F465",
	utensils: "\1F374",
	view: "\1F440",
	wheelchair: "\267F",
	wrench: "\1F527",

	// Social

	dropbox: "\F653",
	dropbox-alt: "\F65A",
	facebook: "\F610",
	facebook-alt: "\F61A",
	flickr: "\F640",
	flickr-alt: "\F644",
	foursquare: "\F690",
	foursquare-alt: "\F691",
	github: "\F670",
	github-alt: "\F671",
	googleplus: "\F613",
	googleplus-alt: "\F614",
	instagram: "\F641",
	instagram-alt: "\F64A",
	kickstarter: "\F681",
	kickstarter-alt: "\F68A",
	linkedin: "\F612",
	linkedin-alt: "\F61E",
	paypal: "\F680",
	paypal-alt: "\F68B",
	pinterest: "\F650",
	pinterest-alt: "\F651",
	pocket: "\F634",
	pocket-alt: "\F635",
	reddit: "\F616",
	reddit-alt: "\F617",
	renren: "\F61C",
	retweet: "\F600",
	skype: "\F636",
	skype-alt: "\F637",
	snapchat: "\F2AC",
	snapchat-alt: "\F2AB",
	soundcloud: "\F6B3",
	soundcloud-alt: "\F6B4",
	spotify: "\F6B1",
	stackexchange: "\F673",
	stackexchange-alt: "\F67B",
	stackoverflow: "\F672",
	stackoverflow-alt: "\F67A",
	stumbleupon: "\F63A",
	stumbleupon-alt: "\F63D",
	telegram: "\F638",
	telegram-alt: "\F639",
	twitter: "\F611",
	twitter-alt: "\F62B",
	tumblr: "\F620",
	tumblr-alt: "\F62A",
	vimeo: "\F631",
	vimeo-alt: "\F63C",
	vine: "\F633",
	vine-alt: "\F63B",
	wechat: "\F6C4",
	wechat-alt: "\F6C5",
	weibo: "\F61B",
	weibo-alt: "\F61D",
	whatsapp: "\F642",
	whatsapp-alt: "\F643",
	wordpress: "\F621",
	youtube: "\F630",
	youtube-alt: "\F632",

	// Status

	alert: "\26A0",
	check: "\2713",
	info: "\2139",
	megaphone: "\1F4E2",

	// Technology

	android: "\F6F3",
	appleinc: "\F8FF",
	desktop: "\1F4BB",
	cloud: "\2601",
	laptop: "\EA00",
	tablet: "\EA01",
	smartphone: "\EA02",
	tv: "\1F4FA",
	wifi: "\EB84",

	// Time

	calendar: "\1F4C5",
	clock: "\23F2",
	watch: "\231A",
	infinity: "\221E",

	// Transportation

	bike: "\1F6B2",
	car: "\1F698",
	plane: "\2708",

	// UI

	filter: "\ED51",
	checkbox-empty: "\ED52",
	checkbox-filled: "\ED53",
	radio-empty: "\ED54",
	radio-filled: "\ED55",

	// BU Hub Indicator

	buhub: '\F700',
	questionmark: '\2753',
);
View source

Description

The icons this site supports. All icons get a name and a UTF-8 value. It's unlikely you'll need to change these, and you probably shouldn't. However, if you're using your own icon font, you may want to add to it.

Used by

mixins

@include icon-content

Since 1.2.0
@mixin icon-content() { ... }
View source

Description

Provides base icon styles normalized across browsers and optimized for accessibility. A helper mixin for the main icon mixin and icon extends. You probably don't actually want to use this unless you're working on Responsive. Use the icon mixin instead.

Parameters

None.

Requires

Used by

@include icon

Since 2.0.0
@mixin icon() { ... }
View source

Description

A mixin to generate icons. Use any icon in $icon-supports. $use-extend will use the extends for performance purposes, but sacrifices your ability to use this inside a media query. Setting this to true is really only beneficial for generating the default placeholders.

Parameters

None.

Throws

Requires

placeholders

%icon-content-before

Since 2.0.0
%icon-content-before { ... }
View source

Description

Provides base icon styles normalized across browsers and optimized for accessibility. A helper placeholder for the main icon mixin and icon extends. You probably don't actually want to use this unless you're working on Responsive. Use the icon mixin instead.

Requires

%icon-content-after

Since 2.0.0
%icon-content-after { ... }
View source

Description

Provides base icon styles normalized across browsers and optimized for accessibility. A helper placeholder for the main icon mixin and icon extends. You probably don't actually want to use this unless you're working on Responsive. Use the icon mixin instead.

Requires

mixins

mixins

@include angle

Since 2.0.0
@mixin angle($|, $|, $|) { ... }
View source

Description

A mixin to quickly add angles to an element. Uses before/after pseudo classes. Based on Jeremy Frank's work here: https://www.viget.com/articles/angled-edges-with-css-masks-and-transforms

Parameters

parameter Nameparameter Descriptionparameter Typeparameter Default value
$|

$pseudo [after] - The pseudo-element to apply the angle to. Use before to get an angle on top, after to get an angle on bottom.

String none
$|

$flip [false] - Whether or not to flip the default angle slant. By default, the angle will slant upwards to the right.

Bool none
$|

$angle [1.5deg] - The number of degrees to slant the angle at.

Deg none

Example

	Add a 1.5 degree angle, slanted right, to the bottom of a callout.
.callout {
	@include angle( after );
}

	Add angles to both edges of a callout.
.callout {
	@include angle( both );
}

	Add a 2.5 degree angle, slanted right, to the top of a callout.
.callout {
	@include angle( before, false, 2.5deg );
}

navigation

General

css

// @group typography // @access public // @since 2.0.0 @mixin font-size( $style )

// @group typography
// @access public
// @since 2.0.0

@mixin font-size( $style ) { ... }
View source

Example

Make a `<h4>` look like an `<h2>`.
	.comparison-title {
	@include font-size( '2' );
}

utilities

placeholders

%equal-height-parent-backcompat

Since 1.2.0
%equal-height-parent-backcompat { ... }
View source

Description

A backwards-compatible equal heights solution for older browsers. Base styles for a container whose children should be equal heights.

%equal-height-child-backcompat

Since 1.2.0
%equal-height-child-backcompat { ... }
View source

Description

A backwards-compatible equal heights solution for older browsers. Base styles for children of the equal-height-parent. These styles will make children appear to be equal heights, even if the actual content is different heights. If you need padding on the bottom of the child items, you might have to adjust the margin-bottom to be lower.

Requires

%equal-heights

Since 2.0.0
%equal-heights { ... }
View source

Description

A newer version of equal heights that takes advantage of flexbox. Use this on your container to make all children equal heights. Plays nice with the grid. Check https://caniuse.com/#search=flexbox for browser support. You may want to provide a min-height on a case by case basis as a fallback.

widgets

css

.menu-item

Since 2.0.0
.menu-item { ... }
View source

Description

Styles social links in menus.

WordPress Admin

css