Skip to content

Log 日志流

等宽字体的日志展示容器,支持增量追加与"贴底"自动滚动,适合构建控制台/构建输出等场景。

基础用法

基础日志流

通过 lines property(或 lines 属性传 JSON 字符串)提供数据;追加内容时只增量渲染新增行,不重建已有节点。

行号

显示行号

追加与自动滚动

追加日志流(贴底自动滚动)

每 1.2s 追加一条日志;仅当用户停靠在底部时自动滚动,上翻阅读历史时不会打断。

关闭自动滚动

auto-scroll=false

设置 auto-scroll="false" 后追加内容不会自动滚到底。

空态

空日志

lines 显示空态占位,文案走 locale(可通过 empty-text 覆盖)。

自定义空态文案

empty-text 覆盖默认空态文案(默认「暂无日志」)。

API

属性

属性说明类型默认值
auto-scroll追加后自动滚动到底(仅贴底时滚动)stringtrue
empty-text空态文案(覆盖 locale 默认值)
line-number显示左侧行号栏boolean
lines日志行 JSON 字符串(属性通道)string[][]

部件:::part(viewport) 滚动视口、::part(log) 日志内容、::part(row) 单行、::part(line-number) 行号、::part(line) 行文本、::part(empty) 空态。