RenderMode="Auto"

[miksh]

How does the RenderMode="Auto" work?

E.g. Grid documentation reads:

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).

So "Auto" could never set Lightweight mode?

 

 

[Dimitar]

Hi,

In order for RenderMode="Auto" to work properly, you should add a reference to the RadDeviceDetectionFramework to your project, which would enable detection of mobile browsers on the server.

With RenderMode="Auto" when viewed on a mobile device browser, controls would try to render in the following order of render mode fallback priority:
- Controls supporting Mobile would be rendered as Mobile;
- Controls supporting Lightweight render mode would be rendered as Lightweight;
- If a certain control does not support Lightweight, it will be rendered as Classic.

And in case your app is viewed on a desktop browser, the same logic will be applied, except that no Mobile rendering will be applied. Or in other words, if a control supports Lightweight, it will be rendered as Lightweight. If not, it will be rendered as Classic. And also note that some controls are lightweight by design, although the applied render mode would state Classic.

The statement in the RadGrid's documentation that RadGrid with Auto would be rendered as Classic on desktop is specific to the RadGrid, based on the render modes it supports. The documentation should be updated, however, as recently we released Lightweight RenderMode support for RadGrid. We will update this part of the article as soon as possible.

I hope the above explains how RenderMode="Auto" works.

Regards,
Dimitar
Telerik