组件/导航组件

EAffix 固钉

import EUI 1.0

示例与代码

固钉

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Flickable { id: flickable clip: true height: 280 width: parent.width contentHeight: 760 Column { width: parent.width spacing: 20 EText { text: "向下滚动，按钮会固定在顶部" } EAffix { target: flickable EButton { text: "固定操作" } } Repeater { model: 14 EText { text: "内容 " + (index + 1) } } } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

属性

属性说明取值与默认值

appendToItem

浮层挂载的目标对象。

默认值null

contentalias

内容插槽；直接在组件内部声明 QML 子对象。

默认值别名：contentHost.data

enabledbool

是否允许交互；false 时控件禁用。

默认值true

heightreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitHeight

offsetreal

相对布局、滚动目标或弹层参考对象的偏移；单位为像素。

默认值0

positionint

固定在滚动区域的上方或下方。

EPlacement.Top
EPlacement.Bottom

默认值EPlacement.Top

revisionint

内部数据或几何变化版本，用于使相关绑定重新计算。

默认值0

targetItem

滚动、定位或加载遮罩所作用的目标对象。

默认值null

teleportedbool

是否把固钉内容挂载到独立浮层目标。

默认值false

visiblebool

是否显示组件。

默认值true

widthreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitWidth

zIndexint

浮层或水印的层叠顺序。

默认值100

fixedbool只读

固钉内容是否已进入固定定位状态。

默认值由运行时计算

targetPositionpoint只读

固钉或引导目标计算后的坐标和尺寸。

字段：x, y

默认值由运行时计算

信号

签名作用

changed(bool fixed)

固定状态变化时触发，fixed 表示当前是否吸附固定。

scrolled(real top, bool fixed)

目标滚动时触发，top 为滚动位置，fixed 为当前固定状态。

方法

签名作用

update()

重新检查吸附状态和固定位置。