Whisper 弹窗触发器
为一个元素绑定事件,触发后显示一个浮层。
获取组件
import { Whisper } from 'rsuite';
// or
import Whisper from 'rsuite/Whisper';
演示
自定义浮层
Props
<Whisper>
属性名称 | 类型 (默认值) |
描述 |
---|---|---|
container | HTMLElement | (() => HTMLElement) | 设置渲染的容器 |
controlId | string | 设置 id 到 <Overlay> 上,并且设置 aria-describedby 到 <Whisper> 上 |
defaultOpen | boolean | 默认是否显示 |
delay | number | 延迟时间 (ms) |
delayClose | number | 延迟关闭时间 (ms) |
delayOpen | number | 延迟打开时间 (ms) |
enterable | boolean | 当 trigger 值为 hover 时候,鼠标是否可进入提示框浮层中 |
followCursor | boolean | 是否启用光标跟随 |
full | boolean | 撑满容器 |
onBlur | () => void | 失去焦点回调函数 |
onClick | () => void | 点击的回调函数 |
onClose | () => void | 关闭回调函数 |
onEnter | () => void | 显示前动画过渡的回调函数 |
onEntered | () => void | 显示后动画过渡的回调函数 |
onEntering | () => void | 显示中动画过渡的回调函数 |
onExit | () => void | 退出前动画过渡的回调函数 |
onExited | () => void | 退出后动画过渡的回调函数 |
onExiting | () => void | 退出中动画过渡的回调函数 |
onFocus | () => void | 获取焦点的回调函数 |
onOpen | () => void | 打开回调函数 |
open | boolean | 手动控制是否显示 |
placement | Placement ('right') |
显示位置 |
preventOverflow | boolean | 防止浮动元素溢出 |
speaker * | Tooltip | Popover | ReactElement | 展示的元素 |
trigger | Trigger (['hover','focus']) |
触发事件,可以通过数组配置多事件 |
Whisper methods
Whisper 上的方法可以通过 ref
获得。
const whisperRef = useRef();
<Whisper ref={whisperRef} {...}>
...
</Whisper>
可用的方法包括
- open
打开一个浮层
open: (delay?: number) => void
- close
关闭一个浮层
close: (delay?: number) => void
- updatePosition
更新浮层位置
updatePosition: () => void
ts:Trigger
type Trigger =
| Array<'click' | 'contextMenu' | 'hover' | 'focus' | 'active'>
| 'click'
| 'contextMenu'
| 'hover'
| 'focus'
| 'active'
| 'none';
ts:Placement
type Placement =
| 'top'
| 'bottom'
| 'right'
| 'left'
| 'bottomStart'
| 'bottomEnd'
| 'topStart'
| 'topEnd'
| 'leftStart'
| 'leftEnd'
| 'rightStart'
| 'rightEnd'
| 'auto'
| 'autoVerticalStart'
| 'autoVerticalEnd'
| 'autoHorizontalStart'
| 'autoHorizontalEnd';