Skeleton

内容加载时显示的占位形状。

浏览器: Chrome 123+Firefox 121+Safari 17.5+
层级: 0
压缩后大小: 317 B
强制布局预算: 0 ms
axe 预算: 0
支持 SSR: 是
公开契约: 测试环境

交互示例

Skeleton

Text

Profile

Media

Table

Pulse, shimmer, static

Load and reveal

Loading workspace…

React

CSS

Tailwind

import { Skeleton } from "@gunkin/uiify";

export default function Example() {
  return (
    <Skeleton
      className={
        "[inline-size:var(--uiify-skeleton-w,_100%)] [min-block-size:var(--uiify-skeleton-h,_1rem)] rounded-sm data-" +
        "[state=loading]:[block-size:var(--uiify-skeleton-h,_1rem)] data-[state=loading]:bg-muted data-[state=loadin" +
        "g]:[animation:uiify-skeleton-pulse_1.8s_ease-in-out_infinite] data-[shape=circle]:rounded-[50%] data-[shape" +
        "=circle]:[corner-shape:round] data-[variant=shimmer]:data-[state=loading]:[background-image:linear-gradient" +
        "(90deg,_var(--muted),_var(--secondary),_var(--muted))] data-[variant=shimmer]:data-[state=loading]:bg-trans" +
        "parent data-[variant=shimmer]:data-[state=loading]:[background-size:200%_100%] data-[variant=shimmer]:data-" +
        "[state=loading]:[animation:uiify-skeleton-shimmer_1.5s_linear_infinite] data-[variant=none]:[animation:none" +
        "] data-[state=loaded]:[animation:uiify-skeleton-reveal_200ms_ease-out] motion-reduce:[animation:none]"
      }
      width={240}
      height={20}
    />
  );
}

/* app.css */

@layer reset, ui, app, tokens, base, demo, components, utilities, theme;

@import "@gunkin/uiify/styles/reset";

@import "@gunkin/uiify/components/behavior.css";

@import "@gunkin/uiify/styles/tokens";

@import "@gunkin/uiify/styles/tailwind";

@import "tailwindcss/utilities.css";

@theme { --spacing: 0.25rem; --font-weight-normal: 400; --font-weight-medium: 500; --font-weight-semibold: 600; --font-weight-bold: 700; }

@source inline('[inline-size:var(--uiify-skeleton-w,_100%)] [min-block-size:var(--uiify-skeleton-h,_1rem)] rounded-sm data-[state=loading]:[block-size:var(--uiify-skeleton-h,_1rem)] data-[state=loading]:bg-muted data-[state=loading]:[animation:uiify-skeleton-pulse_1.8s_ease-in-out_infinite] data-[shape=circle]:rounded-[50%] data-[shape=circle]:[corner-shape:round] data-[variant=shimmer]:data-[state=loading]:[background-image:linear-gradient(90deg,_var(--muted),_var(--secondary),_var(--muted))] data-[variant=shimmer]:data-[state=loading]:bg-transparent data-[variant=shimmer]:data-[state=loading]:[background-size:200%_100%] data-[variant=shimmer]:data-[state=loading]:[animation:uiify-skeleton-shimmer_1.5s_linear_infinite] data-[variant=none]:[animation:none] data-[state=loaded]:[animation:uiify-skeleton-reveal_200ms_ease-out] motion-reduce:[animation:none]');

@layer base { :root { --uiify-control-text: var(--text-sm); } @media (pointer: coarse) { :root { --uiify-control-text: var(--text-base); } } }

/* Authored animation and registered properties used by the Tailwind skin.
 * Visual rules belong in utility recipes; only at-rule definitions live here. */
@layer components {
  @keyframes uiify-presence-in {
    from {
      opacity: 0;
      scale: var(--presence-scale);
    }
  }
}

@layer components {
  @keyframes uiify-presence-out {
    to {
      opacity: 0;
      scale: var(--presence-scale);
    }
  }
}

@property --uiify-spinner-tail {
  syntax: "<angle>";
  inherits: false;
  initial-value: 0deg;
}

@property --uiify-spinner-length {
  syntax: "<angle>";
  inherits: false;
  initial-value: 36deg;
}

@layer components {
  @keyframes uiify-spinner-rotate {
    to {
      transform: rotate(360deg);
    }
  }
}

@layer components {
  @keyframes uiify-spinner-orbit {
    0% {
      --uiify-spinner-tail: 0deg;
      --uiify-spinner-length: 36deg;
    }

    50% {
      --uiify-spinner-tail: 90deg;
      --uiify-spinner-length: 324deg;
    }

    100% {
      --uiify-spinner-tail: 360deg;
      --uiify-spinner-length: 36deg;
    }
  }
}

@layer components {
  @keyframes uiify-skeleton-pulse {
    50% {
      opacity: 0.45;
    }
  }
}

@layer components {
  @keyframes uiify-skeleton-shimmer {
    to {
      background-position: -200% 0;
    }
  }
}

@layer components {
  @keyframes uiify-skeleton-reveal {
    from {
      opacity: 0;
    }
    to {
      opacity: 1;
    }
  }
}

@property --candle-body-height {
  syntax: "<percentage>";
  inherits: true;
  initial-value: 0%;
}

@property --candle-body-top {
  syntax: "<percentage>";
  inherits: true;
  initial-value: 50%;
}

@property --candle-slot {
  syntax: "<percentage>";
  inherits: true;
  initial-value: 100%;
}

@property --candle-wick-height {
  syntax: "<percentage>";
  inherits: true;
  initial-value: 0%;
}

@property --candle-wick-top {
  syntax: "<percentage>";
  inherits: true;
  initial-value: 50%;
}

@property --candle-x {
  syntax: "<percentage>";
  inherits: true;
  initial-value: 0%;
}

@property --candle-scale {
  syntax: "<number>";
  inherits: true;
  initial-value: 1;
}

@property --line-y {
  syntax: "<percentage>";
  inherits: true;
  initial-value: 50%;
}

@property --line-prev-y {
  syntax: "<percentage>";
  inherits: true;
  initial-value: 50%;
}

@property --line-count {
  syntax: "<integer>";
  inherits: false;
  initial-value: 1;
}

@property --line-scale {
  syntax: "<number>";
  inherits: true;
  initial-value: 1;
}

@layer components {
  @keyframes uiify-otp-input-caret-blink {
    50% {
      opacity: 0;
    }
  }
}

API

`Skeleton`

属性	类型	默认值	说明
`variant`	`"pulse" \| "shimmer" \| "none"`	`"pulse"`	占位内容动画。启用减少动态效果时，会禁用动画和内容显示动态效果。
`circle`	`boolean`	`false`	渲染圆形占位内容，而非矩形。
`height`	`number \| string`	—	占位内容高度；数字视为像素。
`loading`	`boolean`	`true`	为false时，在同一外层元素内显示children，保留尺寸和ref；所选样式表为显示过程添加动画。
`width`	`number \| string`	—	占位内容宽度；数字视为像素。
`children`	`ReactNode`	—	loading为false后渲染的真实内容。
`render`	`ReactElement \| ((props, state) => ReactElement)`	—	替换渲染元素，同时保留行为和无障碍连接关系。

键盘

按键	操作

无障碍

Skeleton在加载和显示内容时保留稳定的外层元素。加载占位内容带有aria-hidden，加载完成的子元素保留原生语义。可选择pulse、shimmer或none。启用减少动态效果时会禁用动画。应在外层区域说明加载状态，而非为每个装饰性骨架添加实时状态。

样式钩子

data-uiify-skeletondata-statedata-variantdata-shape--uiify-skeleton-w--uiify-skeleton-h

框架

样式

主题

语言

Skeleton

交互示例

Skeleton

Text

Profile

Media

Table

Pulse, shimmer, static

Load and reveal

API

`Skeleton`

键盘

无障碍

样式钩子