Updated October 1st, 2024
The purpose of this page is to show example HTML and class names for primitive elements. To view mobile layout versions, please resize the viewport. Interactions such as hover states will be shown when interacting. For general interaction and usage guidelines please refer to the UIKit page in the Figma document.
Please read the documentation to learn how to use it.
Almost any layout, style, design, functionality, etc. can be easily implemented in AEM by utilizing blade containers, normal components, HTML components, and bootstrap classes. Give it a good attempt and if you can't get it how you want, please reach out to another team member before writing new CSS or JS.
Our Bootstrap implementation is customized to include several enhancements such as custom colors, gradients, sizes, and more. Please refer to the sections below for more information.
1rem = 16px
These sizes work with most bootstrap classes that affect styling except for sizing classes which use the relative styling units below.
Use these units appended to the end of certain classes like .p
or .m
. For example: .p-3
or .m-48
.
These units work with classes like those that define width and height. For width, the format is .w-[%]
, for example .w-50
which forces an element to 50% percent the width of its container (as long as they hae the appropriate positioning).
Note: the .w-[%]
classes will override any .col
classes, so make sure to only use one type on an element. The .w
classes do not have breakpoint definitions, so .col
is better to use in most situations.
[WIP]
.bg-gray-black
.bg-gray-dark
.bg-gray-medium
.bg-gray
.bg-gray-light
.bg-gray-light-50
.bg-gray-extra-light
.bg-white
.bg-purple
.bg-indigo-dark
.bg-indigo
.bg-primary or .bg-blue
.bg-light-blue
.bg-cyan
.bg-teal
.bg-green
.bg-yellow
.bg-orange
.bg-red
.bg-pink
.text-gray-black
.text-gray-dark
.text-gray-medium
.text-gray
.text-gray-light
.text-gray-light-50
.text-gray-extra-light
.text-white
.text-purple
.text-indigo-dark
.text-indigo
.text-primary or .text-blue
.text-light-blue
.text-cyan
.text-teal
.text-green
.text-yellow
.text-orange
.text-red
.text-pink
Click to copy the class.
You can combine gradient classes with background classes to make color combinations
.bg-primary & .indigo-gradient-east
.bg-cyan & .green-gradient-southeast
Select from the various options below to create your notched element class, than click the element to copy the generated class.
Notch elements are used to create a notch in a box or container to make it stand out. They are used in various places throughout the site.
The shorthand class .notch
applies the default notch properties (indicated below).
The class name is structured as: .notch-[color]-[direction]-[size]
.
For example, .notch-gray-light-se-md
would create a medium sized notch in the south east direction with a light gray color. You can leave out options from right to left to use the default value.
For example, .notch-gray-light
would create a medium sized notch in the south east direction with a light gray color.
Or, .notch-gray-light-se
would create a medium sized notch in the south east direction with a light gray color.
.subhead
Lorem ipsum dolorBody Intro - .body-intro
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc imperdiet mollis luctus. Aenean pulvinar erat rhoncus est euismod suscipit. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Body Copy - <p> or .body-copy
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc imperdiet mollis luctus. Aenean pulvinar erat rhoncus est euismod suscipit. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Body Copy BOLD - .fw-bold
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc imperdiet mollis luctus. Aenean pulvinar erat rhoncus est euismod suscipit. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Form label - <label> or .label
Lorem ipsum dolor sit amet.
Caption - .caption
Lorem ipsum dolor sit amet.
These are how the default bullets will appear if not using any special classes.
You can remove the default dots by adding the class .list-style-none
to the <ul>
element.
Bulleted lists can be set up in 2 columns for desktop & tablet sizes. To do this, add the class .duo-col
to the <ul>
element.
These are special bullets where the default dot is replaced with a Bootstrap Icon. The following icons are currently supported:
ul.dot-bullets
ul.circle-bullets
ul.square-bullets
ul.box-bullets
ul.check-bullets
ul.x-bullets
Individual list items within unordered lists can have a different icon
ul.check-bullets > li.x-bullet
Add a color between the icon name and "bullets" to change the color (all style guide colors are supported, use same name as css varisble).
ul.check-green-bullets > li.x-red-bullet
Use the following format to create a tooltip. Please refer to the Bootstrap 5 documentation for more information.
<a
class="bi bi-info-circle"
data-bs-toggle="tooltip"
data-bs-placement="right"
data-bs-original-title="Tooltip text goes here"></a>
You can create a read more functionality to the text by adding .truncate
to the tag you want to shorten.
<p class="truncate">Text to shorten...</p>
Text to shorten. Minim nostrud anim elit quis laborum exercitation incididunt commodo minim officia ex minim. Eu aliqua quis ad nostrud pariatur. Commodo proident ex ea deserunt. Sint sint enim duis veniam anim nisi ullamco aliquip. Magna velit pariatur est adipisicing exercitation est non dolor excepteur. Esse do Lorem minim cillum eu non nisi nisi labore id amet nulla sunt amet.
.hero.jumbo
(Rarely used, special pages only).hero.xl
(Rarely used, special pages only).hero.large
(Sometimes used, ex: Threat Reports).hero
or .hero.medium
(Most often used, normal pages).hero.small
(Sometimes used, Tertiary pages like Security Awareness Articles).hero.smaller
(Rarely used, special pages only).hero
.hero.inverted
or .hero.reverse
(Used when the BG image / color is too light to read white text)We will be using these on new hero pages (2024) and other pages which use newer design features.
Note: These cannot be used with any hero size except the Medium size, for now.
.hero.bleed
(Product pages).hero.sliced
(Not used)
Body Copy - Lorem ipsum Example Link.
External links using .link-external
(Only use with external links, i.e. links using target="_blank"
)
Arrow links using .link-arrow
Download links using .link-download
Watch Videos using .link-watch
(Use primarily with fancybox modals containing videos. See example)
.btn-external
, .btn-download
, & .btn-watch
are legacy class names. They are equivalent to the new bootstrap classes of .bi-box-arrow-up-right
, .bi-download
, & .btn-play
, respectively.
.btn.btn-primary
.btn.btn-primary.btn-external
.btn.btn-primary.btn-download
.btn.btn-primary.btn-watch
.btn.btn-outline-primary
.btn.btn-outline-primary.btn-external
.btn.btn-outline-primary.btn-download
.btn.btn-outline-primary.btn-watch
.btn.btn-small.btn-primary
.btn.btn-small.btn-outline-primary.btn-external
.btn.btn-inverted
.btn.btn-inverted.btn-external
.btn.btn-inverted.btn-download
.btn.btn-inverted.btn-watch
.btn.btn-outline-inverted
.btn.btn-outline-inverted.btn-external
.btn.btn-outline-inverted.btn-download
.btn.btn-outline-inverted.btn-watch
.table.text-center
Column 1
Column 2
Column 3
Data 1
Data 2
Data 3
.table
.gt-head.bg-gray-black.text-white
Data 1
Data 2
Data 3
Data 1
Data 2
Data 3
When using spanned columns, you must remove the gap and padding from .gt-head
& .gt-row
by adding .p-0
& .gap-0
to them. Then you add padding to each of the cells in the table. .p-2
is preferred but not mandatory.
It is not recommended to use different cell-span lengths in different rows as in the example below, As you can see, this causes alignment issues. If you need to span a column, do it at the same length for all rows in the table unless broken by a new .gt-head
.
.gt-head.bg-gray-black.text-white.p-0.gap-0
.gt-row.p-0.gap-0
.cell-span-2.p-2.bg-gray-light
Normal
Normal
Normal
Normal
.cell-span-3.p-2.bg-gray-light
Normal
Normal
Normal
.cell-span-4.p-2.bg-gray-light
Normal
Normal
.cell-span-5.p-2.bg-gray-light
Normal
.cell-span-6.p-2.bg-gray-light