@fluentui/react-tooltip 9.0.0-rc.1 → 9.0.0-rc.3

package/CHANGELOG.json

@@ -2,7 +2,70 @@
   "name": "@fluentui/react-tooltip",
   "entries": [
     {
-      "date": "Thu, 10 Feb 2022 08:43:43 GMT",
+      "date": "Fri, 18 Feb 2022 13:33:51 GMT",
+      "tag": "@fluentui/react-tooltip_v9.0.0-rc.3",
+      "version": "9.0.0-rc.3",
+      "comments": {
+        "prerelease": [
+          {
+            "author": "behowell@microsoft.com",
+            "package": "@fluentui/react-tooltip",
+            "commit": "50ae56ec346d762d66b3d74ed1127943ffda344f",
+            "comment": "Update documentation comments"
+          },
+          {
+            "author": "lingfangao@hotmail.com",
+            "package": "@fluentui/react-tooltip",
+            "commit": "1aa9e691fcccd9a64168cea7941c0f1e71fa1d14",
+            "comment": "fix: Source maps contain original source code"
+          },
+          {
+            "author": "olfedias@microsoft.com",
+            "package": "@fluentui/react-tooltip",
+            "commit": "2bf88fea066244bc078912bb6e45edb960f3b866",
+            "comment": "update trigger implementation to be consistent"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-tooltip",
+            "comment": "Bump @fluentui/react-portal to v9.0.0-rc.3",
+            "commit": "3b9c1e931c23173da3d1af0c696cdc58516ce504"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-tooltip",
+            "comment": "Bump @fluentui/react-positioning to v9.0.0-rc.3",
+            "commit": "3b9c1e931c23173da3d1af0c696cdc58516ce504"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-tooltip",
+            "comment": "Bump @fluentui/react-shared-contexts to v9.0.0-rc.3",
+            "commit": "3b9c1e931c23173da3d1af0c696cdc58516ce504"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-tooltip",
+            "comment": "Bump @fluentui/react-theme to v9.0.0-rc.3",
+            "commit": "3b9c1e931c23173da3d1af0c696cdc58516ce504"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-tooltip",
+            "comment": "Bump @fluentui/react-utilities to v9.0.0-rc.3",
+            "commit": "3b9c1e931c23173da3d1af0c696cdc58516ce504"
+          },
+          {
+            "author": "beachball",
+            "package": "@fluentui/react-tooltip",
+            "comment": "Bump @fluentui/react-conformance-griffel to v9.0.0-beta.3",
+            "commit": "3b9c1e931c23173da3d1af0c696cdc58516ce504"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Thu, 10 Feb 2022 08:50:30 GMT",
       "tag": "@fluentui/react-tooltip_v9.0.0-rc.1",
       "version": "9.0.0-rc.1",
       "comments": {

package/CHANGELOG.md

@@ -1,12 +1,29 @@
 # Change Log - @fluentui/react-tooltip
 
-This log was last generated on Thu, 10 Feb 2022 08:43:43 GMT and should not be manually modified.
+This log was last generated on Fri, 18 Feb 2022 13:33:51 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## [9.0.0-rc.3](https://github.com/microsoft/fluentui/tree/@fluentui/react-tooltip_v9.0.0-rc.3)
+
+Fri, 18 Feb 2022 13:33:51 GMT 
+[Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-tooltip_v9.0.0-rc.1..@fluentui/react-tooltip_v9.0.0-rc.3)
+
+### Changes
+
+- Update documentation comments ([PR #21736](https://github.com/microsoft/fluentui/pull/21736) by behowell@microsoft.com)
+- fix: Source maps contain original source code ([PR #21690](https://github.com/microsoft/fluentui/pull/21690) by lingfangao@hotmail.com)
+- update trigger implementation to be consistent ([PR #21626](https://github.com/microsoft/fluentui/pull/21626) by olfedias@microsoft.com)
+- Bump @fluentui/react-portal to v9.0.0-rc.3 ([PR #21800](https://github.com/microsoft/fluentui/pull/21800) by beachball)
+- Bump @fluentui/react-positioning to v9.0.0-rc.3 ([PR #21800](https://github.com/microsoft/fluentui/pull/21800) by beachball)
+- Bump @fluentui/react-shared-contexts to v9.0.0-rc.3 ([PR #21800](https://github.com/microsoft/fluentui/pull/21800) by beachball)
+- Bump @fluentui/react-theme to v9.0.0-rc.3 ([PR #21800](https://github.com/microsoft/fluentui/pull/21800) by beachball)
+- Bump @fluentui/react-utilities to v9.0.0-rc.3 ([PR #21800](https://github.com/microsoft/fluentui/pull/21800) by beachball)
+- Bump @fluentui/react-conformance-griffel to v9.0.0-beta.3 ([PR #21800](https://github.com/microsoft/fluentui/pull/21800) by beachball)
+
 ## [9.0.0-rc.1](https://github.com/microsoft/fluentui/tree/@fluentui/react-tooltip_v9.0.0-rc.1)
 
-Thu, 10 Feb 2022 08:43:43 GMT 
+Thu, 10 Feb 2022 08:50:30 GMT 
 [Compare changes](https://github.com/microsoft/fluentui/compare/@fluentui/react-tooltip_v9.0.0-beta.5..@fluentui/react-tooltip_v9.0.0-rc.1)
 
 ### Changes

package/MIGRATION.md

@@ -6,55 +6,63 @@ This Migration guide is a work in progress and is not yet ready for use.
 
 ## Migration from v8
 
-The converged API does not support many of the custom features of the v8 tooltip. We may need to revisit and add additional features to the converged Tooltip if needed.
+TooltipHost is replaced by Tooltip itself, as the wrapper around the element that should receive a tooltip.
 
 - `Tooltip`
-  - `calloutProps` => Not supported. The arrow's visibility can be controlled using `noArrow`.
-  - `componentRef` => `componentRef`
-  - `delay` => `showDelay` on the TooltipTrigger
-  - `directionalHint` => `position` and `align`
-    - `topLeftEdge` => `position: 'above', align: 'start'`
-    - `topCenter` => `position: 'above'`
-    - `topRightEdge` => `position: 'above', align: 'end'`
+  - `calloutProps`
+    - `isBeakVisible` => `withArrow`
+    - `beakWidth` => Not supported.
+    - `gapSpace` => Not supported.
+    - `doNotLayer` => Not supported. Tooltips are always layered by rendering in a Portal.
+    - `setInitialFocus` => Not supported. Tooltips can't be focused, by design.
+  - `componentRef` => Not supported. Tooltips can be controlled declaratively with props like `visible`, instead of using an imperative API like `componentRef`.
+  - `delay` => `showDelay`
+  - `directionalHint` => `positioning`
+    - `topLeftEdge` => `positioning="above-start"`
+    - `topCenter` => `positioning="above"`
+    - `topRightEdge` => `positioning="above-end"`
     - `topAutoEdge` => Not supported
-    - `bottomLeftEdge` => `position: 'below', align: 'start'`
-    - `bottomCenter` => `position: 'below'`
-    - `bottomRightEdge` => `position: 'below', align: 'end'`
+    - `bottomLeftEdge` => `positioning="below-start"`
+    - `bottomCenter` => `positioning="below"`
+    - `bottomRightEdge` => `positioning="below-end"`
     - `bottomAutoEdge` => Not supported
-    - `leftTopEdge` => `position: 'before', align: 'top'`
-    - `leftCenter` => `position: 'before'`
-    - `leftBottomEdge` => `position: 'before', align: 'bottom'`
-    - `rightTopEdge` => `position: 'after', align: 'top'`
-    - `rightCenter` => `position: 'after'`
-    - `rightBottomEdge` => `position: 'after', align: 'bottom'`
-  - `directionalHintForRTL` => Automatic based on whether the element is in an RTL context
-  - `maxWidth` => Add styling to the Tooltip: `tooltip={{ style: { maxWidth: ... }, children: 'Tooltip Content' }}`
-  - `onRenderContent` => Set the Tooltip's `children` to a custom render function
-- `TooltipHost` => `TooltipTrigger`
-  - `calloutProps` => Not supported
+    - `leftTopEdge` => `positioning="before-top"`
+    - `leftCenter` => `positioning="before"`
+    - `leftBottomEdge` => `positioning="before-bottom"`
+    - `rightTopEdge` => `positioning="after-top"`
+    - `rightCenter` => `positioning="after"`
+    - `rightBottomEdge` => `positioning="after-bottom"`
+  - `directionalHintForRTL` => Automatic based on whether the element is in an RTL context according to `FluentProvider`.
+  - `maxWidth` => Supported only through CSS styling of the `content` slot.
+  - `onRenderContent` => Set the `content` slot to a custom render function.
+- `TooltipHost` => The tooltip itself is the "host".
   - `closeDelay` => `hideDelay`
-  - `hostClassName` => Not needed because there is no element rendered by TooltipTrigger
-  - `onTooltipToggle` => Not supported
-  - `overflowMode` => `onlyIfTruncated`
-    - `TooltipOverflowMode.self` => `onlyIfTruncated="true"`
-    - `TooltipOverflowMode.parent` => `onlyIfTruncated="true"` and set `targetRef` to the parent element
+  - `hostClassName` => Not needed because there is no element rendered inline by Tooltip
+  - `onTooltipToggle` => `onVisibleChange`
+  - `overflowMode` => Not supported. If this behavior is needed, the tooltip's visibility can be controlled using the `visible` prop and `onVisibleChange` event.
 
 ## Migration from v0
 
-- `Tooltip` => `TooltipTrigger`
-  - `content="..."` => `tooltip="..."`
-  - `defaultOpen` => Not supported
-  - `flipBoundary` => Not supported
-  - `mountNode` => Unknown
+The v9 Tooltip swaps the meaning of children between content and trigger. In v0, Tooltip's children is the tooltip content, and its trigger is a prop. In v9, that is swapped: Tooltip's children is the trigger, and its content is a prop.
+
+- `Tooltip`
+  - children => `content`
+  - `trigger` => children
+  - `defaultOpen` => Not supported. The tooltip's visibility can be controlled using the `visible` prop and `onVisibleChange` event.
+  - `mountNode` => Not supported
+  - `open` => `visible`
+  - `onOpenChange` => `onVisibleChange`
+  - `pointing` => `withArrow`
+  - `mouseEnterDelay` => `showDelay`
   - `mouseLeaveDelay` => `hideDelay`
-  - `offset` => `offset`
-  - `onOpenChange` => Not supported
-  - `open` => Not supported
-  - `overflowBoundary` => Not supported
-  - `pointing={false}` => `noArrow={true}`
-  - `popperRef` => Not supported
-  - `position` => `position`
-  - `align` => `align`
-  - `positionFixed` => Not supported
-  - `target` => `targetRef`
-  - `trigger` => The child of the `TooltipTrigger`
+  - `subtle={true}` = `appearance="normal"` (default)
+  - `subtle={false}` => `appearance="inverted"`
+  - Positioning props are now attributes of the `positioning` prop:
+    - `flipBoundary` => `positioning.flipBoundary`
+    - `offset` => `positioning.offset`
+    - `overflowBoundary` => `positioning.overflowBoundary`
+    - `popperRef` => `positioning.popperRef`
+    - `position` => `positioning.position`
+    - `align` => `positioning.align`
+    - `positionFixed` => `positioning.positionFixed`
+    - `target` => `positioning.target`