响应式与断点
ruanno-ui 的 Web 组件同时面向桌面与移动端:同一组件在小屏上自动调整交互(触摸目标、换行、弹层位置),布局组件则提供声明式的响应式 prop。
断点
| 断点 | 宽度 | 典型设备 |
|---|---|---|
base | < 640px | 手机竖屏 |
sm | ≥ 640px | 手机横屏 / 小平板 |
md | ≥ 768px | 平板 |
lg | ≥ 1024px | 笔记本 |
xl | ≥ 1280px | 桌面 |
断点值来自 @ruanno-ui/tokens(tokens.json 的 breakpoint 组),JS 侧可通过 breakpointPx 导入。
useBreakpoint()
ts
import { useBreakpoint } from "ruanno-ui";
const { width, current, isMobile, is } = useBreakpoint();
// width: 当前视口宽度(Ref<number>)
// current: 当前命中的最大断点,"base" | "sm" | "md" | "lg" | "xl"
// isMobile: width < 768
// is("md"): width >= 768SSR 安全:挂载前 width 为 0,current 为 "base"。
布局组件的响应式 prop
Row / Col 栅格
24 列栅格,Col 支持按断点设置跨列:
vue
<Row :gutter="16">
<Col :span="24" :md="12" :xl="8">手机整行,平板半行,桌面 1/3</Col>
<Col :span="24" :md="12" :xl="16">其余内容</Col>
</Row>xs / sm / md / lg / xl 均为该断点下的 span,缺省沿用基础 span;另支持 offset / push / pull。
Stack / Grid 的响应式间距
间距类 prop 支持「断点对象」写法:
vue
<Stack :gap="{ base: 8, md: 16, xl: 24 }" direction="row" wrap>
<Tag v-for="t in tags" :key="t">{{ t }}</Tag>
</Stack>base 为缺省值,其余断点按「≥ 断点宽度生效,取命中的最大断点」规则覆盖。
CSS 侧
组件内部的响应式行为用标准媒体查询实现,断点与上表一致。业务侧建议同样消费 tokens:
css
@media (min-width: 768px) {
.page { padding: var(--rn-spacing-6); }
}移动端适配清单
组件库内置的移动适配,业务无需重复处理:
- 触摸交互:统一 Pointer Events,鼠标 / 触摸同一套逻辑;按钮等控件移动端建议
md/lg尺寸(触摸目标 ≥ 36px); - 安全区:固定定位组件消费
env(safe-area-inset-*),页面根容器建议加padding-bottom: env(safe-area-inset-bottom); - 视口:
index.html使用<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">; - 弹层:Dialog / ActionSheet 等在窄屏自动贴边 / 底部弹出样式;
- 横竖屏:组件尺寸均基于容器与视口实时计算,旋转屏幕无需手动刷新。
移动端专属交互组件(PullRefresh、SwipeCell、IndexBar、Picker、TabBar 等)在 Web 端同样可用,适合桌面浏览器里的窄栏 / 抽屉场景。
完整移动端业务示例参考仓库 apps/h5(移动商城):
bash
pnpm --filter @ruanno-ui/h5 dev