Version 1.9.0

.github/workflows/flutter_analysis.yml

@@ -16,7 +16,7 @@ jobs:
         run: flutter pub get
 
       - name: Format code
-        run: flutter format --set-exit-if-changed .
+        run: dart format --set-exit-if-changed .
 
       - name: Analyze code
         run: flutter analyze --fatal-infos .

CHANGELOG.md

@@ -1,3 +1,19 @@
+## [1.9.0]
+* Implement `MacosSlider`
+
+## [1.8.0]
+🚨 Breaking Changes 🚨
+* `ContentArea.builder` has been changed from a `ScrollableWidgetBuilder` to a `WidgetBuilder` due to 
+changes in Flutter 3.7. The `MacosScrollBar` widget needs to undergo radical changes in order to achieve the
+native macOS scrollbar look and feel in the future, so this will be revisited at that time.
+
+Other changes
+* Per Flutter 3.7.0: Replace deprecated `MacosTextField.toolbarOptions` with `MacosTextField.contextMenuBuilder`
+* Ensure the color panel releases when it is closed
+* Avoid render overflows in the `Sidebar` when the window height is resized below a certain threshold ([#325](https://github.com/GroovinChip/macos_ui/issues/325))
+* Update `MacosScrollBar.thumbVisibility` with the latest change introduced in Flutter 3.7
+* Update `README.md` to address issues [#325](https://github.com/GroovinChip/macos_ui/issues/325) & [#332](https://github.com/GroovinChip/macos_ui/issues/332)
+
 ## [1.7.6]
 * Fixed a bug where `MacosPopupButton` would report that a `ScrollController` was not attached to any views
 

README.md

@@ -16,7 +16,9 @@ Guides, codelabs, and other documentation can be found at https://macosui.dev
 
 <img src="https://imgur.com/5mFQKBU.png" width="75%"/>
 
-## 🚨 Usage notes  
+## 🚨 Usage notes
+### <img src="https://storage.googleapis.com/cms-storage-bucket/0dbfcc7a59cd1cf16282.png" height="14"/> Platform Compatibility
+
 pub.dev shows that `macos_ui` only supports macOS. This is because `macos_ui` calls some native code, and therefore 
 specifies macOS as a plugin platform in the `pubspec.yaml` file. `macos_ui` _will_ work on any platform that
 Flutter supports, **but you will get best results on macOS**.
@@ -25,6 +27,14 @@ The features of `macos_ui` that will _not_ work on platforms other than macOS du
 * The `MacosColors.controlAccentColor()` function
 * The `MacosColorWell` widget
 
+### <img src="https://imgur.com/TIP0V7H.png" height="14"/> Popups & window resizing
+
+Since at this time Flutter does not allow UI elements to overflow the bounds of the window, popups are constrained to
+the available space.
+
+Therefore, if you are using widgets that create popups in your toolbar, like `ToolBarPopupButton`, you 
+should avoid allowing your application window to be resized below the height of your tallest popup.
+
 ## Contents
 
 <details>
@@ -196,6 +206,7 @@ class BlurryContainerViewController: NSViewController {
     self.addChild(flutterViewController)
 
     flutterViewController.view.frame = self.view.bounds
++   flutterViewController.backgroundColor = .clear // **Required post-Flutter 3.7.0**
     flutterViewController.view.autoresizingMask = [.width, .height]
     self.view.addSubview(flutterViewController.view)
   }
@@ -847,6 +858,29 @@ CapacityIndicator(
 
 You can set `discrete` to `true` to make it a discrete capacity indicator.
 
+### MacosSlider
+
+A slider is a control that lets people select a value from a continuous or discrete range of values by moving the slider thumb.
+
+ Continuous                                                                                                                                                         | Discrete                                                                                                                                                                                                         |
+|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| ![Continuous Slider Example](https://i.imgur.com/dc4YjoX.png) | ![Discrete Slider Example](https://i.imgur.com/KckOTUf.png)                                                                                   |
+| A horizontal slider where any value continuous value between a min and max can be selected | A horizontal slider where only discrete values between a min and max can be selected. Tick marks are often displayed to provide context. |
+
+
+Here's an example of how to create an interactive continuous slider:
+
+```dart
+double value = 0.5;
+
+MacosSlider(
+  value: value,
+  onChanged: (v) {
+    setState(() => value = v);
+  },
+),
+```
+
 ### RatingIndicator
 
 A rating indicator uses a series of horizontally arranged graphical symbols to communicate a ranking level. The default 

example/lib/main.dart

@@ -171,11 +171,11 @@ class _WidgetGalleryState extends State<WidgetGallery> {
             ],
           ),
           minWidth: 200,
-          builder: (context, controller) {
+          builder: (context, _) {
             return SidebarItems(
               currentIndex: pageIndex,
               onChanged: (i) => setState(() => pageIndex = i),
-              scrollController: controller,
+              scrollController: ScrollController(),
               itemSize: SidebarItemSize.large,
               items: [
                 const SidebarItem(
@@ -263,7 +263,7 @@ class _WidgetGalleryState extends State<WidgetGallery> {
           minWidth: 200,
           maxWidth: 300,
           shownByDefault: false,
-          builder: (context, scrollController) {
+          builder: (context, _) {
             return const Center(
               child: Text('End Sidebar'),
             );

example/lib/pages/buttons_page.dart

@@ -70,8 +70,9 @@ class _ButtonsPageState extends State<ButtonsPage> {
           },
         ),
         ContentArea(
-          builder: (context, scrollController) {
+          builder: (context) {
             return SingleChildScrollView(
+              // controller: _,
               padding: const EdgeInsets.all(20),
               child: Column(
                 children: [
@@ -140,23 +141,22 @@ class _ButtonsPageState extends State<ButtonsPage> {
                         buttonSize: ButtonSize.small,
                         child: const Text('Small'),
                         onPressed: () {
-                          Navigator.push(
-                            context,
+                          Navigator.of(context).push(
                             MaterialPageRoute(
                               builder: (_) {
                                 return MacosScaffold(
                                   toolBar: const ToolBar(
-                                    title: Text("New page"),
+                                    title: Text('New page'),
                                   ),
                                   children: [
                                     ContentArea(
-                                      builder: (context, scrollController) {
+                                      builder: (context) {
                                         return Center(
                                           child: PushButton(
                                             buttonSize: ButtonSize.large,
                                             child: const Text('Go Back'),
                                             onPressed: () {
-                                              Navigator.maybePop(context);
+                                              Navigator.of(context).maybePop();
                                             },
                                           ),
                                         );