Skip to content

Related Topic

List a primary related topic along with a main link and secondary links to other pages with more information.

Table of Contents

  1. Anatomy
  2. Usage Guidelines
  3. WordPress
  4. Specifications
    1. Properties
    2. Styling
      1. Modifiers
      2. Custom Properties
  5. Changelog
  6. Related
    1. Contains
  7. Examples

Anatomy

  1. Topic
  2. Topic Label
  3. Button
  4. Links Label (optional)
  5. Links (optional)

List a primary related topic along with a main link and secondary links to other pages with more information.

Usage Guidelines

This component is intended to be attached to an extended section of content showing a primary topic along with additional links that provide more information about the subject of the section. Note that the additional links are hidden on smaller viewports.

WordPress

This component is inserted automatically on single article pages based on the related program attached to it.

Specifications

Properties

PropertyTypeDescriptionRequiredDefault
topicstring Main topic nameYes-
topic_labelstring Short description of the type of topic, placed before the topic textYes"Topic"
buttonobjectYes-
└ labelstring Visual button textYes-
└ screen_reader_labelstring Text to be read out for a screen readerNo-
└ hrefstring URL for the button linkYes-
links_labelstring Short description of the additional links, if providedNo"Related"
linksarray -No-
└ itemobject ---
└ labelstring Visual button textYes-
└ screen_reader_labelstring Text to be read out for a screen readerNo-
└ hrefstring URL for the button linkYes-

Styling

Modifiers

NameClassDescription
Sticky.tux-c-related-topic--stickyApplies sticky positioning to follow the top of the page as it is scrolled. Space for the sticky header will be included in the positioning if needed.

Custom Properties

NameDefaultResetsDescription
--tux-c-related-topic--border-colorvar(--tux-theme--shade-color, rgba(0, 0, 0, 0.2))Yes-

Changelog

5.1.0 (2023-07-03)

  • fix: set excluded attrs for correct markup (c234340)

1.35.0 (2022-06-30)

  • feat: add sticky modifier (16dc0bd)

1.34.0

  • related-topic added

Contains

Other core components embedded within this template.

Examples

Default

Dessert

Donuts

Learn More

Related

{% set button = {
	label: 'Learn More',
	href: '/desserts/donuts/',
	screen_reader_label: 'Main page for donuts'
} %}

{% set links = [
	{
		label: "Top 10 Donuts",
		href: "/desserts/donuts/top-10/"
	},
	{
		label: "Donut Calculator",
		href: "/desserts/donuts/calculator/"
	},
	{
		label: "Make a Donut",
		href: "/donut-maker/"
	}
] %}

<x-related-topic topic="Donuts" topic_label="Dessert" :button="button" :links="links">
</x-related-topic>

Long Text

Real Cool Dessert

Fresh Sprinkled Chocolate Super Secret Deal-of-the-day Fancy Donuts

Learn More

Related Links for Donuts

{% set button = {
	label: 'Learn More',
	href: '/desserts/donuts/',
	screen_reader_label: 'Main page for donuts'
} %}

{% set links = [
	{
		label: "Top 10 Donuts",
		href: "/desserts/donuts/top-10/"
	},
	{
		label: "Donut Calculator",
		href: "/desserts/donuts/calculator/"
	},
	{
		label: "Make a Donut",
		href: "/donut-maker/"
	}
] %}

<x-related-topic topic="Fresh Sprinkled Chocolate Super Secret Deal-of-the-day Fancy Donuts" topic_label="Real Cool Dessert" links_label="Related Links for Donuts" :button="button" :links="links">
</x-related-topic>

No Links

Dessert

Pies

Learn More 
{% set button = {
	label: 'Learn More',
	href: '/desserts/pies/',
	screen_reader_label: 'Main page for pies'
} %}

<x-related-topic topic="Pies" topic_label="Dessert" :button="button">
</x-related-topic>