Callout

<cs-callout>

Stable

Since 0.1

Callouts display important messages inline with surrounding content. Use them to highlight tips, warnings, errors, or other information users should not miss.

This is a standard callout. You can customize its content and even the icon.

<cs-callout>
  <cs-icon slot="icon" name="info" variant="fill"></cs-icon>
  This is a standard callout. You can customize its content and even the icon.
</cs-callout>

Examples

Variant

Set the variant attribute to match the callout to its message.

  
    A new theme is available

    Try it from Settings whenever you're ready.
  
    Your changes have been saved

    You can safely close this tab now.
  
    Your settings have been updated

    Changes take effect on your next login.
  
    Your session is about to expire

    Save your work to avoid losing it.
  
    This action can't be undone

    Deleting a project removes it for everyone on the team.

<div class="cs-stack">
  <cs-callout variant="brand">
    <cs-icon slot="icon" name="info" variant="fill"></cs-icon>
    <strong>A new theme is available</strong><br />
    Try it from Settings whenever you're ready.
  </cs-callout>

  <cs-callout variant="success">
    <cs-icon slot="icon" name="check_circle" variant="fill"></cs-icon>
    <strong>Your changes have been saved</strong><br />
    You can safely close this tab now.
  </cs-callout>

  <cs-callout variant="neutral">
    <cs-icon slot="icon" name="settings"></cs-icon>
    <strong>Your settings have been updated</strong><br />
    Changes take effect on your next login.
  </cs-callout>

  <cs-callout variant="warning">
    <cs-icon slot="icon" name="warning" variant="fill"></cs-icon>
    <strong>Your session is about to expire</strong><br />
    Save your work to avoid losing it.
  </cs-callout>

  <cs-callout variant="danger">
    <cs-icon slot="icon" name="error" variant="fill"></cs-icon>
    <strong>This action can't be undone</strong><br />
    Deleting a project removes it for everyone on the team.
  </cs-callout>
</div>

Appearance

Use the appearance attribute to change the callout’s visual style. With no appearance set, a callout renders with a quiet fill and border, matching filled-outlined.

  
    This accent callout draws the most attention.
  
    This callout is both filled and outlined.
  
    This callout is only filled.
  
    Here's an outlined callout.
  
    No fill or border on this plain callout.

<div class="cs-stack">
  <cs-callout variant="brand" appearance="accent">
    <cs-icon slot="icon" name="check_box" variant="fill"></cs-icon>
    This <strong>accent</strong> callout draws the most attention.
  </cs-callout>

  <cs-callout variant="brand" appearance="filled-outlined">
    <cs-icon slot="icon" name="format_color_fill"></cs-icon>
    This callout is both <strong>filled</strong> and <strong>outlined</strong>.
  </cs-callout>

  <cs-callout variant="brand" appearance="filled">
    <cs-icon slot="icon" name="format_paint"></cs-icon>
    This callout is only <strong>filled</strong>.
  </cs-callout>

  <cs-callout variant="brand" appearance="outlined">
    <cs-icon slot="icon" name="line_style"></cs-icon>
    Here's an <strong>outlined</strong> callout.
  </cs-callout>

  <cs-callout variant="brand" appearance="plain">
    <cs-icon slot="icon" name="text_fields"></cs-icon>
    No fill or border on this <strong>plain</strong> callout.
  </cs-callout>
</div>

Size

Use the size attribute to change a callout’s size.

  
    Extra-small callout for minimal emphasis.
  
    Small callout for a bit of emphasis.
  
    Medium callout, the default size.
  
    Large callout for more emphasis.
  
    Extra-large callout for maximum emphasis.

<div class="cs-stack">
  <cs-callout size="xs">
    <cs-icon slot="icon" name="info" variant="fill"></cs-icon>
    Extra-small callout for minimal emphasis.
  </cs-callout>

  <cs-callout size="s">
    <cs-icon slot="icon" name="info" variant="fill"></cs-icon>
    Small callout for a bit of emphasis.
  </cs-callout>

  <cs-callout size="m">
    <cs-icon slot="icon" name="info" variant="fill"></cs-icon>
    Medium callout, the default size.
  </cs-callout>

  <cs-callout size="l">
    <cs-icon slot="icon" name="info" variant="fill"></cs-icon>
    Large callout for more emphasis.
  </cs-callout>

  <cs-callout size="xl">
    <cs-icon slot="icon" name="info" variant="fill"></cs-icon>
    Extra-large callout for maximum emphasis.
  </cs-callout>
</div>

Without an Icon

Icons are optional. Omit the icon slot for a text-only callout.

All times are shown in your local timezone.

<cs-callout variant="brand">All times are shown in your local timezone.</cs-callout>

Customizing

Style a callout with regular CSS — background, border, border-radius, color, padding, and margin all work as expected.

A pinch of CSS goes a long way.

<cs-callout
  variant="brand"
  style="
    background: var(--cs-color-brand-fill-quiet);
    border-radius: var(--cs-border-radius-pill);
    border-style: dashed;
  "
>
  <cs-icon slot="icon" name="wand_stars"></cs-icon>
  A pinch of CSS goes a long way.
</cs-callout>

API

Importing

If you're using the autoloader or a hosted project, components load on demand — no manual import needed. To cherry-pick this component, use one of the following snippets.

npm

Self-Hosted

React

import '@cruglobal/cornerstone-components/components/callout/callout.js';

import './cornerstone/components/callout/callout.js';

import CsCallout from '@cruglobal/cornerstone-components/react/callout/index.js';

Slots

Learn more about using slots.

Name	Description
(default)	The callout's main content.
`icon`	An icon to show in the callout. Works best with `<cs-icon>`.

Attributes & Properties

Learn more about attributes and properties.

Property	Attribute	Description	Type	Default	Reflects
`appearance`	`appearance`	The callout's visual appearance.	`'accent' \| 'filled' \| 'outlined' \| 'plain' \| 'filled-outlined'`	—	Yes
`size`	`size`	The callout's size.	`'xs' \| 's' \| 'm' \| 'l' \| 'xl'`	`'m'`	Yes
`variant`	`variant`	The callout's theme variant. Defaults to `brand` if not within another element with a variant.	`'brand' \| 'neutral' \| 'highlight' \| 'information' \| 'success' \| 'warning' \| 'danger'`	`'brand'`	Yes

CSS Parts

Learn more about CSS parts.

Name	Description	CSS selector
`icon`	The container that wraps the optional icon.	`::part(icon)`
`message`	The container that wraps the callout's main content.	`::part(message)`

Quick Links

Recent Searches