Essentials

Tooltips

Configure cell tooltips in NuGrid.

NuGrid provides built-in tooltip support for cells, showing content when hovering over cells with truncated text.

Enabling Tooltips

By default, NuGrid shows tooltips for cells with truncated content. Configure tooltip behavior with the tooltip prop:

<template>
  <NuGrid
    :data="data"
    :columns="columns"
    :tooltip="{
      truncatedOnly: true,
      showDelay: 500,
    }"
  />
</template>

Tooltip Options

OptionTypeDefaultDescription
truncatedOnlybooleantrueOnly show tooltips for truncated content
showDelaynumber500Delay in milliseconds before showing
hideDelaynumber100Delay before hiding (prevents flicker)
mouseFollowbooleanfalseTooltip follows mouse cursor

Show All Tooltips

Show tooltips for all cells, not just truncated ones:

<template>
  <NuGrid
    :data="data"
    :columns="columns"
    :tooltip="{
      truncatedOnly: false,
      showDelay: 300,
    }"
  />
</template>

Mouse Following Tooltips

Enable tooltips that follow the mouse cursor:

<template>
  <NuGrid
    :data="data"
    :columns="columns"
    :tooltip="{
      mouseFollow: true,
      showDelay: 200,
    }"
  />
</template>

Custom Delays

Adjust tooltip timing for your use case:

<template>
  <NuGrid
    :data="data"
    :columns="columns"
    :tooltip="{
      showDelay: 1000,  // Wait 1 second before showing
      hideDelay: 200,   // Keep tooltip briefly when moving between cells
    }"
  />
</template>

Disabling Tooltips

Disable tooltips entirely:

<template>
  <NuGrid
    :data="data"
    :columns="columns"
    :tooltip="false"
  />
</template>

How Truncation Detection Works

NuGrid automatically detects truncated content by comparing the cell's scrollWidth to its clientWidth. When content is cut off due to column width constraints, the tooltip appears on hover.

This works seamlessly with:

  • Fixed column widths
  • Resizable columns
  • Auto-sized columns
  • Text wrapping disabled columns

Next Steps

Columns

Configure column sizing and behavior.

Focus & Navigation

Configure keyboard navigation.