CSC Design System v4.0.1
VueFlavour Vue React Angular TypeScript
Flavour Vue React Angular TypeScript
PrimaryCSC UI Colors Primary Secondary AccentCustom Colors Red Orange Green Blue Purple Pink
CSC UI Colors Primary Secondary AccentCustom Colors Red Orange Green Blue Purple Pink
Guides Getting started Customization Data visualization Migration guide Componentsc-accordionc-alertc-autocompletec-badgec-breadcrumbc-buttonc-button-groupc-cardc-checkboxc-color-pickerc-csc-logoc-data-tablec-date-pickerc-dividerc-file-uploadc-iconc-icon-buttonc-linkc-listc-loaderc-login-buttonsc-login-cardc-mainc-menuc-messagec-modalc-navigation-buttonc-number-fieldc-otp-inputc-pagec-paginationc-popoverc-progress-barc-progress-circlec-radio-groupc-selectc-side-navigationc-sliderc-spinnerc-statusc-stepsc-switchc-tablec-tabsc-tagsc-text-fieldc-time-pickerc-toastsc-toolbarc-tooltipc-tree-select

<c-login-buttons>

A grid of sign-in choices, one `c-login-button` per identity provider, each showing the provider's logo above its name.

Usage

Use it where a service lets the user pick how to sign in, such as Haka, Virtu or a CSC account. Each c-login-button is that provider's sign-in: set its href to make it a link (or handle its click without one), the logo in src and the provider's name in the default slot. The grid has no props or events of its own.

<c-login-buttons>
  <c-login-button href="/login/haka" src="/img/haka.svg">
    Haka login
  </c-login-button>
  <c-login-button href="/login/virtu" src="/img/virtu.svg">
    Virtu login
  </c-login-button>
  <c-login-button href="/login/csc" src="/img/csc.svg">
    CSC login
  </c-login-button>
</c-login-buttons>

When to use

  • On a sign-in page that offers more than one identity provider.
  • For a single sign-in action, use a c-button.

Layout

The grid fits as many columns as its width allows, each at least 12rem wide, and shares each row evenly between them; the buttons move onto further rows as the space narrows. Every button in a row takes the height of the tallest.

Logos

src loads the provider's logo into an <img>, centred above the name and scaled down to fit the button. For markup an <img> cannot carry, such as an inline <svg> or a <picture>, use the button's image slot, which replaces the <img>.

Accessibility

With href a button is a real link: focus, Enter, middle-click and open-in-new-tab come from the platform. Without href it is a native button that Enter and Space press, firing click.

A button's accessible name is the logo's alt followed by the name in the default slot. The name already identifies the provider, so leave alt empty (the default) unless the logo says something the name does not. Mark an inline <svg> in the image slot aria-hidden="true" for the same reason.

Customization

c-login-buttons is itself the grid container, so set gap or grid-template-columns on the element to change the columns:

c-login-buttons {
  grid-template-columns: repeat(auto-fill, minmax(10rem, 1fr));
}

Each button's parts are ::part(root) (the link or button box), ::part(image-wrap) (the area that centres the logo), ::part(image) (the default <img>) and ::part(label) (the bar holding the name).

Examples

Basic
Vue React Angular TypeScript
<template>
  <div>
    <c-login-buttons>
      <c-login-button :src="logo(mdiSchool)">Haka login</c-login-button>

      <c-login-button :src="logo(mdiDomain)">Virtu login</c-login-button>

      <c-login-button :src="logo(mdiAccountCircle)">CSC login</c-login-button>
    </c-login-buttons>
  </div>
</template>

<script setup lang="ts">
import { mdiAccountCircle, mdiDomain, mdiSchool } from '@mdi/js';

// Stand-in provider logos; use your identity provider's logo url instead.
const logo = (path: string) =>
  `data:image/svg+xml;utf8,${encodeURIComponent(
    `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="${path}" fill="#336b8e"/></svg>`,
  )}`;
</script>
Basic · c-login-button
Vue React Angular TypeScript
<template>
  <div>
    <c-login-buttons>
      <c-login-button :src="logo(mdiSchool)">Haka login</c-login-button>

      <c-login-button :src="logo(mdiAccountCircle)">CSC login</c-login-button>
    </c-login-buttons>
  </div>
</template>

<script setup lang="ts">
import { mdiAccountCircle, mdiSchool } from '@mdi/js';

// Stand-in provider logos; use your identity provider's logo url instead.
const logo = (path: string) =>
  `data:image/svg+xml;utf8,${encodeURIComponent(
    `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="${path}" fill="#336b8e"/></svg>`,
  )}`;
</script>

API reference

<c-login-buttons>

A grid of sign-in choices, one `c-login-button` per identity provider, each showing the provider's logo above its name.

Slots

SlotDescription
defaultThe `c-login-button` choices, one per identity provider

<c-login-button>

One identity-provider choice inside `c-login-buttons`: a card with the provider's logo (`src`, or markup in the `image` slot) above the provider's name. With an `href` it is a link to the provider's sign-in; without one it is a button whose `click` you handle. Leave `alt` empty when the name already identifies the provider.

Properties

PropertyAttributeTypeDefaultDescription
altaltstring'' Alternative text for the `src` logo, read before the provider's name. Leave it empty when the name already identifies the provider.
hrefhrefstring'' The provider's sign-in URL, which makes the card a link. Without it the card is a button: handle its `click`.
srcsrcstring'' URL of the provider's logo, shown above the name. The `image` slot replaces it.

Slots

SlotDescription
defaultThe provider's name, shown in the bar under the logo
imageCustom provider logo markup (an inline `<svg>`, a `<picture>`, …) replacing the default `<img>` rendered from `src`

CSS parts

Style from outside with c-login-button::part(name) — parts are the library's only styling customization API.

PartDescription
rootThe whole clickable card: a link with `href`, else a button
image-wrapThe area above the name bar that centres the logo (default image or slotted content)
imageThe default provider logo `<img>` (absent when the `image` slot is used)
labelThe bar under the logo holding the provider's name