For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/zh/components/border-beam.md.
v0.0.57
  • 简体中文
  • BorderBeam

    通用@rockshin/tao-ui

    用沿边框移动的光束突出活动中的区域。

    组件采用 tao-ui 原生实现,公共 API 对齐 Ant Design 6.7.0。外观、主题 token 与 Semantic DOM 定制遵循 tao-ui,主题通过 TaoProvider 配置。

    属性遵循 6.7.0 光束 API,子元素需暴露原生 DOM ref 或 nativeElement 句柄;动画只改变 transform,并遵循减弱动态效果偏好。

    何时使用

    用于需要强调的活动或处理中状态,同时保留明确的文字状态。

    代码演示

    活动卡片

    Processing
    12 tasks are running.
    TSX

    数量与时长

    Two beams
    Two highlights follow the same border with evenly spaced phases.
    TSX

    自定义渐变与单束覆盖

    Independent beams
    Each item controls its own color, size and line width.
    TSX

    偏移与不同圆角

    Activity stream
    The effect follows the top rounded corners and the square bottom corners.
    TSX

    切换活动状态

    Syncing changes
    The border animation follows the current state.
    TSX

    API

    BorderBeam

    属性说明类型默认值
    className节点类名string | undefined-
    style节点样式CSSProperties | undefined-