AtomUI/docs/Desktop.Controls/Timeline/TimelineAPI.md

Timeline API 参考

命名空间

namespace AtomUI.Desktop.Controls;        // Timeline, TimelineItem
namespace AtomUI.Controls.Commons;         // AbstractTimeline, AbstractTimelineItem（基类）
namespace AtomUI.Controls;                 // TimeLineMode 枚举

AXAML 命名空间前缀：atom（xmlns:atom="https://atomui.net"）

---

枚举类型

TimeLineMode

时间轴布局模式枚举，控制内容和指示器的相对位置。

值	说明
Left	左对齐模式（默认），指示器在左、内容在右
Right	右对齐模式，指示器在右、内容在左
Alternate	交替模式，内容在指示器左右交替排列

---

Timeline 公共属性（StyledProperty）

以下属性定义在 AbstractTimeline 基类中，Timeline 继承使用。

属性名	类型	默认值	说明
Mode	TimeLineMode	TimeLineMode.Left	布局模式，控制内容与指示器的相对位置
Pending	object?	null	待办节点内容，非 null 时自动在末尾添加带 Loading 图标的幽灵节点
PendingIcon	PathIcon?	null（默认 LoadingOutlined）	待办节点的自定义指示器图标
IsReverse	bool	false	是否反转排列所有节点

继承自 ItemsControl 的常用属性

属性名	类型	默认值	说明
Items	ItemCollection	—	子项集合，通常为 TimelineItem 实例
ItemTemplate	IDataTemplate?	null	子项数据模板
ItemsSource	IEnumerable?	null	数据绑定源集合
Background	IBrush?	SharedToken.ColorBgContainer	时间轴容器背景色
BorderBrush	IBrush?	SharedToken.ColorBorder	容器边框颜色

---

TimelineItem 公共属性（StyledProperty）

以下属性定义在 AbstractTimelineItem 基类中，TimelineItem 继承使用。

属性名	类型	默认值	说明
Label	string?	null	标签文本（如日期），设置后触发标签布局模式
IndicatorIcon	PathIcon?	null	自定义指示器图标，替代默认空心圆点
IndicatorColor	IBrush?	null（默认 ColorPrimary）	指示器颜色（圆点边框或图标填充色）

继承自 ContentControl 的常用属性

属性名	类型	默认值	说明
Content	object?	null	节点内容（可以是文本字符串或任意控件）
ContentTemplate	IDataTemplate?	null	内容数据模板

---

事件

Timeline 和 TimelineItem 没有定义额外的公共事件。可使用继承的标准事件：

事件名	来源	说明
PointerPressed	Control	指针按下
PointerReleased	Control	指针释放

---

伪类（Pseudo-Classes）

TimelineItem 特有伪类

伪类	常量	触发条件
order-odd	AbstractTimelineItem.OrderOddPC	节点处于奇数位置（从 0 开始计算）
order-even	AbstractTimelineItem.OrderEvenPC	节点处于偶数位置
order-first	AbstractTimelineItem.OrderFirstPC	第一个节点
order-last	AbstractTimelineItem.OrderLastPC	最后一个节点
pending-item	AbstractTimelineItem.PendingItemPC	待办（Pending）节点

继承的标准伪类

伪类	触发条件
:pointerover	鼠标悬浮
:disabled	IsEnabled == false

---

静态构造器影响

AbstractTimeline

以下属性变更会触发重新测量（AffectsMeasure）：

• Mode

以下属性变更会触发重新排列（AffectsArrange）：

• IsReverse

AbstractTimelineItem

以下属性变更会触发重新排列（AffectsArrange）：

• Mode

以下属性变更会触发重新测量（AffectsMeasure）：

• IsReverse