SxWordcloudChart UI 设计规范

自动生成时间: 2026-02-04 组件路径: src/NextUI.Blazor/Components/SxWordcloudChart.razor

1. 组件概述

  • 组件包含 8 个参数，0 个回调，0 个公开方法。

2. 组件模式

模式 条件 说明
- - -

3. 表单字段

字段组件 绑定
- -

4. 操作按钮

外观 动作/链接 禁用条件
- - -

5. 验证规则

未检测到显式验证标记。

6. 状态与流程

内部状态字段： 未检测到明确状态字段。

7. 公共 API

7.1 Parameters

参数 类型 默认值 说明
NameField string "name" Field name for word text when Data contains objects. Default is "name".
ValueField string "value" Field name for word weight when Data contains objects. Default is "value".
Shape string "circle" The shape of the word cloud. Can be: - 'circle' (default) - 'cardioid' (heart shape) - 'diamond' - 'square' - 'triangle-forward' - 'triangle' - 'pentagon' - 'star'
SizeRangeMin int 12 Minimum font size in pixels. Default is 12.
SizeRangeMax int 60 Maximum font size in pixels. Default is 60.
RotationStep int 45 Rotation step in degrees. Default is 45.
GridSize int 8 Grid size for word placement. Larger values mean more spacing. Default is 8.
DrawOutOfBound bool false Whether to draw text outside the container bounds. Default is false.

7.2 Public Methods

无公开方法。

7.3 Events/Callbacks

无回调事件。

8. 典型使用场景 (Use Cases)

8.1 UC-1: 基础渲染

  1. 组件渲染默认状态
  2. 关键区域可见
  3. 无异常

9. 状态不变性测试 (State Invariants)

  • 同一参数重复设置不应触发非必要 UI 改变
  • 与表单字段无关的操作不应影响字段值

10. 测试检查点

  • 默认渲染与基础交互

11. Fluent UI 对齐

未在官方 Fluent UI Blazor 组件目录中找到直接对应项（以官方 demo/docs 目录为准）。

12. 参考文档摘要

  • docs/components/SxWordcloudChart.md: SxWordcloudChart (词云图) - Implemented

13. 规范合规检查

  • 未检测到明显硬编码颜色/px。

14. 变更历史

  • 2026-02-04: 深度分析填充规范。