Stimulsoft参数面板自动显示变量Description如何关闭？

问题背景在 Stimulsoft 报表里变量常被用作输入参数。为了让最终用户看到更友好的字段名开发者通常会维护Alias而Description更适合放内部说明、业务解释或维护备注。原帖用户反馈的问题是从 Stimulsoft Designer、Angular、JS 等2026.2.1版本开始报表启动后参数面板会自动显示变量定义中的Description。此前即使变量填了Description界面上也主要展示Alias。升级后旧报表不改模板也会出现更高的参数项导致报表主体显示区域被压缩。这类问题容易被误判为样式表、前端布局或容器高度问题。实际关键点并不在 CSS而是新版 Viewer/Designer 增加了参数描述显示行为需要使用官方提供的开关控制。官方回复要点Stimulsoft 官方支持人员先记录了内部编号#20165随后给出处理结论新增ParametersPanelShowDescriptions选项用于控制参数面板是否显示描述并说明该选项会在后续构建中提供。之后官方又补充了 .NET 侧的选项名StiOptions.Viewer.Windows.ShowParameterDescription。本次核查时Stimulsoft Reports.JS的 npm 最新版本为2026.2.4。其 TypeScript 定义中已经可以看到对应属性StiViewerOptions.appearance.parametersPanelShowDescriptions。Stimulsoft Reports.NET官方2026.2.3变更日志也列出了StiOptions.Viewer.Windows.ShowParameterDescription说明 .NET 侧开关已进入公开版本。因此可以把解决方向拆成两类JS/Angular/前端 Viewer在创建 Viewer 前将options.appearance.parametersPanelShowDescriptions设为false。.NET Windows Viewer在 Viewer 初始化前将StiOptions.Viewer.Windows.ShowParameterDescription设为false。JS / Angular 侧写法在 Reports.JS 或 Dashboards.JS 中官方论坛提到的是ParametersPanelShowDescriptions而 TypeScript 定义中暴露的属性是小驼峰写法parametersPanelShowDescriptions。它位于Stimulsoft.Viewer.StiViewerOptions的appearance对象下。典型写法如下constoptionsnewStimulsoft.Viewer.StiViewerOptions();options.appearance.parametersPanelShowDescriptionsfalse;constviewernewStimulsoft.Viewer.StiViewer(options,StiViewer,false);viewer.reportreport;viewer.renderHtml(viewer);关键是设置时机要在创建 Viewer 或渲染 Viewer 之前完成。参数面板已经渲染后再改这个值通常还需要重新创建或刷新 Viewer才会反映到当前 UI。如果项目封装了 Angular 组件可以把这段逻辑放在创建 viewer options 的位置而不是散落到报表模板里privatecreateViewerOptions():Stimulsoft.Viewer.StiViewerOptions{constoptionsnewStimulsoft.Viewer.StiViewerOptions();options.appearance.parametersPanelShowDescriptionsfalse;returnoptions;}这样做的好处是所有通过该组件打开的报表都会采用同一策略不需要逐个删除变量的Description。.NET Viewer 侧写法如果使用的是 .NET Windows Viewer官方变更日志给出的选项是StiOptions.Viewer.Windows.ShowParameterDescriptionfalse;建议在创建或显示 Viewer 之前设置例如usingStimulsoft.Report;StiOptions.Viewer.Windows.ShowParameterDescriptionfalse;varreportnewStiReport();report.Load(Report.mrt);report.Show();如果项目中有统一的报表入口例如报表预览服务、桌面端报表窗口基类或应用启动配置可以把这行代码放在那里。这样比逐个修改.mrt报表文件更稳也不会破坏变量定义中的说明信息。需要注意官方论坛补充的是.NET version中的Viewer.Windows选项。ASP.NET、Blazor、JS Viewer 等 Web 场景不要直接套用这行 C# 全局选项应优先使用对应前端 Viewer options 中的parametersPanelShowDescriptions。不建议删除所有 Description原帖用户也提到一个临时思路把所有显示变量的Description值删掉。这个方法能让界面恢复简洁但不建议作为首选。原因有三个Description本身可能有维护价值删除后报表模板会丢失说明信息。已有报表数量多时逐个改模板风险高也不利于回滚。后续如果又希望在某些场景显示描述模板里的信息已经被破坏。更合理的做法是保留变量定义使用 Viewer 层的显示开关决定是否在参数面板呈现描述。模板负责表达业务含义运行时界面负责控制展示密度。排查清单先确认当前版本。JS/Angular 项目检查stimulsoft-reports-js或stimulsoft-dashboards-js是否已经升级到包含parametersPanelShowDescriptions的构建本次核查的2026.2.4类型定义中已经包含该属性。搜索项目中创建StiViewerOptions的位置确认是否设置了options.appearance.parametersPanelShowDescriptions false。确认设置发生在 Viewer 创建、绑定报表、渲染之前。如果 TypeScript 提示没有该属性先检查安装包版本和导入的类型定义不要直接用any绕过版本问题。.NET Windows Viewer 项目检查是否在应用启动或 Viewer 初始化前设置了StiOptions.Viewer.Windows.ShowParameterDescription false。如果仍然显示描述确认当前页面没有创建第二套 Viewer options或在后续代码里又把该开关改回默认值。版本与注意事项官方支持人员在 2026 年 5 月表示新增ParametersPanelShowDescriptions。stimulsoft-reports-js2026.2.4的 TypeScript 定义中包含appearance.parametersPanelShowDescriptions。Stimulsoft Reports.NET2026.2.3官方变更日志包含StiOptions.Viewer.Windows.ShowParameterDescription。如果你的项目低于这些构建可能看不到该选项。此时不要把问题归因到样式失效优先升级到包含该开关的版本再做配置验证。另外JS 属性是parametersPanelShowDescriptions首字母小写官方论坛里的ParametersPanelShowDescriptions更像功能选项名或跨平台描述名。写代码时以当前包的类型定义和 IntelliSense 为准。总结核心不是参数控件坏了而是参数面板默认展示信息变多了。对于需要保留变量说明、但不希望最终用户界面变高的项目不要急着批量删除Description。在 JS/Angular 侧使用options.appearance.parametersPanelShowDescriptions false在 .NET Windows Viewer 侧使用StiOptions.Viewer.Windows.ShowParameterDescription false就能把显示密度控制放回运行时配置层。内容来源说明官方问答来源Stimulsoft Community ForumVariables filter display官方支持人员于 2026-05-05 提到新增ParametersPanelShowDescriptions并于 2026-05-15 补充 .NET 选项名。API 核查来源https://forum.stimulsoft.com/viewtopic.php?p176526https://www.stimulsoft.com/en/changes/reports-net/2026.2.3https://registry.npmjs.org/stimulsoft-reports-js/latesthttps://unpkg.com/stimulsoft-reports-js2026.2.4/Scripts/stimulsoft.reports.d.tshttps://unpkg.com/stimulsoft-dashboards-js2026.2.4/Scripts/stimulsoft.reports.d.ts