accessibility_tools

Checkers and tools to ensure your app is accessible to all. Ensures your app is accessible from day one, by checking your interface as you build it.


License
MIT

Documentation

accessibility_tools

Checkers and tools to ensure your app is accessible to all.

Creating an accessible app is incredibly important. But too often it's forgotten about, or left to later. This package ensures your app is accessible from day one, by checking your interface as you build it.

A screenshot showing an icon with two failed accessibility checks: the tooltip reads "Tap area is missing a semantic label" and "Tap area of 40x40 is too small: should be at least 48×48"

To show the issue tooltip, hover over the widget or long-press it.

From Rebel App Studio

pub License: MIT codecov

Getting Started

Add AccessibilityTools to your app's builder property:

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      // *** Add the line below ***
      builder: (context, child) => AccessibilityTools(child: child),
      home: HomePage(),
    );
  }
}

The tools only run in debug mode, and are compiled out of release builds.

Current accessibility checkers

Semantic label checker

Ensures buttons (and other tappable widgets) have an associated semantic label.

For example, this icon button is missing a label:

IconButton(
  onPressed: () => login(),
  icon: Icon(Icons.person),
)

Adding a semantic label would fix this: Icon(Icons.person, semanticLabel: 'Login').

Tap area checker

Makes sure all tappable widgets are large enough to easily tap. Defaults to the Material Design minimum of 48x48 on mobile devices, and 44x44 on desktop devices.

Large font overflow checker

Experimental: ensures that no flex widgets, such as Column and Row, overflow when a user is using larger font sizes. This checker is experimental, and disabled by default, and can be enabled via AccessibilityTools(checkFontOverflows: true).

Input label checker

Makes sure text fields (TextField, TextFormField, Autocomplete etc) and inputs (Checkbox, Radio, Switch etc) have semantic labels.

Configuration

Checkers are enabled or disabled with properties on the AccessibilityTools widget:

AccessibilityTools(
  // Set to null to disable tap area checking
  minimumTapAreas: MinimumTapAreas.material,
  // Check for semantic labels
  checkSemanticLabels: false,
  // Check for flex overflows
  checkFontOverflows: true,
  child: child,
)