syncfusion-aspnetcore-3d-chart

用途

该技能面向在 ASP.NET Core（Razor）应用中实现 Syncfusion 3D 图表的开发场景。当需要 3D 图表功能、数据可视化、系列配置时使用。核心组件为标签助手 <ejs-chart3d>，用于渲染支持鼠标与触摸交互的 3D 可视化图表。

主要能力

• 多种图表类型：柱状图（Column）、条形图（Bar），以及堆叠变体 StackingColumn、StackingBar、StackingColumn100、StackingBar100。
• 数据绑定：支持本地 JSON 数据、通过 DataManager 的远程数据绑定，以及 OData 适配器配置；支持 XName、YName 属性映射与远程数据查询过滤，并可处理空数据点。
• 坐标轴与刻度：支持分类轴、数值轴、日期时间轴、对数轴，支持单图表多窗格及坐标轴自定义与标签定位。
• 数据标签与图例：可启用并定位数据标签，支持标签模板与格式化；图例支持上、下、左、右定位及自定义坐标定位、对齐与反转选项。
• 样式与外观：支持自定义调色板、按数据点映射颜色、图表背景与边框定制、单个数据点定制、边框样式与图表尺寸、主题与配色方案。
• 用户交互与事件：支持 Point、Series、Cluster 选择模式，点选高亮与事件，提示框启用与配置（固定或跟踪定位）、提示框格式模板与样式、选择事件处理。
• 高级功能：打印、导出为 PNG/SVG、无障碍与 WCAG 合规、事件处理（PointRender、TextRender、SelectionComplete）、大数据集性能优化、跨浏览器兼容。
• 其他：响应式设计与 RTL 支持。

使用方式

技能以参考文档导航形式组织，按需阅读对应文件：

• references/getting-started.md：安装与 NuGet 包设置、ASP.NET Core 项目配置、标签助手注册、脚本与样式引用、基础图表渲染与初始数据绑定。
• references/data-binding-series.md：本地 JSON 绑定、DataManager 远程绑定、OData 适配器、空数据点处理、XName/YName 映射、远程查询过滤。
• references/chart-types-series.md：条形图、柱状图、堆叠条形/柱状图、堆叠 100% 变体、系列可见性与数据映射、类型专属配置。
• references/axes-configuration.md：分类轴、数值轴、日期时间轴、对数轴、多窗格、坐标轴自定义与标签定位。
• references/data-labels-legends.md：数据标签启用与定位、模板与格式化、图例定位与对齐、标签可见性与重叠处理。
• references/styling-appearance.md：调色板、点级颜色映射、背景与边框、单点定制、主题与配色。
• references/user-interactions.md：选择模式、点选高亮与事件、系列选择、提示框配置与模板、选择事件处理。
• references/advanced-features.md：打印、导出 PNG/SVG、无障碍与 WCAG、事件处理、性能优化、跨浏览器兼容。

最小示例（ASP.NET Core Razor）：

<ejs-chart3d id="container" title="Product Sales" enableRotation="true" rotation="7" tilt="10" depth="100">
    <e-chart3d-primaryxaxis valueType="@Syncfusion.EJ2.Charts.ValueType.Category">
    </e-chart3d-primaryxaxis>
    <e-chart3d-series-collection>
        <e-chart3d-series dataSource="ViewBag.chartData" 
                          xName="month" 
                          yName="sales" 
                          type="@Syncfusion.EJ2.Charts.Chart3DSeriesType.Column">
        </e-chart3d-series>
    </e-chart3d-series-collection>
    <e-chart3d-legendsettings position="@Syncfusion.EJ2.Charts.LegendPosition.Bottom"></e-chart3d-legendsettings>
    <e-chart3d-tooltipsettings enable="true"></e-chart3d-tooltipsettings>
</ejs-chart3d>

public class HomeController : Controller
{
    public IActionResult Index()
    {
        List<ChartData> chartData = new List<ChartData>
        {
            new ChartData { month = "Jan", sales = 35 },
            new ChartData { month = "Feb", sales = 28 },
            new ChartData { month = "Mar", sales = 34 }
        };
        ViewBag.chartData = chartData;
        return View();
    }
}

public class ChartData
{
    public string month { get; set; }
    public double sales { get; set; }
}

常见模式包括：多系列对比（定义多个 <e-chart3d-series>、使用对比色、启用图例并通过图例点击切换系列可见性）；交互式数据探索（设置 SelectionMode 为 Point、启用自定义格式提示框、处理 PointRender 事件、实现选择事件回调）；实时数据更新（绑定动态数据源、更新集合并刷新、大数据集考虑远程绑定、按数据范围调整坐标轴）；多窗格显示（定义多行并设置行跨度、按索引分配系列、为每行配置独立坐标轴、使用同步 X 轴对齐）。

关键属性速查：type（图表类型）、xName（X 轴数据字段）、yName（Y 轴数据字段）、dataSource（系列数据）、visible（系列可见性）、cornerRadius（柱/条圆角，0-10 像素）、marker.visible（数据点标记）、dataLabel.visible（数据标签）、tooltip.enable（提示框）、selectionMode（None、Point、Series、Cluster）、background（图表背景色）、wallColor（3D 后墙颜色）。

适用场景

适用于需要在 ASP.NET Core Razor 应用中呈现 3D 数据可视化、进行多系列对比、交互式数据探索、实时数据展示或多窗格对比分析的场景。

限制

资料未提供该组件的收费、价格、授权方式、具体平台版本要求或性能指标等信息，暂未提供。