Props

名称	类型	默认值	说明
title	string	必填	主要信息，渲染为空状态里的标题元素。要写清“什么是空的”，例如 “No projects yet”，避免 “No data” 这类宽泛说法。
description	string	-	标题下方的辅助文字，解释这块区域为什么是空的，或者用户接下来可以做什么。渲染为 <div>。
headingLevel	1 | 2 | 3 | 4 | 5 | 6	3	标题的语义级别，只决定渲染的 HTML 标签（h1–h6），使标题能接上文档大纲。标题的视觉大小在任何级别下都相同。
isCompact	boolean	false	启用紧凑变体：收紧间距和文字大小，适用于卡片、侧边栏等空间受限的区域，操作按钮也会改为竖排。

插槽

名称	说明
icon	标题上方的图标或插图。外层容器带有 aria-hidden="true"，因此放在这里的图标不需要设置 label。
title	标题的富内容，会覆盖 title 属性，例如在标题里放一个链接。
description	说明文字的富内容，会覆盖 description 属性。因为渲染为 <div>，这里可以放列表、链接等块级元素。
actions	说明文字下方的操作按钮，通常是一到两个。默认横向排列并自动换行，isCompact 为 true 时改为竖向排列。

原生属性

根元素为 <div>。

以下内容传入根元素：

• HTML 属性。
• aria-* 属性。
• data-* 属性。
• class。
• style。

根元素默认带有 role="status"，显式传入的 role 会覆盖它。

主题令牌

packages/themes/neutral/empty-state.css 提供以下令牌，主题可以覆盖它们：

令牌	说明
--astryx-empty-state-title-foreground	标题颜色，默认与主要文字色一致。
--astryx-empty-state-description-foreground	说明文字颜色，默认与次要文字色一致。
--astryx-empty-state-text-width	标题与说明组成的文字列的最大宽度，默认 360px。