Footer Ready

Footer component is used as the global footer for all views. Contains copyright data and links to related documents.

Footer contains your application’s secondary menu items that perform an action when clicked. Each action in the footer should navigate to a href or trigger another action like a Modal overlay.

Examples #

Open in new window

<duet-footer id="duet-footer_default_footer" logo-href="/" language="fi" class="duet-example-without-padding"> </duet-footer>

<script>
  (function(){
    // Select the above footer component
    var footer = document.querySelector("#duet-footer_default_footer")

    // Set the main links in footer
    footer.items = [
      { label: "Hae korvausta", href: "#" },
      { label: "Osta vakuutus", href: "#" },
      { label: "Yhteystiedot", href: "#" },
    ]

    // Set the help menu items in footer
    footer.menu = [
      { label: "Turvallisuus ja käyttöehdot", href: "#" },
      { label: "Evästeet", href: "#" },
      { label: "Henkilötietojen käsittely", href: "#" },
    ]

    // Listen for clicks on footer items
    footer.addEventListener("duetItemClick", function (e) {
      console.log("Item clicked:", e.detail)
      var event = e.detail.originalEvent
      var data = e.detail.data
      event.preventDefault()
    })

    // Listen for clicks on footer menu
    footer.addEventListener("duetMenuClick", function (e) {
      console.log("Menu clicked:", e.detail)
      var event = e.detail.originalEvent
      var data = e.detail.data
      event.preventDefault()
    })

    // Listen for clicks on the logo
    footer.addEventListener("duetLogoClick", function (e) {
      console.log("Logo clicked:", e.detail)
      var event = e.detail.originalEvent
      var data = e.detail.data
      event.preventDefault()
    })

    // duet events
    footer.addEventListener("duetEvent", function (e) {
      console.log("Duet event:", e.detail)
    })
  }())
</script>

Open in new window

<duet-footer id="duet-footer_footer_with_just_logo_and_menu" logo-href="/" language="fi" class="duet-example-without-padding"> </duet-footer>

<script>
  (function(){
    // Select the above footer component
    var footer = document.querySelector("#duet-footer_footer_with_just_logo_and_menu")

    // Set the help menu items in footer
    footer.menu = [
      { label: "Turvallisuus ja käyttöehdot", href: "#" },
      { label: "Evästeet", href: "#" },
      { label: "Henkilötietojen käsittely", href: "#" },
    ]
  }())

</script>

Open in new window

<duet-footer id="duet-footer_footer_using_simple_variation" variation="simple" class="duet-example-without-padding"> </duet-footer>

<script>
  (function(){
    // Select the above footer component
    var footer = document.querySelector("#duet-footer_footer_using_simple_variation")

    // Set the help menu items in footer
    footer.menu = [
      { label: "Turvallisuus ja käyttöehdot", href: "#" },
      { label: "Evästeet", href: "#" },
      { label: "Henkilötietojen käsittely", href: "#", external: true },
    ]
  }())
</script>

Open in new window

<duet-footer id="duet-footer_footer_with_links_that_open_to_a_new_tab" logo-href="/" language="fi" class="duet-example-without-padding"> </duet-footer>

<script>
  (function(){
    // Select the above footer component
    var footer = document.querySelector("#duet-footer_footer_with_links_that_open_to_a_new_tab")

    // Set the main links in footer
    footer.items = [
      { label: "Hae korvausta", href: "#" },
      { label: "Osta vakuutus", href: "#" },
      { label: "Yhteystiedot", href: "#", external: true },
    ]

    // Set the help menu items in footer
    footer.menu = [
      { label: "Turvallisuus ja käyttöehdot", href: "#", external: true },
      { label: "Evästeet", href: "#", external: true },
      { label: "Henkilötietojen käsittely", href: "#", external: true },
    ]
  }())
</script>

Open in new window

<duet-footer
  logo-href="/"
  language="fi"
    items='[
    { "label": "Hae korvausta", "href": "#" },
    { "label": "Osta vakuutus", "href": "#" },
    { "label": "Yhteystiedot", "href": "#" }
  ]'
  menu='[
    { "label": "Turvallisuus ja käyttöehdot", "href": "#" },
    { "label": "Evästeet", "href": "#" },
    { "label": "Henkilötietojen käsittely", "href": "#" }
  ]'
>
</duet-footer>

Open in new window

<duet-footer id="duet-footer_footer_with_additional_info" logo-href="/" language="fi" class="duet-example-without-padding">
  <duet-paragraph
    size="small"
    color="gray-lightest"
    margin="none"
    slot="info"
  >Vikatilanteessa saat apua puhelimitse tai sähköpostilla ma-to klo 9.00-16.30 ja pe klo 9.00-16.00</duet-paragraph>
</duet-footer>

<script>
  (function(){
    // Select the above footer component
    var footer = document.querySelector("#duet-footer_footer_with_additional_info")

    // Set the main links in footer
    footer.items = [
      { label: "09 453 4315 ", href: "tel:094534315 ", hideArrow: true },
      { label: "ajoneuvovakuutukset@lahitapiola.fi", href: "mailto:ajoneuvovakuutukset@lahitapiola.fi", hideArrow: true },
    ]

    // Set the help menu items in footer
    footer.menu = [
      { label: "Turvallisuus ja käyttöehdot", href: "#" },
      { label: "Evästeet", href: "#" },
      { label: "Henkilötietojen käsittely", href: "#" },
    ]

    // Listen for clicks on footer items
    footer.addEventListener("duetItemClick", function (e) {
      console.log("Item clicked:", e.detail)
      var event = e.detail.originalEvent
      var data = e.detail.data
      event.preventDefault()
    })

    // Listen for clicks on footer menu
    footer.addEventListener("duetMenuClick", function (e) {
      console.log("Menu clicked:", e.detail)
      var event = e.detail.originalEvent
      var data = e.detail.data
      event.preventDefault()
    })

    // Listen for clicks on the logo
    footer.addEventListener("duetLogoClick", function (e) {
      console.log("Logo clicked:", e.detail)
      var event = e.detail.originalEvent
      var data = e.detail.data
      event.preventDefault()
    })

    // duet events
    footer.addEventListener("duetEvent", function (e) {
      console.log("Duet event:", e.detail)
    })
  }())

</script>

Properties #

Property	Attribute	Description	Type	Default
`accessibleLabel`	`accessible-label`	Accessible label for footer	`string`	`undefined`
`accessibleLabelExternal`	`accessible-label-external`	Adds accessible label for tooltip that is shown in external link (url & external have both been set)	`string`	`getLocaleString(this.accessibleLabelExternalDefaults)`
`accessibleLabelExternalDefaults`	`accessible-label-external-default`	Property to change accessibleLabelExternal defaults on the component. normally you would handle these strings on an application level and override accessibleLabelExternal when needed	`DuetLangObject \| string`	`DuetStringsExternalDefaults`
`items`	`items`	An array of items for the main footer links. Items have to include mandatory "label" and "href" fields to work. Additionally, you can pass an "id" that is added as an HTML identifier for the anchor tag. Note that previously mandatory "icon" field has now been removed - setting it has no effect.	`any`	`undefined`
`language`	`language`	[DEPRECATED] this is now handled via the html lang tag, and is no longer used - kept to avoid breaking changes and ease unit testing The currently active language. This setting changes the logo to match the chosen language.	`"en" \| "fi" \| "sv"`	`getLanguage()`
`logoHref`	`logo-href`	URL that the logo link points to.	`string`	`"/"`
`margin`	`margin`	Controls the margin of the component.	`"auto" \| "none"`	`"auto"`
`menu`	`menu`	An array of items for the small footer menu. Items have to include mandatory "label" and "href" fields to work. Additionally, you can pass an "id" that is added as an HTML identifier for the anchor tag.	`any`	`undefined`
`theme`	`theme`	Theme of the navigation.	`"" \| "default" \| "turva"`	`""`
`variation`	`variation`	Style variation of the footer.	`"default" \| "multilevel" \| "simple"`	`"default"`

Events #

Event	Description	Type
`duetAnalytics`	Event raised when an items with an associated analytics ID is clicked. Analytics ID can be accessed via event.detail.analyticsId	`CustomEvent<{ analyticsId: string; component: "duet-footer"; }>`
`duetChange`	[DEPRECATED] in favour of the more specific events like duetLogoClick. Callback for when a user is about to navigate to another page. You can prevent the default browser functionality by calling event.detail.originalEvent.preventDefault() inside your listener. Additionally, the passed data is available via event.detail.data.	`CustomEvent<{ component: "duet-footer"; data: DuetFooterItem; originalEvent: Event; }>`
`duetEvent`	General event stream for the following events: item: onMouseEnter, onTouchDown; menuItem: onMouseEnter, onTouchDown;. You can prevent the default browser functionality by calling event.detail.originalEvent.preventDefault() inside your listener. Additionally, the passed data is available via event.detail.data.	`CustomEvent<{ component: "duet-footer"; data: DuetFooterItem; originalEvent: Event; }>`
`duetItemClick`	Event raised when the items are clicked. You can prevent the default browser functionality by calling event.detail.originalEvent.preventDefault() inside your listener. Additionally, the passed data is available via event.detail.data.	`CustomEvent<{ component: "duet-footer"; data: DuetFooterItem; originalEvent: Event; }>`
`duetLogoClick`	Event raised when the logo is clicked. You can prevent the default browser functionality by calling event.detail.originalEvent.preventDefault() inside your listener. Additionally, the passed data is available via event.detail.data.	`CustomEvent<{ component: "duet-footer"; data: DuetFooterItem; originalEvent: Event; }>`
`duetMenuClick`	Event raised when the menu links are clicked. You can prevent the default browser functionality by calling event.detail.originalEvent.preventDefault() inside your listener. Additionally, the passed data is available via event.detail.data.	`CustomEvent<{ component: "duet-footer"; data: DuetFooterItem; originalEvent: Event; }>`

Slots #

Slot	Description
`"extra"`	A slot for extra links.
`"info"`	A slot for additional info above footer items.

Shadow Parts #

Part	Description
`"menu"`	piercing selector for styling the menu section of the footer
`"top"`	piercing selector for styling the top part of the footer

Usage #

This section includes guidelines for designers and developers about the usage of this component in different contexts.

When to use #

Footer component is used as the global footer for all views.

When not to use #

Inside HTML footer element as Duet Footer already uses it internally.

Variations #

This section describes the different component variations, their purpose, and when to use each variation.

Name	Purpose
`default`	Default style is the most common footer variation. Only switch to another variation if you need to adjust the visual weight of the element.
`simple`	Simple variation should be used sparingly in views such as error pages.

Accessibility #

This component has been validated to meet the WCAG 2.1 AA accessibility guidelines. You can find additional information regarding accessibility of this component below.

Footer uses HTML <footer> element internally which is an HTML sectioning element that by default defines ARIA landmark with role contentinfo.
Because of the above reason, footer should never be wrapped inside another <footer> element.

Additional considerations #

If the service is public and does not require logging in, clicking the logo in the footer takes the user to the frontpage of lahitapiola.fi or turva.fi.
If the service requires signing in (self portal), the logo in the footer takes the user to the home view of that specific service.
In case the user is in the middle of purchase or similar flow, clicking the logo should show a warning modal asking whether the user actually wants to leave the page as the data already entered will be lost. View an example of this modal.

Integration

For integration, event and theming guidelines, please see Using Components. This documentation explains how to implement and use Duet’s components across different technologies like Angular, React or Vanilla JavaScript.

Integration guidelines

Tutorials

Follow these practical tutorials to learn how to build simple page layouts using Duet’s CSS Framework, Web Components and other features:

Tutorials

Troubleshooting

If you experience any issues while using a component, please head over to the Support page for more guidelines and help.

Footer Ready

Examples #

Properties #

Events #

Slots #

Shadow Parts #

Usage #

When to use #

When not to use #

Variations #

Accessibility #

Additional considerations #

Integration

Tutorials

Building Layouts

Using CLI Tools

Creating Custom Patterns

Server Side Rendering

Sharing Prototypes

Usage With Markdown

Troubleshooting