Component

Glance metric

The glance metric component is an at-a-glance view of data for a content item. The minimum requirements for it to display are a name and figure.

Search for usage of this component on GitHub.

How it looks (preview) (preview all)

Unique pageviews

167 million

This is in your top 10 items

How to call this component

<%= render "govuk_publishing_components/components/glance_metric", {
  name: "Unique pageviews",
  figure: "167",
  measurement_display_label: "m",
  measurement_explicit_label: "million",
  context: "This is in your top 10 items"
} %>

Accessibility acceptance criteria

This component must:

  • include an explicit label when an abbreviated label is also used
  • communicate number value and label (if present) in a single dictation when read with a screen reader
  • convey the meaning of the number shown
  • The component must use the correct heading level for the page (defaults to <h3>)

Links in the component must:

  • accept focus
  • be focusable with a keyboard
  • be usable with a keyboard
  • indicate when they have focus
  • change in appearance when touched (in the touch-down state)
  • change in appearance when hovered
  • be usable with touch
  • be usable with voice commands
  • have visible text
  • have meaningful text

Other examples

Standard options

This component uses the component wrapper helper. It accepts the following options and applies them to the parent element of the component. See the component wrapper helper documentation for more detail.

  • id - accepts a string for the element ID attribute
  • data_attributes - accepts a hash of data attributes
  • aria - accepts a hash of aria attributes
  • classes - accepts a space separated string of classes, these should not be used for styling and must be prefixed with js-
  • margin_bottom - accepts a number from 0 to 9 (0px to 60px) using the GOV.UK Frontend spacing scale (defaults to no margin)
  • role - accepts a space separated string of roles
  • lang - accepts a language attribute value
  • open - accepts an open attribute value (true or false)
  • hidden - accepts an empty string, ‘hidden’, or ‘until-found’
  • tabindex - accepts an integer. The integer can also be passed as a string.
  • dir - accepts ‘rtl’, ‘ltr’, or ‘auto’.

No measurement labels (preview)

Feedback comments

35 

<%= render "govuk_publishing_components/components/glance_metric", {
  name: "Feedback comments",
  figure: "35"
} %>

Custom heading level (preview)

A custom heading level can be specified if necessary. Defaults to a h3. The heading level does not change any styling.

Feedback comments

35 million 

<%= render "govuk_publishing_components/components/glance_metric", {
  name: "Feedback comments",
  figure: "35",
  measurement_display_label: "m",
  measurement_explicit_label: "million",
  heading_level: 2
} %>