Layout

Divider

A horizontal separator, plain or with a centered label such as "or".

JxDivider import 'package:jx_cli/ui.dart' Available since 0.0.2

Preview


When to use it

  • Between sign-in methods ("or").
  • Between sections of a menu or a form.

Minimal example

Dart
JxDivider()
JxDivider(label: 'or')

Complete example

A full Jaspr component you can paste into a project.

Dart
import 'package:jaspr/dom.dart';
import 'package:jaspr/jaspr.dart';
import 'package:jx_cli/ui.dart';

class SignIn extends StatelessComponent {
  const SignIn({super.key});

  @override
  Component build(BuildContext context) {
    return div(classes: 'flex fd:col gap:4 mw:[24rem]', [
      const JxButton(variant: JxButtonVariant.outline, fullWidth: true, [.text('Continue with GitHub')]),
      const JxDivider(label: 'or'),
      const JxTextField(id: 'email', label: 'Email', type: InputType.email),
      const JxButton(fullWidth: true, [.text('Send a sign-in link')]),
    ]);
  }
}

Properties

Property Type Default Description
label String? null Centered text. Without it, the divider is an <hr> .
classes String? null Extra JX classes, appended after the component classes.

Customizing

  • Pass classes to add or override utilities: they come last, so classes: 'w:full' wins over the default width.
  • Space it with margins: classes: 'my:8'.

Accessibility

  • Without a label it is an <hr>, announced as a separator.
  • With a label it carries role="separator"; the lines are hidden from screen readers and the label is read.