FloatButton#
通用
@rockshin/tao-ui提供持续可见的悬浮操作与返回顶部控件。
组件采用 tao-ui 原生实现,公共 API 对齐 Ant Design 6.7.0。外观、主题 token 与 Semantic DOM 定制遵循 tao-ui,主题通过 TaoProvider 配置。
按钮、Group 与 BackTop 遵循 6.7.0;提示与徽标使用 tao-ui 组件,滚动动画遵循减弱动态效果偏好;固定控件在 iframe 中预览。
#何时使用
适合跨当前页面使用的少量操作,纯图标按钮需提供可访问名称。
#代码演示
#基础操作与提示
TSX
import { useState } from "react";
import { FloatButton } from "@rockshin/tao-ui";
export default function Example() {
const [count, setCount] = useState(0);
return (
<div style={{ minHeight: 220 }}>
<p>Action count: {count}</p>
<FloatButton
tooltip="Create item"
aria-label="Create item"
type="primary"
onClick={() => setCount(count + 1)}
/>
</div>
);
}#形状、文字与徽标
TSX
import { FloatButton } from "@rockshin/tao-ui";
export default function Example() {
return (
<div style={{ minHeight: 220 }}>
<FloatButton
content="Help"
shape="square"
tooltip="Help"
style={{ insetInlineEnd: 84 }}
/>
<FloatButton content="Chat" badge={{ count: 8 }} tooltip="Messages" />
</div>
);
}#点击展开分组与位置
TSX
import { useState } from "react";
import { FloatButton } from "@rockshin/tao-ui";
export default function Example() {
const [selected, setSelected] = useState("None");
return (
<div style={{ minHeight: 260 }}>
<p>Selected: {selected}</p>
<FloatButton.Group
trigger="click"
tooltip="Actions"
aria-label="Actions"
placement="left"
shape="square"
>
<FloatButton content="A" onClick={() => setSelected("Action A")} />
<FloatButton content="B" onClick={() => setSelected("Action B")} />
</FloatButton.Group>
</div>
);
}#受控分组
TSX
import { useState } from "react";
import { Button, FloatButton } from "@rockshin/tao-ui";
export default function Example() {
const [open, setOpen] = useState(false);
return (
<div style={{ minHeight: 260 }}>
<Button onClick={() => setOpen(!open)}>
{open ? "Close actions" : "Open actions"}
</Button>
<FloatButton.Group
trigger="click"
open={open}
onOpenChange={setOpen}
tooltip="Actions"
aria-label="Actions"
>
<FloatButton content="One" />
<FloatButton content="Two" />
</FloatButton.Group>
</div>
);
}#悬停展开与禁用操作
TSX
import { FloatButton } from "@rockshin/tao-ui";
export default function Example() {
return (
<div style={{ minHeight: 260 }}>
<FloatButton.Group
trigger="hover"
tooltip="More actions"
aria-label="More actions"
>
<FloatButton content="Ready" />
<FloatButton content="Locked" disabled />
</FloatButton.Group>
</div>
);
}#返回滚动容器顶部
TSX
import { useRef } from "react";
import { FloatButton } from "@rockshin/tao-ui";
export default function Example() {
const target = useRef<HTMLDivElement>(null);
return (
<div>
<div
ref={target}
style={{
height: 260,
overflow: "auto",
border: "1px solid var(--tao-color-border)",
padding: 16,
}}
>
<p>Scroll down to reveal BackTop.</p>
<div
style={{
height: 900,
background:
"linear-gradient(var(--tao-color-fill-tertiary), transparent)",
}}
/>
</div>
<FloatButton.BackTop
target={() => target.current!}
visibilityHeight={120}
showProgress
duration={250}
/>
</div>
);
}#API
#FloatButton
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| className | 节点类名 | string | undefined | - |
| style | 节点样式 | CSSProperties | undefined | - |
| disabled | 是否禁用 | boolean | undefined | - |