Implement Tooltip

CHANGELOG.md

@@ -1,4 +1,5 @@
 ## [0.0.12]
+* Implement `Tooltip`
 * Add mouse cursors to help button, push button and `TextField`
 
 ## [0.0.11]

README.md

@@ -16,7 +16,7 @@ Flutter widgets and themes implementing the current macOS design language.
   - [RadioButton](#radiobutton)
   - [PushButton](#pushbutton)
   - [Switch](#switch)
-- [Fields and Labels](#fields-and-labels)
+- [Fields](#fields)
   - [TextField](#textfield)
 - [Indicators](#indicators)
   - [Progress Indicators](#progress-indicators)
@@ -156,7 +156,7 @@ Switch(
 ),
 ```
 
-# Fields and Labels
+# Fields
 
 ## TextField
 
@@ -170,6 +170,27 @@ Here's an example of how to create a basic text field:
 TextField(),
 ```
 
+# Labels
+
+Labels are a short description of what an element on the screen does.
+
+## Tooltip
+
+Tooltips succinctly describe how to use controls without shifting people’s focus away from the primary interface. Help tags appear when the user positions the pointer over a control for a few seconds. A tooltip remains visible for 10 seconds, or until the pointer moves away from the control.
+
+![Tooltip Example](https://developer.apple.com/design/human-interface-guidelines/macos/images/help_Tooltip.png)
+
+To create a tooltip, wrap any widget on a `Tooltip`:
+
+```dart
+Tooltip(
+  message: 'This is a tooltip',
+  child: Text('Hover or long press to show a tooltip'),
+),
+```
+
+You can customize the tooltip the way you want using its `style` property. A tooltip automatically adapts to its environment, responding to touch and pointer events.
+
 # Indicators
 
 ## Progress Indicators

example/lib/main.dart

@@ -71,8 +71,11 @@ class _DemoState extends State<Demo> {
                     onChanged: (v) => setState(() => value = v),
                   ),
                   SizedBox(height: 20),
-                  HelpButton(
-                    onPressed: () {},
+                  Tooltip(
+                    message: 'This button shows help',
+                    child: HelpButton(
+                      onPressed: () {},
+                    ),
                   ),
                   SizedBox(height: 20),
                   CapacityIndicator(

lib/macos_ui.dart

@@ -21,6 +21,7 @@ export 'src/indicators/capacity_indicators.dart';
 export 'src/indicators/progress_indicators.dart';
 export 'src/indicators/rating_indicator.dart';
 export 'src/indicators/relevance_indicator.dart';
+export 'src/labels/tooltip.dart';
 export 'src/layout/content_area.dart';
 export 'src/layout/resizable_pane.dart';
 export 'src/layout/scaffold.dart';