Link List

The Link List component is built from an author-defined list of links or links pulled from a defined parent page or tag. Simple list style display options include bullets, numbers, or none.

On This Page:

Example

View on public site:

When to Use

The Link List component can be used to help break up large blocks of text, make complex articles and blog posts easier to grasp, and make key information stand out.

Usage

Introduce a list with a clear, descriptive sentence or phrase. The words used just before the link list are important because it lets the reader know what the list is about and why it is important. 

The orientation of link lists changes based on the designated number of columns for Desktop, Tablet, and Mobile. Vertical lists are best when you have three or more items that you want to attract attention to. 

Bulleted lists attract attention, support scanning, shorten text, and reveal the relationship of items. Bulleted lists work best when they include related items. The items should share a similar level of importance.

Numbered lists are usually reserved for instances in which the items must occur in a specific order, such as steps in a procedure, or when keeping count is important, such as a top 10 list.

Manual Link List

Displayed as bullets, to show 3 columns in desktop view, 4 columns in tablet view and 2 columns in mobile view:

Displayed as numbers, to show 2 columns in desktop view, 3 columns in tablet view and 1 column in mobile view:

Displayed as links, to show 2 columns in desktop view, 2 columns in tablet view and 1 column in mobile view:

Dynamic Link List

Built using Child Pages, to display as bullets, to show 3 columns in desktop view, 4 columns in tablet view and 2 columns in mobile view:

Built using Page Tags, to display as bullets, to show 2 columns in desktop view, 3 columns in tablet view and 1 column in mobile view:

Built using Assets, to display as numbers, to show 2 columns in desktop view, 2 columns in tablet view and 1 column in mobile view:

Built using Anchors, to display as links, to show 1 column in desktop view, 1 column in tablet view and 1 column in mobile view:

Configure Dialog

The configure dialog allows the content author to build a list manually or dynamically and define the display type and number of columns for each breakpoint. Expand the sections below to learn more about the Link List's dialog box.

Build - Choose to build the link list manually or dynamically.

 

Open links in new tab? - Select if you would like the links in the list to open in a new tab.

 

Display as - Choose to display the links in bullets, numbers, or links.

 

Desktop columns - Number of columns to display in desktop.

 

Tablet columns - Number of columns to display in tablet.

 

Mobile columns - Number of columns to display in mobile.

Top of Section

Add field - Click 'Add field' to add a new page

 

Link Label - Label for the link.

 

Link URL/Source* - AEM page path or external url of Anchor component

 

Alt Text - Text the screenreader will read.

Top of Section

Build List Using - Child Pages is selected.

 

Parent Page - Browse AEM sites for the parent of the child pages you wish to display in the list. Leave empty to use current page

Top of Section

Build List Using - Tags - Pages is selected.

 

Parent Page - Browse the AEM sites for the parent of the child pages you wish to display in the list. Leave empty to use current page

 

Tags/Keywords - The source tag value(s).

 

Match - Define the criteria for your tags.

 

Top of Section

Build List Using - Child Assets is selected.

 

Parent Asset Path -  Browse the DAM for the folder/parent of the child assets you wish to display in the list.

Top of Section

NOTE

This list is not currently working as assets are NOT routinely tagged.

Build List Using - Tags - Assets is selected.

 

Parent Tag Asset Path -  Browse the DAM for the folder/parent of the child assets you wish to display in the list.

 

Asset Tags/Keywords - The source tag value(s).

 

Top of Section

Build List Using - Anchors is selected.

 

Anchor container path - Leave empty to use current page. Otherwise this needs to point to a Page or a layout/grid containing anchor components.

Top of Section

Developer Resources

Expand the section below to see the Link List Component HTML output.

<div id="llList_1147666549" class="uscb-link-list-container">
<!-- Define and zero custom counter to allow count to properly show through all ols in component -->
<style type="text/css">
.uscb-link-list-container {
counter-reset: link-list-counter;
}

.uscb-link-list-container span {
list-style: none;
}

.uscb-link-list-container ul {
list-style-type: disc;
list-style-position: inside;
}

.uscb-link-list-container ol li:before {
counter-increment: link-list-counter;
content: counter(link-list-counter) ". " !important;
}

#llList_1147666549 {
column-count: 2;
}

@media (min-width: 768px) {
#llList_1147666549 {
column-count: 4;
}
}

/* Census tablet breakpoint */

@media (min-width: 1200px) {

/* 2020 tablet breakpoint */

#llList_1147666549 {
column-count: 3;
}
}
</style>

<div class="uscb-multi-col-list">
<ul class="uscb-link-list">
<li class="uscb-multi-col-list-item">
<a href="http://author-publish.dev.census.gov/en.html" onclick="linkClick(this, 'Link List Component');" target="_blank">Manual Link Label 1</a>
</li>
<li class="uscb-multi-col-list-item">
<a href="http://author-publish.dev.census.gov/en.html" onclick="linkClick(this, 'Link List Component');" target="_blank">Manual Link Label 2</a>
</li>
<li class="uscb-multi-col-list-item">
<a href="http://author-publish.dev.census.gov/en.html" onclick="linkClick(this, 'Link List Component');" target="_blank">Manual Link Label 3</a>
</li>
<li class="uscb-multi-col-list-item">
<a href="http://author-publish.dev.census.gov/en.html" onclick="linkClick(this, 'Link List Component');" target="_blank">Manual Link Label 4</a>
</li>
<li class="uscb-multi-col-list-item">
<a href="http://author-publish.dev.census.gov/en.html" onclick="linkClick(this, 'Link List Component');" target="_blank">Manual Link Label 5</a>
</li>
<li class="uscb-multi-col-list-item">
<a href="http://author-publish.dev.census.gov/en.html" onclick="linkClick(this, 'Link List Component');" target="_blank">Manual Link Label 6</a>
</li>

</ul>
</div>
</div>

 

Top of Section
Is this page helpful?
Thumbs Up Image Yes Thumbs Down Image No
NO THANKS
255 characters maximum 255 characters maximum reached
Thank you for your feedback.
Comments or suggestions?

Top

Back to Header