SPECIAL PRICING
BLACK FRIDAY SALE
PERSONAL $99
TEAM $349
ENDS DEC 1
GET IT NOW

Button

Angular Material Button is a versatile, customizable component used to trigger actions, navigate to links, or submit forms. It covers plain buttons, icon only buttons and floating action buttons, each one available in four sizes, with a leading or trailing icon, a destructive look for dangerous actions and a loading state. BuilderKit restyles all of them and gives them a more modern appearance.

The Button component is one of the most heavily customized components in BuilderKit. While Angular Material offers a wide range of styles and configurations, that flexibility can easily lead to inconsistency in real-world projects.

BuilderKit simplifies this by combining appearance and color into a single concept. Instead of juggling variants and tones, you choose from four clearly defined button types: primary, secondary (default), tertiary, and link.

Each type defines both the visual appearance and the color logic to keep things predictable and consistent. All types also support a destructive variant for critical actions.

For a set of options that stay pressed once chosen instead of firing an action, use the button toggle component.

Example

A default button, a primary button and an icon only button side by side.

<button matButton>Button</button>
<button matButton class="primary">Primary</button>
<button matButton>
<mat-icon svgIcon="circle-user"/>
</button>

Type

The primary, tertiary and link classes change the emphasis; a button without a type class is the default.

<button matButton>Default</button>
<button matButton class="primary">Primary</button>
<button matButton class="tertiary">Tertiary</button>
<button matButton class="link">Link</button>

Size

The tiny, small and large classes change the size; medium is the default.

<button matButton class="tiny">Tiny</button>
<button matButton class="small">Small</button>
<button matButton>Medium</button>
<button matButton class="large">Large</button>

Leading icon

An icon placed before the label.

Link
<button matButton>
<mat-icon svgIcon="check"/>
Button
</button>

<a matButton>
<mat-icon svgIcon="check"/>
Link
</a>

Trailing icon

An icon placed after the label.

Link
<button matButton>
<mat-icon svgIcon="chevron-down" iconPositionEnd/>
Button
</button>

<a matButton>
<mat-icon svgIcon="chevron-down" iconPositionEnd/>
Link
</a>

Destructive

The destructive class marks an action that removes or discards something and works with every type.

<button matButton class="destructive">Delete</button>
<button matButton class="primary destructive">Delete</button>

Disabled

The disabled attribute keeps the button inert and dims it.

<button matButton disabled>Button</button>
<button matButton class="primary" disabled>Primary</button>

Loading

The showProgress attribute shows a spinner inside the button and blocks interaction while it is on.

<button matButton showProgress>
Button
<mat-progress-spinner progressIndicator mode="indeterminate" diameter="18"/>
</button>

<button matButton class="primary" showProgress>
Primary
<mat-progress-spinner progressIndicator mode="indeterminate" diameter="18"/>
</button>

Icon button

matIconButton is Material's icon button: a bare target with no border or background until hovered, meant for toolbars, table rows and inline actions, with the same size scale and destructive variant.

<button matIconButton>
<mat-icon svgIcon="circle-user"/>
</button>

<a matIconButton>
<mat-icon svgIcon="circle-user"/>
</a>

FAB

Floating action buttons come in regular, mini and extended sizes for the primary action of a screen.

<button matFab>
<mat-icon svgIcon="user-round-plus"/>
</button>

<button matMiniFab>
<mat-icon svgIcon="user-round-plus"/>
</button>

<button matFab extended>
<mat-icon svgIcon="user-round-plus"/>
Add user
</button>

Button group Since v4.0.0

BuilderKit adds a button group treatment on top of the Angular Material Button. Wrap two or more buttons in the button-group class and they join into a single control with shared borders and rounded outer corners. Pagers, toolbars and split buttons all come out of the same markup. Stick to one type and one size per group, since mixing them leaves the shared border colored by only one side.

<div class="button-group">
<button matButton>Day</button>
<button matButton>Week</button>
<button matButton>Month</button>
</div>

<div class="button-group">
<button matButton><mat-icon svgIcon="text-align-start"/></button>
<button matButton><mat-icon svgIcon="text-align-center"/></button>
<button matButton><mat-icon svgIcon="text-align-end"/></button>
</div>

<div class="button-group">
<button matButton class="primary">Save</button>
<button matButton class="primary" [matMenuTriggerFor]="saveMenu">
<mat-icon svgIcon="chevron-down"/>
</button>
</div>

<mat-menu #saveMenu="matMenu">
<button mat-menu-item>Save as draft</button>
<button mat-menu-item>Save and publish</button>
</mat-menu>

Icon only Since v4.0.0

A button that contains only an icon needs no extra class. The button styles detect the empty label and square the padding, as the Example demo shows.

The icon-only class is for a button that still has a label in its markup. It hides the label visually and keeps it for screen readers, so the button keeps its accessible name. Its main use is responsive: with a breakpoint variant such as max-sm:icon-only, an action collapses to its icon on small screens and shows its label on larger ones. The class expects a single icon, so hide any trailing icon on the same breakpoint.

It is not an icon button: it keeps the regular button surface, border and size scale, while matIconButton has no border or background until hovered.

The same two actions with their labels visible and with the labels hidden by icon-only.

<button matButton>
<mat-icon svgIcon="download"/>
Export
</button>

<button matButton class="primary">
<mat-icon svgIcon="plus"/>
New invoice
</button>

<button matButton class="icon-only">
<mat-icon svgIcon="download"/>
Export
</button>

<button matButton class="primary icon-only">
<mat-icon svgIcon="plus"/>
New invoice
</button>

Spread Since v4.0.0

Buttons center their content as a group. The spread class lets the label fill the remaining width instead, so a full width button reads like a select field with the value at the start and a trailing icon at the end. Use it for custom popover and menu triggers. It works with every type and size.

<button matButton class="w-full max-w-xs spread" [matMenuTriggerFor]="statusMenu">
<mat-icon svgIcon="chevron-down" iconPositionEnd/>
In progress
</button>

<mat-menu #statusMenu="matMenu">
<button mat-menu-item>Backlog</button>
<button mat-menu-item>In progress</button>
<button mat-menu-item>Done</button>
</mat-menu>