为什么捐赠
API 浏览器
联系站长
布局 QPageSticky

QPageSticky 组件能够将 DOM 元素或组件固定在 QPage 内容区域的指定位置,并在页面滚动时保持位置固定。

该组件的一大特色是智能避让功能:即使布局中的页眉、页脚或抽屉未设置为固定定位,被 QPageSticky 包装的元素也不会与它们重叠。当这些布局元素可见时,QPageSticky 会自动计算并调整其位置,确保内容始终可见。例如,当页脚未固定时,用户滚动到页面底部时,QPageSticky 包装的元素会自动上移以避免被页脚遮挡。

QPageSticky API

正在加载 QPageSticky API...

用法

TIP

QPageSticky 需要在 QLayout 环境中使用。虽然默认情况下 QLayout 会管理整个窗口,但在这些示例中,我们使用了容器化的 QLayouts 以便演示。这种做法仅用于示例目的,实际应用中您可以根据需求选择合适的布局方式。

WARNING

使用 QPageSticky 时请注意:

  • 组件必须放置在 QLayout 组件内部
  • 组件必须是其父级容器的最后一个子元素,这样才能确保正确的层叠顺序

基础用法

此示例展示了 QPageSticky 的基本功能,您可以:

  • 通过菜单按钮控制抽屉菜单的显示/隐藏
  • 滚动页面观察固定元素的行为
  • 调整视窗大小,体验在 700px 和 500px 断点时的响应式布局效果
基础示例



扩展用法

以下示例展示了如何利用 QPageSticky 的扩展功能来实现一个页面专属的工具栏,演示了更复杂的应用场景:

扩展示例