时间分隔/格式化(TimeSeparator)
时间分隔/格式化:TimeSeparator 是 IDL 定义的跨端 UI 组件,props / events / behaviors 在各平台语义一致。本页给出契约属性、事件、渲染行为、数据源与 Electron 端绑定/示例。
契约属性(props)
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
timestamp | int64 | 是 | 时间戳(epoch 毫秒) |
now | int64 | 否 | 参照时间(便于测试注入;默认当前时间) |
事件
该组件未声明事件;交互通过属性和宿主回调完成。
渲染行为
- 当天 HH:mm;昨天“昨天 HH:mm”;7 天内“周X HH:mm”;更早 YYYY-MM-DD HH:mm
数据源
未在 IDL 声明 dataSource;由宿主从 IMLib 拉取(getConversationList / getHistoryMessages / MESSAGES / CONVERSATION 事件)。
依赖边界
组件不直连网络与数据库:会话/消息由宿主从 IMLib 拉取后传入,组件只做排序、角标、格式化与渲染。
平台绑定
| 项 | 值 |
|---|---|
| 公开符号 / 签名 | TimeSeparator(props: {timestamp: number; now?: number}) |
| 导出列表包含 | 是 |
| UI 框架 | React 组件(props 契约),宿主渲染;组件不直连网络 / DB / IPC |
使用示例
JavaScript / TypeScript
IMKit.mount(container, 'TimeSeparator', { timestamp: Date.now() - 300000 });相关文档
- 功能列表:能力矩阵
- 组件 API:全部组件 props / events
- 主题定制
- 多语言与格式化
- Electron IMLib:数据来源