@ng-cn/core 1.0.17 → 1.0.18

package/src/app/lib/components/ui/tooltip/tooltip-content.component.ts

@@ -1,5 +1,16 @@
-import { cn, Presence } from '@/lib/utils';
-import { ChangeDetectionStrategy, Component, computed, inject, input } from '@angular/core';
+import { Align, cn, computePosition, getTransformOrigin, Presence, Side } from '@/lib/utils';
+import {
+  afterNextRender,
+  ChangeDetectionStrategy,
+  Component,
+  computed,
+  effect,
+  ElementRef,
+  inject,
+  Injector,
+  input,
+  signal,
+} from '@angular/core';
 import { TOOLTIP_CONTEXT, TooltipAlign, TooltipSide } from './tooltip-context';
 
 export type TooltipContentState = 'open' | 'closed';
@@ -34,7 +45,8 @@ export interface TooltipContentProps {
  *
  * @description
  * TooltipContent displays the actual tooltip content. It supports positioning
- * on different sides and alignments relative to the trigger.
+ * on different sides and alignments relative to the trigger using fixed positioning
+ * via computePosition to avoid clipping inside overflow:hidden ancestors.
  *
  * ## Features
  * - Configurable side (top, right, bottom, left)
@@ -42,10 +54,14 @@ export interface TooltipContentProps {
  * - Customizable offset from trigger
  * - Smooth enter/exit animations
  * - Uses Presence for proper exit animations
+ * - Fixed positioning — not clipped by overflow:hidden ancestors
+ * - Escape key to dismiss
+ * - disableHoverableContent support
  *
  * ## Accessibility
  * - `role="tooltip"` on the element
  * - Unique ID for aria-describedby relationship with trigger
+ * - Escape key dismisses tooltip (WCAG 1.4.13)
  *
  * @example Basic usage
  * ```html
@@ -81,10 +97,12 @@ export interface TooltipContentProps {
       <div
         [class]="computedClass()"
         [attr.data-state]="state()"
-        [attr.data-side]="side()"
-        [attr.data-align]="align()"
+        [attr.data-side]="computedSide()"
+        [attr.data-align]="computedAlign()"
+        [style]="positionStyles()"
         role="tooltip"
         [id]="context.tooltipId"
+        (mouseenter)="onMouseEnter()"
       >
         <ng-content />
       </div>
@@ -93,10 +111,35 @@ export interface TooltipContentProps {
   host: {
     'attr.data-slot': '"tooltip-content"',
     class: 'contents',
+    '(document:keydown.escape)': 'onEscape()',
   },
   changeDetection: ChangeDetectionStrategy.OnPush,
 })
 export class TooltipContent {
+  constructor() {
+    // Recalculate position when open state changes (browser-only via afterNextRender)
+    effect(() => {
+      const isOpen = this.context.open();
+      if (isOpen) {
+        this.isPositioned.set(false);
+        afterNextRender(
+          () => {
+            this.schedulePositionUpdate();
+          },
+          { injector: this._injector },
+        );
+      } else {
+        this.cancelScheduledPositionUpdate();
+        this.isPositioned.set(false);
+        this.positionStyles.set({
+          position: 'fixed',
+          top: '-9999px',
+          left: '-9999px',
+        });
+      }
+    });
+  }
+
   /** The preferred side of the trigger to render against */
   readonly side = input<TooltipSide>('top');
   /** The distance in pixels from the trigger */
@@ -108,29 +151,110 @@ export class TooltipContent {
   /** Additional CSS classes */
   readonly class = input<string>('');
 
+  private readonly _elementRef = inject(ElementRef);
+  private readonly _injector = inject(Injector);
+
   protected readonly context = inject(TOOLTIP_CONTEXT);
 
+  protected readonly isPositioned = signal(false);
+  /** Computed position after collision detection */
+  protected readonly computedSide = signal<Side>('top');
+  protected readonly computedAlign = signal<Align>('center');
+  protected readonly positionStyles = signal<Record<string, string>>({
+    position: 'fixed',
+    top: '-9999px',
+    left: '-9999px',
+  });
+
+  private positionFrameId: number | null = null;
+
   /** Current state: open or closed */
   protected readonly state = computed<TooltipContentState>(() =>
     this.context.open() ? 'open' : 'closed',
   );
-  protected readonly computedClass = computed(() => {
-    const sideClasses = {
-      top: 'bottom-full left-1/2 -translate-x-1/2 mb-2',
-      bottom: 'top-full left-1/2 -translate-x-1/2 mt-2',
-      left: 'right-full top-1/2 -translate-y-1/2 mr-2',
-      right: 'left-full top-1/2 -translate-y-1/2 ml-2',
-    };
-
-    return cn(
-      'absolute z-50 overflow-hidden rounded-md border bg-popover px-3 py-1.5 text-sm text-popover-foreground shadow-md',
+
+  protected readonly computedClass = computed(() =>
+    cn(
+      'z-50 overflow-hidden rounded-md border bg-popover px-3 py-1.5 text-sm text-popover-foreground shadow-md',
       'data-[state=open]:animate-in data-[state=closed]:animate-out',
       'data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0',
       'data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95',
       'data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2',
       'data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2',
-      sideClasses[this.side()],
+      !this.isPositioned() && 'opacity-0 pointer-events-none',
       this.class(),
+    ),
+  );
+
+  onMouseEnter(): void {
+    if (this.context.disableHoverableContent?.()) {
+      this.context.setOpen(false);
+    }
+  }
+
+  protected onEscape(): void {
+    if (this.context.open()) {
+      this.context.setOpen(false);
+    }
+  }
+
+  private schedulePositionUpdate(): void {
+    this.cancelScheduledPositionUpdate();
+
+    this.positionFrameId = requestAnimationFrame(() => {
+      this.updatePosition();
+
+      this.positionFrameId = requestAnimationFrame(() => {
+        this.updatePosition();
+        this.positionFrameId = null;
+      });
+    });
+  }
+
+  private cancelScheduledPositionUpdate(): void {
+    if (this.positionFrameId !== null) {
+      cancelAnimationFrame(this.positionFrameId);
+      this.positionFrameId = null;
+    }
+  }
+
+  private updatePosition(): void {
+    const triggerElement = this.context.triggerRef?.();
+    const contentElement = this._elementRef.nativeElement.querySelector(
+      '[role="tooltip"]',
+    ) as HTMLElement;
+
+    if (!triggerElement || !contentElement) return;
+
+    const triggerRect = triggerElement.getBoundingClientRect();
+    const contentRect = contentElement.getBoundingClientRect();
+    const overlayWidth = Math.round(contentRect.width || 100);
+    const overlayHeight = Math.round(contentRect.height || 32);
+
+    const result = computePosition(
+      triggerRect,
+      { width: overlayWidth, height: overlayHeight },
+      {
+        side: this.side() as Side,
+        align: this.align() as Align,
+        sideOffset: this.sideOffset(),
+        alignOffset: this.alignOffset(),
+        avoidCollisions: true,
+        collisionPadding: 8,
+      },
     );
-  });
+
+    this.computedSide.set(result.side);
+    this.computedAlign.set(result.align);
+
+    // Set position styles with transform origin for animations
+    const transformOrigin = getTransformOrigin(result.side, result.align);
+    this.positionStyles.set({
+      position: 'fixed',
+      top: result.styles.top || '',
+      left: result.styles.left || '',
+      '--radix-tooltip-content-transform-origin': transformOrigin,
+    });
+    this.isPositioned.set(true);
+  }
 }

package/src/app/lib/components/ui/tooltip/tooltip-context.ts

@@ -9,13 +9,15 @@ export interface TooltipContextValue {
   /** Set open state */
   setOpen: (open: boolean) => void;
   /** Delay before showing tooltip (ms) */
-  delayDuration: number;
+  delayDuration: () => number;
   /** Skip delay duration when quickly hovering between tooltips (ms) */
   skipDelayDuration: number;
   /** Unique ID for aria-describedby relationship */
   tooltipId: string;
   /** Whether hoverable content is disabled */
   disableHoverableContent: () => boolean;
+  /** Reference to the trigger element for fixed positioning */
+  triggerRef?: WritableSignal<HTMLElement | null>;
 }
 
 export const TOOLTIP_CONTEXT = new InjectionToken<TooltipContextValue>('TOOLTIP_CONTEXT');

package/src/app/lib/components/ui/tooltip/tooltip-provider.component.ts

@@ -73,7 +73,7 @@ export class TooltipProvider implements TooltipContextValue {
   /** Unique ID for aria-describedby relationship */
   readonly tooltipId = `tooltip-provider-${++tooltipIdCounter}`;
   /** The duration from when the pointer enters the trigger until the tooltip opens */
-  readonly delayDuration = 700;
+  readonly delayDuration = input<number>(700);
   /** How much time a user has to enter another trigger without incurring a delay again */
   readonly skipDelayDuration = 300;
 

package/src/app/lib/components/ui/tooltip/tooltip-trigger.component.ts

@@ -1,4 +1,4 @@
-import { ChangeDetectionStrategy, Component, inject, input, OnDestroy } from '@angular/core';
+import { ChangeDetectionStrategy, Component, ElementRef, inject, input, OnDestroy } from '@angular/core';
 import { TOOLTIP_CONTEXT } from './tooltip-context';
 
 /**
@@ -70,6 +70,7 @@ export class TooltipTrigger implements OnDestroy {
   readonly asChild = input<boolean>(false);
 
   protected readonly context = inject(TOOLTIP_CONTEXT);
+  private readonly _elementRef = inject(ElementRef);
 
   private showTimeout: ReturnType<typeof setTimeout> | null = null;
   private hideTimeout: ReturnType<typeof setTimeout> | null = null;
@@ -80,9 +81,10 @@ export class TooltipTrigger implements OnDestroy {
 
   onMouseEnter(): void {
     this.clearTimeouts();
+    this.context.triggerRef?.set(this._elementRef.nativeElement);
     this.showTimeout = setTimeout(() => {
       this.context.setOpen(true);
-    }, this.context.delayDuration);
+    }, this.context.delayDuration());
   }
   onMouseLeave(): void {
     this.clearTimeouts();
@@ -93,6 +95,7 @@ export class TooltipTrigger implements OnDestroy {
   }
   onFocus(): void {
     // Show immediately on focus for keyboard users
+    this.context.triggerRef?.set(this._elementRef.nativeElement);
     this.context.setOpen(true);
   }
   onBlur(): void {

package/src/app/lib/components/ui/tooltip/tooltip.component.ts

@@ -126,9 +126,11 @@ export class Tooltip implements TooltipContextValue {
   readonly disableHoverableContent = input<boolean>(false);
 
   readonly open = signal(false);
+  /** Reference to the trigger element for fixed positioning */
+  readonly triggerRef = signal<HTMLElement | null>(null);
 
   /** The duration from when the pointer enters the trigger until the tooltip opens */
-  readonly delayDuration = 700;
+  readonly delayDuration = input<number>(700);
   /** How much time a user has to enter another trigger without incurring a delay again */
   readonly skipDelayDuration = 300;
   /** Unique ID for aria-describedby relationship */