New feature and update goldens

.gitignore

@@ -28,3 +28,4 @@ migrate_working_dir/
 .dart_tool/
 build/
 test/failures
+/example/multiexample/

CHANGELOG.md

@@ -1,3 +1,6 @@
+## 1.6.0
+- New feature `selectAllOption`, You will have a default option to select all the items on your list.
+
 ## 1.5.5
 - Some format tweaks.
 - Update to `withValues` on colors.

README.md

@@ -31,7 +31,7 @@ Add the dependency to your `pubspec.yaml` file:
 
 ```yaml
 dependencies:
-  multiselect_field: ^1.5.5
+  multiselect_field: ^1.6.0
 ```
 
 Then, install the dependencies using:

lib/core/chip_multiselect_field.dart

@@ -47,7 +47,7 @@ final class ChipMultiselectField extends StatelessWidget {
       shape: RoundedRectangleBorder(
         borderRadius: BorderRadius.circular(5),
         side: BorderSide(
-          color: Colors.grey.withValues(alpha: 255 * 0.3),
+          color: Colors.grey.withValues(alpha: 255 * 0.4),
           style: BorderStyle.solid,
           width: 0.5,
           strokeAlign: 0.5,
@@ -56,7 +56,7 @@ final class ChipMultiselectField extends StatelessWidget {
       deleteIcon: Align(
         alignment: Alignment.center,
         child: Icon(Icons.close,
-            size: 15, color: Colors.grey.withValues(alpha: 255 * 0.5)),
+            size: 15, color: Colors.grey.withValues(alpha: 255 * 0.7)),
       ),
       onDeleted: onDeleted,
     );

lib/core/multi_select.dart

@@ -112,6 +112,8 @@ class MultiSelectField<T> extends StatefulWidget {
   final String? label;
   final TextStyle? textStyleLabel;
 
+  final bool selectAllOption;
+
   const MultiSelectField({
     super.key,
     required this.data,
@@ -138,6 +140,7 @@ class MultiSelectField<T> extends StatefulWidget {
     this.titleMenuStyle,
     this.textStyleSingleSelection,
     this.cleanCurrentSelection = false,
+    this.selectAllOption = false,
     this.label,
     this.textStyleLabel,
   });
@@ -169,10 +172,17 @@ class _MultiSelectFieldState<T> extends State<MultiSelectField<T>>
 
   /// It helps to show the complete list of elements after selecting an element using the text filter.
   bool _onSelected = false;
+  bool _selectAllActive = false;
+
+  List<Choice<T>> get _cleanData => widget
+      .data()
+      .where((ele) => ele.key != null || ele.key!.isNotEmpty)
+      .toList();
 
   @override
   void initState() {
     super.initState();
+
     if (widget.defaultData != null && widget.defaultData!.isNotEmpty) {
       _selectedChoice.clear();
       _selectedChoice.addAll(widget.defaultData!);
@@ -215,6 +225,15 @@ class _MultiSelectFieldState<T> extends State<MultiSelectField<T>>
       _selectedChoice.clear();
     }
 
+    /// Verification for select all data, if you select one per one and you have select all option, you nee to si is you're selected all data.
+    bool equalData = isSameData(_selectedChoice, widget.data());
+
+    if (equalData) {
+      _selectAllActive = true;
+    } else if (_selectAllActive && widget.selectAllOption && !equalData) {
+      _selectAllActive = false;
+    }
+
     super.didUpdateWidget(oldWidget);
   }
 
@@ -413,28 +432,55 @@ class _MultiSelectFieldState<T> extends State<MultiSelectField<T>>
                 ),
               ),
               menuChildren: [
+                if (widget.selectAllOption)
+                  Padding(
+                    padding: const EdgeInsets.only(top: 5),
+                    child: CheckboxMenuButton(
+                      value: _selectAllActive,
+                      onChanged: (vale) {
+                        _selectAllActive = !_selectAllActive;
+
+                        _selectedChoice = _selectAllActive ? _cleanData : [];
+                        widget.onSelect(_selectedChoice, false);
+                      },
+                      child: Text("All"),
+                    ),
+                  ),
                 ..._onFilteredChoice
                     .where((element) => element.value.isNotEmpty)
                     .map(
                   (result) {
                     bool isGroupingTitle =
                         result.key == null || result.key!.isEmpty;
                     return SizedBox(
-                      width:
-                          widget.menuWidthBaseOnContent ? null : size.maxWidth,
+                      width: widget.menuWidthBaseOnContent
+                          ? null
+                          : widget.selectAllOption
+                              ? (size.maxWidth - 10)
+                              : size.maxWidth,
                       child: MenuItemButton(
                         closeOnActivate:
                             widget.singleSelection || widget.data().length == 1,
                         key: (!isGroupingTitle && _isSelected(result)) &&
                                 _selectedChoice.indexOf(result) == 0
                             ? _selectedItemKey
                             : null,
-                        trailingIcon: (!isGroupingTitle && _isSelected(result))
-                            ? const Icon(
-                                Icons.check,
-                                color: Colors.green,
-                                size: 12,
-                              )
+                        trailingIcon: !widget.selectAllOption
+                            ? (!isGroupingTitle && _isSelected(result))
+                                ? const Icon(
+                                    Icons.check,
+                                    color: Colors.green,
+                                    size: 12,
+                                  )
+                                : null
+                            : null,
+                        leadingIcon: widget.selectAllOption && !isGroupingTitle
+                            ? (_isSelected(result))
+                                ? const Icon(
+                                    Icons.check_box,
+                                    color: Colors.green,
+                                  )
+                                : Icon(Icons.check_box_outline_blank)
                             : null,
                         style: widget.buttonStyle ??
                             ButtonStyle(
@@ -489,6 +535,10 @@ class _MultiSelectFieldState<T> extends State<MultiSelectField<T>>
                   MenuStyle(
                     elevation: const WidgetStatePropertyAll<double>(5),
                     visualDensity: VisualDensity.adaptivePlatformDensity,
+                    padding: widget.selectAllOption
+                        ? WidgetStatePropertyAll<EdgeInsets>(
+                            EdgeInsets.only(left: 10))
+                        : null,
                     maximumSize: widget.menuWidthBaseOnContent &&
                             widget.menuHeightBaseOnContent
                         ? null
@@ -591,7 +641,7 @@ class _MultiSelectFieldState<T> extends State<MultiSelectField<T>>
       widget.onSelect(_selectedChoice, false);
 
       /// Clean filtering
-      _onFilteredChoice = widget.data();
+      _onFilteredChoice = _cleanData;
 
       // Update the UI with the latest state.
       setState(() {});
@@ -700,3 +750,9 @@ class Choice<T> {
   @override
   int get hashCode => Object.hash(key, value, metadata);
 }
+
+bool isSameData<T>(List<Choice<T>> list1, List<Choice<T>> list2) {
+  if (list1.length != list2.length) return false;
+
+  return Set.from(list1).containsAll(list2);
+}

pubspec.yaml

@@ -1,6 +1,6 @@
 name: multiselect_field
 description: "A flexible dropdown field supporting single/multiple selection modes, styles, titles, etc"
-version: 1.5.5
+version: 1.6.0
 homepage: https://github.com/JhonaCodes/multiselect_field.git
 
 environment: