Primitives

Separator

The separator primitive allow you to semantically separate content either horizontally or vertically.

Import

Import the Separator primitives from ng-primitives/separator.

import { NgpSeparator } from 'ng-primitives/separator';

Usage

Assemble the separator directives in your template.

<div ngpSeparator></div>

Reusable Component

Create a reusable component that uses the NgpSeparator directive.

Schematics

Generate a reusable separator component using the Angular CLI.

ng g ng-primitives:primitive separator

Options

  • path: The path at which to create the component file.
  • prefix: The prefix to apply to the generated component selector.
  • componentSuffix: The suffix to apply to the generated component class name.
  • fileSuffix: The suffix to apply to the generated component file name. Defaults to component.
  • exampleStyles: Whether to include example styles in the generated component file. Defaults to true.

API Reference

The following directives are available to import from the ng-primitives/separator package:

NgpSeparator

Data Attributes

Attribute Description
data-orientation The orientation of the separator.

Global Configuration

You can configure the default options for all separators in your application by using the provideSeparatorConfig function in a providers array.

import { provideSeparatorConfig } from 'ng-primitives/tabs';

bootstrapApplication(AppComponent, {
  providers: [
    provideSeparatorConfig({
      orientation: 'horizontal',
    }),
  ],
});

NgpSeparatorConfig

The following options are available to configure the default tab options:

Define the default orientation of the separator. Accessibility

Adheres to the WAI-ARIA Separator Design Pattern.

Copyright © 2026 Angular Primitives

This site is powered by Netlify