add Property getNestedPopperElements

src/createTippy.ts

@@ -755,9 +755,16 @@ export default function createTippy(
   }
 
   function getNestedPopperTree(): PopperElement[] {
-    return arrayFrom(
-      popper.querySelectorAll('[data-__NAMESPACE_PREFIX__-root]')
+    const popperElements: PopperElement[] = [];
+    if (typeof instance.props.getNestedPopperElements === 'function') {
+      popperElements.push(...instance.props.getNestedPopperElements(popper));
+    }
+
+    popperElements.push(
+      ...arrayFrom(popper.querySelectorAll('[data-__NAMESPACE_PREFIX__-root]'))
     );
+
+    return popperElements;
   }
 
   function scheduleShow(event?: Event): void {

src/props.ts

@@ -35,6 +35,7 @@ export const defaultProps: DefaultProps = {
   delay: 0,
   duration: [300, 250],
   getReferenceClientRect: null,
+  getNestedPopperElements: null,
   hideOnClick: true,
   ignoreAttributes: false,
   interactive: false,

src/types.ts

@@ -73,6 +73,7 @@ export interface Props extends LifecycleHooks, RenderProps {
   duration: number | [number | null, number | null];
   followCursor: boolean | 'horizontal' | 'vertical' | 'initial';
   getReferenceClientRect: null | GetReferenceClientRect;
+  getNestedPopperElements: null | ((popper: PopperElement) => PopperElement[]);
   hideOnClick: boolean | 'toggle';
   ignoreAttributes: boolean;
   inlinePositioning: boolean;

website/src/pages/v6/all-props.mdx

@@ -28,6 +28,7 @@ tippy(targets, {
 - [duration](#duration) <RenderIcon />
 - [followCursor](#followcursor) <PluginIcon />
 - [getReferenceClientRect](#getreferenceclientrect)
+- [getNestedPopperElements](#getnestedpopperelements)
 - [hideOnClick](#hideonclick)
 - [ignoreAttributes](#ignoreattributes)
 - [inertia](#inertia) <RenderIcon />
@@ -412,6 +413,21 @@ tippy(targets, {
 
 ---
 
+### getNestedPopperElements
+
+Used for keeping tippy open when mouse is over child tippy instances.
+
+```js
+tippy(targets, {
+  // default (uses the reference passed as first argument)
+  getNestedPopperElements: null,
+  // function that returns custom popper elements
+  getNestedPopperElements: (popperElement) => Array.from(popperElement.querySelectorAll('.my-custom-tooltips'),
+});
+```
+
+---
+
 ### hideOnClick
 
 Determines if the tippy hides upon clicking the reference or outside of the