Tooltip

Contextual information displayed on hover or focus to provide additional details.

Tooltip Positions

Directional Tooltips

This tooltip appears above
This tooltip appears below
This tooltip appears to the left
This tooltip appears to the right

Tooltip Variants

Color Variants

Default dark tooltip
Primary colored tooltip
Success message
Warning message
Error message

Multi-line Tooltip

This is a multi-line tooltip that can contain longer descriptions and additional information about the element you're hovering over.

Real Estate Use Cases

Property Information

250 m²
Total living area
★ A+
Energy efficiency rating
📅 2019
Year built

Implementation Guide

HTML Structure

<!-- Basic Tooltip -->
<div class="lyd-tooltip">
    <button class="lyd-button primary">Hover me</button>
    <div class="lyd-tooltip-content top">Tooltip text</div>
</div>

<!-- Multi-line Tooltip -->
<div class="lyd-tooltip">
    <button class="lyd-button primary">Hover for details</button>
    <div class="lyd-tooltip-content large top">
        This is a longer tooltip with multiple lines of text.
    </div>
</div>

React/Next.js Component

import { ReactNode } from 'react';

interface TooltipProps {
  children: ReactNode;
  content: string;
  position?: 'top' | 'bottom' | 'left' | 'right';
  variant?: 'default' | 'primary' | 'success' | 'warning' | 'error';
  size?: 'default' | 'large';
}

export const Tooltip = ({ 
  children, 
  content, 
  position = 'top',
  variant = 'default',
  size = 'default'
}: TooltipProps) => {
  const tooltipClasses = [
    'lyd-tooltip-content',
    position,
    variant !== 'default' && variant,
    size !== 'default' && size
  ].filter(Boolean).join(' ');
  
  return (
    <div className="lyd-tooltip">
      {children}
      <div className={tooltipClasses}>
        {content}
      </div>
    </div>
  );
};

API Reference

Class Description
.lyd-tooltip Container for tooltip component
.lyd-tooltip-content Tooltip content container
.top Position tooltip above trigger
.bottom Position tooltip below trigger
.left Position tooltip to the left
.right Position tooltip to the right
.primary Primary color variant
.success Success color variant
.warning Warning color variant
.error Error color variant
.large Multi-line tooltip variant

Accessibility & Best Practices

Accessibility Guidelines

  • Use aria-describedby to associate tooltip with trigger
  • Ensure tooltip appears on focus for keyboard users
  • Provide sufficient contrast (4.5:1 minimum)
  • Keep tooltip text concise and descriptive
  • Don't rely solely on tooltips for critical information

Best Practices

  • Position tooltips to avoid viewport edges
  • Use appropriate delay before showing
  • Ensure tooltips don't interfere with interactions
  • Test on mobile devices (consider alternatives)
  • Keep animations smooth and fast