CivicTheme
  • Docs
  • Changelog
  • Getting started
    • Introduction
    • Installation
    • Getting help
    • Security policy
    • Partnerships
  • Installation
    • Drupal theme
  • Contributing
    • Contribution model
    • Contribution basics
    • Small contribution spec
    • Medium contribution spec
    • Major (RFC-level) contribution spec
    • Code of conduct
    • Figma contributions
  • Components
    • Component list
    • Atoms
      • Button
      • Chip
      • Content link
      • Check box
      • Field description
      • Field message
      • Fieldset
      • Label
      • Radio
      • Select
      • Textarea
      • Text field
      • Heading
      • Link
      • Paragraph
      • Popover
      • Quote
      • Table
      • Tag
      • Text list
    • Molecules
      • Accordion
      • Attachment
      • Breadcrumb
      • Callout
      • Event Card
      • Field
      • Figure
      • Group filter
      • Logo
      • Map
      • Navigation card
      • Next step
      • Pagination
      • Promo card
      • Search
      • Service card
      • Single filter
      • Snippet
      • Subject Card
      • Table of Contents
      • Tabs
      • Tag List
      • Tooltip
      • Video Player
    • Organisms
      • Alert
      • Banner
      • Campaign
      • Footer
      • Header
      • List
      • Message
      • Mobile Navigation
      • Navigation
      • Promo
      • Side Navigation
      • Skip link
      • Slider
      • Social links
  • Content Authoring
    • Overview
    • Global settings
      • Favicon
      • Header
        • Site slogan
        • Header logos
        • Primary navigation
        • Secondary navigation
      • Banner
      • Search
      • Link
      • Skip link
      • Side navigation
      • Signup
      • Footer
        • Footer logo
        • Social links
        • Footer navigation
        • Acknowledgement of Country
        • Copyright
      • Colours
    • Content types
      • Page
        • Configure the banner
      • Event
      • Alert
    • Content components
      • Accordion
      • Automated list
      • Attachment
      • Callout
      • Campaign
      • Content
        • Quote
      • iFrame
      • Manual List
        • Event card
        • Event reference card
        • Navigation card
        • Navigation reference card
        • Promo card
        • Promo reference card
        • Publication card
        • Service card
        • Subject card
        • Subject reference card
        • Snippet
      • Map
      • Next step
      • Promo
      • Slider
      • Webform
    • Vocabularies
      • Topics
      • Site sections
    • User accounts & roles
Powered by GitBook
On this page
  • When to use
  • When not to use
  • Best practice guidelines
  • Accessibility
  • Security
  • Component inspiration and uplift
  • User research on this component
  • Known issues
  • More research needed
  • Help improve this component
  • Resources
  • References
  • Changelog
  • Contact us

Was this helpful?

Edit on GitHub
Export as PDF
  1. Components
  2. Organisms

Campaign

PreviousBannerNextFooter

Last updated 1 month ago

Was this helpful?

The Campaign component is a full-width featured content block designed to prominently showcase important content with a heading, date, image, lead copy, and calls to action.

When to use

Use the Campaign component when you need to:

  • Prominently feature important content at the top of a page or section

  • Showcase trending or featured articles, events, or publications

  • Create a visually impactful area that draws users' attention

  • Provide a clear call to action related to featured content

  • Emphasise time-sensitive content that requires user attention

When not to use

Do not use the Campaign component when:

  • The content does not warrant such prominent visual treatment

  • You need to display multiple items with equal hierarchy

  • There is insufficient content to populate the component (heading, image, text)

  • You require a more interactive or dynamic element like a carousel or slider

  • The design calls for a more subtle or minimalist presentation


Best practice guidelines

  • Strong imagery: Select high-quality, relevant images that support the campaign message and enhance visual appeal

  • Clear hierarchy: Maintain proper visual hierarchy with a prominent heading, supporting copy, and clear calls to action

  • Concise content: Keep headings and lead copy concise and compelling to maximise impact

  • Purposeful CTAs: Include clear, action-oriented buttons that direct users to relevant content

  • Mobile optimisation: Ensure the component adapts appropriately for mobile viewing, with text remaining readable and CTAs easily tappable

  • Balanced design: Maintain appropriate spacing and balance between text and imagery

  • Consistent application: Use consistent styling for recurring campaigns to establish pattern recognition

  • Tags for context: Include relevant topic tags to provide additional context and categorisation

  • Accessible contrast: Ensure text maintains sufficient contrast against background images or colours

  • Content relevance: The content should be highly relevant to user needs and aligned with key organisational priorities


Accessibility

According to the 'CivicTheme v1.7.0 Accessibility Assessments' file, the Campaign component has been tested against WCAG 2.2 standards with the following results:

The component passes most accessibility tests, including:

WCAG Criterion
Level
Description

1.1.1 Non-text Content

A

The image is considered decoration and can be ignored by screen readers

1.4.3 Contrast (Minimum)

AA

Contrast meets the minimum 4.5:1 requirement

1.4.4 Resize text

AA

Text remains visible and readable when resized to at least 200%

1.4.12 Text Spacing

AA

Text remains readable with adjusted spacing requirements

2.1.1 Keyboard

A

Elements are accessible using keyboard navigation only

2.4.7 Focus Visible

AA

Focus is visible when navigating using a keyboard

4.1.2 Name, Role, Value

A

For all elements, the name and role can be programmatically determined

Security

No specific security concerns have been identified for this component. Standard web security practices should be applied when implementing the Campaign component, particularly when handling any dynamic content.

Component inspiration and uplift

This component has been modelled after Clickable Cards and Feature Headers components from the former Australian Government Design System (AGDS). As documented in the CivicTheme Compliance Statements document, the component has been uplifted by Salsa Digital in the following ways:

  • Presentation as a large feature that spans the width of the site's body

  • Configuration options for both primary and tertiary calls to action

  • Support for additional attributes such as topic tags and dates for content like Events and Publications

  • Desktop layout optimisation with inline imagery alongside description rather than stacked, creating a hero-like appearance

  • Improved tag positioning below the Heading component to allow multiple tags in a single row

  • Implementation of the Tag List component to replace the single Tag component, allowing multiple tags to be displayed

This improvement was based on feedback from previous CivicTheme projects where content needed greater prominence but couldn't use the space of a full hero banner. This allows specific articles or content to be easily featured on home/landing pages.


User research on this component

★★★☆☆ (3/5) Confidence rating = Moderate (Based on limited direct testing but informed by related component research)

No specific user research data is directly available for the Campaign component in the provided documentation. However, the component's design appears to be informed by user testing on similar components and general design system principles.

Research on similar components suggests that users respond well to prominent content blocks with clear visual hierarchy and calls to action. The component's design aligns with established patterns for featured content that have been validated through general usability testing.

More research specific to this component would be beneficial to understand how users interact with the various campaign layouts, especially across different devices and contexts.

Known issues

  • Mobile responsiveness: On smaller screens, the component's side-by-side layout shifts to a stacked presentation, which may require special consideration for image cropping and text length

  • Content maintenance: Featured campaigns require regular review and updating to remain relevant, which can create maintenance overhead

  • Visual balance: When using images of varying dimensions or orientations, additional styling may be needed to maintain visual consistency

  • Potential clutter: When implemented with multiple tags, dates, and buttons, the component may appear cluttered if not carefully designed

More research needed

  • User engagement metrics: More data is needed on how users interact with the Campaign component compared to other content highlighting methods

  • Optimal content length: Research to determine the ideal length for campaign headings and lead copy for maximum engagement

  • Button effectiveness: Testing which CTA styling and wording produces better conversion rates within campaign contexts

  • Image impact: Understanding how different image styles and content affect user perception and interaction with campaigns

  • Mobile interactions: Specific research on how mobile users interact with this component and whether the stacked layout presents any usability challenges

Help improve this component

To help make this component useful and up-to-date, you can:

  • Contribute to our Campaign component discussion on GitHub

  • Submit your user research findings to help improve the component

  • Propose changes or enhancements to the Campaign component

  • Submit examples of successful implementation in your projects


Resources

  • Storybook

  • GitHub

References

  • Nielsen Norman Group. (2020). "F-Shaped Pattern of Reading on the Web"

  • Krug, S. (2014). "Don't Make Me Think, Revisited: A Common Sense Approach to Web Usability"

  • Schade, A. (2015). "The Fold Manifesto: Why the Page Fold Still Matters"

  • Web Content Accessibility Guidelines (WCAG) 2.2. W3C. 2023.

  • Digital Service Standard, Digital Transformation Agency. 2023.

Changelog

Version
Date
Changes

1.7.0

March 2024

Updated accessibility assessment against WCAG 2.2

1.6.0

2023

Added support for multiple tags using Tag List component

1.5.0

2023

Improved responsive behaviour on mobile devices

1.0.0

2022

Initial component release

Contact us

Check out our to learn more.

If you have a question about the CivicTheme design system or need our help, visit the page for guidance.

contributing section
Figma
Getting Help