SxPropertyInspector (属性检查器)
NextUI 内部工具组件。用于动态编辑组件属性的检查面板，支持多种数据类型。
使用场景
- Workbench 属性编辑
- Demo 配置面板
- 动态参数调试
约束说明
Groups 需包含至少一个分组。PropertyItem.Value 需与 Type 匹配。
行为说明
- 宽度不足时自动切换紧凑模式。
- 可拖拽调整标签列宽。
API
Parameters (参数)
| 状态 |
参数名 |
类型 |
默认值 |
描述 |
| Implemented |
Groups |
List<PropertyResultGroup> |
new() |
属性分组集合。 |
| Implemented |
CompactWidthThreshold |
string |
"16rem" |
紧凑布局阈值。 |
| Implemented |
LabelMinWidth |
string |
"6rem" |
左列最小宽度。 |
| Implemented |
ValueMinWidth |
string |
"6rem" |
右列最小宽度。 |
| Implemented |
Id (继承) |
string? |
null |
组件 Id。 |
| Implemented |
Class (继承) |
string? |
null |
CSS 类名。 |
| Implemented |
Style (继承) |
string? |
null |
自定义样式。 |
| Implemented |
Title (继承) |
string? |
null |
HTML title。 |
| Implemented |
AdditionalAttributes (继承) |
IEnumerable<KeyValuePair<string, object>>? |
null |
额外属性。 |
Events (事件)
| 状态 |
事件名 |
类型 |
描述 |
| Implemented |
OnUpdate |
EventCallback<PropertyUpdateArgs> |
任意属性值被用户修改时触发。 |
布局规范（Layout）
双列表格模式（默认）
- 列宽比例：默认
1/3 : 2/3（左列属性名 / 右列值）。
- 分割线：支持拖拽调整，自动记住比例。
- 对齐规则：
- 左列：左对齐。
- 右列：整体右对齐（开关/按钮靠右，输入框铺满）。
- 行高：以文本框高度为基准，行高一致、内容垂直居中。
- 行分割线：每行都有横线，视觉为表格风格。
紧凑模式（宽度过窄时）
- 触发阈值默认
16rem（可配置）。
- 能一行尽量一行，放不下时允许两行或多行。
- 控件按类型区别展示：Switch 仍靠右，文本/选择类可铺满。
编辑呈现（默认策略）
- 文本/数字：默认直接显示“紧凑无边框”输入框。
- 枚举/列表：使用紧凑无边框选择控件。
- 布尔：使用 Switch，右对齐。
PropertyItem 扩展字段
| 字段 |
类型 |
描述 |
IsReadOnly |
bool |
是否以只读方式展示该属性（只显示值，不可编辑）。 |
IsDisabled |
bool |
是否禁用该属性的交互控件。 |
Hint |
string? |
属性说明或不可编辑原因提示。 |
参考设计 (References)
