Log 日志流
等宽字体的日志展示容器,支持增量追加与"贴底"自动滚动,适合构建控制台/构建输出等场景。
基础用法
基础日志流
通过 lines property(或 lines 属性传 JSON 字符串)提供数据;追加内容时只增量渲染新增行,不重建已有节点。
行号
显示行号
追加与自动滚动
追加日志流(贴底自动滚动)
每 1.2s 追加一条日志;仅当用户停靠在底部时自动滚动,上翻阅读历史时不会打断。
关闭自动滚动
auto-scroll=false
设置 auto-scroll="false" 后追加内容不会自动滚到底。
空态
空日志
空 lines 显示空态占位,文案走 locale(可通过 empty-text 覆盖)。
自定义空态文案
empty-text 覆盖默认空态文案(默认「暂无日志」)。
API
属性
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
auto-scroll | 追加后自动滚动到底(仅贴底时滚动) | string | true |
empty-text | 空态文案(覆盖 locale 默认值) | — | — |
line-number | 显示左侧行号栏 | boolean | — |
lines | 日志行 JSON 字符串(属性通道) | string[] | [] |
部件:::part(viewport) 滚动视口、::part(log) 日志内容、::part(row) 单行、::part(line-number) 行号、::part(line) 行文本、::part(empty) 空态。