R后悔药 Rue.js
  • 首页
    • 深度指南
    • 实战例子
    • 快速上手
    • 路由指南
    • 术语表
    • 错误代码参考
  • API
    • 合作伙伴
    • 插件
    • 组件库
    • 工具链
    • Text.js
    • 新闻简报
    • 常见问题
    • 团队
    • 版本发布
    • 社区指南
    • 行为规范
    • 隐私政策
  • 赞助
  • 合作伙伴
设置
目录统计
总条目
  • 按钮 Button
  • 排版 Typography
  • 时间选择器 TimePicker
  • 下拉菜单 Dropdown
  • 悬浮操作按钮 FAB
  • 模态框 Modal
  • 切换 Swap
  • 主题控制器 Theme Controller
  • 手风琴 Accordion
  • 头像 Avatar
  • 徽标 Badge
  • 卡片 Card
  • 轮播 Carousel
  • 聊天气泡 Chat
  • 折叠面板 Collapse
  • 倒计时 Countdown
  • 描述列表 Descriptions
  • 对比 Diff
  • 二维码 QRCode
  • 悬浮 3D 卡片 Hover 3D
  • 悬浮画廊 Hover Gallery
  • 键盘提示 Kbd
  • 列表 List
  • 统计 Stat
  • 状态 Status
  • 表格 Table
  • 文本轮播 Text Rotate
  • 时间线 Timeline
  • 锚点 Anchor
  • 固钉 Affix
  • 面包屑 Breadcrumbs
  • 底部导航 Dock
  • 链接 Link
  • 菜单 Menu
  • 导航栏 Navbar
  • 分页 Pagination
  • 步骤 Steps
  • 选项卡 Tabs
  • 提示 Alert
  • 结果页 Result
  • 空状态 Empty
  • 加载 Loading
  • 全局提示 Message
  • 进度条 Progress
  • 环形进度 Radial Progress
  • 骨架屏 Skeleton
  • 通知提醒框 Notification
  • 轻提示 Toast
  • 气泡确认框 Popconfirm
  • 气泡卡片 Popover
  • 工具提示 Tooltip
  • 日历 Calendar
  • 颜色选择器 ColorPicker
  • 复选框 Checkbox
  • 字段集 Fieldset
  • 表单 Form
  • 文件输入 File Input
  • 筛选器 Filter
  • 标签 Label
  • 单选框 Radio
  • 范围选择 Range
  • 评分 Rating
  • 分段选择 Segmented
  • 自动完成 AutoComplete
  • 选择器 Select
  • 树选择 TreeSelect
  • 树控件 Tree
  • 提及输入 Mentions
  • 穿梭框 Transfer
  • 漫游引导 Tour
  • 输入框 Input
  • 数字输入 InputNumber
  • 文本域 Textarea
  • 开关 Toggle
  • 校验器 Validator
  • 分隔线 Divider
  • 弹性布局 Flex
  • 分割面板 Splitter
  • 抽屉侧边栏 Drawer
  • 页脚 Footer
  • 栅格 Grid
  • 瀑布流 Masonry
  • 布局 Layout
  • 主视觉区 Hero
  • 指示器 Indicator
  • 组合项 Join
  • 蒙版 Mask
  • 水印 Watermark
  • 间距 Space
  • 堆叠 Stack
  • 浏览器样机 Mockup Browser
  • 代码样机 Mockup Code
  • 手机样机 Mockup Phone
  • 窗口样机 Mockup Window
目录统计
总条目
  • 按钮 Button
  • 排版 Typography
  • 时间选择器 TimePicker
  • 下拉菜单 Dropdown
  • 悬浮操作按钮 FAB
  • 模态框 Modal
  • 切换 Swap
  • 主题控制器 Theme Controller
  • 手风琴 Accordion
  • 头像 Avatar
  • 徽标 Badge
  • 卡片 Card
  • 轮播 Carousel
  • 聊天气泡 Chat
  • 折叠面板 Collapse
  • 倒计时 Countdown
  • 描述列表 Descriptions
  • 对比 Diff
  • 二维码 QRCode
  • 悬浮 3D 卡片 Hover 3D
  • 悬浮画廊 Hover Gallery
  • 键盘提示 Kbd
  • 列表 List
  • 统计 Stat
  • 状态 Status
  • 表格 Table
  • 文本轮播 Text Rotate
  • 时间线 Timeline
  • 锚点 Anchor
  • 固钉 Affix
  • 面包屑 Breadcrumbs
  • 底部导航 Dock
  • 链接 Link
  • 菜单 Menu
  • 导航栏 Navbar
  • 分页 Pagination
  • 步骤 Steps
  • 选项卡 Tabs
  • 提示 Alert
  • 结果页 Result
  • 空状态 Empty
  • 加载 Loading
  • 全局提示 Message
  • 进度条 Progress
  • 环形进度 Radial Progress
  • 骨架屏 Skeleton
  • 通知提醒框 Notification
  • 轻提示 Toast
  • 气泡确认框 Popconfirm
  • 气泡卡片 Popover
  • 工具提示 Tooltip
  • 日历 Calendar
  • 颜色选择器 ColorPicker
  • 复选框 Checkbox
  • 字段集 Fieldset
  • 表单 Form
  • 文件输入 File Input
  • 筛选器 Filter
  • 标签 Label
  • 单选框 Radio
  • 范围选择 Range
  • 评分 Rating
  • 分段选择 Segmented
  • 自动完成 AutoComplete
  • 选择器 Select
  • 树选择 TreeSelect
  • 树控件 Tree
  • 提及输入 Mentions
  • 穿梭框 Transfer
  • 漫游引导 Tour
  • 输入框 Input
  • 数字输入 InputNumber
  • 文本域 Textarea
  • 开关 Toggle
  • 校验器 Validator
  • 分隔线 Divider
  • 弹性布局 Flex
  • 分割面板 Splitter
  • 抽屉侧边栏 Drawer
  • 页脚 Footer
  • 栅格 Grid
  • 瀑布流 Masonry
  • 布局 Layout
  • 主视觉区 Hero
  • 指示器 Indicator
  • 组合项 Join
  • 蒙版 Mask
  • 水印 Watermark
  • 间距 Space
  • 堆叠 Stack
  • 浏览器样机 Mockup Browser
  • 代码样机 Mockup Code
  • 手机样机 Mockup Phone
  • 窗口样机 Mockup Window

Stack 堆叠容器

Stack 使用 Rue 当前的 stack 视觉风格,同时把 API 补成更清晰的语义层。除了基础的vertical和horizontal,现在还支持placement 组合定位,以及reverse反向层级。

何时使用

  • 需要把多张卡片、图片、文件封面或通知面板做成同一视觉堆叠。
  • 需要用一条属性快速切换堆叠朝向和落点,而不想反复记忆底层 class。
  • 需要保持当前堆叠视觉,但希望额外控制最新项是否位于最上层。

# 基础堆叠

展示 3 div stackDemo,作为最小可用写法。

1
2
3

# 图片堆叠

展示 stacked images,用于相册封面或图库预览。

Stack example 1Stack example 2Stack example 3

# 卡片堆叠

展示 stacked cards,适合做 deck、ticket 或文件层。

A
B
C

# 对齐与 Placement

基础的 vertical / horizontal 继续可用;placement 可以直接表达组合定位。

vertical="top"
A
B
C
horizontal="start"
A
B
C
placement="top-end"
A
B
C
placement="bottom-start"
A
B
C

# 反向层级

reverse 适合把最当前本、最新消息或最新封面放在最上层。

Default order
v1 Initial draft
v2 Review notes
v3 Final copy
reverse
v3 Final copy
v2 Review notes
v1 Initial draft

# 阴影层次

展示 shadow 示例,适合强调卡片深度和层级关系。

A
B
C

# 通知堆叠

展示通知示例,并结合 reverse 展示“最新一条在最上层”的常见用法。

Notification 3

Latest release is live. Tap here to share the changelog.

Notification 2

Deploy finished successfully. Tap here to open the report.

Notification 1

You have 3 unread messages. Tap here to see.

# 场景组合

把 as、placement、reverse 和 className 组合起来,可以很快搭出带语义的堆叠封面。

Release deck
Draft
Roadmap 2026
Review
Product launch notes
Published
April release
Asset pile
open-graph.png
thumbnail.png
hero.png

API

当前页面展示的是 Stack 的完整可用 API,基础属性保持,新属性作为语义增强层补充进来。

属性说明类型默认值
as指定根节点标签或组件,适合 section、article 等语义容器。any'div'
className补充容器尺寸、圆角、边框、背景等样式。string-
horizontal水平方向定位;显式传入时会覆盖 placement 里的水平预设。'center' | 'start' | 'end''center'
placement组合定位快捷写法,用一条属性同时声明 vertical 和 horizontal。'center' | 'top' | 'bottom' | 'start' | 'end' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end''center'
reverse反转子节点渲染顺序,适合把最新项放在最上层。booleanfalse
vertical垂直方向定位;显式传入时会覆盖 placement 里的垂直预设。'center' | 'top' | 'bottom''center'

placement 快捷映射

placement="top"→vertical="top"
placement="bottom"→vertical="bottom"
placement="start"→horizontal="start"
placement="end"→horizontal="end"
placement="top-start"→vertical="top" + horizontal="start"
placement="bottom-end"→ vertical="bottom" + horizontal="end"

FAQ

已经有 vertical 和 horizontal,为什么还要加 placement?

placement适合快速写组合定位,尤其是top-end、bottom-start这类常见场景。 如果你已经在用API,也可以使用基础的 vertical和horizontal。

placement 和 vertical / horizontal 同时传会怎样?

显式传入的vertical、horizontal优先级更高。也就是说,placement更像一个快捷预设,而不是强制覆盖层。

reverse 会改变样式还是改变 DOM 顺序?

reverse 会反转子节点渲染顺序,因此最适合“最新项在最上层”的内容流场景,比如通知、版本封面、设计稿堆叠。

页内导航
页内导航
文档
  • 深度指南
  • 实战例子
  • 快速上手
  • 术语表
  • 错误码参照表
关于
  • 常见问题
  • 团队
  • 版本发布
  • 社区指南
生态
  • 插件
  • 组件库
  • 路由指南
  • Text.js
© 2024-2026 Xiangmin Liu
Rue.JS