Search packages, repositories and app categories

dotted_line cover
Package detailsv3.3.0

dotted_line

This package allows you to draw dotted lines with Flutter. You can draw a beautiful dotted line.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
194K
Likes
328
Pub points
160

Install package

flutter pub add dotted_line

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

The dotted_line package enables developers to easily create visually appealing dotted lines in Flutter applications. It provides a simple and customizable way to draw dashed or dotted lines across various UI elements, enhancing the design of interfaces with minimal code. The package supports multiple platforms including Android, iOS, Web, macOS, Windows, and Linux, making it versatile for cross-platform development. With intuitive configuration options, it's ideal for adding separators, dividers, or decorative elements in modern app designs.

Use cases

  • Creating visual separators in lists
  • Designing custom dividers in forms
  • Enhancing UI with decorative line elements
  • Building responsive layouts with dashed borders
  • Adding stylistic accents in card components

Key features

  • Easy integration with Flutter widgets
  • Customizable dot size and spacing
  • Support for both horizontal and vertical lines
  • Cross-platform compatibility
  • Lightweight and performant
  • Configurable stroke color and width

Suitable for

  • UI designers seeking decorative elements
  • Developers building clean, modern interfaces
  • Projects requiring consistent visual styling
  • Apps with need for subtle graphical accents
  • Cross-platform Flutter applications

Considerations

  • Limited to line-based decorations only
  • No support for animated dots
  • Requires manual handling of alignment in complex layouts
  • Not suitable for high-performance drawing scenarios
  • Depends on Flutter's rendering pipeline for smooth display

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

logo.png


About

This package allows you to draw dotted lines with Flutter.

screenshot.png

Usage

Parameter Default Description
direction Axis.horizontal The direction of the entire dotted line.
alignment WrapAlignment.center The alignment of the entire dotted line.
lineLength double.infinity The length of the entire dotted line.
lineThickness 1.0 The thickness of the entire dotted line.
dashLength 4.0 The length of the dash.
dashColor Colors.black The color of the dash.
dashGradient null The gradient colors of the dash.
dashRadius 0.0 The radius of the dash.
dashGapLength 4.0 The length of the dash gap.
dashGapColor Colors.transparent The color of the dash gap.
dashGapGradient null The gradient colors of the dash gap.
dashGapRadius 0.0 The radius of the dash gap.
addRepaintBoundary false Whether to wrap the dotted line with a RepaintBoundary.

This can be used without parameters.

import 'package:dotted_line/dotted_line.dart';

DottedLine()

You can also customize by specifying parameters.

import 'package:dotted_line/dotted_line.dart';

DottedLine(
  direction: Axis.horizontal,
  alignment: WrapAlignment.center,
  lineLength: double.infinity,
  lineThickness: 1.0,
  dashLength: 4.0,
  dashColor: Colors.black,
  dashGradient: [Colors.red, Colors.blue],
  dashRadius: 0.0,
  dashGapLength: 4.0,
  dashGapColor: Colors.transparent,
  dashGapGradient: [Colors.red, Colors.blue],
  dashGapRadius: 0.0,
  addRepaintBoundary: true,
)

Performance Optimization

If your DottedLine is placed inside a widget that rebuilds frequently, you might experience performance issues (dropped frames) because the dashes and gaps are constantly repainted.

In such cases, setting addRepaintBoundary: true can improve performance by wrapping the DottedLine in a RepaintBoundary, isolating its paint step.

Note: The default is false to prevent unexpected memory overhead. Keep it false if you are displaying hundreds of dotted lines (e.g., in a large list) to avoid excessive memory usage.

Example

The sample code can be found under the example package. You can try changing all parameters.

Categories

Source repository

Projects using this package