deprecated It is strongly recommended that this not to be used.

Links List block

This component has been deprecated. See "usage" for information on migrating.

github location npm version



This deprecates vf-links-list as many components are either widely unused or only seldom used — for the components that aren't yet used much we also have major revisions coming and we wish to discourage use of components that are about to be overhauled.

Usage of this component can by substituted with other components or new ones under development:

  • Links List Default: use vf-list + vf-heading
  • Links List no heading: use vf-list
  • Links List Tight: use vf-list (we may add a vf-list--tight variant subject to demand)
  • Links List Very Easy: see above
  • Links List Easy: to be overhauled as vf-navigation--on-page
  • Links List Has Images: use vf-summary--has-image or vf-flag--middle

Original guidance

The Links List component is a robust list group that can be used in a variety of grid layouts.

The Links List can have a title <h3 class="vf-links__heading">Example Title</h3>.

In each list item you can have:

A link <a class="vf-links__link" href="">Example Link</a>.

Except for a Links List that is using the the design variant of vf-links__list--easy you can also use:

It can make use of the vf-badge component <span class="vf-badge">Example Tag</span>.

It can include meta information <p class="vf-links__meta">Example Meta</p>.

Contextual Based Link Lists

"On this page"

If you want to provide a set of links that will anchor to sections on the page you should use:

note: You will need to add a corresponding id to the section you are linking to for the anchor to work.

Link List
<div class="vf-links vf-links__list--easy">
  <h3 class="vf-links__heading">On this page</h3>
  <ul class="vf-links__list | vf-list">
    <li class="vf-list__item">
      <a class="vf-list__link" href="#Anchor-Text">
        Anchor Text
        <svg class="vf-icon vf-icon__arrow--down | vf-list__icon" xmlns="" viewBox="0 0 24 24"><path d="M.249,7.207,11.233,19.678h0a1.066,1.066,0,0,0,1.539,0L23.751,7.207a.987.987,0,0,0-.107-1.414l-1.85-1.557a1.028,1.028,0,0,0-1.438.111L12.191,13.8a.25.25,0,0,1-.379,0L3.644,4.346A1.021,1.021,0,0,0,2.948,4a1,1,0,0,0-.741.238L.356,5.793A.988.988,0,0,0,0,6.478.978.978,0,0,0,.249,7.207Z"></path></svg>
Linked Section In Page
<section class="vf-component" id="Anchor-Text">

"In this section"

If you want to include quick links as part of a section of content you can use:

Link List
<div class="vf-links vf-links--tight vf-links__list--s vf-links__list--very-easy">
  <h3 class="vf-links__heading">In this section</h3>
  <ul class="vf-links__list vf-links__list--secondary | vf-list">
    <li class="vf-list__item">
      <a class="vf-list__link" href="#Anchor-Text">
        Anchor Text
Linked Text In Section
<section class="vf-component">
  <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Maiores dolore eveniet sed totam deleniti, ipsum dolorum cupiditate, aut error quae beatae nemo esse pariatur repellendus illo dicta doloribus alias ipsa.</p>
  <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Quam, ut aut eveniet consectetur rem. Sapiente quis optio cupiditate molestias debitis quisquam ab in. Voluptates, expedita modi aliquam, sint tempore magnam.</p>
  <p id="Anchor-Text">Lorem ipsum dolor sit amet, consectetur adipisicing elit. Nobis quo magnam accusamus vel porro, ullam tempora illo atque vitae voluptatum ratione temporibus, est, itaque quasi eum cupiditate mollitia adipisci. Suscipit.</p>
  <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Pariatur fuga eveniet ducimus, dolorem sit itaque sequi nisi praesentium consequatur, temporibus tempore rem illo laboriosam libero repudiandae neque labore suscipit expedita.</p>



Installation info

This component is distributed with npm. After installing npm, you can install the vf-link-list with this command.

$ yarn add --dev @visual-framework/vf-link-list


The source files included are written in Sass(scss). You can point your Sass include-path at your node_modules directory and import it like this.

@import "@visual-framework/vf-link-list/index.scss";

Make sure you import Sass requirements along with the modules. You can use a project boilerplate or the vf-sass-starter




  • Fix issue loading scripts and styles for latest site


  • Documentation upgrade


  • New release


  • Update node-html-parser to 5.1.0
  • Use eleventy v1.0.0-beta.8


  • Utilise new vf-navigation--on-this-page.
  • Update project boilerplate links at


  • Documentation updates
  • New release


  • Update milestones and roadmap.


  • Add ELIXIR banner to example EMBL-EBI page.


  • Fixed issue of overlapping menu on VF components site


  • dependency bump


  • Implements updated vf-search markup.
  • Changes a few pages on how it works with nunjucks and markdown.


  • updates Design Tokens homepage.
  • adds neutral colour tokens
  • adds 'status banners' for components in the documentation page.
  • Adds the form options as their own set of components in the list.
  • Updates to use 11ty 0.12.1


  • changes the vf-intro so it's a white background, removes the padding.
  • changes the links in vf-intro to be the 'correct' buttons.


  • small change to cards on homepage


  • dependency bump


  • dependency bump


  • dependency bump


  • dependency bump
  • adds roamap and consultation docs


  • design token documenation now lives in the component libary


  • adds updates blog


  • begin to make more pattern/boilerplate guidance
  • minor templating updates


  • dependency bump


  • uses vf-favicon
  • adds meta attributes


  • run vf-component-assets:everything on local dev
  • remove reference to removed /css/app.css


  • Add 404
  • Fix component CSS generation


  • Also generate per-component CSS with vf-css:generate-component-css


  • Initial release to be used with vf-core 2.2.0


File system location: components/vf-link-list

Find an issue on this page? Propose a change or discuss it.