Global Configuration
variables
$mqs
Since 1.0.0$mqs: true !default;
View sourceDescription
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
- [mixin]
breakpoint
$xs
Since 1.2.0$xs: 500px !default;
View sourceDescription
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 sourceDescription
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
- [placeholder]
container-styles
- [placeholder]
row-styles
$md
Since 1.2.0$md: 992px !default;
View sourceDescription
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
- [placeholder]
container-styles
- [placeholder]
equal-height-child-backcompat
$lg
Since 1.2.0$lg: 1200px !default;
View sourceDescription
The window width at which large styles will begin. By default, this is set to target most laptops.
Used by
- [placeholder]
container-styles
$xl
Since 1.2.0$xl: 1500px !default;
View sourceDescription
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 sourceDescription
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
- [mixin]
breakpoint
$margin
Since 2.0.0$margin: 30px !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
A padding variable for situations where you need a larger amount of padding.
$tint-hue
Since 2.0.0$tint-hue: none !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
A grayscale variable that takes advantage of the tint system. Produces a plain black. Overriding this variable is not supported.
Used by
- [placeholder]
button-styles
- [placeholder]
button-styles
- [placeholder]
button-styles
$color-grayscale-1
Since 1.0.0$color-grayscale-1: tint-gray( #111 );
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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
- [placeholder]
button-styles-input
$color-grayscale-8
Since 1.0.0$color-grayscale-8: tint-gray( #888 );
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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
- [placeholder]
button-styles-input
$color-grayscale-e
Since 1.0.0$color-grayscale-e: tint-gray( #eee );
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
The default border style.
$font-family-form
Since 1.0.0$font-family-form: $font-family-sans-serif !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
Controls the font used on all buttons and things that looks like buttons across the site.
Used by
- [placeholder]
button-styles
$font-size-button
Since 1.0.0$font-size-button: inherit !default;
View sourceDescription
Controls the font size used on all buttons and things that looks like buttons across the site.
Used by
- [placeholder]
button-styles
$color-button-bg
Since 1.0.0$color-button-bg: $color-grayscale-e !default;
View sourceDescription
Controls the background color used on default buttons and things that looks like buttons across the site.
Used by
- [placeholder]
button-styles
$color-button-text
Since 1.0.0$color-button-text: $color-grayscale-4 !default;
View sourceDescription
Controls the text color used on default buttons and things that looks like buttons across the site.
Used by
- [placeholder]
button-styles
$color-button-primary-bg
Since 1.0.0$color-button-primary-bg: #0074E0 !default;
View sourceDescription
Controls the background color used on primary buttons and things that looks like buttons across the site.
Used by
- [placeholder]
button-styles-primary
$color-button-primary-text
Since 1.0.0$color-button-primary-text: $color-grayscale-f !default;
View sourceDescription
Controls the text color used on primary buttons and things that looks like buttons across the site.
Used by
- [placeholder]
button-styles-primary
- [placeholder]
button-styles-primary
$margin-button
Since 2.0.0$margin-button: 0 $margin-small $margin-small 0 !default;
View sourceDescription
Controls the margin on buttons in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.
Used by
- [placeholder]
button-styles
$padding-button
Since 2.0.0$padding-button: 0.5em 1em !default;
View sourceDescription
Controls the margin on buttons in forms. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.
Used by
- [placeholder]
button-styles
$border-button
Since 2.0.0$border-button: 0;
View sourceDescription
Controls the border on buttons.
Used by
- [placeholder]
button-styles
$border-radius-button
Since 2.0.0$border-radius-button: 2px !default;
View sourceDescription
Controls the rounding of edges on buttons. Note: this style may not apply to Gravity Forms due to overly specific plugin CSS.
Used by
- [placeholder]
button-styles
$color-base
Since 1.0.0$color-base: $color-grayscale-5 !default;
View sourceDescription
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 sourceDescription
Base margin for the section tag.
$min-size-headings
Since 2.0.0$min-size-headings: $font-size-base !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
The default font for body copy.
functions
Since 2.0.0
@function tint-gray() { ... }
View sourceDescription
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
- [variable]
tint-hue
- [variable]
tint-saturation
- [variable]
tint-saturation
- [variable]
tint-hue
Since 2.0.0
@function calc-scale($min, $max, $steps) { ... }
View sourceDescription
Calculates the multiplier needed for growth between a minimum and maximum value based on a given rate of growth.
Parameters
parameter Name | parameter Description | parameter Type | parameter Default value |
---|---|---|---|
$min | The minimum value to use. Units, if used, must match | Int | — none |
$max | The minimum value to use. Units, if used, must match | 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
- [function]
calc-size
Since 2.0.0
@function calc-size($step, $rate, $scale, $min, $scaled, $base) { ... }
View sourceDescription
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 Name | parameter Description | parameter Type | parameter 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 | Int | — none |
$min | The minimum amount you need returned. | Int | — none |
$scaled | Whether or not to return a scaled value, using | Bool | — none |
$base | A value to divide by in order to return a scaled value. The units on this value need to match | Int | — none |
Returns
Int
—A unitless size.
See
- [function]
calc-scale
css
section
Since 1.0.0section { ... }
View sourceDescription
Controls spacing between section tags.
table
Since 1.0.0table { ... }
View sourceDescription
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 sourceDescription
Adds stripes to tables.
.table-bordered
Since 1.0.0.table-bordered { ... }
View sourceDescription
Adds both horizontal and vertical borders.
.table-horizontal
Since 1.0.0.table-horizontal { ... }
View sourceDescription
Switches the border on tables from vertical to horizontal.
body
Since 1.0.0body { ... }
View sourceDescription
Base styles and typography for all HTML elements.
a
Since 1.0.0a { ... }
View sourceDescription
Controls base styling for all links.
Helpers
placeholders
%clearfix
Since 1.0.0%clearfix { ... }
View sourceDescription
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
- [placeholder]
container-styles
- [placeholder]
row-styles
%hide-text
Since 1.0.0%hide-text { ... }
View sourceDescription
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" );
}
%responsive-video-styles
Since 1.0.0%responsive-video-styles { ... }
View sourceDescription
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 sourceDescription
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
- [variable]
container-md
%back-link-styles
Since 1.0.0%back-link-styles { ... }
View sourceDescription
A placeholder to mimic the styles of the "Back" link on archive pages.
Requires
- [variable]
color-back-link-before
- [variable]
back-link-before
%card-styles
Since 1.0.0%card-styles { ... }
View sourceDescription
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
- [mixin]
border-radius
- [variable]
border-radius-message
- [variable]
color-message-bg
- [variable]
border-message
- [variable]
color-message-border-left
- [variable]
border-width-message
- [variable]
padding-message
mixins
@include aspect-ratio
Since 3.1.2@mixin aspect-ratio() { ... }
View sourceDescription
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 sourceDescription
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
- [placeholder]
card-styles
@include box-shadow
Since 1.0.0@mixin box-shadow() { ... }
View sourceDescription
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
- [placeholder]
button-styles
- [placeholder]
button-styles-input
@include linear-gradient
Since 1.2.0@mixin linear-gradient() { ... }
View sourceDescription
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
- [placeholder]
button-styles
@include opacity
Since 1.0.0@mixin opacity() { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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
- [mixin]
transform
@include scale
Since 1.0.0@mixin scale() { ... }
View sourceDescription
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
- [mixin]
transform
@include translate
Since 1.0.0@mixin translate() { ... }
View sourceDescription
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
- [mixin]
transform
@include transform-origin
Since 1.0.0@mixin transform-origin() { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
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.0Deprecated in favor of flexbox approach in Responsive 2.0
@mixin vertical-center-child-ie8() { ... }
View sourceDescription
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.0Deprecated in favor of flexbox approach in Responsive 2.0
@mixin vertical-center-ie9() { ... }
View sourceDescription
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 sourceDescription
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 Name | parameter Description | parameter Type | parameter 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 sourceDescription
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 Name | parameter Description | parameter Type | parameter Default value |
---|---|---|---|
$| | $breakpoint - The window width to begin applying your styles. Can be any pixel value, but | 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
- [variable]
mqs
- [variable]
lte-ie8-target-width
Used by
- [placeholder]
container-styles
- [placeholder]
container-styles
- [placeholder]
container-styles
- [placeholder]
row-styles
- [placeholder]
equal-height-child-backcompat
@include debug-map
Since 2.0.0@mixin debug-map($|) { ... }
View sourceDescription
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 Name | parameter Description | parameter Type | parameter Default value |
---|---|---|---|
$| | $map - A sass map to debug. | Map | — none |
@include retina
Since 1.0.0@mixin retina() { ... }
View sourceDescription
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 sourceDescription
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 Name | parameter Description | parameter Type | parameter 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 | 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 sourceDescription
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 sourceDescription
The class WordPress generates when you align something right in the visual editor.
.alignleft
Since 1.0.0.alignleft { ... }
View sourceDescription
The class WordPress generates when you align something left in the visual editor.
.aligncenter
Since 1.0.0.aligncenter { ... }
View sourceDescription
The class WordPress generates when you center something in the visual editor.
.responsive-table
Since 1.0.0.responsive-table { ... }
View sourceDescription
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 sourceDescription
For code within the WordPress content area.
.back-link
Since 1.0.0.back-link { ... }
View sourceDescription
Controls the styles of the "Back" link on archive pages. Use this class to only style CSS with the back link. Use the placeholder to style anything that looks like a back link.
.message
Since 1.0.0.message { ... }
View sourceDescription
Controls the styling for messages.
Icons
placeholders
%icon-base
Since 1.2.0%icon-base { ... }
View sourceDescription
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 sourceDescription
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
- [mixin]
icon-content
Typography
placeholders
%heading-base
Since 1.0.0%heading-base { ... }
View sourceDescription
Controls base styles for all heading tags.
Requires
- [variable]
color-heading
- [variable]
font-family-heading
- [variable]
color-heading-small
variables
$font-family-sans-serif
Since 1.0.0$font-family-sans-serif: "Benton-Sans", "Helvetica", sans-serif !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
A font to use for headings. Affects <h1>
, <h2>
, etc.
Used by
- [placeholder]
heading-base
$color-heading
Since 1.0.0$color-heading: $color-grayscale-0 !default;
View sourceDescription
A color to use for headings. Affects <h1>
, <h2>
, etc.
Used by
- [placeholder]
heading-base
$color-heading-small
Since 1.0.0$color-heading-small: $color-grayscale-6 !default;
View sourceDescription
A font to use for small tags within headings.
Used by
- [placeholder]
heading-base
$font-margin-base
Since 1.0.0$font-margin-base: 0 0 1.5em 0 !default;
View sourceDescription
Base margin for HTML tags. Primarily affects <p>
.
$color-link
Since 1.0.0$color-link: #0f69d7 !default;
View sourceDescription
Base color for links.
$color-link-visited
Since 1.0.0$color-link-visited: #7337af !default;
View sourceDescription
Base color for visited links. Must be different from $color-link
for accessibility reasons.
$color-link-active
Since 1.0.0$color-link-active: $color-grayscale-0 !default;
View sourceDescription
Base color for active links. Must be different from $color-link
for accessibility reasons.
$font-padding-code
Since 1.0.0$font-padding-code: 0.2em 0.4em !default;
View sourceDescription
Base padding for the <code>
tag.
$font-margin-code
Since 1.0.0$font-margin-code: $margin 0 !default;
View sourceDescription
Base margin for the <code>
tag.
$color-code
Since 1.0.0$color-code: $color-grayscale-6 !default;
View sourceDescription
Text color to use for the <code>
tag.
$color-code-bg
Since 1.0.0$color-code-bg: $color-grayscale-f5 !default;
View sourceDescription
Background color to use for the <code>
tag.
$border-code
Since 2.0.0$border-code: $border !default;
View sourceDescription
Base border for the <code>
tag.
$font-margin-blockquote
Since 1.0.0$font-margin-blockquote: 1em $margin-large !default;
View sourceDescription
Base margin for the <blockquote>
tag.
$font-margin-list
Since 1.0.0$font-margin-list: $font-margin-base !default;
View sourceDescription
Base margin for <ul>
and <ol>
tags.
$font-padding-list
Since 1.0.0$font-padding-list: 0 0 0 40px !default;
View sourceDescription
Base padding for <ul>
and <ol>
tags.
$font-margin-dd
Since 1.0.0$font-margin-dd: 0 0 0 $margin !default;
View sourceDescription
Base margin for <dd>
tags.
css
h1
Since 1.0.0h1 { ... }
View sourceDescription
Styles for all h1 tags.
h2
Since 1.0.0h2 { ... }
View sourceDescription
Styles for all h2 tags.
h3
Since 1.0.0h3 { ... }
View sourceDescription
Styles for all h3 tags.
h4
Since 1.0.0h4 { ... }
View sourceDescription
Styles for all h4 tags.
h5
Since 1.0.0h5 { ... }
View sourceDescription
Styles for all h5 tags.
h6
Since 1.0.0h6 { ... }
View sourceDescription
Styles for all h6 tags.
blockquote
Since 1.0.0blockquote { ... }
View sourceDescription
Styles for all blockquotes.
p, pre
Since 1.0.0p,
pre { ... }
View sourceDescription
Styles for all paragraphs and preformatted content.
code, kbd, pre, samp
Since 1.0.0code,
kbd,
pre,
samp { ... }
View sourceDescription
Styles for all preformatted and code content.
dd
Since 1.0.0dd { ... }
View sourceDescription
Styles for definition stuff.
code
Since 1.0.0code { ... }
View sourceDescription
Styles for code element.
.code
Since 1.0.0.code { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
Sets the margin width for content and footbar widgets.
$column-padding-bottom
Since 1.2.0$column-padding-bottom: 10px !default;
View sourceDescription
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 sourceDescription
The amount of padding to add to columns on desktop.
$sidebar-padding
Since 1.2.0$sidebar-padding: 3.46667% !default;
View sourceDescription
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 sourceDescription
Sets the number of supported widgets in the footbar. Matches the number of columns in the theme by default.
Navigation
Branding
variables
$font-family-brand
Since 1.0.0$font-family-brand: "Whitney SSm A", "Whitney SSm B", "Helvetica", "Arial", sans-serif !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
The font family to use for the unbranded branding type.
$height-brand
Since 1.0.0$height-brand: 120px !default;
View sourceDescription
The height of the branding area.
$color-brand
Since 1.0.0$color-brand: $color-grayscale-0 !default;
View sourceDescription
The color used for the site name when a site is using BU branding.
$color-unbranded
Since 1.0.0$color-unbranded: #c00;
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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
Since 1.0.0$image-bumclogo: "https://www.bu.edu/cdn/images/logos/bumclogo96x40.png" !default;
View sourceDescription
The image used for the BUMC logo. 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 sourceDescription
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 sourceDescription
Controls styling for elements in the branding area, including the logo and site description.
.brand-container
Since 1.0.0.brand-container { ... }
View sourceDescription
Controls styling for the logo container.
.brand-signature
Since 1.4.0.brand-signature { ... }
View sourceDescription
Controls styling for the signature brand style.
.brand-unbranded
Since 1.4.0.brand-unbranded { ... }
View sourceDescription
Controls styling for the unbranded brand style.
.brand-part-logotype
Since 1.4.0.brand-part-logotype { ... }
View sourceDescription
Controls styling for the logotype brand part.
.brand-part-sitename
Since 1.4.0.brand-part-sitename { ... }
View sourceDescription
Controls styling for the site name brand part.
.brand-part-parent
Since 1.4.0.brand-part-parent { ... }
View sourceDescription
Controls styling for the parent entity brand part.
.brand-part-subparent
Since 1.4.0.brand-part-subparent { ... }
View sourceDescription
Controls styling for the subparent entity brand part.
.brand-site-description
Since 1.4.0.brand-site-description { ... }
View sourceDescription
Controls styling for the site description.
.brand-masterplate
Since 1.0.0.brand-masterplate { ... }
View sourceDescription
Controls styling for the masterplate.
.brand-bumclogo
Since 1.0.0.brand-bumclogo { ... }
View sourceDescription
Controls styling for the BUMC logo.
Layout
variables
$container-sm
Since 1.2.0$container-sm: 750px !default;
View sourceDescription
The container width for the small (sm) breakpoint.
Used by
- [placeholder]
container-styles
$container-md
Since 1.2.0$container-md: 970px !default;
View sourceDescription
The container width for the medium (md) breakpoint.
Used by
- [placeholder]
resposive-table-styles
- [placeholder]
container-styles
$container-lg
Since 1.2.0$container-lg: 1170px !default;
View sourceDescription
The container width for the large (lg) breakpoint.
Used by
- [placeholder]
container-styles
$z-index-content
Since 2.0.0$z-index-content: $z-index-1 !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
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-overlays
Since 2.0.0$z-index-overlays: $z-index-9 !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
General styles for all content banner positions.
.banner-container-window-width
Since 1.0.0.banner-container-window-width { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
Styles for the content-width content banner position. Sits directly inside .content-area
.
.content
Since 1.0.0.content { ... }
View sourceDescription
Controls styling for all content, from the masthead to the site footer.
.content-container
Since 1.0.0.content-container { ... }
View sourceDescription
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 sourceDescription
Styles for the content area (formerly styled by article[role=main]). Sits next to the sidebar.
.sidebar
Since 1.0.0.sidebar { ... }
View sourceDescription
The default class for styling sidebars.
.sidebar-location-left
Since 1.2.0.sidebar-location-left { ... }
View sourceDescription
Styles for the left sidebar location.
.content-container-narrow
Since 1.4.0.content-container-narrow { ... }
View sourceDescription
Styles for narrow content.
.footbar
Since 1.0.0.footbar { ... }
View sourceDescription
Controls styling for the footbar.
.footbar-container
Since 1.0.0.footbar-container { ... }
View sourceDescription
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 sourceDescription
Styles the disclaimer, which shows in the site footer.
.masthead
Since 1.0.0.masthead { ... }
View sourceDescription
Controls all styling related to the masthead. This includes navigation, branding, and search.
.masthead-container
Since 1.0.0.masthead-container { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
Handles styling for the 404 page.
Content
variables
$table-margin
Since 1.0.0$table-margin: $margin 0 !default;
View sourceDescription
Base margin for the table tag.
$table-padding
Since 1.0.0$table-padding: 0.5em 1em !default;
View sourceDescription
Base padding for the table.
$table-border
Since 1.0.0$table-border: $border !default;
View sourceDescription
Default border for tables.
$color-table-head
Since 1.0.0$color-table-head: $color-heading !default;
View sourceDescription
Default color for table headings.
$table-head-bg
Since 1.0.0$table-head-bg: $color-grayscale-e !default;
View sourceDescription
Default background for table headings.
$table-stripes
Since 1.0.0$table-stripes: $color-grayscale-f5 !default;
View sourceDescription
Default background for striped table backgrounds.
$color-collapsible-icon
Since 2.0.0$color-collapsible-icon: $color-icons !default;
View sourceDescription
Controls the color of icons on collapsibles.
$color-collapsible-icon-hover
Since 2.0.0$color-collapsible-icon-hover: $color-link !default;
View sourceDescription
Controls the color of icons on collapsibles when you hover.
$border-collapsible
Since 2.0.0$border-collapsible: $border !default;
View sourceDescription
Controls the border between collapsibles.
$border-coursefeed
Since 2.0.0$border-coursefeed: $border !default;
View sourceDescription
Controls the border between course feed items.
$margin-floated-content
Since 1.0.0$margin-floated-content: $margin-small !default;
View sourceDescription
The margin to use around anything floated in the content area.
$box-shadow-table
Since 1.0.0$box-shadow-table: inset -20px 0 20px -10px $color-grayscale-f0 !default;
View sourceDescription
The shadow to use in tables.
$color-banner-container
Since 1.0.0$color-banner-container: $color-grayscale-f0 !default;
View sourceDescription
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 sourceDescription
Controls the padding on the banner container.
$padding-banner-window-width
Since 3.0.2$padding-banner-window-width: $padding-small !default;
View sourceDescription
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 sourceDescription
Controls the background color of the content.
$back-link-before
Since 1.0.0$back-link-before: "← " !default;
View sourceDescription
Controls the shape used in "back" links, such as the links you see at the bottom of the page when viewing a single profile. By default, this is an arrow.
Used by
- [placeholder]
back-link-styles
$color-back-link-before
Since 1.0.0$color-back-link-before: $color-grayscale-f !default;
View sourceDescription
Controls the color of the arrow in "back" links, such as the links you see at the bottom of the page when viewing a single profile.
Used by
- [placeholder]
back-link-styles
css
.bu_collapsible_container
Since 1.0.0.bu_collapsible_container { ... }
View sourceDescription
Styles a collapsible item.
.bu_collapsible
Since 1.0.0.bu_collapsible { ... }
View sourceDescription
Styles the header on a collapsible item.
.cf-course
Since 1.0.0.cf-course { ... }
View sourceDescription
Controls the styling for a single course in a course feed.
.cf-course-title
Since 2.0.0.cf-course-title { ... }
View sourceDescription
Controls the styling for the course title in a course feed.
.cf-course-id
Since 2.0.0.cf-course-id { ... }
View sourceDescription
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 sourceDescription
Controls the styling for course credits, availability, and prerequisites.
.cf-table
Since 2.0.0.cf-table { ... }
View sourceDescription
Controls the styling for the section table.
.cf-section-title
Since 2.0.0.cf-section-title { ... }
View sourceDescription
Controls the styling for the section title.
.cf-section-dates
Since 2.0.0.cf-section-dates { ... }
View sourceDescription
Controls the styling for the section start and end dates.
.cf-course-offered
Since 2.0.0.cf-course-offered { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
BU Hub Indicator Wrapper
.cf-hub-head
Since 2.0.1.cf-hub-head { ... }
View sourceDescription
BU Hub Indicator Title
.bu-hub-iconstyles
Since 2.0.1.bu-hub-iconstyles { ... }
View sourceDescription
BU Hub Indicator Title Iconstyles
.cf-hub-offerings
Since 2.0.1.cf-hub-offerings { ... }
View sourceDescription
BU Hub Indicator Area
- List
.gallery
Since 1.4.0.gallery { ... }
View sourceDescription
Base styles for the gallery shortcode in WordPress.
.gallery-item
Since 1.4.0.gallery-item { ... }
View sourceDescription
Styles for each supported number of columns in the WordPress gallery shortcode.
.bu-slideshow-container
Since 1.0.0.bu-slideshow-container { ... }
View sourceDescription
BU Slideshow styles.
.label
Since 1.0.0.label { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
Controls the color of the month when using the graphic style in the calendar widget.
$color-footbar-widget-link
Since 1.0.0$color-footbar-widget-link: $color-link !default;
View sourceDescription
Controls the color of links in widgets in the footbar.
$color-footbar-widget-link-hover
Since 1.0.0$color-footbar-widget-link-hover: $color-link !default;
View sourceDescription
Controls the color of links in widgets in the footbar when you hover.
$color-widget-post-meta
Since 1.0.0$color-widget-post-meta: $color-grayscale-6 !default;
View sourceDescription
Controls the color of the metadata in the BU posts widget.
$widget-margin-bottom
Since 1.0.0$widget-margin-bottom: $margin !default;
View sourceDescription
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 sourceDescription
Controls the font family used for the widget title.
$border-widget-title
Since 1.0.0$border-widget-title: $border !default;
View sourceDescription
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 sourceDescription
Controls the border width used on the widget title.
$color-widget-title
Since 1.0.0$color-widget-title: $color-grayscale-0 !default;
View sourceDescription
Controls the color of the widget title.
$widget-title-link-after
Since 1.0.0$widget-title-link-after: " →" !default;
View sourceDescription
Controls the shape which shows after the widget title if it is a link. By default, this is set to be an arrow.
$color-widget-title-link-after
Since 1.0.0$color-widget-title-link-after: currentColor !default;
View sourceDescription
Controls the color of the shape which shows after the widget title if it is a link.
$color-widget-title-link-after-hover
Since 1.0.0$color-widget-title-link-after-hover: $color-grayscale-0 !default;
View sourceDescription
Controls the color of the shape which shows after the widget title when you hover.
$font-family-widget-heading
Since 1.0.0$font-family-widget-heading: $font-family-sans-serif !default;
View sourceDescription
Controls the font family used for headings in widget content.
$color-widget-link
Since 1.0.0$color-widget-link: $color-link !default;
View sourceDescription
Controls the color of links in the widget content.
$color-widget-link-hover
Since 1.0.0$color-widget-link-hover: $color-link !default;
View sourceDescription
Controls the color of links when you hover in the widget content.
$border-widget-list
Since 1.0.0$border-widget-list: $border !default;
View sourceDescription
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 sourceDescription
Styles events in the calendar widget. Affects all formats.
.widget-calendar-link
Since 2.0.0.widget-calendar-link { ... }
View sourceDescription
Styles links in the calendar widget. Affects all formats.
.widget-calendar-date
Since 2.0.0.widget-calendar-date { ... }
View sourceDescription
Styles dates in the calendar widget. Affects all formats.
.widget-calendar-event-default
Since 2.0.0.widget-calendar-event-default { ... }
View sourceDescription
Styles an event in the calendar widget default format.
.widget-calendar-date-default
Since 2.0.0.widget-calendar-date-default { ... }
View sourceDescription
Styles dates in the calendar widget default format.
.widget-calendar-title-default
Since 2.0.0.widget-calendar-title-default { ... }
View sourceDescription
Styles titles in the calendar widget default format.
.widget-calendar-link-graphic
Since 2.0.0.widget-calendar-link-graphic { ... }
View sourceDescription
Styles links in the calendar widget graphic format.
.widget-calendar-date-graphic
Since 2.0.0.widget-calendar-date-graphic { ... }
View sourceDescription
Styles dates in the calendar widget graphic format.
.widget-calendar-day-graphic
Since 2.0.0.widget-calendar-day-graphic { ... }
View sourceDescription
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 sourceDescription
Styles the month in the calendar widget graphic format.
.widget-calendar-title-graphic
Since 2.0.0.widget-calendar-title-graphic { ... }
View sourceDescription
Styles the title in the calendar widget graphic format.
.widget-post
Since 2.0.0.widget-post { ... }
View sourceDescription
Handles styling for posts in the BU Posts widget (news widget).
.widget-post-headline
Since 2.0.0.widget-post-headline { ... }
View sourceDescription
Handles styling for the post headline in the BU Posts widget (news widget).
.widget-post-meta
Since 2.0.0.widget-post-meta { ... }
View sourceDescription
Handles styling for metadata in the BU Posts widget (news widget).
.widget-post-excerpt
Since 2.0.0.widget-post-excerpt { ... }
View sourceDescription
Handles styling for the excerpt in the BU Posts widget (news widget).
.widget-post-thumbnail
Since 2.0.0.widget-post-thumbnail { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
Handles global widget styling.
.widget-title
Since 1.0.0.widget-title { ... }
View sourceDescription
Handles title styles for all widgets.
.blogroll
Since 2.0.0.blogroll { ... }
View sourceDescription
Styles the blog list in the blogroll widget.
.widget_links, .widget_archive
Since 2.0.0.widget_links,
.widget_archive { ... }
View sourceDescription
Handles styling for archive and link widgets.
Forms
placeholders
%button-styles
Since 1.2.0%button-styles { ... }
View sourceDescription
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
- [mixin]
linear-gradient
- [mixin]
box-shadow
- [variable]
color-button-bg
- [variable]
border-button
- [variable]
border-radius-button
- [variable]
color-button-text
- [variable]
font-family-button
- [variable]
font-size-button
- [variable]
margin-button
- [variable]
padding-button
- [variable]
color-grayscale-0
- [variable]
color-grayscale-0
- [variable]
color-grayscale-0
%button-styles-input
Since 1.2.0%button-styles-input { ... }
View sourceDescription
Controls button styles for input tags globally. Only to be used with form element tags.
Requires
- [mixin]
box-shadow
- [variable]
color-grayscale-d
- [variable]
color-grayscale-7
%button-styles-primary
Since 1.2.0%button-styles-primary { ... }
View sourceDescription
Styles buttons in a "primary" way so as to look more important when there are multiple buttons near each other.
Requires
- [variable]
color-button-primary-bg
- [variable]
color-button-primary-text
- [variable]
color-button-primary-text
css
form
Since 1.0.0form { ... }
View sourceDescription
The general styles for forms.
fieldset
Since 1.0.0fieldset { ... }
View sourceDescription
The general styles for the fieldset element. Wraps around sets of controls within a form. See MDN on fieldset.
legend
Since 1.0.0legend { ... }
View sourceDescription
The general styles for the legend element, which holds a caption for the fieldset element. See MDN on legend.
label
Since 1.0.0label { ... }
View sourceDescription
The general styles for labels on form fields. See MDN on label.
button, [type="button"], [type="reset"], [type="submit"]
Since 1.0.0button,
[type="button"],
[type="reset"],
[type="submit"] { ... }
View sourceDescription
The general styles for inputs which should look like buttons.
.form-row
Since 1.0.0.form-row { ... }
View sourceDescription
Styles form rows, if you are not using Gravity Forms. From Pure v0.5.0.
.form-controls
Since 1.0.0.form-controls { ... }
View sourceDescription
Styles form controls, if you are not using Gravity Forms. From Pure v0.5.0.
.required
Since 1.0.0.required { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
Styles Gravity Forms.
.button
Since 1.0.0.button { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
Controls the border width between comments on a post.
$comment-padding
Since 1.0.0$comment-padding: $padding-small !default;
View sourceDescription
Controls the amount of spacing within comments.
$comment-padding-mobile
Since 1.0.0$comment-padding-mobile: $padding-small !default;
View sourceDescription
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 sourceDescription
Controls the font family used for comments on a post.
$color-comments
Since 1.0.0$color-comments: $color-base !default;
View sourceDescription
Controls the color of comments on a post.
$color-comment-reply
Since 1.0.0$color-comment-reply: $color-grayscale-6 !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
Controls the background color of the comment submission form.
$border-comment-form
Since 1.0.0$border-comment-form: $border !default;
View sourceDescription
Controls the border style on the comment submission form.
$border-width-comment-form
Since 1.0.0$border-width-comment-form: 3px !default;
View sourceDescription
Controls the border width on the comment submission form.
$border-message
Since 1.0.0$border-message: $border !default;
View sourceDescription
The style of the border on comments and items using the card styles.
Used by
- [placeholder]
card-styles
$border-width-message
Since 1.0.0$border-width-message: 1px 1px 1px 5px !default;
View sourceDescription
The width of the border on comments and items using the card styles.
Used by
- [placeholder]
card-styles
$border-radius-message
Since 1.0.0$border-radius-message: 3px !default;
View sourceDescription
The amount of rounding (border radius) to apply to the corners of comments.
Used by
- [placeholder]
card-styles
$padding-message
Since 1.0.0$padding-message: 20px !default;
View sourceDescription
The amount of padding to apply to comments.
Used by
- [placeholder]
card-styles
$color-message-bg
Since 1.0.0$color-message-bg: $color-grayscale-f0 !default;
View sourceDescription
The background of comments.
Used by
- [placeholder]
card-styles
$color-message-border-left
Since 1.0.0$color-message-border-left: $color-grayscale-0 !default;
View sourceDescription
The left border color of comments.
Used by
- [placeholder]
card-styles
$padding-single-meta
Since 1.0.0$padding-single-meta: 20px !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
Controls the color of the left border in the metadata card at the bottom of the single post template.
css
.post-part
Since 2.0.0.post-part { ... }
View sourceDescription
Handles styling for posts in news listings and archive pages.
.post-headline
Since 2.0.0.post-headline { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
Controls styling for the comments section on posts.
.comments-list
Since 1.0.0.comments-list { ... }
View sourceDescription
Controls styling for comment threads on posts.
.comment
Since 1.0.0.comment { ... }
View sourceDescription
Controls styling for the comment container.
.comment-body
Since 1.0.0.comment-body { ... }
View sourceDescription
Controls styling for individual comments on posts.
.comment-reply-link
Since 1.0.0.comment-reply-link { ... }
View sourceDescription
Controls styling for the comment reply link.
.comment-author
Since 1.0.0.comment-author { ... }
View sourceDescription
Controls styling for the comment author.
.says
Since 2.0.0.says { ... }
View sourceDescription
Controls styling for the "says" text after comment author.
.comment-metadata
Since 2.0.0.comment-metadata { ... }
View sourceDescription
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 sourceDescription
Styles the container which holds the comment content.
.comment-respond
Since 1.0.0.comment-respond { ... }
View sourceDescription
Styles the comment form container.
.comment-respond-title
Since 1.0.0.comment-respond-title { ... }
View sourceDescription
Styles the comment form title.
.comment-form-submit
Since 1.0.0.comment-form-submit { ... }
View sourceDescription
Styles the container around the comment form submit button.
.form-tip
Since 1.0.0.form-tip { ... }
View sourceDescription
Styles "view guidelines" and other helper text in the comment form.
#comment
Since 2.0.0#comment { ... }
View sourceDescription
Styles the comment text area in the comments form.
.comment-submit
Since 2.0.0.comment-submit { ... }
View sourceDescription
Styles the comment form submit button.
.cancel-comment-reply
Since 2.0.0.cancel-comment-reply { ... }
View sourceDescription
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 sourceDescription
Handles styling for the metadata card at the bottom of posts.
.single-meta-post-title
Since 2.0.0.single-meta-post-title { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
Handles styling for categories and tags in the metadata card at the bottom of posts.
.archive-link-container
Since 2.0.0.archive-link-container { ... }
View sourceDescription
Handles styling for the archive (View all posts) link container.
.archive-link
Since 2.0.0.archive-link { ... }
View sourceDescription
Handles styling for the archive (View all posts) link.
Calendar
variables
$color-calendar-heading-date-range
Since 1.0.0$color-calendar-heading-date-range: $color-grayscale-6 !default;
View sourceDescription
Controls the color of the date range on the calendar listing template. By default, this is right after the topic.
$color-calendar-event-link
Since 1.0.0$color-calendar-event-link: $color-link !default;
View sourceDescription
Controls the color of links on the calendar listing template.
$color-calendar-event-link-hover
Since 1.0.0$color-calendar-event-link-hover: $color-link !default;
View sourceDescription
Controls the color of links on the calendar listing template when you hover.
$border-calendar-list
Since 2.0.0$border-calendar-list: $border !default;
View sourceDescription
Controls the border between events on the calendar listing template.
$color-calendar-month-th-bg
Since 1.0.0$color-calendar-month-th-bg: $color-grayscale-e !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
Controls the font family of day cells in the calendar picker in the sidebar of the calendar listing template.
$color-calendar-month-link
Since 1.0.0$color-calendar-month-link: $color-grayscale-6 !default;
View sourceDescription
Controls the color of links in the calendar picker in the sidebar of the calendar listing template.
$color-calendar-month-link-hover
Since 1.0.0$color-calendar-month-link-hover: $color-link !default;
View sourceDescription
Controls the color of links when you hover in the calendar picker in the sidebar of the calendar listing template.
$color-calendar-month-link-out-bg
Since 1.0.0$color-calendar-month-link-out-bg: $color-grayscale-f5 !default;
View sourceDescription
Controls the background of links in the calendar picker for days that are not in the current month (previous/next month) in the sidebar of the calendar listing template.
$color-calendar-month-link-out
Since 1.0.0$color-calendar-month-link-out: $color-grayscale-6 !default;
View sourceDescription
Controls the color of links in the calendar picker for days that are not in the current month (previous/next month) in the sidebar of the calendar listing template.
$color-calendar-month-link-today-bg
Since 1.0.0$color-calendar-month-link-today-bg: $color-grayscale-e !default;
View sourceDescription
Controls the background of the current day's link in the calendar picker in the sidebar of the calendar listing template.
$color-calendar-month-link-today
Since 1.0.0$color-calendar-month-link-today: $color-grayscale-0 !default;
View sourceDescription
Controls the color of the current day's link 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 sourceDescription
Controls the font used for labels in the sidebar of the single calendar event template.
Used by
- [placeholder]
single-event-label
$font-weight-calendar-label
Since 1.0.0$font-weight-calendar-label: 700 !default;
View sourceDescription
Controls the font weight used for labels in the sidebar of the single calendar event template.
Used by
- [placeholder]
single-event-label
$color-single-event-label
Since 1.0.0$color-single-event-label: $color-grayscale-9 !default;
View sourceDescription
Controls the color of labels in the sidebar of the single calendar event template.
Used by
- [placeholder]
single-event-label
css
.calendar-list-topic
Since 2.0.0.calendar-list-topic { ... }
View sourceDescription
Handles styling for the calendar topic on the calendar listing page.
.calendar-list-range
Since 2.0.0.calendar-list-range { ... }
View sourceDescription
Handles styling for the selected date range in the calendar listing page.
.calendar-list-events
Since 2.0.0.calendar-list-events { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
Handles styling for an individual event on a given day in the calendar listing page.
.calendar-list-event-link
Since 2.0.0.calendar-list-event-link { ... }
View sourceDescription
Handles styling for the link to an individual event in the calendar listing page.
.widget-calendar-picker
Since 2.0.0.widget-calendar-picker { ... }
View sourceDescription
Styles the BU Calendar list page date picker.
.calendar-topics
Since 2.0.0.calendar-topics { ... }
View sourceDescription
Styles the BU Calendar list page topics widget.
.single-event-schedule
Since 2.0.0.single-event-schedule { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
Handles styling for all single calendar labels, specifically the event fields.
.single-event-info
Since 3.2.1.single-event-info { ... }
View sourceDescription
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 sourceDescription
Handles styling for times in the single calendar event schedule.
.single-event-description
Since 2.0.0.single-event-description { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
Handles styling for all single calendar labels, specifically the event fields.
Requires
- [variable]
color-single-event-label
- [variable]
font-family-single-event-label
- [variable]
font-weight-calendar-label
%single-event-info
Since 2.0.0%single-event-info { ... }
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
Adjusts the size of the basic profile photo.
$profile-photo-default-size
Since 2.0.0$profile-photo-default-size: 50px;
View sourceDescription
Adjusts the size of the default profile photo.
$border-profiles
Since 1.0.0$border-profiles: $border !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
Controls the color used for labels in the single profile listing template sidebar.
css
.profile-listing
Since 2.0.0.profile-listing { ... }
View sourceDescription
Styles for all profile listings.
.profile-item
Since 2.0.0.profile-item { ... }
View sourceDescription
Styles for all profile items in a listing.
.profile-photo
Since 2.0.0.profile-photo { ... }
View sourceDescription
Styles for all profile photos.
.profile-name
Since 2.0.0.profile-name { ... }
View sourceDescription
Styles for all profile names.
.profile-title
Since 2.0.0.profile-title { ... }
View sourceDescription
Styles for all profile titles.
.profile-link
Since 2.0.0.profile-link { ... }
View sourceDescription
Styles for all profile links. Since links are usually wrapped around the whole profile, we leave link styling to specific child elements to avoid visual chaos.
.profile-format-advanced
Since 2.0.0.profile-format-advanced { ... }
View sourceDescription
Styles the advanced profile format.
.profile-item-advanced
Since 2.0.0.profile-item-advanced { ... }
View sourceDescription
Styles an advanced profile item.
.profile-link-advanced
Since 2.0.0.profile-link-advanced { ... }
View sourceDescription
Styles an advanced profile item link.
.profile-photo-advanced
Since 2.0.0.profile-photo-advanced { ... }
View sourceDescription
Styles an advanced profile item photo.
.profile-format-basic
Since 2.0.0.profile-format-basic { ... }
View sourceDescription
Styles the basic profile format.
.profile-item-basic
Since 2.0.0.profile-item-basic { ... }
View sourceDescription
Styles a basic profile item.
.profile-photo-basic
Since 2.0.0.profile-photo-basic { ... }
View sourceDescription
Styles a basic profile photo.
.profile-format-default
Since 2.0.0.profile-format-default { ... }
View sourceDescription
Styles the default profile format.
.profile-item-default
Since 2.0.0.profile-item-default { ... }
View sourceDescription
Styles a default profile item.
.profile-photo-default
Since 2.0.0.profile-photo-default { ... }
View sourceDescription
Styles a default profile photo.
.profile-item-mini
Since 2.0.0.profile-item-mini { ... }
View sourceDescription
Styles the mini profile format.
.profile-photo-mini
Since 2.0.0.profile-photo-mini { ... }
View sourceDescription
Styles the mini profile photo.
.profile-details-mini
Since 2.0.0.profile-details-mini { ... }
View sourceDescription
Styles the mini profile details.
.profile-name-mini
Since 2.0.0.profile-name-mini { ... }
View sourceDescription
Styles the mini profile name.
.profile-email-mini
Since 2.0.0.profile-email-mini { ... }
View sourceDescription
Styles the mini profile email.
.profile-single-name
Since 2.0.0.profile-single-name { ... }
View sourceDescription
Styles the single profile name - typically the title of the page.
.profile-single-title
Since 2.0.0.profile-single-title { ... }
View sourceDescription
Styles the single profile title - typically the subtitle of the page.
.profile-single-photo
Since 2.0.0.profile-single-photo { ... }
View sourceDescription
Styles the single profile photo.
.profile-single-details
Since 2.0.0.profile-single-details { ... }
View sourceDescription
Styles the single profile details sidebar.
.profile-details-label
Since 2.0.0.profile-details-label { ... }
View sourceDescription
Styles the single profile details labels.
.profile-details-list
Since 2.0.0.profile-details-list { ... }
View sourceDescription
Styles the single profile details list.
.profile-details-item
Since 2.0.0.profile-details-item { ... }
View sourceDescription
Styles the single profile details items.
accessibility
functions
Since 3.2.0
@function accessible-text() { ... }
View sourceDescription
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 sourceDescription
The base padding to use for content sitewide.
$padding-large
Since 2.0.0$padding-large: $padding * 2;
View sourceDescription
The base padding to use for large spacing sitewide.
content
variables
$color-gallery-overlay
Since 2.0.0$color-gallery-overlay: rgba( $color-grayscale-0, 0.75 ) !default;
View sourceDescription
A variable which controls the color of overlays on photo hover in WordPress galleries.
$margin-gallery
Since 3.0.2$margin-gallery: 10px !default;
View sourceDescription
A variable which controls the margin around photos in WordPress galleries.
css
footer
global
variables
$min-size-headings-mobile
Since 2.0.0$min-size-headings-mobile: $min-size-headings !default;
View sourceDescription
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 sourceDescription
Base styles for all wrapper elements.
%container-styles
Since 1.2.0%container-styles { ... }
View sourceDescription
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
- [mixin]
breakpoint
- [mixin]
breakpoint
- [mixin]
breakpoint
- [placeholder]
clearfix
- [variable]
grid-container-padding
- [variable]
sm
- [variable]
container-sm
- [variable]
grid-container-padding-desktop
- [variable]
md
- [variable]
container-md
- [variable]
lg
- [variable]
container-lg
%row-styles
Since 1.2.0%row-styles { ... }
View sourceDescription
Base styles for containers that hold grid elements. A negative margin is included to counteract the grid item margins.
Requires
- [mixin]
breakpoint
- [placeholder]
clearfix
- [variable]
grid-row-margin
- [variable]
sm
- [variable]
grid-row-margin-desktop
%row-child-styles
Since 1.2.0%row-child-styles { ... }
View sourceDescription
Base styles for children of a row. Usually used for grid items.
Requires
- [variable]
grid-column-padding
- [variable]
grid-column-padding
grid
variables
$burf-extras
Since 2.1.11$burf-extras: true !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
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
- [placeholder]
col-margin-parent
$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 sourceDescription
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 sourceDescription
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 sourceDescription
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 sourceDescription
The amount of padding to put on the content container.
Used by
- [placeholder]
container-styles
$grid-container-padding-desktop-sides
Since 1.0.0$grid-container-padding-desktop-sides: $padding !default;
View sourceDescription
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 sourceDescription
The amount of padding to put on the content container on desktop.
Used by
- [placeholder]
container-styles
$grid-row-margin
Since 1.0.0$grid-row-margin: 0 -#{$grid-container-padding} !default;
View sourceDescription
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
- [placeholder]
row-styles
$grid-row-margin-desktop
Since 1.0.0$grid-row-margin-desktop: 0 -#{$grid-container-padding-desktop-sides} !default;
View sourceDescription
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
- [placeholder]
row-styles
$grid-column-padding
Since 1.0.0$grid-column-padding: $padding !default;
View sourceDescription
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
- [placeholder]
row-child-styles
- [placeholder]
row-child-styles
$grid-margin-padding
Since 2.0.0$grid-margin-padding: $padding !default;
View sourceDescription
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 sourceDescription
Styles for parents of margin grid items. Also available in breakpoint flavors, just like the grid classes - for example, .col-md-margin-parent
.
Requires
- [variable]
grid-margin-width
icons
variables
$print-icon-classes
Since 2.0.0$print-icon-classes: false !default;
View sourceDescription
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 sourceDescription
The font family to use for icons across the site. Change this to use a different homegrown font family.
Used by
- [mixin]
icon-content
$font-size-icon
Since 2.0.0$font-size-icon: 21px !default;
View sourceDescription
The font size to use for icons across the site.
$color-icons
Since 1.0.0$color-icons: unset !default;
View sourceDescription
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
- [mixin]
icon-content
$use-default-icons
Since 2.1.11$use-default-icons: true !default;
View sourceDescription
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 sourceDescription
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 sourceDescription
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
- [mixin]
icon
mixins
@include icon-content
Since 1.2.0@mixin icon-content() { ... }
View sourceDescription
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
- [variable]
color-icons
- [variable]
font-family-icons
Used by
- [placeholder]
icon-content
- [placeholder]
icon-content-before
- [placeholder]
icon-content-after
- [mixin]
icon
@include icon
Since 2.0.0@mixin icon() { ... }
View sourceDescription
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
#{$name}
is not a supported icon. See www.bu.edu/cdn/fonts/icons/bu-default-icons/specimen-icons.html for a list of supported icons. If this is a custom icon you meant to add for your own icon font, be sure you
Requires
- [mixin]
icon-content
- [variable]
icons-responsive
placeholders
%icon-content-before
Since 2.0.0%icon-content-before { ... }
View sourceDescription
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
- [mixin]
icon-content
%icon-content-after
Since 2.0.0%icon-content-after { ... }
View sourceDescription
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
- [mixin]
icon-content
mixins
mixins
@include angle
Since 2.0.0@mixin angle($|, $|, $|) { ... }
View sourceDescription
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 Name | parameter Description | parameter Type | parameter 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 sourceExample
Make a `<h4>` look like an `<h2>`.
.comparison-title {
@include font-size( '2' );
}
.bu_copyright
.bu_copyright { ... }
View sourceDescription
Copyright styles - only for print
utilities
placeholders
%equal-height-parent-backcompat
Since 1.2.0%equal-height-parent-backcompat { ... }
View sourceDescription
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 sourceDescription
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
- [mixin]
breakpoint
- [variable]
md
%equal-heights
Since 2.0.0%equal-heights { ... }
View sourceDescription
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
WordPress Admin
css
.post-edit-link
Since 3.2.0.post-edit-link { ... }
View sourceDescription
Provides a link for admins to edit the page within the page content. Formerly .edit-link
, this has been updated to better match WordPress standards from both a class naming perspective and a user interface perspective.