Skip to main content
All docs
V25.2
  • Enable the Report Designer's Skeleton Screen

    • 2 minutes to read

    When the Web Report Designer loads its UI and report, it can display a skeleton screen (content placeholder):

    Web Report Designer  -- Skeleton screen

    The skeleton screen is enabled in DevExpress Reporting ASP.NET Core templates. You can create a sample project using templates and review the code for skeleton screen implementation details. For information on DevExpress Templates, refer to the following help topic: Use DevExpress Templates to Create an ASP.NET Core App with a Report Designer.

    If your project is not based on DevExpress Templates, modify project files as follows to enable the skeleton screen:

    1. Reference the dx-reporting-skeleton-screen.css file from the devexpress-reporting npm package on the page that contains the Report Designer:

      @section Scripts {
          <link href="~/css/dx-reporting-skeleton-screen.css" rel="stylesheet" />
          ...
      }
      
    2. Render two separate parts of the reporting control:

      • Call the RenderHtml method to render markup.
      • Call the RenderScripts method to render scripts.
      @{
          var designerRender = Html.DevExpress().ReportDesigner("reportDesigner")
              .Height("1000px")
              .Bind("TestReport");
          @designerRender.RenderHtml()
      }
      
      @section Scripts {
          <link href="~/css/dx-reporting-skeleton-screen.css" rel="stylesheet" />
          ...
          @designerRender.RenderScripts()
      }
      
    3. Render scripts in the specified section after all other scripts are rendered:

      <!DOCTYPE html>
      <html>
      <head>
      @*
      ...
      *@
      </head>
      <body>
          @*
          ...
          *@
          @RenderSection("Scripts", false)
      </body>
      </html>
      
    4. Specify the dx-reporting-skeleton-screen.css file in the bundle configuration:

      [
        // ...
        {
          "outputFileName": "wwwroot/css/dx-reporting-skeleton-screen.css",
          "inputFiles": [
            "node_modules/devexpress-reporting/dist/css/dx-reporting-skeleton-screen.css"
          ],
          "minify": {
            "enabled": false,
            "adjustRelativePaths": false
          }
        }
        // ...
      ]
      
    5. Rebuild and run the project.