flutter_screwdriver 3.2.0

A flutter package aiming to provide useful extensions and helper functions to ease and speed up development.

example/example.md

📝 Examples

import 'package:flutter_screwdriver/flutter_screwdriver.dart';

'#FF4433'.toColor(); // returns Color object
context.theme; // short for Theme.of(context)
myConfirmationView.showAsDialog(context);
homeRoute.push(context); // short for Navigation.of(context).push(homeRoute);
closeApp(); // closes the app

Colors.red.hexString; // converts to hex string
Color(0xFF4433).toMaterialColor(); // converts given color to material color with standard shades
Color(0xFF4433).shade(300); // creates white based shades of given color
Colors.red.tweenTo(Colors.blue); // creates ColorTween

State and Context Extensions

Access common inherited widgets directly from state.

theme; // Short for Theme.of(context)
mediaQuery; // Short for MediaQuery.of(context)
focusScope; // Short for FocusScope.of(context)
navigator; // Short for Navigator.of(context)
hideKeyboard(); // hides soft input keyboard

context.theme;
context.mediaQuery;
context.focusScope;
context.navigator;
context.hideKeyboard();

TextEditingController

emailController.trimmed;
emailController.isBlank;
emailController.onChanged((value) => print(value));
emailController.onSelectionChanged((selection) => print(selection));
emailController.textChanges(); // Returns a Stream<String>
emailController.selectionChanges(); // Returns a Stream<TextSelection>

Routes

FadeScalePageRoute();
FadeThroughPageRoute();
SharedAxisPageRoute();

Hiding keyboard when clicked outside tap-able views

import 'package:flutter_screwdriver/flutter_screwdriver.dart';


HideKeyboard(
  MaterialApp(
    theme: ThemeData.light(),
    debugShowCheckedModeBanner: false,
    home: Scaffold(
      body: MyWidget(),
    ),
  ),
);

Clearing focus when navigation happens (mainly to close keyboard if visible)

import 'package:flutter_screwdriver/flutter_screwdriver.dart';

MaterialApp(
  theme: ThemeData.light(),
  debugShowCheckedModeBanner: false,
  navigatorObservers: [
    ClearFocusNavigatorObserver(),
  ],
  home: Scaffold(
    body: MyWidget(),
  ),
);

Using TickingWidget

Do you have a widget that needs to repaint as time passes? e.g. clocks, countdowns, etc. Use TickingWidget to create such widgets.

import 'package:flutter_screwdriver/flutter_screwdriver.dart';

TickingWidget(
  mode: TickingMode.seconds, // Specify when to repaint.
  autoStart: true, // Start the timer automatically. Default is true.
  builder: (context, time, child) {
    // Widget that needs to repaint.
    return Text(time.toString());
  },
  child: Text("Widget that doesn't need to repaint"),
);

Custom start and stop

autoStart is set to true by default. If you want to start the timer manually, set it to false and inside the builder, call start() by doing TickingWidget.of(context).startTicker().

Using elapsed duration

TickerWidget provides the elapsed duration since the start of the timer. You can access it using TickingWidget.of(context).elapsedDuration inside the builder.

import 'package:flutter_screwdriver/flutter_screwdriver.dart';

TickingWidget(
  mode: TickingMode.seconds,
  autoStart: true,
  builder: (context, time, child) {
    final elapsed = TickingWidget.of(context).elapsedDuration;
    return Text("Elapsed: $elapsed");
  },
  child: Text("Widget that doesn't need to repaint"),
);

Adding ticking to existing widgets

You can add ticking to existing stateful widgets using TickingStateMixin. The condition is that the state of the widget should be using either TickerProviderStateMixin or SingleTickerProviderStateMixin. For implementation details, look into TickingWidget source code.

Checkout [documentation][docs]