Files
aurora-admin/frameworks-mobile/Sticky.css
T
aurora-admin f1fbfc2ddb
Regression / regression (push) Canceled after 0s
feat(品牌标识): 几何 K 图标(favicon/顶栏标记/theme-color) + 并行会话成果入库
## 品牌标识(本次会话)

起因:品牌此前没有任何图形标识 —— 唯一 favicon 是内联 data-URI 里的字母「A」,
那是 v2.0.0「Aurora Admin → Kole UI」改名漏掉的一处(PC 顶栏也是「A」,
移动端站已是「K」;移动端文档站则完全没有 favicon)。

- 几何:24 网格三个互不接触的笔画(竖 + 两斜),圆头描边;
  描边 2.25 → 16px 标签页尺寸下正好 1.5px = 规范原文「描边1.5px」
- 取色分两套(刻意):favicon 硬编码品牌蓝/白(渲染在浏览器标签栏,不继承 kole-dark);
  顶栏标记走 currentColor(实测暗色下自动转 rgb(20,22,28))
- 新增 theme-color 双条(light #FFFFFF / dark #1C1F26,取 --kole-color-card-bg)
- 修 site/app.js hero 标语 KOLE ADMIN → KOLE UI(改名变形残留)
- 移动端 7 个模板补 favicon(此前计数 0)

验收:门禁 9 条全 OK(site-routing/site-routes/mobile-docs/mobile-site/isolation/
theme/nav/i18n/icons);PC 回归 1464/1464 · 移动端 807/807,各连跑 8 次一致;
两端 favicon 405 字节逐字节一致;PC 站控制台错误 1→0。

## 并行会话成果(本次一并入库)

- 图标系统:2576 图标(TDesign/Element Plus,MIT)+ 11 端注入 + 5 个构建门禁工具
  + IconPreview 预览页 + ICON-SPEC.md 冻结规格
- 移动端平台:47 组件 × 6 端 + 文档站 53 页 + 隔离门禁
- PC 组件:103 个大后台组件 / 组件11 批次
- uni-app:PC 端试点 + 移动端端实现 + 真实编译验证

## 工程

- .gitignore 补 .scratch/ 与 .zcode-preexisting-*.txt(会话中间产物,实测 9.1MB,不入库)
- CHANGELOG 补品牌标识条目
- ROADMAP 登 S8-P4(品牌标识任务包 + og:image/apple-touch-icon 未做部分)
2026-09-21 10:05:48 +08:00

97 lines
3.3 KiB
CSS

/* Kole UI Mobile · Sticky 样式 — 对齐移动端规格 §39
吸顶容器:用 CSS 原生 position: sticky(不是 JS 监听滚动 + position: fixed)——
后者在触屏上会随惯性滚动抖动,且离开文档流后会占位丢失、需要手动补占位元素。
sticky 的贴合位置由 `--kole-m-sticky-offset` 决定(默认等于导航栏高度,业务侧可覆盖),
safeArea=true 时再叠加安全区;吸顶后的形态变化由宿主按滚动位置切 is-stuck。 */
.kole-m-sticky {
/* 组件级变量:贴合边缘的偏移量(业务侧可覆盖,贴底用法通常覆盖为 0) */
--kole-m-sticky-offset: var(--kole-m-navbar-height);
position: sticky;
z-index: 100;
box-sizing: border-box;
display: flex;
align-items: center;
gap: var(--kole-space-8);
min-height: var(--kole-m-touch-target);
padding: var(--kole-space-8) var(--kole-m-gutter);
background: var(--kole-color-card-bg);
color: var(--kole-color-text-title);
font-family: var(--kole-font-family);
font-size: var(--kole-m-font-size-body);
font-weight: 500;
line-height: 1.4;
}
/* 变体 position:贴顶 / 贴底 */
.kole-m-sticky--top { top: var(--kole-m-sticky-offset); }
.kole-m-sticky--bottom { bottom: var(--kole-m-sticky-offset); }
/* 变体 safeArea=true:偏移叠加刘海 / 底部横条安全区(env() 不可用时安全区为 0px) */
.kole-m-sticky--top.kole-m-sticky--safe {
top: calc(var(--kole-m-sticky-offset) + var(--kole-m-safe-top));
}
.kole-m-sticky--bottom.kole-m-sticky--safe {
bottom: calc(var(--kole-m-sticky-offset) + var(--kole-m-safe-bottom));
}
/* 变体 shadow=true:吸顶后才出现的阴影(未吸顶时与内容齐平,不留悬空感) */
.kole-m-sticky--shadow { box-shadow: none; }
.kole-m-sticky--shadow.is-stuck { box-shadow: var(--kole-shadow-medium); }
/* 状态 is-stuck:已贴合边缘(由宿主按滚动位置切换) */
.kole-m-sticky.is-stuck {
border-block-end: 1px solid var(--kole-color-border);
}
.kole-m-sticky--bottom.is-stuck {
border-block-end: 0;
border-block-start: 1px solid var(--kole-color-border);
}
.kole-m-sticky__title {
flex: 1 1 auto;
min-width: 0;
overflow: hidden;
white-space: nowrap;
text-overflow: ellipsis;
}
.kole-m-sticky__extra { flex: 0 0 auto; font-size: var(--kole-m-font-size-label); font-weight: 400; color: var(--kole-color-text-secondary); }
/* 容器内的动作按钮(可选):原生 button,热区 44px,负外边距吸收不撑高栏体 */
.kole-m-sticky__action {
flex: 0 0 auto;
display: inline-flex;
align-items: center;
justify-content: center;
box-sizing: border-box;
min-width: var(--kole-m-touch-target);
height: var(--kole-m-touch-target);
margin-inline-end: calc(-1 * var(--kole-space-12));
padding: 0 var(--kole-space-8);
border: 0;
border-radius: var(--kole-radius-base);
background: none;
color: var(--kole-color-brand);
font-family: inherit;
font-size: var(--kole-m-font-size-label);
font-weight: 400;
line-height: 1;
cursor: pointer;
touch-action: manipulation;
}
.kole-m-sticky__action:active { background: var(--kole-color-brand-bg); }
.kole-m-sticky__action:focus-visible {
outline: 2px solid var(--kole-color-focus-ring);
outline-offset: -2px;
}
@media (prefers-reduced-motion: reduce) {
.kole-m-sticky { transition: none; }
}