Edit this page

Render Modes

RadPivotGrid has three different render modes that can change the actual HTML markup that is rendered. Those render modes are exposed via the RenderMode property that accepts the following values -Classic, Mobile, Lightweight and Auto.

The possible options are:

  • Classic — this mode is the rendering that has been used before.It remains without changes and it is the default value of the property. In this mode tables and background images (in several sprites) are used to create the layout (including rounded corners and shadows).

  • Lightweight — this mode is supported since Q3 2015 version andemphasizes on semantic HTML and CSS3. It reduces the amount of markup the control renders and makes it easier to customize. This also reduces the number of image sprites required by the control and the other controlsfrom the suite it uses. In addition, all table elements are removed from the layout of the control. All of this decreases the overall size and complexity of each skin, including custom ones.

  • Auto — this option will automatically decide how to render the control on a smartphone, tablet or PC and will switch between Classic and Mobile render modes (depending on the used device).

important

RadPivotGrid and its child controls, as well as the other controls included in the Telerik® UI for ASP.NET AJAX suite that utilize render modes, support only one type of render mode per page. All such controls must have the same RenderMode on a given page. This also includes instances from user controls and master pages.

Setting Render Mode

There are two ways to configure the rendering mode of the controls:

  • Setting the RenderMode property in the markup as a string, or setting it in the code-behind with a member of the Telerik.Web.UI.RenderMode enum.Following is an example for setting the RenderMode property in the markup:
<telerik:RadPivotGrid ID="RadPivotGrid1" runat="server" RenderMode="Lightweight">
</telerik:RadPivotGrid>
  • A global setting in the web.config file that will affect the entire application, unless a concrete value is specifiedfor a given control instance:
<appSettings>
    <add key="Telerik.Web.UI.PivotGrid.RenderMode" value="Lightweight" />
</appSettings>