VNL Works
VNL Works
VNL Works
← Components
Download ZIPRegistry JSON
Package: tailwind-motion-kit
ui

Tooltip (CSS-only)

依存ゼロの小さな説明。hover/focus-visibleで表示。

tooltiphintcss
Customize

--mk-tooltip-bg / --mk-tooltip-gap / --mk-tooltip-max-width

A11y

重要な情報はtooltipに閉じ込めない（常時テキストが望ましい）。

Install

“壊れにくさ”優先のため、依存は増やさずに ファイルをコピーして使う 形式です。

Files

まずは下記ファイルをプロジェクトに配置してください。

required-files.md
- tailwind-motion-kit/css/00_tokens.css (css)
- tailwind-motion-kit/css/21_tooltip.css (css)
Option A

まずは Bundle を読み込んで、動作を確認するのがおすすめです。

globals.css
/* Bundle: まずはこれが一番簡単 */
@import "./tailwind-motion-kit/css/99_bundle.css";
Option B

必要な CSS だけ読み込みたい場合はこちら。

globals.css
/* 1) CSS: グローバルCSSに追記 */
@import "./tailwind-motion-kit/css/00_tokens.css";
@import "./tailwind-motion-kit/css/21_tooltip.css";
JavaScript

CSS-only のため初期化は不要です。

init.js
/* JS 初期化は不要です */

Snippets

Copy & paste
usage.html
<button class="mk-tooltip" data-mk-tooltip="これはヒントです" data-mk-tooltip-pos="top">i</button>

Files

この部品が参照する実ファイルです。

tailwind-motion-kit/css/00_tokens.css
css
tailwind-motion-kit/css/00_tokens.css
/*!
 * Tailwind Motion Kit (mk) - Tokens
 * --------------------------------
 * 目的: 速度・距離・イージング等の“モーション言語”を統一し、
 *       パーツを増やしても品位が崩れない状態を作ります。
 *
 * 使い方:
 *  - :root の変数を上書きするだけで全体の動きを一括調整できます。
 *  - 個別要素は style="" か data-mk-* 属性で上書きできます（JSがある場合）。
 */

:root {
  /* --- イージング（加減速） --- */
  --mk-ease-out: cubic-bezier(0.16, 1, 0.3, 1);
  --mk-ease-in: cubic-bezier(0.32, 0, 0.67, 0);
  --mk-ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);
  /* “少しだけ遊び”が欲しい時用（多用は上品さを損ねます） */
  --mk-ease-out-back: cubic-bezier(0.34, 1.56, 0.64, 1);

  /* --- 時間 --- */
  --mk-duration-fast: 160ms;
  --mk-duration-medium: 280ms;
  --mk-duration-slow: 600ms;
  --mk-duration-slower: 900ms;

  /* コンポーネントが参照する“共通デフォルト” */
  --mk-duration: var(--mk-duration-medium);
  --mk-ease: var(--mk-ease-out);
  --mk-delay: 0ms;

  /* --- 移動量 --- */
  --mk-distance-1: 6px;
  --mk-distance-2: 12px;
  --mk-distance-3: 20px;
  --mk-distance: var(--mk-distance-2);

  /* --- ぼかし --- */
  --mk-blur-0: 0px;
  --mk-blur-1: 6px;
  --mk-blur-2: 10px;
  --mk-blur: var(--mk-blur-1);

  /* --- 影（浮遊感） --- */
  --mk-shadow-lift: 0 12px 30px rgba(0, 0, 0, 0.14);
  --mk-shadow-soft: 0 10px 22px rgba(0, 0, 0, 0.10);

  /* --- アンダーライン --- */
  --mk-underline-thickness: 2px;
  --mk-underline-offset: 0.2em;

  /* --- フォーカスリング --- */
  --mk-ring-color: rgba(59, 130, 246, 0.35);
  --mk-ring-size: 3px;

  /* --- スケルトン（ロード中） --- */
  --mk-skeleton-a: rgba(0, 0, 0, 0.06);
  --mk-skeleton-b: rgba(0, 0, 0, 0.12);
  --mk-skeleton-speed: 1250ms;

  /* --- スピナー --- */
  --mk-spinner-size: 1.2em;
  --mk-spinner-border: 2px;

  /* --- テキスト分割表示 --- */
  --mk-char-step: 25ms; /* 1文字ごとの遅延 */


  /* --- ダイアログ / ドロワー --- */
  --mk-dialog-duration: var(--mk-duration-slow);
  --mk-dialog-ease: var(--mk-ease-out);
  --mk-dialog-backdrop-opacity: 0.45;
  --mk-dialog-offset: var(--mk-distance-3);
  --mk-dialog-scale-from: 0.995;
  --mk-dialog-radius: 18px;

  /* --- 折りたたみ（アコーディオン） --- */
  --mk-collapse-duration: var(--mk-duration-medium);
  --mk-collapse-ease: var(--mk-ease);

  /* --- Toast / 通知 --- */
  --mk-toast-gap: 10px;
  --mk-toast-width: min(360px, calc(100vw - 24px));
  --mk-toast-duration: var(--mk-duration-medium);
  --mk-toast-ease: var(--mk-ease-out);

  /* --- スクロール進捗（トップバー） --- */
  --mk-scroll-progress-top: 0px;
  --mk-scroll-progress-height: 3px;
  --mk-scroll-progress-ease: linear;

  /* --- ナビ下線インジケータ --- */
  --mk-nav-underline-height: 2px;
  --mk-nav-underline-radius: 999px;
  --mk-nav-duration: var(--mk-duration-medium);
  --mk-nav-ease: var(--mk-ease-out);


  /* --- UI state（idle/loading/success/error） --- */
  --mk-state-hold-success: 900ms;
  --mk-state-hold-error: 1400ms;


  /* --- Tabs --- */
  --mk-tabs-gap: 10px;
  --mk-tabs-radius: 999px;
  --mk-tabs-duration: var(--mk-duration-medium);
  --mk-tabs-ease: var(--mk-ease-out);
  --mk-tabs-underline-height: 2px;
  --mk-tabs-underline-color: currentColor;

  /* --- Tooltip --- */
  --mk-tooltip-bg: rgba(0, 0, 0, 0.82);
  --mk-tooltip-fg: #fff;
  --mk-tooltip-radius: 10px;
  --mk-tooltip-padding: 10px 12px;
  --mk-tooltip-gap: 8px;
  --mk-tooltip-shadow: 0 18px 60px rgba(0,0,0,0.35);
  --mk-tooltip-max-width: 260px;

  /* --- Stepper --- */
  --mk-stepper-gap: 14px;
  --mk-step-size: 28px;
  --mk-step-line: rgba(255, 255, 255, 0.14);
  --mk-step-done: rgba(59, 130, 246, 1);
  --mk-step-current: rgba(255, 255, 255, 0.92);
  --mk-step-todo: rgba(255, 255, 255, 0.5);

}

/* motion減衰設定のあるユーザーには、動きを最小化して“結果”を出します */
@media (prefers-reduced-motion: reduce) {
  :root {
    --mk-duration-fast: 0ms;
    --mk-duration-medium: 0ms;
    --mk-duration-slow: 0ms;
    --mk-duration-slower: 0ms;
    --mk-duration: 0ms;
    --mk-delay: 0ms;
  }
}
tailwind-motion-kit/css/21_tooltip.css
css
tailwind-motion-kit/css/21_tooltip.css
/*!
 * Tailwind Motion Kit (mk) - Tooltip
 * ---------------------------------
 * 目的: “小さな説明”を、過剰にならない形で添える。
 * 方針: 依存ゼロ（CSSのみ）。hover だけでなく focus-visible でも表示します。
 *
 * 使い方（最小）:
 * <button class="mk-tooltip" data-mk-tooltip="説明テキスト">Hover</button>
 *
 * 位置（任意）:
 *  - data-mk-tooltip-pos="top|bottom|left|right"
 */

.mk-tooltip {
  position: relative;
}

.mk-tooltip::after,
.mk-tooltip::before {
  position: absolute;
  left: 50%;
  transform: translate3d(-50%, 0, 0);
  opacity: 0;
  pointer-events: none;

  transition:
    opacity var(--mk-duration) var(--mk-ease),
    transform var(--mk-duration) var(--mk-ease);
}

/* bubble */
.mk-tooltip::after {
  content: attr(data-mk-tooltip);
  bottom: calc(100% + var(--mk-tooltip-gap));
  transform: translate3d(-50%, 6px, 0);

  max-width: var(--mk-tooltip-max-width);
  padding: var(--mk-tooltip-padding);
  border-radius: var(--mk-tooltip-radius);
  background: var(--mk-tooltip-bg);
  color: var(--mk-tooltip-fg);
  font-size: 12px;
  line-height: 1.4;
  box-shadow: var(--mk-tooltip-shadow);
  white-space: normal;
  text-wrap: pretty;
}

/* arrow */
.mk-tooltip::before {
  content: "";
  bottom: calc(100% + calc(var(--mk-tooltip-gap) - 2px));
  transform: translate3d(-50%, 6px, 0);

  width: 10px;
  height: 10px;
  background: var(--mk-tooltip-bg);
  rotate: 45deg;
  border-radius: 2px;
}

/* show */
.mk-tooltip:hover::after,
.mk-tooltip:hover::before,
.mk-tooltip:focus-visible::after,
.mk-tooltip:focus-visible::before {
  opacity: 1;
  transform: translate3d(-50%, 0, 0);
}

/* positions */
.mk-tooltip[data-mk-tooltip-pos="bottom"]::after {
  top: calc(100% + var(--mk-tooltip-gap));
  bottom: auto;
  transform: translate3d(-50%, -6px, 0);
}

.mk-tooltip[data-mk-tooltip-pos="bottom"]::before {
  top: calc(100% + calc(var(--mk-tooltip-gap) - 2px));
  bottom: auto;
  transform: translate3d(-50%, -6px, 0);
  rotate: 45deg;
}

.mk-tooltip[data-mk-tooltip-pos="left"]::after {
  left: auto;
  right: calc(100% + var(--mk-tooltip-gap));
  bottom: 50%;
  transform: translate3d(6px, 50%, 0);
}

.mk-tooltip[data-mk-tooltip-pos="left"]::before {
  left: auto;
  right: calc(100% + calc(var(--mk-tooltip-gap) - 2px));
  bottom: 50%;
  transform: translate3d(6px, 50%, 0);
}

.mk-tooltip[data-mk-tooltip-pos="right"]::after {
  left: calc(100% + var(--mk-tooltip-gap));
  bottom: 50%;
  transform: translate3d(-6px, 50%, 0);
}

.mk-tooltip[data-mk-tooltip-pos="right"]::before {
  left: calc(100% + calc(var(--mk-tooltip-gap) - 2px));
  bottom: 50%;
  transform: translate3d(-6px, 50%, 0);
}

/* For left/right we reposition transforms when shown */
.mk-tooltip[data-mk-tooltip-pos="left"]:hover::after,
.mk-tooltip[data-mk-tooltip-pos="left"]:hover::before,
.mk-tooltip[data-mk-tooltip-pos="left"]:focus-visible::after,
.mk-tooltip[data-mk-tooltip-pos="left"]:focus-visible::before {
  transform: translate3d(0, 50%, 0);
  opacity: 1;
}

.mk-tooltip[data-mk-tooltip-pos="right"]:hover::after,
.mk-tooltip[data-mk-tooltip-pos="right"]:hover::before,
.mk-tooltip[data-mk-tooltip-pos="right"]:focus-visible::after,
.mk-tooltip[data-mk-tooltip-pos="right"]:focus-visible::before {
  transform: translate3d(0, 50%, 0);
  opacity: 1;
}

.mk-tooltip[data-mk-tooltip-pos="bottom"]:hover::after,
.mk-tooltip[data-mk-tooltip-pos="bottom"]:hover::before,
.mk-tooltip[data-mk-tooltip-pos="bottom"]:focus-visible::after,
.mk-tooltip[data-mk-tooltip-pos="bottom"]:focus-visible::before {
  transform: translate3d(-50%, 0, 0);
  opacity: 1;
}

@media (prefers-reduced-motion: reduce) {
  .mk-tooltip::after,
  .mk-tooltip::before {
    transition: none !important;
  }
}
Preview
Tips
  • • デザイン側は CSS 変数（tokens）で一括調整できます。
  • • 動きは “短く・小さく・同じ癖” を優先すると品位が保てます。
  • • prefers-reduced-motion を必ず考慮してください。