- Accordion
- Alert
- Alert Dialog
- Aspect Ratio
- Attachment
- Autocomplete
- Avatar
- Badge
- Breadcrumb
- Bubble
- Button
- Button Group
- Calendar
- Card
- Carousel
- Chart
- Checkbox
- Code Block
- Collapsible
- Combobox
- Command
- Context Menu
- Data Table
- Date Picker
- Dialog
- Drawer
- Dropdown Menu
- Empty
- Field
- Hover Card
- Input Group
- Input OTP
- Input
- Item
- Kbd
- Label
- Marker
- Menubar
- Message
- Message Scroller
- Native Select
- Navigation Menu
- Pagination
- Popover
- Progress
- Questionnaire
- Radio Group
- Resizable
- Scroll Area
- Select
- Separator
- Sheet
- Sidebar
- Skeleton
- Slider
- Sonner (Toast)
- Spinner
- Switch
- Table
- Tabs
- Textarea
- Toggle
- Toggle Group
- Tooltip
- Trace
Empty
Use the Empty component to display a empty state.
import { Component } from '@angular/core';
import { NgIcon, provideIcons } from '@ng-icons/core';
import { lucideArrowUpRight, lucideFolderCode } from '@ng-icons/lucide';
import { HlmButton } from '@spartan-ng/helm/button';
import { HlmEmptyImports } from '@spartan-ng/helm/empty';
@Component({
selector: 'spartan-empty-preview',
imports: [NgIcon, HlmButton, HlmEmptyImports],
providers: [provideIcons({ lucideFolderCode, lucideArrowUpRight })],
template: `
<hlm-empty>
<hlm-empty-header>
<hlm-empty-media variant="icon">
<ng-icon name="lucideFolderCode" />
</hlm-empty-media>
<div hlmEmptyTitle>No Projects Yet</div>
<div hlmEmptyDescription>
You haven't created any projects yet. Get started by creating your first project.
</div>
</hlm-empty-header>
<hlm-empty-content class="flex-row justify-center gap-2">
<button hlmBtn>Create Project</button>
<button hlmBtn variant="outline">Import Project</button>
</hlm-empty-content>
<a href="#" hlmBtn class="text-muted-foreground" variant="link" size="sm">
Learn More
<ng-icon name="lucideArrowUpRight" />
</a>
</hlm-empty>
`,
})
export class EmptyPreview {}Installation
ng g @spartan-ng/cli:ui emptynx g @spartan-ng/cli:ui emptyimport { OVERLAY_DEFAULT_CONFIG } from '@angular/cdk/overlay';
import { brnClasses, type BrnClassesOptions } from '@spartan-ng/brain/core';
import { cn, type ClassValue } from 'cn';
import { createCn } from 'cn/config';
import { makeEnvironmentProviders, type EnvironmentProviders } from '@angular/core';
import { provideSpartanHlm } from '@spartan-ng/helm/utils';
/**
* Merges class values and resolves Tailwind CSS conflicts.
*
* To customize the merge (e.g. register custom theme values), create your own instance:
*
* @example
* ```ts
*
*
* export const hlm = createCn({
* extend: { classGroups: { 'font-size': [{ text: ['hero'] }] } },
* });
* ```
*/
export const hlm = cn;
/**
* This function dynamically adds and removes classes for a given element without requiring
* the a class binding (e.g. `[class]="..."`) which may interfere with other class bindings.
* The classes are merged with `hlm`.
*/
export function classes(computed: () => ClassValue[] | string, options: Omit<BrnClassesOptions, 'merge'> = {}) {
brnClasses(computed, { ...options, merge: hlm });
}
/**
* Provides default configuration for Spartan Helm components.
*
* This utility configures the Angular CDK overlay to disable the `usePopover`
* behavior introduced in Angular 21, which causes CDK overlay-based components
* (sheets, dialogs, tooltips, etc.) to render above `position: fixed` elements
* like `<hlm-toaster>`.
*
* @returns {EnvironmentProviders} Environment providers to be added to the application config.
*
* @example
* ```ts
* // app.config.ts
*
*
* export const appConfig: ApplicationConfig = {
* providers: [
* provideSpartanHlm(),
* // ... other providers
* ],
* };
* ```
*/
export function provideSpartanHlm(): EnvironmentProviders {
return makeEnvironmentProviders([
{
provide: OVERLAY_DEFAULT_CONFIG,
useValue: { usePopover: false },
},
]);
}import { Directive, input } from '@angular/core';
import { VariantProps, cva } from 'class-variance-authority';
import { classes } from '@spartan-ng/helm/utils';
@Directive({
selector: '[hlmEmptyContent],hlm-empty-content',
exportAs: 'hlmEmptyContent',
host: { 'data-slot': 'empty-content' },
})
export class HlmEmptyContent {
constructor() {
classes(() => 'gap-2.5 text-sm flex w-full max-w-sm min-w-0 flex-col items-center text-balance');
}
}
@Directive({
selector: '[hlmEmptyDescription]',
exportAs: 'hlmEmptyDescription',
host: { 'data-slot': 'empty-description' },
})
export class HlmEmptyDescription {
constructor() {
classes(
() =>
'text-sm/relaxed text-muted-foreground [&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4',
);
}
}
@Directive({
selector: '[hlmEmptyHeader],hlm-empty-header',
exportAs: 'hlmEmptyHeader',
host: { 'data-slot': 'empty-header' },
})
export class HlmEmptyHeader {
constructor() {
classes(() => 'gap-2 flex max-w-sm flex-col items-center');
}
}
const emptyMediaVariants = cva(
'mb-2 flex shrink-0 items-center justify-center [&_ng-icon]:pointer-events-none [&_ng-icon]:shrink-0',
{
variants: {
variant: {
default: 'bg-transparent',
icon: "bg-muted text-foreground flex size-8 shrink-0 items-center justify-center rounded-lg [&_ng-icon:not([class*='text-'])]:text-[length:--spacing(4)]",
},
},
defaultVariants: {
variant: 'default',
},
},
);
export type EmptyMediaVariants = VariantProps<typeof emptyMediaVariants>;
@Directive({
selector: '[hlmEmptyMedia],hlm-empty-media',
exportAs: 'hlmEmptyMedia',
host: {
'data-slot': 'empty-media',
'[attr.data-variant]': 'variant()',
},
})
export class HlmEmptyMedia {
public readonly variant = input<EmptyMediaVariants['variant']>();
constructor() {
classes(() => emptyMediaVariants({ variant: this.variant() }));
}
}
@Directive({
selector: '[hlmEmptyTitle]',
exportAs: 'hlmEmptyTitle',
host: { 'data-slot': 'empty-title' },
})
export class HlmEmptyTitle {
constructor() {
classes(() => 'text-sm font-medium tracking-tight');
}
}
@Directive({
selector: '[hlmEmpty],hlm-empty',
exportAs: 'hlmEmpty',
host: { 'data-slot': 'empty' },
})
export class HlmEmpty {
constructor() {
classes(
() => 'gap-4 rounded-xl border-dashed p-6 flex w-full min-w-0 flex-1 flex-col items-center justify-center text-center text-balance',
);
}
}
export const HlmEmptyImports = [
HlmEmpty,
HlmEmptyContent,
HlmEmptyDescription,
HlmEmptyHeader,
HlmEmptyTitle,
HlmEmptyMedia,
] as const;import { Directive, input } from '@angular/core';
import { VariantProps, cva } from 'class-variance-authority';
import { classes } from '@spartan-ng/helm/utils';
@Directive({
selector: '[hlmEmptyContent],hlm-empty-content',
exportAs: 'hlmEmptyContent',
host: { 'data-slot': 'empty-content' },
})
export class HlmEmptyContent {
constructor() {
classes(() => 'gap-4 text-sm flex w-full max-w-sm min-w-0 flex-col items-center text-balance');
}
}
@Directive({
selector: '[hlmEmptyDescription]',
exportAs: 'hlmEmptyDescription',
host: { 'data-slot': 'empty-description' },
})
export class HlmEmptyDescription {
constructor() {
classes(
() =>
'text-sm/relaxed text-muted-foreground [&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4',
);
}
}
@Directive({
selector: '[hlmEmptyHeader],hlm-empty-header',
exportAs: 'hlmEmptyHeader',
host: { 'data-slot': 'empty-header' },
})
export class HlmEmptyHeader {
constructor() {
classes(() => 'gap-2 flex max-w-sm flex-col items-center');
}
}
const emptyMediaVariants = cva(
'mb-2 flex shrink-0 items-center justify-center [&_ng-icon]:pointer-events-none [&_ng-icon]:shrink-0',
{
variants: {
variant: {
default: 'bg-transparent',
icon: "bg-muted text-foreground flex size-10 shrink-0 items-center justify-center rounded-lg [&_ng-icon:not([class*='text-'])]:text-[length:--spacing(6)]",
},
},
defaultVariants: {
variant: 'default',
},
},
);
export type EmptyMediaVariants = VariantProps<typeof emptyMediaVariants>;
@Directive({
selector: '[hlmEmptyMedia],hlm-empty-media',
exportAs: 'hlmEmptyMedia',
host: {
'data-slot': 'empty-media',
'[attr.data-variant]': 'variant()',
},
})
export class HlmEmptyMedia {
public readonly variant = input<EmptyMediaVariants['variant']>();
constructor() {
classes(() => emptyMediaVariants({ variant: this.variant() }));
}
}
@Directive({
selector: '[hlmEmptyTitle]',
exportAs: 'hlmEmptyTitle',
host: { 'data-slot': 'empty-title' },
})
export class HlmEmptyTitle {
constructor() {
classes(() => 'text-lg font-medium tracking-tight');
}
}
@Directive({
selector: '[hlmEmpty],hlm-empty',
exportAs: 'hlmEmpty',
host: { 'data-slot': 'empty' },
})
export class HlmEmpty {
constructor() {
classes(
() => 'gap-4 rounded-lg border-dashed p-12 flex w-full min-w-0 flex-1 flex-col items-center justify-center text-center text-balance',
);
}
}
export const HlmEmptyImports = [
HlmEmpty,
HlmEmptyContent,
HlmEmptyDescription,
HlmEmptyHeader,
HlmEmptyTitle,
HlmEmptyMedia,
] as const;import { Directive, input } from '@angular/core';
import { VariantProps, cva } from 'class-variance-authority';
import { classes } from '@spartan-ng/helm/utils';
@Directive({
selector: '[hlmEmptyContent],hlm-empty-content',
exportAs: 'hlmEmptyContent',
host: { 'data-slot': 'empty-content' },
})
export class HlmEmptyContent {
constructor() {
classes(() => 'gap-2.5 text-xs flex w-full max-w-sm min-w-0 flex-col items-center text-balance');
}
}
@Directive({
selector: '[hlmEmptyDescription]',
exportAs: 'hlmEmptyDescription',
host: { 'data-slot': 'empty-description' },
})
export class HlmEmptyDescription {
constructor() {
classes(
() =>
'text-xs/relaxed text-muted-foreground [&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4',
);
}
}
@Directive({
selector: '[hlmEmptyHeader],hlm-empty-header',
exportAs: 'hlmEmptyHeader',
host: { 'data-slot': 'empty-header' },
})
export class HlmEmptyHeader {
constructor() {
classes(() => 'gap-2 flex max-w-sm flex-col items-center');
}
}
const emptyMediaVariants = cva(
'mb-2 flex shrink-0 items-center justify-center [&_ng-icon]:pointer-events-none [&_ng-icon]:shrink-0',
{
variants: {
variant: {
default: 'bg-transparent',
icon: "bg-muted text-foreground flex size-8 shrink-0 items-center justify-center rounded-none [&_ng-icon:not([class*='text-'])]:text-[length:--spacing(4)]",
},
},
defaultVariants: {
variant: 'default',
},
},
);
export type EmptyMediaVariants = VariantProps<typeof emptyMediaVariants>;
@Directive({
selector: '[hlmEmptyMedia],hlm-empty-media',
exportAs: 'hlmEmptyMedia',
host: {
'data-slot': 'empty-media',
'[attr.data-variant]': 'variant()',
},
})
export class HlmEmptyMedia {
public readonly variant = input<EmptyMediaVariants['variant']>();
constructor() {
classes(() => emptyMediaVariants({ variant: this.variant() }));
}
}
@Directive({
selector: '[hlmEmptyTitle]',
exportAs: 'hlmEmptyTitle',
host: { 'data-slot': 'empty-title' },
})
export class HlmEmptyTitle {
constructor() {
classes(() => 'text-sm font-medium');
}
}
@Directive({
selector: '[hlmEmpty],hlm-empty',
exportAs: 'hlmEmpty',
host: { 'data-slot': 'empty' },
})
export class HlmEmpty {
constructor() {
classes(
() => 'gap-4 rounded-none border-dashed p-6 flex w-full min-w-0 flex-1 flex-col items-center justify-center text-center text-balance',
);
}
}
export const HlmEmptyImports = [
HlmEmpty,
HlmEmptyContent,
HlmEmptyDescription,
HlmEmptyHeader,
HlmEmptyTitle,
HlmEmptyMedia,
] as const;import { Directive, input } from '@angular/core';
import { VariantProps, cva } from 'class-variance-authority';
import { classes } from '@spartan-ng/helm/utils';
@Directive({
selector: '[hlmEmptyContent],hlm-empty-content',
exportAs: 'hlmEmptyContent',
host: { 'data-slot': 'empty-content' },
})
export class HlmEmptyContent {
constructor() {
classes(() => 'gap-4 text-sm flex w-full max-w-sm min-w-0 flex-col items-center text-balance');
}
}
@Directive({
selector: '[hlmEmptyDescription]',
exportAs: 'hlmEmptyDescription',
host: { 'data-slot': 'empty-description' },
})
export class HlmEmptyDescription {
constructor() {
classes(
() =>
'text-sm/relaxed text-muted-foreground [&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4',
);
}
}
@Directive({
selector: '[hlmEmptyHeader],hlm-empty-header',
exportAs: 'hlmEmptyHeader',
host: { 'data-slot': 'empty-header' },
})
export class HlmEmptyHeader {
constructor() {
classes(() => 'gap-2 flex max-w-sm flex-col items-center');
}
}
const emptyMediaVariants = cva(
'mb-2 flex shrink-0 items-center justify-center [&_ng-icon]:pointer-events-none [&_ng-icon]:shrink-0',
{
variants: {
variant: {
default: 'bg-transparent',
icon: "bg-muted text-foreground flex size-10 shrink-0 items-center justify-center rounded-lg [&_ng-icon:not([class*='text-'])]:text-[length:--spacing(6)]",
},
},
defaultVariants: {
variant: 'default',
},
},
);
export type EmptyMediaVariants = VariantProps<typeof emptyMediaVariants>;
@Directive({
selector: '[hlmEmptyMedia],hlm-empty-media',
exportAs: 'hlmEmptyMedia',
host: {
'data-slot': 'empty-media',
'[attr.data-variant]': 'variant()',
},
})
export class HlmEmptyMedia {
public readonly variant = input<EmptyMediaVariants['variant']>();
constructor() {
classes(() => emptyMediaVariants({ variant: this.variant() }));
}
}
@Directive({
selector: '[hlmEmptyTitle]',
exportAs: 'hlmEmptyTitle',
host: { 'data-slot': 'empty-title' },
})
export class HlmEmptyTitle {
constructor() {
classes(() => 'text-lg font-medium tracking-tight');
}
}
@Directive({
selector: '[hlmEmpty],hlm-empty',
exportAs: 'hlmEmpty',
host: { 'data-slot': 'empty' },
})
export class HlmEmpty {
constructor() {
classes(
() => 'gap-4 rounded-lg border-dashed p-12 flex w-full min-w-0 flex-1 flex-col items-center justify-center text-center text-balance',
);
}
}
export const HlmEmptyImports = [
HlmEmpty,
HlmEmptyContent,
HlmEmptyDescription,
HlmEmptyHeader,
HlmEmptyTitle,
HlmEmptyMedia,
] as const;import { Directive, input } from '@angular/core';
import { VariantProps, cva } from 'class-variance-authority';
import { classes } from '@spartan-ng/helm/utils';
@Directive({
selector: '[hlmEmptyContent],hlm-empty-content',
exportAs: 'hlmEmptyContent',
host: { 'data-slot': 'empty-content' },
})
export class HlmEmptyContent {
constructor() {
classes(() => 'gap-2 text-xs/relaxed flex w-full max-w-sm min-w-0 flex-col items-center text-balance');
}
}
@Directive({
selector: '[hlmEmptyDescription]',
exportAs: 'hlmEmptyDescription',
host: { 'data-slot': 'empty-description' },
})
export class HlmEmptyDescription {
constructor() {
classes(
() =>
'text-xs/relaxed text-muted-foreground [&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4',
);
}
}
@Directive({
selector: '[hlmEmptyHeader],hlm-empty-header',
exportAs: 'hlmEmptyHeader',
host: { 'data-slot': 'empty-header' },
})
export class HlmEmptyHeader {
constructor() {
classes(() => 'gap-1 flex max-w-sm flex-col items-center');
}
}
const emptyMediaVariants = cva(
'mb-2 flex shrink-0 items-center justify-center [&_ng-icon]:pointer-events-none [&_ng-icon]:shrink-0',
{
variants: {
variant: {
default: 'bg-transparent',
icon: "bg-muted text-foreground flex size-8 shrink-0 items-center justify-center rounded-md [&_ng-icon:not([class*='text-'])]:text-[length:--spacing(4)]",
},
},
defaultVariants: {
variant: 'default',
},
},
);
export type EmptyMediaVariants = VariantProps<typeof emptyMediaVariants>;
@Directive({
selector: '[hlmEmptyMedia],hlm-empty-media',
exportAs: 'hlmEmptyMedia',
host: {
'data-slot': 'empty-media',
'[attr.data-variant]': 'variant()',
},
})
export class HlmEmptyMedia {
public readonly variant = input<EmptyMediaVariants['variant']>();
constructor() {
classes(() => emptyMediaVariants({ variant: this.variant() }));
}
}
@Directive({
selector: '[hlmEmptyTitle]',
exportAs: 'hlmEmptyTitle',
host: { 'data-slot': 'empty-title' },
})
export class HlmEmptyTitle {
constructor() {
classes(() => 'text-sm font-medium tracking-tight');
}
}
@Directive({
selector: '[hlmEmpty],hlm-empty',
exportAs: 'hlmEmpty',
host: { 'data-slot': 'empty' },
})
export class HlmEmpty {
constructor() {
classes(
() => 'gap-4 rounded-xl border-dashed p-6 flex w-full min-w-0 flex-1 flex-col items-center justify-center text-center text-balance',
);
}
}
export const HlmEmptyImports = [
HlmEmpty,
HlmEmptyContent,
HlmEmptyDescription,
HlmEmptyHeader,
HlmEmptyTitle,
HlmEmptyMedia,
] as const;import { Directive, input } from '@angular/core';
import { VariantProps, cva } from 'class-variance-authority';
import { classes } from '@spartan-ng/helm/utils';
@Directive({
selector: '[hlmEmptyContent],hlm-empty-content',
exportAs: 'hlmEmptyContent',
host: { 'data-slot': 'empty-content' },
})
export class HlmEmptyContent {
constructor() {
classes(() => 'gap-4 text-sm flex w-full max-w-sm min-w-0 flex-col items-center text-balance');
}
}
@Directive({
selector: '[hlmEmptyDescription]',
exportAs: 'hlmEmptyDescription',
host: { 'data-slot': 'empty-description' },
})
export class HlmEmptyDescription {
constructor() {
classes(
() =>
'text-sm/relaxed text-muted-foreground [&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4',
);
}
}
@Directive({
selector: '[hlmEmptyHeader],hlm-empty-header',
exportAs: 'hlmEmptyHeader',
host: { 'data-slot': 'empty-header' },
})
export class HlmEmptyHeader {
constructor() {
classes(() => 'gap-2 flex max-w-sm flex-col items-center');
}
}
const emptyMediaVariants = cva(
'mb-2 flex shrink-0 items-center justify-center [&_ng-icon]:pointer-events-none [&_ng-icon]:shrink-0',
{
variants: {
variant: {
default: 'bg-transparent',
icon: "bg-muted text-foreground flex size-10 shrink-0 items-center justify-center rounded-xl [&_ng-icon:not([class*='text-'])]:text-[length:--spacing(5)]",
},
},
defaultVariants: {
variant: 'default',
},
},
);
export type EmptyMediaVariants = VariantProps<typeof emptyMediaVariants>;
@Directive({
selector: '[hlmEmptyMedia],hlm-empty-media',
exportAs: 'hlmEmptyMedia',
host: {
'data-slot': 'empty-media',
'[attr.data-variant]': 'variant()',
},
})
export class HlmEmptyMedia {
public readonly variant = input<EmptyMediaVariants['variant']>();
constructor() {
classes(() => emptyMediaVariants({ variant: this.variant() }));
}
}
@Directive({
selector: '[hlmEmptyTitle]',
exportAs: 'hlmEmptyTitle',
host: { 'data-slot': 'empty-title' },
})
export class HlmEmptyTitle {
constructor() {
classes(() => 'text-lg font-medium tracking-tight');
}
}
@Directive({
selector: '[hlmEmpty],hlm-empty',
exportAs: 'hlmEmpty',
host: { 'data-slot': 'empty' },
})
export class HlmEmpty {
constructor() {
classes(
() => 'gap-4 rounded-2xl border-dashed p-12 flex w-full min-w-0 flex-1 flex-col items-center justify-center text-center text-balance',
);
}
}
export const HlmEmptyImports = [
HlmEmpty,
HlmEmptyContent,
HlmEmptyDescription,
HlmEmptyHeader,
HlmEmptyTitle,
HlmEmptyMedia,
] as const;Usage
import { HlmEmptyImports } from '@spartan-ng/helm/empty';<hlm-empty>
<hlm-empty-header>
<hlm-empty-media variant="icon">
<ng-icon name="lucideFolderCode" />
</hlm-empty-media>
<div hlmEmptyTitle>No data</div>
<div hlmEmptyDescription>No data found</div>
</hlm-empty-header>
<hlm-empty-content>
<button hlmBtn>Add data</button>
</hlm-empty-content>
</hlm-empty>Examples
Outline
Use the border utility class to create a outline empty state.
import { Component } from '@angular/core';
import { NgIcon, provideIcons } from '@ng-icons/core';
import { lucideCloud } from '@ng-icons/lucide';
import { HlmButton } from '@spartan-ng/helm/button';
import { HlmEmptyImports } from '@spartan-ng/helm/empty';
@Component({
selector: 'spartan-empty-outline',
imports: [NgIcon, HlmButton, HlmEmptyImports],
providers: [provideIcons({ lucideCloud })],
template: `
<div hlmEmpty class="border border-dashed">
<div hlmEmptyHeader>
<div hlmEmptyMedia variant="icon">
<ng-icon name="lucideCloud" />
</div>
<div hlmEmptyTitle>Cloud Storage Empty</div>
<div hlmEmptyDescription>Upload files to your cloud storage to access them anywhere.</div>
</div>
<div hlmEmptyContent>
<button hlmBtn variant="outline">Upload Files</button>
</div>
</div>
`,
})
export class EmptyOutline {}Background
Use the bg-* and bg-gradient-* utilities to add a background to the empty state.
import { Component } from '@angular/core';
import { NgIcon, provideIcons } from '@ng-icons/core';
import { lucideBell, lucideRefreshCcw } from '@ng-icons/lucide';
import { HlmButton } from '@spartan-ng/helm/button';
import { HlmEmptyImports } from '@spartan-ng/helm/empty';
@Component({
selector: 'spartan-empty-background',
imports: [NgIcon, HlmButton, HlmEmptyImports],
providers: [provideIcons({ lucideBell, lucideRefreshCcw })],
template: `
<div hlmEmpty class="from-muted/50 to-background h-full w-full bg-gradient-to-b from-30%">
<div hlmEmptyHeader>
<div hlmEmptyMedia variant="icon">
<ng-icon name="lucideBell" />
</div>
<div hlmEmptyTitle>No notifications</div>
<div hlmEmptyDescription>You're all caught up. New notifications will appear here.</div>
</div>
<div hlmEmptyContent>
<button hlmBtn variant="outline">
<ng-icon name="lucideRefreshCcw" />
Refresh
</button>
</div>
</div>
`,
})
export class EmptyBackground {}Avatar
Use the EmptyMedia component to display an avatar in the empty state.
import { Component } from '@angular/core';
import { NgIcon, provideIcons } from '@ng-icons/core';
import { lucideMessageCircle } from '@ng-icons/lucide';
import { HlmAvatarImports } from '@spartan-ng/helm/avatar';
import { HlmButton } from '@spartan-ng/helm/button';
import { HlmEmptyImports } from '@spartan-ng/helm/empty';
@Component({
selector: 'spartan-empty-avatar',
imports: [NgIcon, HlmButton, HlmEmptyImports, HlmAvatarImports],
providers: [provideIcons({ lucideMessageCircle })],
template: `
<div hlmEmpty>
<div hlmEmptyHeader>
<div hlmEmptyMedia>
<hlm-avatar class="size-12">
<img src="/assets/avatar.png" alt="spartan logo. Resembling a spartanic shield" hlmAvatarImage />
<span class="bg-[#FD005B] text-white" hlmAvatarFallback>RG</span>
</hlm-avatar>
</div>
<div hlmEmptyTitle>User Offline</div>
<div hlmEmptyDescription>
This user is currently offline. You can leave a message to notify them or try again later.
</div>
</div>
<div hlmEmptyContent>
<button hlmBtn size="sm">
<ng-icon name="lucideMessageCircle" />
Leave message
</button>
</div>
</div>
`,
})
export class EmptyAvatar {}Avatar Group
Use the EmptyMedia component to display an avatar group in the empty state.
import { Component } from '@angular/core';
import { NgIcon, provideIcons } from '@ng-icons/core';
import { lucidePlus } from '@ng-icons/lucide';
import { HlmAvatarImports } from '@spartan-ng/helm/avatar';
import { HlmButton } from '@spartan-ng/helm/button';
import { HlmEmptyImports } from '@spartan-ng/helm/empty';
@Component({
selector: 'spartan-empty-avatar-group',
imports: [NgIcon, HlmButton, HlmEmptyImports, HlmAvatarImports],
providers: [provideIcons({ lucidePlus })],
template: `
<div hlmEmpty>
<div hlmEmptyHeader>
<div hlmEmptyMedia>
<div
class="[&>hlm-avatar]:ring-background flex -space-x-2 [&>hlm-avatar]:size-12 [&>hlm-avatar]:ring-2 [&>hlm-avatar]:grayscale"
>
<hlm-avatar class="size-12">
<img src="https://picsum.photos/1000/800?grayscale&random=1" alt="avatar 1" hlmAvatarImage />
<span class="bg-[#FD005B] text-white" hlmAvatarFallback>A1</span>
</hlm-avatar>
<hlm-avatar class="size-12">
<img src="https://picsum.photos/1000/800?grayscale&random=2" alt="avatar 2" hlmAvatarImage />
<span class="bg-[#FD005B] text-white" hlmAvatarFallback>A2</span>
</hlm-avatar>
<hlm-avatar class="size-12">
<img src="https://picsum.photos/1000/800?grayscale&random=3" alt="avatar 3" hlmAvatarImage />
<span class="bg-[#FD005B] text-white" hlmAvatarFallback>A3</span>
</hlm-avatar>
</div>
</div>
<div hlmEmptyTitle>No Team Members</div>
<div hlmEmptyDescription>Invite your team to collaborate on this project.</div>
</div>
<div hlmEmptyContent>
<button hlmBtn size="sm">
<ng-icon name="lucidePlus" />
Invite Members
</button>
</div>
</div>
`,
})
export class EmptyAvatarGroup {}Input Group
You can add an InputGroup component to the EmptyContent component.
import { Component } from '@angular/core';
import { NgIcon, provideIcons } from '@ng-icons/core';
import { lucideSearch } from '@ng-icons/lucide';
import { HlmEmptyImports } from '@spartan-ng/helm/empty';
import { HlmInputGroupImports } from '@spartan-ng/helm/input-group';
import { HlmKbdImports } from '@spartan-ng/helm/kbd';
@Component({
selector: 'spartan-empty-input-group',
imports: [NgIcon, HlmEmptyImports, HlmInputGroupImports, HlmKbdImports],
providers: [provideIcons({ lucideSearch })],
template: `
<hlm-empty>
<hlm-empty-header>
<div hlmEmptyTitle>404 - Not Found</div>
<div hlmEmptyDescription>The page you're looking for doesn't exist. Try searching for what you need below.</div>
</hlm-empty-header>
<hlm-empty-content>
<hlm-input-group class="sm:w-3/4">
<input hlmInputGroupInput placeholder="Try searching for pages..." />
<hlm-input-group-addon>
<ng-icon name="lucideSearch" />
</hlm-input-group-addon>
<hlm-input-group-addon align="inline-end">
<kbd hlmKbd>/</kbd>
</hlm-input-group-addon>
</hlm-input-group>
<div hlmEmptyDescription>
Need help?
<a href="#">Contact Support</a>
</div>
</hlm-empty-content>
</hlm-empty>
`,
})
export class EmptyInputGroup {}RTL
To enable RTL support in spartan-ng, see the RTL configuration guide.
import { Component, computed, inject } from '@angular/core';
import { NgIcon, provideIcons } from '@ng-icons/core';
import { lucideArrowUpRight, lucideFolderCode } from '@ng-icons/lucide';
import { TranslateService, Translations } from '@spartan-ng/app/app/shared/translate.service';
import { HlmButton } from '@spartan-ng/helm/button';
import { HlmEmptyImports } from '@spartan-ng/helm/empty';
@Component({
selector: 'spartan-empty-rtl',
imports: [NgIcon, HlmButton, HlmEmptyImports],
providers: [provideIcons({ lucideFolderCode, lucideArrowUpRight })],
template: `
<hlm-empty [dir]="_dir()">
<hlm-empty-header>
<hlm-empty-media variant="icon">
<ng-icon name="lucideFolderCode" />
</hlm-empty-media>
<div hlmEmptyTitle>{{ _t()['title'] }}</div>
<div hlmEmptyDescription>
{{ _t()['description'] }}
</div>
</hlm-empty-header>
<hlm-empty-content class="flex-row justify-center gap-2">
<button hlmBtn>{{ _t()['createProject'] }}</button>
<button hlmBtn variant="outline">{{ _t()['importProject'] }}</button>
</hlm-empty-content>
<a href="#" hlmBtn class="text-muted-foreground" variant="link" size="sm">
{{ _t()['learnMore'] }}
<ng-icon name="lucideArrowUpRight" class="rtl:rotate-270" />
</a>
</hlm-empty>
`,
})
export class EmptyRtl {
private readonly _language = inject(TranslateService).language;
private readonly _translations: Translations = {
en: {
dir: 'ltr',
values: {
title: 'No Projects Yet',
description: "You haven't created any projects yet. Get started by creating your first project.",
createProject: 'Create Project',
importProject: 'Import Project',
learnMore: 'Learn More',
},
},
ar: {
dir: 'rtl',
values: {
title: 'لا توجد مشاريع بعد',
description: 'لم تقم بإنشاء أي مشاريع بعد. ابدأ بإنشاء مشروعك الأول.',
createProject: 'إنشاء مشروع',
importProject: 'استيراد مشروع',
learnMore: 'تعرف على المزيد',
},
},
he: {
dir: 'rtl',
values: {
title: 'אין פרויקטים עדיין',
description: 'עדיין לא יצרת פרויקטים. התחל על ידי יצירת הפרויקט הראשון שלך.',
createProject: 'צור פרויקט',
importProject: 'ייבא פרויקט',
learnMore: 'למד עוד',
},
},
};
private readonly _translation = computed(() => this._translations[this._language()]);
protected readonly _t = computed(() => this._translation().values);
protected readonly _dir = computed(() => this._translation().dir);
}Helm API
HlmEmptyContent
Selector: [hlmEmptyContent],hlm-empty-content
ExportAs: hlmEmptyContent
HlmEmptyDescription
Selector: [hlmEmptyDescription]
ExportAs: hlmEmptyDescription
HlmEmptyHeader
Selector: [hlmEmptyHeader],hlm-empty-header
ExportAs: hlmEmptyHeader
HlmEmptyMedia
Selector: [hlmEmptyMedia],hlm-empty-media
ExportAs: hlmEmptyMedia
Inputs
| Prop | Type | Default | Description |
|---|---|---|---|
| variant | EmptyMediaVariants['variant'] | - | - |
HlmEmptyTitle
Selector: [hlmEmptyTitle]
ExportAs: hlmEmptyTitle
HlmEmpty
Selector: [hlmEmpty],hlm-empty
ExportAs: hlmEmpty
On This Page