跳到主要内容

响应式与断点 ​

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 >= 768

SSR 安全:挂载前 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