feat 完善注释

This commit is contained in:
Ironsp
2026-10-01 17:24:57 +08:00
parent 2b59f68fd7
commit 9f4a5c7cda
183 changed files with 485 additions and 3615 deletions

View File

@@ -1,18 +1,12 @@
// 通用工具类
// 内容容器:设计稿内容宽 1780(x70→1850,specs2 全量复核)
// 1920 视口下 padding 70 → 内容 1780;窄视口只收窄留白,不产生横向滚动。
// ⚠️ 不能用固定 70px 留白:窄视口下 1780+140 > 视口宽 → 横向滚动条。
.container {
width: 100%;
max-width: @container-width;
margin: 0 auto;
// 留白夹在 16 与 70 之间:(1920 − 1780) / 2 = 70
padding: 0
clamp(@spacing-base, calc((100% - @page-content) / 2), @page-gutter);
}
// 首页容器:首页设计稿单独基准(内容 1680,留白 120)
.container--home {
padding: 0 @home-gutter;
@@ -21,14 +15,9 @@
}
}
// ============ 登录 / 注册 / 找回密码(蓝湖设计稿 02·51·54·55) ============
// 三页共用外壳:左侧 784 品牌渐变面板 + 右侧白底表单区(表单块在右区内居中)。
// 设计稿锚点:面板 (0,0) 784×1080;主标 (257,304) 40/700;标语 (257,715) 22/600。
.auth-page {
position: relative;
display: flex;
// ⚠️ html 上有全局 zoom(@page-zoom):内部 100vh 会被再缩一次,
// 渲染高 = 100vh × zoom,故必须除以 zoom 才能铺满真实视口(否则底部留灰带)。
min-height: calc(100vh / @page-zoom);
background: @white;
@@ -38,7 +27,7 @@
&__brand {
.flex(column, flex-start, center);
flex: 0 0 @login-brand-width; // 35%,右栏 flex:1 自动占 65%
flex: 0 0 @login-brand-width;
padding: 304px 24px 0;
background: linear-gradient(
160deg,
@@ -74,7 +63,6 @@
color: @white;
}
// 游客模式固定 24px(不再乘 @auth-font-scale)
&__guest {
position: absolute;
top: 28px;
@@ -90,7 +78,6 @@
}
}
// 表单项在右侧区域内水平 + 垂直居中(不再按设计稿固定锚点定位)
&__main {
.flex(column, center, center);
flex: 1;
@@ -101,8 +88,6 @@
&__card {
.flex(column, flex-start, flex-start);
width: 693px;
// 标题 / 副标题 / 表单标签一律左对齐(设计稿 x1039)。
// 显式声明是为了不继承任何父级 text-align:center —— 三页(登录/注册/找回)共用。
text-align: left;
}
@@ -114,9 +99,6 @@
color: #1f2937;
}
// 老大要求:主标 / 副标在**表单列内**居中(设计稿原锚点 x1039 是左对齐)。
// 表单列 = margin-left:17px + 宽 680;这里用 padding-left:17px 把居中盒同步右移,
// 使两者的视觉中轴与表单列中轴重合(而不是与 693 宽的卡片中轴重合,否则会偏左 7px)。
&__title,
&__subtitle {
align-self: center;