flutter_randomcolor | Flutter package (original) (raw)

RandomColor for Dart & Flutter #

Generate visually appealing random colors with ease in your Dart and Flutter projects.

Table of Contents #

Features
Installation
Quick Start
Usage Guide
API Reference
Examples
Contributing
License
Acknowledgements
Generate random colors with fine-tuned control
Specify color types, luminosity, and output formats
Direct integration with Flutter's Color class
Highly customizable with easy-to-use API
Consistent results across platforms

Add this to your package's pubspec.yaml file:

dependencies:
  flutter_randomcolor: ^1.0.16

Then run:

$ flutter pub get

import 'package:flutter_randomcolor/flutter_randomcolor.dart';

// Generate a random color
var color = RandomColor.getColor(Options());

// Generate a Flutter Color object
Color flutterColor = RandomColor.getColorObject(Options());

Generate a random color with default options:

var color = RandomColor.getColor(Options());

Get a Color object for direct use in Flutter widgets:

Color widgetColor = RandomColor.getColorObject(Options(
  colorType: ColorType.blue,
  luminosity: Luminosity.light,
));

// Use in a widget
Container(
  color: widgetColor,
  child: Text('Colored Container'),
)

Fine-tune your color generation:

var customColor = RandomColor.getColor(Options(
  colorType: [ColorType.red, ColorType.blue],
  luminosity: Luminosity.dark,
  format: Format.rgba,
  alpha: 0.8,
));

`RandomColor.getColor(Options options)` #

Returns a color based on the specified options.

`RandomColor.getColorObject(Options options)` #

Returns a Flutter Color object based on the specified options.

colorType: ColorType or List<ColorType>
luminosity: Luminosity
format: Format
alpha: double (0.0 to 1.0)
count: int

ColorType

random, monochrome, red, orange, yellow, green, blue, purple, pink

Luminosity

random, dark, light, bright

Format

rgba, rgb, rgbArray, hsla, hex, hsl, hsva, hsvArray, hslArray

// Bright green color in hex format
var brightGreen = RandomColor.getColor(Options(
  colorType: ColorType.green,
  luminosity: Luminosity.bright,
  format: Format.hex
));

// Array of 5 pastel colors
var pastelColors = RandomColor.getColor(Options(
  luminosity: Luminosity.light,
  count: 5
));

// Dark red or blue with 50% opacity
var transparentDark = RandomColor.getColor(Options(
  colorType: [ColorType.red, ColorType.blue],
  luminosity: Luminosity.dark,
  format: Format.rgba,
  alpha: 0.5
));


// Flutter Color with seed options to return the same color
var seedColor = RandomColor.getColorObject(Options(
  colorType: ColorType.red,
  luminosity: Luminosity.dark,
  format: Format.hex,
  seed: 1234
));

We welcome contributions! Please see our Contributing Guide for more details.

This project is licensed under the MIT License - see the LICENSE file for details.

Original JavaScript implementation by David Merfield
Dart port maintained by DAMMAK

Available in Other Languages