v0.3.2 ready

CHANGELOG.md

@@ -1,3 +1,12 @@
+## [0.3.2] - April 13, 2020
+
+- Added VxTextDropDown Widget with textDropDown() ext.
+- Added VxRandomBox Widget with randomBox() ext.
+- Added Vx.log(), Vx.inspect() utilities.
+- Added Vx.isReleaseMode, Vx.isProfileMode, Vx.isDebugMode, Vx.isWeb utilities..
+- Example App updated.
+- Bug Fixes
+
 ## [0.3.1] - April 10, 2020
 
 - Added VxSwiper Widget with swiper() ext.

example/lib/main.dart

@@ -12,6 +12,7 @@ void main() => runApp(MaterialApp(
 class Demo extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
+ Vx.inspect("message");
  return Scaffold(
  appBar: VxAppBar(
  searchBar: true,
@@ -81,6 +82,14 @@ class Demo extends StatelessWidget {
  ["Decimal Item 1", "Decimal Item 2"],
  primary: false,
  ),
+ ["Item 1", "Item 2", "Item 3"]
+ .textDropDown(
+ selectedValue: "Item 1",
+ onChanged: (value) {
+ Vx.log(value);
+ },
+ )
+ .make(),
  ]).p16().scrollVertical(),
  );
  }

example/pubspec.lock

@@ -108,7 +108,7 @@ packages:
  name: petitparser
  url: "https://pub.dartlang.org"
  source: hosted
- version: "3.0.2"
+ version: "2.4.0"
  quiver:
  dependency: transitive
  description:
@@ -190,6 +190,6 @@ packages:
  name: xml
  url: "https://pub.dartlang.org"
  source: hosted
- version: "3.7.0"
+ version: "3.6.1"
 sdks:
- dart: ">=2.7.0 <3.0.0"
+ dart: ">=2.6.0 <3.0.0"

lib/src/flutter/drop_down_button.dart

@@ -11,44 +11,46 @@
  * limitations under the License.
  */
 
+import 'package:flutter/material.dart';
 import 'package:velocity_x/src/flutter/builder.dart';
 import 'package:velocity_x/src/velocity_x_extensions.dart';
-import 'package:flutter/material.dart';
 
-class VxDropDownButton extends VxWidgetBuilder<StatefulBuilder> {
- VxDropDownButton(
+class VxTextDropDown extends VxWidgetBuilder<StatefulBuilder> {
+ VxTextDropDown(
  this._items, {
- @required this.valueHolder,
- }) : assert(valueHolder != null);
+ @required this.selectedValue,
+ @required this.onChanged,
+ }) : assert(selectedValue != null),
+ assert(onChanged != null);
 
  /// The List<String> used to create [DropdownMenuItem].
  ///
  /// _items can't be null.
  final List<String> _items;
 
- /// The value used to define currently selected value of [VxDropDownButton].
- String valueHolder;
+ /// The value used to define currently selected value of [VxTextDropDown].
+ String selectedValue;
 
  /// Defines the [TextStyle] for [DropdownMenuItem].
  ///
  /// By default the value of `_textStyle` is [TextTheme.subhead]
  /// value of the current [ThemeData.textTheme].
  TextStyle _textStyle;
 
- /// Defines the widget used to draw underline for [VxDropDownButton]
+ /// Defines the widget used to draw underline for [VxTextDropDown]
  Widget _underLine;
 
  /// Defines the elevation for menu when drop down is open.
  ///
  /// By default, the value of `_elevation` is 8.
  int _elevation;
 
- /// Defines the size of [VxDropDownButton] icon.
+ /// Defines the size of [VxTextDropDown] icon.
  ///
  /// By default, the value of `_iconSize` is 24.
  double _iconSize;
 
- /// The [Icon] used for [VxDropDownButton].
+ /// The [Icon] used for [VxTextDropDown].
  ///
  /// By default, the icon is [Icons.arrow_drop_down]
  Icon _dropDownIcon;
@@ -67,7 +69,7 @@ class VxDropDownButton extends VxWidgetBuilder<StatefulBuilder> {
  /// The color for the button's Material when it has the input focus.
  Color _focusColor;
 
- /// If the `_autoFocus` is true, [VxDropDownButton] will be selected as the initial focus when no other node
+ /// If the `_autoFocus` is true, [VxTextDropDown] will be selected as the initial focus when no other node
  /// in its scope is currently focused.
  bool _autoFocus = false;
 
@@ -80,43 +82,42 @@ class VxDropDownButton extends VxWidgetBuilder<StatefulBuilder> {
  bool _isDense = false;
 
  /// Called when user selects a value from drop down menu.
- ValueChanged<String> _onValueChange;
-
+ ValueChanged<String> onChanged;
 
- VxDropDownButton textStyle(TextStyle style) => this.._textStyle = style;
+ VxTextDropDown textStyle(TextStyle style) => this.._textStyle = style;
 
- VxDropDownButton underLine(Widget widget) => this.._underLine = widget;
+ VxTextDropDown underLine(Widget widget) => this.._underLine = widget;
 
- VxDropDownButton elevation(int val) => this.._elevation = val;
+ VxTextDropDown elevation(int val) => this.._elevation = val;
 
- VxDropDownButton iconSize(double val) => this.._iconSize = val;
+ VxTextDropDown iconSize(double val) => this.._iconSize = val;
 
- VxDropDownButton icon(Icon _icon) => this.._dropDownIcon = _icon;
+ VxTextDropDown icon(Icon _icon) => this.._dropDownIcon = _icon;
 
- VxDropDownButton disabledIconColor(Color color) =>
+ VxTextDropDown disabledIconColor(Color color) =>
  this.._disabledIconColor = color;
 
- VxDropDownButton enabledIconColor(Color color) =>
+ VxTextDropDown enabledIconColor(Color color) =>
  this.._enabledIconColor = color;
 
- VxDropDownButton get autoFocus => this.._autoFocus = true;
+ VxTextDropDown get autoFocus => this.._autoFocus = true;
 
- VxDropDownButton get isExpanded => this.._isExpanded = true;
+ VxTextDropDown get isExpanded => this.._isExpanded = true;
 
- VxDropDownButton get isDense => this.._isDense = true;
+ VxTextDropDown get isDense => this.._isDense = true;
 
- VxDropDownButton focusColor(Color color) => this.._focusColor = color;
+ VxTextDropDown focusColor(Color color) => this.._focusColor = color;
 
- VxDropDownButton onChange(ValueChanged<String> function) =>
- this.._onValueChange = function;
+// VxTextDropDown onChange(ValueChanged<String> function) =>
+// this..onChanged = function;
 
  @override
  StatefulBuilder make({Key key}) {
  return StatefulBuilder(
  builder: (BuildContext context, StateSetter setState) {
  return DropdownButton<String>(
  key: key,
- value: valueHolder,
+ value: selectedValue,
  style: _textStyle,
  underline: _underLine,
  iconEnabledColor: _enabledIconColor,
@@ -136,9 +137,9 @@ class VxDropDownButton extends VxWidgetBuilder<StatefulBuilder> {
  .toList(),
  onChanged: (String value) {
  setState(() {
- valueHolder = value;
+ selectedValue = value;
  });
- _onValueChange(value);
+ onChanged(value);
  },
  );
  },
@@ -147,6 +148,9 @@ class VxDropDownButton extends VxWidgetBuilder<StatefulBuilder> {
 }
 
 extension DropDownExtension on List<String> {
- VxDropDownButton dropDown({@required String value}) =>
- VxDropDownButton(this, valueHolder: value);
+ /// The [value] should be a part of the list of strings.
+ VxTextDropDown textDropDown(
+ {@required String selectedValue,
+ @required ValueChanged<String> onChanged}) =>
+ VxTextDropDown(this, selectedValue: selectedValue, onChanged: onChanged);
 }

lib/src/flutter/random.dart

@@ -0,0 +1,58 @@
+import 'dart:math';
+
+import 'package:flutter/material.dart';
+
+mixin _RandomColor {
+ static final Random _random = Random();
+
+ /// Returns a random color.
+ static Color next() {
+ return Color(0xFF000000 + _random.nextInt(0x00FFFFFF));
+ }
+}
+
+/// A Container Widget that takes up a given [width] and [height] and paints itself with a
+/// random color.
+class VxRandomBox extends StatefulWidget {
+ final double width;
+ final double height;
+ final Widget child;
+ final bool changeOnRedraw;
+
+ const VxRandomBox(
+ {this.width, this.height, this.child, this.changeOnRedraw = true});
+
+ @override
+ _VxRandomBoxState createState() => _VxRandomBoxState();
+}
+
+class _VxRandomBoxState extends State<VxRandomBox> {
+ Color _randomColor;
+
+ @override
+ void initState() {
+ super.initState();
+ _randomColor = _RandomColor.next();
+ }
+
+ @override
+ Widget build(BuildContext context) {
+ return Container(
+ width: widget.width,
+ height: widget.height,
+ color: widget.changeOnRedraw == true ? _RandomColor.next() : _randomColor,
+ child: widget.child,
+ );
+ }
+}
+
+extension RandomContainerWidgetExtension on Widget {
+ VxRandomBox randomBox(
+ {double width, double height, bool changeOnRedraw = true}) =>
+ VxRandomBox(
+ child: this,
+ height: height,
+ width: width,
+ changeOnRedraw: changeOnRedraw,
+ );
+}

lib/src/flutter/widgets.dart

@@ -38,13 +38,17 @@ extension WidgetsExtension on Widget {
  child: this,
  );
 
- ///Hide a widget
- Widget hide({Key key, bool isVisible = false, bool maintainSize = false}) => Visibility(
+ ///Hides a widget
+ Widget hide({Key key, bool isVisible = false, bool maintainSize = false}) =>
+ Visibility(
  key: key,
  child: this,
  visible: isVisible,
  maintainSize: maintainSize,
  maintainAnimation: maintainSize,
  maintainState: maintainSize,
  );
+
+ /// Widget to show exception
+ Widget errorWidget(Object ex) => ErrorWidget(ex);
 }

lib/src/velocity_x_extensions.dart

@@ -11,6 +11,7 @@
  * limitations under the License.
  */
 
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/rendering.dart';
 import 'package:velocity_x/src/flutter/selectable_text.dart';

lib/src/velocity_xx.dart

@@ -11,6 +11,10 @@
  * limitations under the License.
  */
 
+import 'dart:async';
+import 'dart:developer' as dev;
+
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 
 mixin Vx {
@@ -299,6 +303,54 @@ mixin Vx {
  static ShapeBorder withRounded(double radius) =>
  RoundedRectangleBorder(borderRadius: BorderRadius.circular(radius));
 
+ // Emit a log event.
+ ///
+ /// This function was designed to map closely to the logging information
+ /// collected by `package:logging`.
+ ///
+ /// - [message] is the log message
+ /// - [time] (optional) is the timestamp
+ /// - [sequenceNumber] (optional) is a monotonically increasing sequence number
+ /// - [level] (optional) is the severity level (a value between 0 and 2000); see
+ /// the `package:logging` `Level` class for an overview of the possible values
+ /// - [name] (optional) is the name of the source of the log message
+ /// - [zone] (optional) the zone where the log was emitted
+ /// - [error] (optional) an error object associated with this log event
+ /// - [stackTrace] (optional) a stack trace associated with this log event
+ static void log(String message,
+ {DateTime time,
+ int sequenceNumber,
+ int level = 0,
+ String name = '',
+ Zone zone,
+ Object error,
+ StackTrace stackTrace}) =>
+ dev.log(message,
+ error: error,
+ level: level,
+ name: name,
+ sequenceNumber: sequenceNumber,
+ stackTrace: stackTrace,
+ time: time,
+ zone: zone);
+
+ /// Send a reference to [object] to any attached debuggers.
+ ///
+ /// Debuggers may open an inspector on the object. Returns the argument.
+ static void inspect(Object object) => dev.inspect(object);
+
+ ///Checks whether release mode or not
+ bool get isReleaseMode => kReleaseMode;
+
+ ///Checks whether debug mode or not
+ bool get isDebugMode => kDebugMode;
+
+ ///Checks whether profile mode or not
+ bool get isProfileMode => kProfileMode;
+
+ ///Checks whether profile mode or not
+ bool get isWeb => kIsWeb;
+
  /// Get color from the hex value
  static Color hexToColor(String code) {
  return Color(int.parse(code.substring(1, 7), radix: 16) + 0xFF000000);

lib/velocity_x.dart

@@ -18,6 +18,7 @@ export 'src/flutter/list.dart';
 export 'src/flutter/object.dart';
 export 'src/flutter/opacity.dart';
 export 'src/flutter/padding.dart';
+export 'src/flutter/random.dart';
 export 'src/flutter/rich_text.dart';
 export 'src/flutter/scroll.dart';
 export 'src/flutter/selectable_text.dart';

pubspec.lock

@@ -108,7 +108,7 @@ packages:
  name: petitparser
  url: "https://pub.dartlang.org"
  source: hosted
- version: "3.0.2"
+ version: "2.4.0"
  quiver:
  dependency: transitive
  description:
@@ -183,6 +183,6 @@ packages:
  name: xml
  url: "https://pub.dartlang.org"
  source: hosted
- version: "3.7.0"
+ version: "3.6.1"
 sdks:
- dart: ">=2.7.0 <3.0.0"
+ dart: ">=2.6.0 <3.0.0"

pubspec.yaml

@@ -1,6 +1,6 @@
 name: velocity_x
 description: A minimalist Flutter framework for rapidly building custom designs.
-version: 0.3.1
+version: 0.3.2
 homepage: https://velocityx.dev
 repository: https://github.com/iampawan/VelocityX