flutter_text_divider 0.1.2

A Flutter widget that renders a divider with a text label centred between two lines.

text_divider

A Flutter package providing a TextDivider widget that displays a text label centred between two lines.

Supports both horizontal and vertical orientations and integrates with Flutter's ThemeData / DividerThemeData out of the box.

---

Features

• Horizontal and vertical orientations via axis: Axis.horizontal / Axis.vertical
• Inherits line colour and thickness from DividerThemeData / ThemeData
• Inherits text style from TextTheme.bodyMedium
• Configurable gap, indent, endIndent, and custom colours / styles
• height / width parameters mirror Divider.height and VerticalDivider.width for proper spacing

---

Usage

Horizontal (default)

import 'package:text_divider/text_divider.dart';

// Minimal
const TextDivider(text: 'or')

// Customised
TextDivider(
  text: 'or',
  color: Colors.grey,
  thickness: 1.5,
  gap: 12,
  indent: 16,
  endIndent: 16,
  textStyle: const TextStyle(fontSize: 14, color: Colors.grey),
)

Vertical

The widget must be placed inside a parent with a bounded height (e.g. a SizedBox, Expanded, or a Column with constrained height).

SizedBox(
  height: 200,
  child: TextDivider(
    text: 'or',
    axis: Axis.vertical,
    color: Colors.grey,
    thickness: 1.5,
    gap: 12,
  ),
)

---

Parameters

Parameter	Type	Default	Description
text	String	required	Label shown in the centre of the divider.
axis	Axis	Axis.horizontal	Orientation of the dividing lines.
textStyle	TextStyle?	bodyMedium	Style applied to text.
color	Color?	theme default	Colour of the dividing lines.
thickness	double	1.0	Thickness of each line. Must be > 0.
gap	double	8.0	Space between the text and each line.
indent	double	0.0	Leading space (left for horizontal, top for vertical).
endIndent	double	0.0	Trailing space (right for horizontal, bottom for vertical).
height	double?	16.0	Total vertical extent of a horizontal divider (like Divider.height).
width	double?	16.0	Total horizontal extent of a vertical divider (like VerticalDivider.width).
fallbackLineLength	double	40.0	Fixed line length when inside unbounded constraints.

---

Getting started

Add the dependency to your pubspec.yaml:

dependencies:
  text_divider: ^0.1.0

Then run:

flutter pub get