# CodeBlock 更新日志

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

### v1.8.2 (2026-10-23)

- 单行代码与附件、普通／全屏语言标签与动作组保持至少4 CSS px；更大首选覆盖依原响应式协议压缩／恢复。单行变体复用Frame singleLine并标记Fill内容槽，防止响应方向改为列或短代码使trailing丢失位置。代码、行号、原滚动／复制／格式化和全屏行为保持。

- 2026-09-28：同步 Indicator 的统一命中与状态视觉；Corner 默认同时调整宽高，显式单轴配置继续生效。

- 2026-09-27：text/plain/plaintext/txt 独立文本着色，英文标识及数字复用关键字粉色，URL 复用注释灰色；不再把 URL 后正文误判为注释。

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

| 日期 | 版本 | 说明 |
|:---|:---|:---|
| 2026-09-18 | v1.8.0 | 新增 `horizontalScrollbarVisibility`，允许横向滚动条仅在代码块 hover 时显示；默认仍为溢出时常显。 |
| 2026-09-03 | v1.7.0 | 新增默认开启的 format，按语言格式化展示及复制内容；支持显式关闭、异步竞态保护、原文回退与单行变体保留。 |
| 2026-08-17 | v1.6.3 | 默认态、全屏态与 `singleLine` 接入共享 Overlay 横向滚动条；代码横向溢出时常显并支持拖拽，不再隐藏原生条后缺少可见滚动反馈 |
| 2026-08-15 | v1.6.2 | 内部 `pre` / `code` 显式使用 `border-box`，与既有 padding、margin、font reset 一起隔离可选 `snowui-base.css` 的元素级影响 |
| 2026-08-12 | v1.6.1 | `singleLine` 的 padding、gap 与圆角对齐 Input 标准态：上下 12px、左右 16px、gap 8px、圆角 16px |
| 2026-08-12 | v1.6.0 | 新增 `variant="singleLine"`；参考 Input 实现 Leading / Content / Trailing 三槽布局，保留高亮与复制，移除语言、行号、全屏、纵向滚动及高度拖拽结构 |
| 2026-08-09 | v1.5.1 | Button bare 默认改为 100% 后，内置复制 / 放大操作显式使用 `emphasis="muted"` 保留原 40% → hover 100% 的次级操作视觉 |
| 2026-07-30 | v1.5.0 | 全屏展开/收起改用共享元素 `layout` 策略，实际过渡位置与尺寸，代码字形不参与缩放；普通态与全屏态统一遵循 `showLineNumbers`，消除退出末帧横向突变 |
| 2026-07-08 | v1.4.7 | 顶部操作按钮容器的 `pin-top-right` 偏移从 `--padding-2`（8px）调整为 `--padding-3`（12px），普通态与全屏态保持一致 |
| 2026-07-08 | v1.4.6 | 顶部复制 / 放大操作按钮统一使用 Button bare 默认 16×16 尺寸；移除 CodeBlock 私有按钮外壳尺寸，按钮组间距改为 `--gap-2`（8px）并接入 `--snowui-code-block-gap-override` |
| 2026-06-21 | v1.4.4 | 右下角私有 resize icon 与 pointer 算法迁移到统一 Indicator corner；复用宿主 hover、1px→2px、颜色、键盘和 ARIA 协议 |
| 2026-06-22 | v1.4.5 | 修复 Indicator action 创建 effect 订阅受控高度，导致首次 pointermove 写回后销毁拖拽会话；保持与旧版 CodeBlock、Textarea 相同的连续 pointer capture 语义 |
| 2026-05-02 | v1.4.1 | 全屏放大/缩小改为调用 Frame controller 的共享元素 FLIP 布局转场，进入从普通态位置放大，退出缩回普通态位置 |
| 2026-05-01 | v1.4.0 | 默认高度改为内容自适应到最多 15 行；新增右下角拖拽高度手柄；新增顶部/尾部滚动遮罩 |
| 2026-05-01 | v1.3.6 | 新增 `showLanguage` 控制语言标识显示；工具栏间距调整为 language 与按钮组 8px、按钮之间 4px |
| 2026-05-01 | v1.3.5 | 按钮 hover 对齐 Button `bare`：关闭背景叠加，默认透明度 0.4，hover 透明度 1 |
| 2026-05-01 | v1.3.4 | 按钮区颜色统一为 `--black-40`；按钮 hover 改为规范要求的 `currentColor` 叠加层 |
| 2026-05-01 | v1.3.3 | 新增 `visibleLines` 控制默认状态显示几行代码；行号列与代码列间距改为 `--gap-3`（12px） |
| 2026-05-01 | v1.3.2 | 隔离 `snowui-base.css` 全局 `code` 样式对 CodeBlock 内部 `<code>` 的 padding/margin/font 影响；排版统一由根容器继承控制 |
| 2026-05-01 | v1.3.1 | 修复行号列与代码列的行盒对齐；移除组件内残留 `font-family` 设置 |
| 2026-05-01 | v1.3.0 | 支持 `<CodeBlock>代码</CodeBlock>` children 直接写代码；外置动作槽改为与 Input 一致的 `as="trailing"`；代码字号/行高改为 `--text-12` / `--leading-12` |
| 2026-05-01 | v1.2.0 | 代码区默认显示 5 行并接入通用浮层滚动条；全屏退出改为 Frame `whileAppear` 反向播放；整体背景统一为 Background/2；语法 token 色直接写死到选择器 |
| 2026-05-01 | v1.1.0 | 按 Figma Code block 设计还原浅色代码块样式；新增内置轻量语法着色；代码文字不再设置字号、行高与字体 |
| 2026-04-30 | v1.0.0 | 初始创建：代码块显示、行号、复制、全屏放大，Frame 默认动效驱动图标切换 |