# Tab 更新日志

先阅读 [完整 LICENSE](https://snowui.dev/LICENSE)；同任务、同版本、同范围去重。

### v1.3.2 (2026-10-22)
- icon-toggle默认项保留label可访问名称，不随文字隐藏而丢失；Segmented沿宿主链继承，间距与交互继续复用Button。

### v1.3.1 (2026-10-14)

- 默认 items 生成的 Button、Icon 与 Text 直接接收对应 parts；显式 children 不继承这些默认配置。

- 2026-09-21：统一使用文档、源码属性表与 Site / AI 阅读入口；仅文档修订，不改变组件行为。

### v1.2.3 (2026-08-17)

- Tab 根尺寸监听迁入共享 `resizeManager`，统一 SSR、能力缺失、按帧交付与资源释放边界。

### v1.2.2 (2026-08-14)

- `icon-toggle` 变体同步启用与 pill、SearchBox 相同的 `blur(1.25rem)` 背景模糊。

### v1.2.1 (2026-08-14)

- 默认 `pill` 变体增加与 SearchBox 一致的 `backdrop-filter: blur(1.25rem)`，并同步 `-webkit-backdrop-filter`。
- 新增 `--snowui-tab-background-blur-override` 公开覆盖入口；其他变体默认不启用背景模糊。

### v1.2.0 (2026-07-06)

- `TabItem` 新增可选 `icon`；默认内置模式可生成 `Button + Icon + Text`，完整支持 `variant="icon-toggle"`。

### v1.1.1 (2026-06-23)

#### Item 尺寸覆盖契约
- 明确 Item 尺寸样式优先级：`style > class > Button size > Tab size`；Tab size 仅作为未显式指定时的组合默认值。

### v1.1.0 (2026-06-23)

#### 新功能与尺寸契约
- 新增 `variant="bare"`：容器与 Item 均无外壳，不显示 indicator，支持文字、单 Icon 和混合内容，使用 12/16/20px gap 与 0.4→1 opacity 状态。
- Tab `size` 通过显式 Button size context 传给直系 `Button as="item"`；Button 自身仍是尺寸定义唯一来源，实例显式 `size` 优先。

### v1.0.8 (2026-06-22)

#### 组合能力
- 补充无外壳 Button Item 组合。Tab 的 `--snowui-button-opacity-override` 与 Button 的内部透明度变量属于同一根节点级联链，未激活仍为 0.4，不会叠乘为 0.16。

### v1.0.7 (2026-06-21)

#### 动效归口
- 新增 `TAB_INDICATOR_MOTION` 组件族 preset，indicator 的 transform、width、height 统一恢复为 transitions.dev Tabs sliding 的 250ms smooth-out。
- 位移改为消费真实存在的 Frame control bridge，移除不存在的 transform bridge 命名；Tab 不再误用通用 `RESIZE_MOTION`。

### v1.0.6 (2026-06-21)

#### 动效修复
- 修复 `variant="icon-toggle"` 切换后 ResizeObserver 以无动画同步覆盖 indicator 移动的问题；初始化后所有尺寸重测继续播放移动效果。
- Tab 根曾注入通用 resize preset；该方案已在 v1.0.7 被 Tab indicator 专属 preset 替代。

### v1.0.5 (2026-06-18)

#### 动效还原
- 完整对齐 transitions.dev Tabs sliding：indicator 的 transform、width、height 统一为 250ms 与 `cubic-bezier(0.22, 1, 0.36, 1)`，消除原先位移 200ms、尺寸 300ms 造成的不同步。
- 保留首次渲染与 resize 瞬间贴位，并补充 `prefers-reduced-motion` 关闭 indicator 过渡。

### v1.0.4 (2026-06-13)

#### 交互修正
- 背景移动对齐 transitions.dev Tabs sliding：indicator 改为直接写入 DOM `transform / width / height`，初始定位与 resize 时临时关闭 transition 并强制 reflow 贴位，只有用户切换时才执行滑动动效。

### v1.0.3 (2026-05-31)

#### 样式调整
- active Text / Icon 按 variant 拆分：pill / icon-toggle 保持 `--static-black-100`，underline 使用 `--primary`，solid 保持 Button 默认颜色链。
- inactive Text / Icon 统一使用 `--black-100 × opacity: 0.4`。
- 四种 variant 示例均补充 Icon，便于直接观察 Text / Icon 颜色继承。

### v1.0.2 (2026-05-31)

#### 样式调整
- 修正 Item 两态颜色源：inactive Text / Icon 保持 Button 默认 `--black-100`，active Text / Icon 使用 `--static-black-100`。
- inactive 的 40% 视觉仍只由整体 `opacity: 0.4` 表达；inactive hover 与 active 使用 `opacity: 1`。

### v1.0.1 (2026-05-31)

#### 样式调整
- 移除 inactive Item 的 40% 颜色值路径，改用 `opacity: 0.4`，hover / active 恢复 `opacity: 1`，对齐 `StyleSpec.md §2.4.5`。
- 新增 `--snowui-tab-inactive-opacity-override` / `--snowui-tab-hover-opacity-override` 外部覆盖入口。

### v1.0.0 (2026-05-20)

#### 新功能
- 初始实现:4 variant(pill / solid / underline / icon-toggle)× 3 size(sm/md/lg)× 2 direction(row/column)
- 共享 indicator 元素位置 / 尺寸过渡，消费 Frame control / size motion bridge 变量
- Roving tabindex 键盘行为,支持 selectionFollowsFocus 模式开关
- 支持 `fill` Figma fill 宽度,容器有显式宽度时横向子项等宽填满
- 配套为 Frame 新增 `FRAME_SIZE_MOTION_BRIDGE`,详见 bridge.md changelog v1.3.0

#### 修正
- `variant="underline"` 容器默认圆角为 0;下划线 / 竖线尺寸由组件计算,不依赖 CSS 强制覆盖内联尺寸