203 lines
7.6 KiB
Rust
203 lines
7.6 KiB
Rust
//! `component_map` 的守门测试：表槽位 ↔ 枚举次序、官方高程/形状、圆角分层（D32）、微度量入口。
|
||
//!
|
||
//! 拆成独立文件是为了让 `mod.rs` 留出文档空间（项目硬约束：单文件 ≤400 行）。
|
||
|
||
use super::*;
|
||
|
||
#[test]
|
||
fn table_matches_component_order() {
|
||
for (i, spec) in table::SPECS.iter().enumerate() {
|
||
assert_eq!(
|
||
spec.component as usize, i,
|
||
"SPECS 第 {i} 行顺序与枚举不一致"
|
||
);
|
||
}
|
||
}
|
||
|
||
#[test]
|
||
fn every_component_resolves() {
|
||
assert_eq!(Component::ALL.len(), table::SPECS.len());
|
||
for component in Component::ALL {
|
||
let spec = component.spec();
|
||
assert_eq!(spec.component, component);
|
||
assert!(spec.text.style().size_px >= 11.0);
|
||
}
|
||
}
|
||
|
||
#[test]
|
||
fn names_are_unique() {
|
||
let mut seen = std::collections::BTreeSet::new();
|
||
for component in Component::ALL {
|
||
assert!(
|
||
seen.insert(component.name()),
|
||
"组件名重复：{}",
|
||
component.name()
|
||
);
|
||
}
|
||
}
|
||
|
||
#[test]
|
||
fn elevation_matches_official_component_tokens() {
|
||
// A 级来源（androidx.compose.material3.tokens）：
|
||
// FilledCardTokens/OutlinedCardTokens.ContainerElevation = Level0
|
||
// MenuTokens.ContainerElevation = Level2
|
||
// DialogTokens.ContainerElevation = Level3
|
||
// SnackbarTokens.ContainerElevation = Level3
|
||
// AppBarTokens = Level0、ListTokens.ItemContainerElevation = Level0
|
||
// 偏离只允许出现在有登记的地方（Tooltip 是 B 级：token 文件里没有 Elevation 行）。
|
||
for (component, expect) in [
|
||
(Component::FilledCard, Elevation::Level0),
|
||
(Component::OutlinedCard, Elevation::Level0),
|
||
(Component::Menu, Elevation::Level2),
|
||
(Component::Dialog, Elevation::Level3),
|
||
(Component::Snackbar, Elevation::Level3),
|
||
(Component::TopAppBar, Elevation::Level0),
|
||
(Component::ListItem, Elevation::Level0),
|
||
(Component::TextField, Elevation::Level0),
|
||
] {
|
||
assert_eq!(
|
||
component.spec().elevation,
|
||
expect,
|
||
"{} 的高程与官方组件令牌不一致",
|
||
component.name()
|
||
);
|
||
}
|
||
// R4「全屏都在飘」的守门：一屏常见元素里带阴影（>Level0）的只允许是浮层。
|
||
for component in Component::ALL {
|
||
if component.spec().elevation > Elevation::Level0 {
|
||
assert!(
|
||
matches!(
|
||
component,
|
||
Component::Menu | Component::Dialog | Component::Snackbar | Component::Tooltip
|
||
),
|
||
"{} 不该有阴影（只有浮层允许）",
|
||
component.name()
|
||
);
|
||
}
|
||
}
|
||
}
|
||
|
||
#[test]
|
||
fn shapes_match_official_component_tokens() {
|
||
// 官方：卡片 CornerMedium(12)、对话框 CornerExtraLarge(28)、菜单 CornerExtraSmall(4)、
|
||
// 按钮/导航指示条 CornerFull、chip CornerSmall(8)。
|
||
assert_eq!(Component::FilledCard.spec().shape, ShapeScale::Medium);
|
||
assert_eq!(Component::OutlinedCard.spec().shape, ShapeScale::Medium);
|
||
assert_eq!(Component::Dialog.spec().shape, ShapeScale::ExtraLarge);
|
||
assert_eq!(Component::Menu.spec().shape, ShapeScale::ExtraSmall);
|
||
assert_eq!(Component::PrimaryButton.spec().shape, ShapeScale::Full);
|
||
assert_eq!(Component::Chip.spec().shape, ShapeScale::Small);
|
||
}
|
||
|
||
#[test]
|
||
fn only_primary_actions_use_filled_emphasis_and_one_dialog_layer() {
|
||
// 契约 §1：状态色不复用 accent、每屏最多一个实心 accent → 只有 primary-button 是
|
||
// 「实心强调」，其余按钮的形态由页面决定但不能是 Full + Level0 + Emphasized 的组合。
|
||
let primary = Component::PrimaryButton.spec();
|
||
assert_eq!(primary.shape, ShapeScale::Full);
|
||
assert_eq!(primary.text, TypeRole::LabelLarge);
|
||
// 浮层类必须比卡片层高。
|
||
assert!(Component::Dialog.spec().elevation > Component::OutlinedCard.spec().elevation);
|
||
assert!(Component::Menu.spec().elevation > Component::FilledCard.spec().elevation);
|
||
}
|
||
|
||
#[test]
|
||
fn morphs_always_expand_upwards() {
|
||
for component in Component::ALL {
|
||
if let Some(morph) = component.spec().morph {
|
||
assert_ne!(
|
||
morph.from,
|
||
morph.to,
|
||
"{} 的形变起止不能相同",
|
||
component.name()
|
||
);
|
||
// 方向必须「沿阶梯胀开」（morph 对 `Full` 也没问题，rank 把它排在末尾），
|
||
// 不比较像素跨度：`Full` 的半径依赖边长，用固定边长比会被 `None` 之外的大档拉爆。
|
||
assert!(
|
||
morph.from.rank() < morph.to.rank(),
|
||
"{} 的形变方向反了：{:?} → {:?}",
|
||
component.name(),
|
||
morph.from,
|
||
morph.to
|
||
);
|
||
}
|
||
}
|
||
}
|
||
|
||
#[test]
|
||
fn appended_variants_keep_the_frozen_order() {
|
||
// 枚举冻结为「只可末尾追加」：前 20 个的次序不能动（M69 只在末尾加 5 个）。
|
||
assert_eq!(Component::ALL.len(), 25);
|
||
assert_eq!(Component::ALL[0], Component::TopAppBar);
|
||
assert_eq!(Component::ALL[19], Component::EmptyState);
|
||
assert_eq!(Component::ALL[20], Component::Checkbox);
|
||
assert_eq!(Component::ALL[24], Component::Divider);
|
||
for (i, component) in Component::ALL.iter().enumerate() {
|
||
assert_eq!(*component as usize, i, "ALL 的次序与枚举判别值不一致");
|
||
}
|
||
}
|
||
|
||
#[test]
|
||
fn micro_radius_only_on_micro_controls() {
|
||
// D32：微半径只能给 ≤24dp 的微控件，且此时 `shape` 必须是占位 None（不参与渲染）。
|
||
let mut owners = Vec::new();
|
||
for component in Component::ALL {
|
||
let spec = component.spec();
|
||
let Some(radius) = spec.micro_radius else {
|
||
continue;
|
||
};
|
||
owners.push(component);
|
||
assert_eq!(radius, ComponentRadius::Micro, "白名单外的微半径不许过表");
|
||
assert_eq!(
|
||
spec.shape,
|
||
ShapeScale::None,
|
||
"{} 有微半径时 shape 必须占位 None（2dp 不在刻度里）",
|
||
component.name()
|
||
);
|
||
let metrics = component
|
||
.metrics()
|
||
.expect("带微半径的组件必须有 ComponentMetrics");
|
||
assert!(
|
||
metrics.width <= crate::shape::MICRO_CONTROL_MAX_SIZE
|
||
&& metrics.height <= crate::shape::MICRO_CONTROL_MAX_SIZE,
|
||
"{} 超出微控件尺寸上限",
|
||
component.name()
|
||
);
|
||
assert_eq!(
|
||
radius.radius_px(metrics.width),
|
||
Some(radius.dp()),
|
||
"{} 的微半径按自身尺寸取不到",
|
||
component.name()
|
||
);
|
||
}
|
||
assert_eq!(
|
||
owners,
|
||
vec![Component::Checkbox],
|
||
"当前只允许 Checkbox 用微半径"
|
||
);
|
||
}
|
||
|
||
#[test]
|
||
fn metrics_resolve_only_for_controls_with_inner_geometry() {
|
||
for component in [
|
||
Component::Checkbox,
|
||
Component::Radio,
|
||
Component::Search,
|
||
Component::NavigationDrawer,
|
||
] {
|
||
assert!(
|
||
component.metrics().is_some(),
|
||
"{} 缺 ComponentMetrics",
|
||
component.name()
|
||
);
|
||
}
|
||
// Divider 只有厚度，而厚度是一像素线（LM），不该出现在 CM 里。
|
||
assert!(Component::Divider.metrics().is_none());
|
||
// 骨架级尺寸不许在 CM 里重复一份（Single Source of Truth）。
|
||
for component in [Component::Search, Component::NavigationDrawer] {
|
||
let metrics = component.metrics().unwrap();
|
||
assert_eq!(metrics.width, 0.0, "{} 的宽度属骨架级", component.name());
|
||
assert_eq!(metrics.height, 0.0, "{} 的高度属骨架级", component.name());
|
||
}
|
||
}
|