Files
aurora-admin/frameworks-mobile/Form.uniapp.vue
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

253 lines
7.8 KiB
Vue
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.
<template>
<view class="kole-m-form" :class="formClass">
<view
v-for="(item, i) in fields"
:key="String(keyOf(item, i))"
class="kole-m-form__item"
:class="{ 'is-error': !!(item && item.error) }"
>
<view class="kole-m-form__label">
<text v-if="item && item.required" class="kole-m-form__star">*</text>
<text>{{ item && item.label }}</text>
</view>
<view class="kole-m-form__main">
<view
v-if="item && item.type === 'select'"
class="kole-m-form__hit"
:role="disabled ? '' : 'button'"
:aria-disabled="disabled ? 'true' : 'false'"
@tap="onSelect(item)"
>
<text>{{ item.value || item.placeholder || '' }}</text>
<text class="kole-m-form__arrow">›</text>
</view>
<textarea
v-else-if="item && item.type === 'textarea'"
class="kole-m-form__control kole-m-form__control--multiline"
:name="item.name"
:value="item.value || ''"
:placeholder="item.placeholder || ''"
:disabled="disabled"
@input="onInput(item, $event)"
/>
<input
v-else
class="kole-m-form__control"
type="text"
:name="item && item.name"
:value="(item && item.value) || ''"
:placeholder="(item && item.placeholder) || ''"
:disabled="disabled"
:aria-required="item && item.required ? 'true' : 'false'"
:aria-invalid="item && item.error ? 'true' : 'false'"
@input="onInput(item, $event)"
/>
<text v-if="item && item.error" class="kole-m-form__error">{{ item.error }}</text>
<text v-if="item && item.hint" class="kole-m-form__hint">{{ item.hint }}</text>
</view>
</view>
<slot></slot>
<view v-if="submitText" class="kole-m-form__item">
<view
class="kole-m-form__submit"
:role="disabled ? '' : 'button'"
:aria-disabled="disabled ? 'true' : 'false'"
@tap="onSubmit"
>
<text>{{ submitText }}</text>
</view>
</view>
</view>
</template>
<script setup>
/* uni-app 端 · 表单(移动端)— 规格 §32
跨端差异:
① 表单根与字段用 view(小程序没有 <form> 的原生校验语义),提交用 view + role="button" + @tap;
② 控件是 uni 的 <input> / <textarea>,事件对象是 { detail: { value } },没有 DOM event.target;
③ 必填星号用 <text>,语义由 :aria-required 承担(小程序读屏读 aria-*);
④ 不支持 :focus-visible,聚焦反馈改由控件自身边框承担。
尺寸用 rpx:88rpx = 375pt 下的 44px 触控最小边长。 */
import { computed, ref } from 'vue';
const props = defineProps({
fields: { type: Array, default: () => [] },
labelPosition: { type: String, default: 'top' },
borderless: { type: Boolean, default: false },
disabled: { type: Boolean, default: false },
submitText: { type: String, default: '提交' }
});
const emit = defineEmits(['submit', 'change']);
/* 唯一实例基名:同页多实例不撞号(模块级自增即可) */
let seq = 0;
const base = ref('');
seq += 1;
base.value = 'kole-m-form-' + seq;
const formClass = computed(() => [
props.labelPosition === 'left' ? 'kole-m-form--left' : '',
props.borderless ? 'kole-m-form--borderless' : '',
props.disabled ? 'is-disabled' : ''
].filter(Boolean));
function keyOf(item, i) {
return item && item.name !== undefined ? item.name : i;
}
/* uni 的 input / textarea 事件对象为 { detail: { value } },无 DOM event.target */
function onInput(item, e) {
if (props.disabled) return;
emit('change', item && item.name, e && e.detail ? e.detail.value : '');
}
function onSelect(item) {
if (props.disabled) return;
emit('change', item && item.name, item && item.value);
}
function onSubmit() {
if (props.disabled) return;
emit('submit', props.fields);
}
</script>
<style>
.kole-m-form {
--kole-m-form-label-width: 144rpx; /* labelPosition=left 时的标签列宽(72px @375pt) */
--kole-m-form-gap: 16rpx; /* 标签与控件之间的间距 */
--kole-m-touch-target: 88rpx;
--kole-m-font-size-body: 32rpx;
--kole-m-font-size-label: 28rpx;
--kole-m-gutter: 32rpx;
box-sizing: border-box;
width: 100%;
background-color: var(--kole-color-card-bg);
color: var(--kole-color-text-body);
font-size: var(--kole-m-font-size-body);
}
.kole-m-form__item {
box-sizing: border-box;
display: flex;
flex-direction: column;
padding: 24rpx var(--kole-m-gutter);
}
.kole-m-form:not(.kole-m-form--borderless) .kole-m-form__item + .kole-m-form__item {
border-top: 1rpx solid var(--kole-color-border);
}
.kole-m-form--borderless .kole-m-form__item + .kole-m-form__item { border-top: 0; }
.kole-m-form--left .kole-m-form__item { flex-direction: row; }
.kole-m-form--left .kole-m-form__label {
flex-shrink: 0;
width: var(--kole-m-form-label-width);
padding-top: 18rpx;
}
.kole-m-form__label {
display: flex;
align-items: center;
margin-bottom: var(--kole-m-form-gap);
color: var(--kole-color-text-title);
font-size: var(--kole-m-font-size-label);
}
.kole-m-form--left .kole-m-form__label { margin-bottom: 0; }
.kole-m-form__star {
padding-right: 8rpx;
color: var(--kole-color-error);
}
.kole-m-form__main { flex: 1; }
.kole-m-form__control {
box-sizing: border-box;
width: 100%;
min-height: var(--kole-m-touch-target);
padding: 16rpx 24rpx;
border: 1rpx solid var(--kole-color-border);
border-radius: 8rpx;
background-color: var(--kole-color-card-bg);
color: var(--kole-color-text-body);
font-size: var(--kole-m-font-size-body);
}
.kole-m-form__control--multiline { min-height: 176rpx; }
/* 非输入型控件:整行热区,按下有反馈 */
.kole-m-form__hit {
box-sizing: border-box;
display: flex;
align-items: center;
justify-content: space-between;
min-height: var(--kole-m-touch-target);
padding: 16rpx 24rpx;
border: 1rpx solid var(--kole-color-border);
border-radius: 8rpx;
background-color: var(--kole-color-card-bg);
color: var(--kole-color-text-body);
}
.kole-m-form__hit:active { background-color: var(--kole-color-table-header-bg); }
.kole-m-form__arrow { color: var(--kole-color-text-placeholder); }
/* 状态 error:边框、标签与星号一起变错误色(不只靠一处提示) */
.kole-m-form__item.is-error .kole-m-form__control,
.kole-m-form__item.is-error .kole-m-form__hit { border-color: var(--kole-color-error); }
.kole-m-form__item.is-error .kole-m-form__label { color: var(--kole-color-error); }
.kole-m-form__error {
display: block;
padding-top: 8rpx;
color: var(--kole-color-error);
font-size: var(--kole-m-font-size-label);
}
.kole-m-form__hint {
display: block;
padding-top: 8rpx;
color: var(--kole-color-text-secondary);
font-size: var(--kole-m-font-size-label);
}
/* 状态 disabled:整表置灰 */
.kole-m-form.is-disabled { background-color: var(--kole-color-disabled-bg); }
.kole-m-form.is-disabled .kole-m-form__label,
.kole-m-form.is-disabled .kole-m-form__hint { color: var(--kole-color-text-disabled); }
.kole-m-form.is-disabled .kole-m-form__control,
.kole-m-form.is-disabled .kole-m-form__hit {
background-color: var(--kole-color-disabled-bg);
color: var(--kole-color-text-disabled);
}
/* 提交行:整行主操作(高度 ≥ 88rpx 触控边长) */
.kole-m-form__submit {
box-sizing: border-box;
display: flex;
align-items: center;
justify-content: center;
width: 100%;
min-height: var(--kole-m-touch-target);
border-radius: 8rpx;
background-color: var(--kole-color-brand);
color: var(--kole-color-text-inverse);
font-size: var(--kole-m-font-size-body);
}
.kole-m-form__submit:active { background-color: var(--kole-color-brand-active); }
.kole-m-form.is-disabled .kole-m-form__submit {
background-color: var(--kole-color-disabled-bg);
color: var(--kole-color-text-disabled);
}
</style>