Files
aurora-admin/frameworks-mobile/PullRefresh.html
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

172 lines
7.6 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
<title>Kole UI Mobile · PullRefresh(H5)</title>
<link rel="stylesheet" href="../.design_library/kole-ui-mobile/colors_and_type.css">
<link rel="stylesheet" href="PullRefresh.css">
<style>
body { margin: 0; background: var(--kole-color-page-bg); font-family: var(--kole-font-family); color: var(--kole-color-text-body); }
.demo { max-width: 375px; margin: 0 auto; padding: var(--kole-m-gutter) 0; }
.demo-label { margin: 0; padding: var(--kole-space-12) var(--kole-m-gutter) var(--kole-space-8);
font-size: var(--kole-m-font-size-label); color: var(--kole-color-text-secondary); }
.demo-frame { position: relative; max-width: 375px; margin: 0 auto; height: 200px;
overflow: hidden; background: var(--kole-color-card-bg); border-block: 1px solid var(--kole-color-border); }
.demo-list { margin: 0; padding: 0; list-style: none; }
.demo-list li { padding: var(--kole-space-12) var(--kole-m-gutter); border-bottom: 1px solid var(--kole-color-border);
.demo-block[hidden] { display: none; }
body.demo-single .demo-frame { margin-top: 0; }
body.demo-single .demo-label:first-child { padding-top: var(--kole-space-12); }
font-size: var(--kole-m-font-size-label); }
</style>
</head>
<body>
<div class="demo">
<section class="demo-block" data-demo="pull">
<p class="demo-label">下拉中(state=pull,未达阈值 60px)</p>
<div class="demo-frame" data-assert="pullrefresh-pull">
<div class="kole-m-pullrefresh is-pulling" style="--kole-m-pullrefresh-offset: 36px">
<div class="kole-m-pullrefresh__indicator" role="status" aria-live="polite">
<span class="kole-m-pullrefresh__spinner" aria-hidden="true"></span>
<span class="kole-m-pullrefresh__text">下拉即可刷新</span>
</div>
<div class="kole-m-pullrefresh__content">
<ul class="demo-list"><li>订单 20260920-001</li><li>订单 20260920-002</li></ul>
</div>
</div>
</div>
</section>
<section class="demo-block" data-demo="ready">
<p class="demo-label">已达阈值(state=ready,松手立即刷新)</p>
<div class="demo-frame" data-assert="pullrefresh-ready">
<div class="kole-m-pullrefresh is-ready" style="--kole-m-pullrefresh-offset: 60px">
<div class="kole-m-pullrefresh__indicator" role="status" aria-live="polite">
<span class="kole-m-pullrefresh__spinner" aria-hidden="true"></span>
<span class="kole-m-pullrefresh__text">松开立即刷新</span>
</div>
<div class="kole-m-pullrefresh__content">
<ul class="demo-list"><li>订单 20260920-001</li><li>订单 20260920-002</li></ul>
</div>
</div>
</div>
</section>
<section class="demo-block" data-demo="refreshing">
<p class="demo-label">刷新中(state=refreshing,在框内向下拖动触发)</p>
<div class="demo-frame" data-assert="pullrefresh-refreshing">
<div class="kole-m-pullrefresh" id="pr-gesture" data-behavior="pull-triggers:#pr-gesture|is-refreshing">
<div class="kole-m-pullrefresh__indicator" role="status" aria-live="polite">
<span class="kole-m-pullrefresh__spinner" aria-hidden="true"></span>
<span class="kole-m-pullrefresh__text">下拉即可刷新</span>
</div>
<div class="kole-m-pullrefresh__content">
<ul class="demo-list"><li>订单 20260920-001</li><li>订单 20260920-002</li></ul>
<button class="kole-m-pullrefresh__fallback" type="button" id="pr-refresh">刷新列表</button>
</div>
</div>
</div>
</section>
<section class="demo-block" data-demo="done">
<p class="demo-label">完成提示(state=done)</p>
<div class="demo-frame" data-assert="pullrefresh-done">
<div class="kole-m-pullrefresh is-done" style="--kole-m-pullrefresh-offset: 60px">
<div class="kole-m-pullrefresh__indicator" role="status" aria-live="polite">
<span class="kole-m-pullrefresh__spinner" aria-hidden="true"></span>
<span class="kole-m-pullrefresh__text">刷新完成</span>
</div>
<div class="kole-m-pullrefresh__content">
<ul class="demo-list"><li>订单 20260920-003(新)</li><li>订单 20260920-001</li></ul>
</div>
</div>
</div>
</div>
</section>
<script>
/* 手势:Pointer Events;位移以纵向为主 —— 横向分量更大时放弃本次下拉(规格 §4.5)。
达到阈值松手 → 同步进入 refreshing(可断言),随后异步进入 done 并复位。 */
(function () {
var root = document.getElementById('pr-gesture');
if (!root) return;
var THRESHOLD = 60;
var startY = 0, startX = 0, dy = 0, active = false;
function setOffset(v) { root.style.setProperty('--kole-m-pullrefresh-offset', v + 'px'); }
function setState(state, text) {
root.classList.remove('is-pulling', 'is-ready', 'is-refreshing', 'is-done');
if (state) root.classList.add('is-' + state);
var t = root.querySelector('.kole-m-pullrefresh__text');
if (t && text) t.textContent = text;
}
root.addEventListener('pointerdown', function (e) {
if (root.classList.contains('is-refreshing')) return;
active = true;
startY = e.clientY;
startX = e.clientX;
dy = 0;
});
root.addEventListener('pointermove', function (e) {
if (!active) return;
dy = e.clientY - startY;
var dx = Math.abs(e.clientX - startX);
if (dx > Math.abs(dy)) { active = false; return; }
if (dy <= 0) { setOffset(0); setState(null); return; }
setOffset(dy);
if (dy >= THRESHOLD) setState('ready', '松开立即刷新');
else setState('pulling', '下拉即可刷新');
});
function release() {
if (!active) return;
active = false;
if (dy >= THRESHOLD) refresh();
else { setOffset(0); setState(null, '下拉即可刷新'); }
}
root.addEventListener('pointerup', release);
root.addEventListener('pointercancel', release);
function refresh() {
setOffset(THRESHOLD);
setState('refreshing', '正在刷新…');
setTimeout(function () {
setState('done', '刷新完成');
setTimeout(function () { setOffset(0); setState(null, '下拉即可刷新'); }, 600);
}, 300);
}
var btn = document.getElementById('pr-refresh');
if (btn) btn.addEventListener('click', refresh);
})();
</script>
<script>
/* ?demo=<id> → 只显示该演示块:文档站为每个演示单独起一个 375×640 预览帧。
无参数时全部显示 —— 测试页与回归走无参数路径,行为不变。 */
(function () {
var id = new URLSearchParams(location.search).get('demo');
if (!id) return;
var blocks = Array.prototype.slice.call(document.querySelectorAll('.demo-block'));
var hit = false;
blocks.forEach(function (b) {
var on = b.getAttribute('data-demo') === id;
if (on) hit = true;
b.hidden = !on;
});
if (!hit) { blocks.forEach(function (b) { b.hidden = false; }); return; }
document.body.classList.add('demo-single');
/* 单块模式去掉 min-height:100vh —— 否则内容高度随帧高变化(帧高→vh→内容高)形成反馈环,
自适应量到的永远是视口高度而不是内容高度。 */
var demoBox = document.querySelector('.demo');
if (demoBox) demoBox.style.minHeight = 'auto';
/* 单块模式:帧内不再重复显示演示标题行(文档页已给出标题与说明) */
blocks.forEach(function (b) {
var label = b.querySelector('.demo-label');
if (label && !b.hidden) label.hidden = true;
});
})();
</script>
</body>
</html>