Button
A native button with default/secondary/ghost variants and three sizes.
fandry-button
Example
Link to section ExampleCustom colors and parts
Link to section Custom colors and partsThe same component with a few --fd-* tokens set around it and its parts restyled. The code is under Parts below.
Props
Link to section Props| Prop | Type | Default | Description |
|---|---|---|---|
variant | 'default' | 'secondary' | 'ghost' | 'default' | Visual style. |
size | 'sm' | 'md' | 'lg' | 'md' | Button size. |
disabled | boolean | false | Disables the button. A button that must keep focus (one that is saving) takes element-props={ tabIndex: 0, ariaDisabled: 'true' } instead: it looks the same, has the same disabled state, and its clicks are ignored. |
type | 'button' | 'submit' | 'reset' | 'button' | Native button type. |
Parts
Link to section PartsStyle the elements inside the component from your own CSS with ::part(). Every fandry component renders in native shadow DOM, so parts work on LWR and Salesforce alike. For colors, spacing, radius and type across many components, set the --fd-* tokens instead. The code for the "Custom colors and parts" example above:
| Part | Description |
|---|---|
base | The outermost element. |
States are extra names on a part while the state is on. Name both to style one state, e.g.fandry-checkbox::part(control checked).
| State | Description |
|---|---|
default | The default look (variant="default"). |
secondary | variant="secondary". |
ghost | variant="ghost". |
disabled | A control, option or item that cannot be used. |
<!-- template -->
<div class="brand row">
<fandry-button class="cta">Add to cart</fandry-button>
<fandry-button variant="secondary">Save for later</fandry-button>
<fandry-button variant="ghost">Share</fandry-button>
<fandry-button class="rainbow">Launch sale</fandry-button>
</div>
/* css */
/* Scoped to this demo. Set the same --fd-* tokens on :root to theme
every fandry-* component on the site. */
.brand {
--fd-primary: 160 84% 26%;
--fd-ring-color: 160 84% 36%;
--fd-radius-md: 999px;
}
fandry-button::part(base) {
font-weight: 700;
letter-spacing: 0.02em;
}
fandry-button.cta::part(base) {
padding-inline: 1.5rem;
}
/* The glow goes on the element, not the part: a box-shadow on the part
would replace the button's focus ring. */
fandry-button.cta {
filter: drop-shadow(0 6px 12px hsl(160 84% 26% / 0.35));
}
/* A variant is a state too: only secondary buttons. */
fandry-button::part(base secondary) {
color: hsl(160 84% 26%);
border-color: hsl(160 84% 26%);
}
/* Even a rainbow border is only CSS: two layers under the label, on the
part's own ::before and ::after. No copy of the component needed. */
fandry-button.rainbow::part(base) {
position: relative;
isolation: isolate;
border-color: transparent;
background: transparent;
color: hsl(160 40% 14%);
}
fandry-button.rainbow::part(base)::before,
fandry-button.rainbow::part(base)::after {
content: '';
position: absolute;
border-radius: inherit;
}
fandry-button.rainbow::part(base)::before {
inset: -1px;
z-index: -2;
background: conic-gradient(#ff4d4d, #ffb84d, #f5f54d, #4dff88, #4dd2ff, #7a4dff, #ff4de1, #ff4d4d);
animation: rainbow-turn 4s linear infinite;
}
fandry-button.rainbow::part(base)::after {
inset: 2px;
z-index: -1;
background: hsl(0 0% 100%);
}
@keyframes rainbow-turn {
to {
filter: hue-rotate(360deg);
}
}
@media (prefers-reduced-motion: reduce) {
fandry-button.rainbow::part(base)::before {
animation: none;
}
}
Code
Link to section Code<fandry-button variant="secondary" size="lg">Save</fandry-button>
Example: A loading state, with a slot
Link to section Example: A loading state, with a slotCode
<!-- template: the spinner is just slotted content -->
<fandry-button element-props={saveButtonProps} onclick={handleSave}>
<template lwc:if={saving}>
<fandry-spinner size="sm" aria-hidden="true"></fandry-spinner>
</template>
{saveLabel}
</fandry-button>
// js
saving = false;
// The text says what's happening; the spinner beside it is decoration.
get saveLabel() {
return this.saving ? 'Saving…' : 'Save';
}
// aria-disabled, not disabled: disabling the focused button would drop
// focus to the page. It keeps focus but ignores clicks, so handleSave
// can't run twice. tabIndex: 0 is fandry-button's own default.
get saveButtonProps() {
return { tabIndex: 0, ariaDisabled: this.saving ? 'true' : null };
}
async handleSave() {
this.saving = true;
try {
await this.save();
} finally {
this.saving = false;
}
}
<!-- Need it on many screens? Wrap it once in your own small component that
renders fandry-button like this: composition, nothing copied. -->