Enum Variant 

pub enum Variant {
    Transparent,
    Default,
    Secondary,
    Tertiary,
    Custom(&'static str),
}

Semantic prominence level of a [Card] component.

Each variant maps to a distinct background-color class so that themes can interpret “prominence” differently without hard-coding specific palettes into component logic.

Default

Variant::Default is the default variant.

Examples

use card_rs::Variant;

let cls = Variant::Tertiary.to_class();
assert_eq!(cls, "card--tertiary");

let style = Variant::Transparent.to_style();
assert!(style.contains("transparent"));

Variants

Transparent

Minimal prominence, transparent background.

Use for less important content or for cards nested inside other cards.

Default

Standard card appearance (bg-surface). This is the default.

Suitable for most use cases.

Secondary

Medium prominence (bg-surface-secondary).

Use to draw moderate attention.

Tertiary

Higher prominence (bg-surface-tertiary).

Use for primary or featured content.

Custom(&'static str)

Arbitrary inline CSS styling for the variant.

E.g. "background: linear-gradient(...);".

Implementations

impl Variant

pub fn to_class(self) -> &'static str

Returns the BEM modifier CSS class for this variant.

Returns

One of "card--transparent", "card--default", "card--secondary", or "card--tertiary".

pub fn to_style(self) -> &'static str

Returns the inline CSS background/border style for this variant.

These values mirror the HeroUI design token mapping:

• transparent → no background
• default → #ffffff surface with a subtle border
• secondary → light gray surface
• tertiary → slightly warmer surface

Trait Implementations

impl Clone for Variant

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Variant

impl Debug for Variant

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Variant

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Variant

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Variant