Ignite UI API Reference

ui.igGridResponsive

ui.igGridResponsive_image

The Responsive Web Design (RWD) Mode feature of the igGrid control adopts the concepts of Responsive Web Design in order to improve user experience on different devices. Responsive Web Design mode allows you to support multiple screen sizes and form factors with single code base and design. In RWD mode, the grid’s adaptation to the devices’ screen can be configured to be either:

  • Auto-hiding of columns (This is configured through the RWD mode feature’s column hiding functionality.)
  • Any structural and formatting change that can be implemented through a grid template

To this end, the RWD Mode feature supports a set of pre-defined grid templates which replace the igGrid template once the RWD mode sets in. Using templates allows for a wide scope of adaptations, including row hiding, using different fonts and font sizes, merging several rows/columns in one row/column, and many others. The RWD mode supports having different grid adaptations for different device screen sizes. A set of pre-defined adaptations to which a unique name is assigned is called “RWD mode profile”. Each profile has a range of screen sizes for which it is activated. As different screen sizes are, in practice, associated with different types of devices, the RWD mode profiles are essentially associated with device types.

The igGrid control comes with three pre-defined RWD mode profiles based on the device’s screen width. Those profiles are activated using CSS3 media queries:

  • Phone – for screen widths up to 767 pixels. Default available CSS classes are: ui-visible-phone and ui-hidden-phone. The name of the profile is “phone”.
  • Tablet – for screen widths between 768 pixels and 979 pixels. Default available CSS classes are: ui-visible-tablet and ui-hidden-tablet. The name of the profile is “tablet”.
  • Desktop –for screen widths larger than 980 pixels. Default available CSS classes are: ui-visible-desktop and ui-hidden-desktop. The name of the profile is “desktop”.

Further information regarding the classes, options, events, methods and themes of this API are available under the associated tabs above.

The following code snippet demonstrates how to initialize the igGrid control with Responsive Web Design Mode feature.

Click here for more information on how to get started using this API. For details on how to reference the required scripts and themes for the igGrid control read, Using JavaScript Resources in Ignite UI and Styling and Theming Ignite UI.

Code Sample

 
<!doctype html>
<html>
<head>
    <!-- Infragistics Combined CSS -->
    <link href="css/themes/infragistics/infragistics.theme.css" rel="stylesheet" type="text/css" />
    <link href="css/structure/infragistics.css" rel="stylesheet" type="text/css" />
    <!-- jQuery Core -->
    <script src="js/jquery.js" type="text/javascript"></script>
    <!-- jQuery UI -->
    <script src="js/jquery-ui.js" type="text/javascript"></script>
    <!-- Infragistics Combined Scripts -->
    <script src="js/infragistics.core.js" type="text/javascript"></script>
    <script src="js/infragistics.lob.js" type="text/javascript"></script>
    <script type="text/javascript">
        var products = [
            { "ProductID": 1, "Name": "Adjustable Race", "ProductNumber": "AR-5381" },
            { "ProductID": 2, "Name": "Bearing Ball", "ProductNumber": "BA-8327" },
            { "ProductID": 3, "Name": "BB Ball Bearing", "ProductNumber": "BE-2349" },
            { "ProductID": 4, "Name": "Headset Ball Bearings", "ProductNumber": "BE-2908" },
            { "ProductID": 316, "Name": "Blade", "ProductNumber": "BL-2036" },
            { "ProductID": 317, "Name": "LL Crankarm", "ProductNumber": "CA-5965" },
            { "ProductID": 318, "Name": "ML Crankarm", "ProductNumber": "CA-6738" },
            { "ProductID": 319, "Name": "HL Crankarm", "ProductNumber": "CA-7457" },
            { "ProductID": 320, "Name": "Chainring Bolts", "ProductNumber": "CB-2903" }
        ];
 
        $(function () {
            $("#gridResponsive").igGrid({
                columns: [
                    { headerText: "Product ID", key: "ProductID", dataType: "number" },
                    { headerText: "Product Name", key: "Name", dataType: "string" },
                    { headerText: "Product Number", key: "ProductNumber", dataType: "string" }
                ],
                features:[
                    {
                        name: "Responsive",
                        columnSettings: [
                            {
                                columnKey: "ProductID",
                                classes: "ui-hidden-phone"
                            }
                        ]
                    }
                ],
                width: "100%",
                dataSource: products
            });
        });
    </script>
</head>
<body>
    <div id="gridColumnMoving"></div>
</body>
</html>
    

Related Samples

Related Topics

Dependencies

jquery-1.4.4.js
jquery.ui.core.js
jquery.ui.widget.js
infragistics.ui.grid.framework.js
infragistics.ui.tree.js
infragistics.ui.shared.js
infragistics.datasource.js
infragistics.util.js

Inherits

  • allowedColumnWidthPerType

    Type:
    object
    Default:
    {}

    When windowWidthToRenderVertically is null, determine minimal widths columns can take before
    forcing vertical rendering for the grid.

    Code Sample

     
            //Initialize
            $(".selector").igGrid({
                features : [
                    {
                        name : "Responsive",
                        allowedColumnWidthPerType : {
                            string: 120,
                            number: 50,
                            bool: 50,
                            date: 80,
                            object: 150
                        }
                    }
                ]
            });
    
            //Get
            var allowedColumnWidthPerType = $(".selector").igGridResponsive("option", "allowedColumnWidthPerType");
                
    • bool

      Type:
      number
      Default:
      50

      Minimal width in pixels bool columns can take before forcing vertical rendering.

      Code Sample

       
              //Initialize
              $(".selector").igGrid({
                  features : [
                      {
                          name : "Responsive",
                          allowedColumnWidthPerType : {
                              bool: 50
                          }
                      }
                  ]
              });
      
              //Get
              var allowedBoolColumnWidth = $(".selector").igGridResponsive("option", "allowedColumnWidthPerType").bool;
                          
    • date

      Type:
      number
      Default:
      80

      Minimal width in pixels date columns can take before forcing vertical rendering.

      Code Sample

       
              //Initialize
              $(".selector").igGrid({
                  features : [
                      {
                          name : "Responsive",
                          allowedColumnWidthPerType : {
                              date: 50
                          }
                      }
                  ]
              });
      
              //Get
              var allowedDateColumnWidth = $(".selector").igGridResponsive("option", "allowedColumnWidthPerType").date;
                          
    • number

      Type:
      number
      Default:
      50

      Minimal width in pixels number columns can take before forcing vertical rendering.

      Code Sample

       
              //Initialize
              $(".selector").igGrid({
                  features : [
                      {
                          name : "Responsive",
                          allowedColumnWidthPerType : {
                              number: 50
                          }
                      }
                  ]
              });
      
              //Get
              var allowedNumberColumnWidth = $(".selector").igGridResponsive("option", "allowedColumnWidthPerType").number;
                          
    • object

      Type:
      number
      Default:
      150

      Minimal width in pixels object columns can take before forcing vertical rendering.

      Code Sample

       
              //Initialize
              $(".selector").igGrid({
                  features : [
                      {
                          name : "Responsive",
                          allowedColumnWidthPerType : {
                              object: 50
                          }
                      }
                  ]
              });
      
              //Get
              var allowedObjectColumnWidth = $(".selector").igGridResponsive("option", "allowedColumnWidthPerType").object;
                          
    • string

      Type:
      number
      Default:
      120

      Minimal width in pixels string columns can take before forcing vertical rendering.

      Code Sample

       
              //Initialize
              $(".selector").igGrid({
                  features : [
                      {
                          name : "Responsive",
                          allowedColumnWidthPerType : {
                              string: 50
                          }
                      }
                  ]
              });
      
              //Get
              var allowedStringColumnWidth = $(".selector").igGridResponsive("option", "allowedColumnWidthPerType").string;
                          
  • columnSettings

    Type:
    array
    Default:
    []
    Elements Type:
    object

    A list of column settings that specifies how columns will react based on the environment the grid is run on.

    Code Sample

     
            //Initialize
            $(".selector").igGrid({
                features : [
                    {
                        name : "Responsive",
                        columnSettings : [
    				        {
                                columnIndex: 0, 
                                classes: "ui-hidden-phone"
                            }
    			        ]
                    }
                ]
            });
    
            //Get
            var colSettings = $(".selector").igGridResponsive("option", "columnSettings");
    
            //Set
            var colSettings = [
    				{
                        columnKey: "ProductName", 
                        classes: "ui-hidden-phone"
                    }
    			];
                
            $(".selector").igGridResponsive("option", "columnSettings", colSettings);
          
    • classes

      Type:
      string
      Default:
      ""

      A list of predefined classes to decide element's visibility on.

      Code Sample

        
              //Initialize
              $(".selector").igGrid({
                  features : [
                      {
                          name : "Responsive",
                          columnSettings : [
                              {
                                  columnIndex: 0, 
                                  classes: "ui-hidden-tablet"
                              }
                          ]
                      }
                  ]
              });
                
    • columnIndex

      Type:
      number
      Default:
      null

      Column index. Can be used in place of column key. The preferred way of populating a column setting is to always use the column keys as identifiers.

      Code Sample

        
              //Initialize
              $(".selector").igGrid({
                  features : [
                      {
                          name : "Responsive",
                          columnSettings : [
                              {
                                  columnIndex: 0, 
                                  classes: "ui-hidden-tablet"
                              }
                          ]
                      }
                  ]
              });
                
    • columnKey

      Type:
      string
      Default:
      null

      Column key. This is a required property in every column setting if columnIndex is not set.

      Code Sample

        
              //Initialize
              $(".selector").igGrid({
                  features : [
                      {
                          name : "Responsive",
                          columnSettings : [
                              {
                                  columnKey: "ProductId",
                                  classes: "ui-hidden-tablet"
                              }
                          ]
                      }
                  ]
              });
                
    • configuration

      Type:
      object
      Default:
      null

      A configuration object to use for the responsive functionality. Uses the keys defined in the widget's responsiveModes object. The classes property is not used if this one is set.

      Code Sample

        
              //Initialize
              $(".selector").igGrid({
                  features : [
                      {
                          name : "Responsive",
                          columnSettings : [
                              {
                                  columnKey: "ProductDescription", 
                                  configuration: {
      								phone: {
      									hidden: true
      								},
      								tablet: {
      									template: "<span style='color:green;'>${ProductDescription}</span>"
      								}
      							}
                              }
                          ]
                      }
                  ]
              });
                
  • enableVerticalRendering

    Type:
    bool
    Default:
    true

    Enable or disable the responsive vertical rendering for the grid.

    Code Sample

     
            //Initialize
            $(".selector").igGrid({
                features : [
                    {
                        name : "Responsive",
                        enableVerticalRendering : false
                    }
                ]
            });
    		
            //Get
            var enableVerticalRendering = $(".selector").igGridResponsive("option", "enableVerticalRendering");
                
  • forceResponsiveGridWidth

    Type:
    bool
    Default:
    true

    If this option is set to true the widget will ensure the grid's width is always set to 100%.

    Code Sample

         
            //Initialize
            $(".selector").igGrid({
                features : [
                    {
                        name : "Responsive",
                        forceResponsiveGridWidth : true
                    }
                ]
            });
    		
            //Get
            var text = $(".selector").igGridResponsive("option", "forceResponsiveGridWidth");
            
  • inherit

    Type:
    bool
    Default:
    false

    Enables/disables feature inheritance for the child layouts. NOTE: It only applies for igHierarchicalGrid.

  • propertiesColumnWidth

    Type:
    enumeration
    Default:
    50%

    The width of the properties column when vertical rendering is enabled.

    Members

      • string
      • The width in a (%) string.
      • number
      • The width as a number in percents.

    Code Sample

     
            //Initialize
            $(".selector").igGrid({
                features : [
                    {
                        name : "Responsive",
                        propertiesColumnWidth : "30%"
                    }
                ]
            });
    		
            //Get
            var propertiesColumnWidth = $(".selector").igGridResponsive("option", "propertiesColumnWidth");
                
  • reactOnContainerWidthChanges

    Type:
    bool
    Default:
    true

    If this option is set to true an igResponsiveContainer widget will be attached to the igGrid control which will notify the feature when changes in the width of the container occur.

    Code Sample

         
            //Initialize
            $(".selector").igGrid({
                features : [
                    {
                        name : "Responsive",
                        reactOnContainerWidthChanges : true
                    }
                ]
            });
    		
            //Get
            var text = $(".selector").igGridResponsive("option", "reactOnContainerWidthChanges");
    		
    		//Set
            $(".selector").igGridResponsive("option", "reactOnContainerWidthChanges", true); 
            
  • responsiveModes

    Type:
    object
    Default:
    null

    The recognized types of environments and their configuration.

    Code Sample

         
            //Initialize
            $(".selector").igGrid({
                features : [
                    {
                        name : "Responsive",
                        responsiveModes : {
    						phone: "infragistics",
    						tablet: "infragistics",
    						desktop: "infragistics"
    					}
                    }
                ]
            });
    		
            //Get
            var text = $(".selector").igGridResponsive("option", "responsiveModes");
    		
    		//Set
    		var responsiveModes = {
    			phone: "infragistics",
    			tablet: "infragistics",
    			desktop: "infragistics"
    		};
                
            $(".selector").igGridResponsive("option", "responsiveModes", responsiveModes); 
            
  • responsiveSensitivity

    Type:
    number
    Default:
    20

    The amount of pixels the window needs to resize with for the grid to respond.

    Code Sample

         
            //Initialize
            $(".selector").igGrid({
                features : [
                    {
                        name : "Responsive",
                        responsiveSensitivity : 20
                    }
                ]
            });
    		
            //Get
            var text = $(".selector").igGridResponsive("option", "responsiveSensitivity");
            
  • rowTemplate

    Type:
    object
    Default:
    null

    A configuration object to use for mutliple row templates defined according to the responsive configuration.

    Code Sample

         
            //Initialize
            $(".selector").igGrid({
                features : [
                    {
                        name : "Responsive",
                        rowTemplate : {
    						phone: "<tr><td>${Name}</td><td><img width='110' height='150' src='${BoxArt.LargeUrl}'></img></td><td><p>{{html Synopsis}}</p></td></tr>"
    					}
                    }
                ]
            });
    		
            //Get
            var text = $(".selector").igGridResponsive("option", "rowTemplate");
            
  • valuesColumnWidth

    Type:
    enumeration
    Default:
    50%

    The width of the values column when vertical rendering is enabled.

    Members

      • string
      • The width in a (%) string.
      • number
      • The width as a number in percents.

    Code Sample

     
            //Initialize
            $(".selector").igGrid({
                features : [
                    {
                        name : "Responsive",
                        valuesColumnWidth: "60%"
                    }
                ]
            });
    
            //Get
            var valuesColumnWidth = $(".selector").igGridResponsive("option", "valuesColumnWidth");
                
  • windowWidthToRenderVertically

    Type:
    enumeration
    Default:
    null

    The window's width under which the grid will render its contents vertically. .

    Members

    • null
    • Type:object
    • The grid will determine when to render this mode automatically.
    • string
    • The width in a (px) string.
    • number
    • The width as a number.

    Code Sample

     
            //Initialize
            $(".selector").igGrid({
                features : [
                    {
                        name : "Responsive",
                        windowWidthToRenderVertically: "60%"
                    }
                ]
            });
    
            //Get
            var windowWidthToRenderVertically = $(".selector").igGridResponsive("option", "windowWidthToRenderVertically");
                

For more information on how to interact with the Ignite UI controls' events, refer to
Using Events in Ignite UI.

Note: Calling API methods programmatically does not raise events related to their operation unless specifically stated otherwise by the corresponding API documentation; those events are only raised by their respective user interaction.

Show Details
  • responsiveColumnHidden

    Cancellable:
    false

    Event fired after a hiding operation is executed on the collection of columns.
    The handler function takes arguments evt and ui.
    Use ui.owner to get the reference to the igGridResponsive widget.
    Use ui.owner.grid to get the reference to the igGrid widget.
    Use ui.columnIndex to get the hidden column index. Has a value only if the column's key is a number.
    Use ui.columnKey to get the hidden column key. Has a value only if the column's key is a string.

    Code Sample

     
    			//Delegate
    			$(document).delegate(".selector", "iggridresponsiveresponsivecolumnhidden", function (evt, ui) {
    				//return reference to igGridResponsive object
    				ui.owner;
    				//return reference igGrid object
    				ui.owner.grid;
    				//return column key
    				ui.columnKey;
    				//return column index
    				ui.columnIndex;
    			});
    
    			//Initialize
                $(".selector").igGrid({
    				features: [{
    					name: "Responsive",
    					responsiveColumnHidden: function (evt, ui) {...}
    				}]
    			});
          
  • responsiveColumnHiding

    Cancellable:
    true

    Event fired before a hiding operation is executed on a collection of columns.
    The handler function takes arguments evt and ui.
    Use ui.owner to get the reference to the igGridResponsive widget.
    Use ui.owner.grid to get the reference to the igGrid widget.
    Use ui.columnIndex to get the hidden column index. Has a value only if the column's key is a number.
    Use ui.columnKey to get the hidden column key. Has a value only if the column's key is a string.

    Code Sample

     
    			//Delegate
    			$(document).delegate(".selector", "iggridresponsiveresponsivecolumnhiding", function (evt, ui) {
    				//return reference to igGridResponsive object
    				ui.owner;
    				//return reference igGrid object
    				ui.owner.grid;
    				//return column key
    				ui.columnKey;
    				//return column index
    				ui.columnIndex;
    			});
    
    			//Initialize
                $(".selector").igGrid({
    				features: [{
    					name: "Responsive",
    					responsiveColumnHiding: function (evt, ui) {...}
    				}]
    			});
          
  • responsiveColumnShowing

    Cancellable:
    true

    Event fired before a showing operation is executed on a collection of columns.
    The handler function takes arguments evt and ui.
    Use ui.owner to get the reference to the igGridResponsive widget.
    Use ui.owner.grid to get the reference to the igGrid widget.
    Use ui.columnIndex to get the shown column index. Has a value only if the column's key is a number.
    Use ui.columnKey to get the shown column key. Has a value only if the column's key is a string.

    Code Sample

     
    			//Delegate
    			$(document).delegate(".selector", "iggridresponsiveresponsivecolumnshowing", function (evt, ui) {
    				//return reference to igGridResponsive object
    				ui.owner;
    				//return reference igGrid object
    				ui.owner.grid;
    				//return column key
    				ui.columnKey;
    				//return column index
    				ui.columnIndex;
    			});
    
    			//Initialize
                $(".selector").igGrid({
    				features: [{
    					name: "Responsive",
    					responsiveColumnShowing: function (evt, ui) {...}
    				}]
    			});
          
  • responsiveColumnShown

    Cancellable:
    false

    Event fired after a showing operation is executed on the collection of columns.
    The handler function takes arguments evt and ui.
    Use ui.owner to get the reference to the igGridResponsive widget.
    Use ui.owner.grid to get the reference to the igGrid widget.
    Use ui.columnIndex to get the shown column index. Has a value only if the column's key is a number.
    Use ui.columnKey to get the shown column key. Has a value only if the column's key is a string.

    Code Sample

     
    			//Delegate
    			$(document).delegate(".selector", "iggridresponsiveresponsivecolumnshown", function (evt, ui) {
    				//return reference to igGridResponsive object
    				ui.owner;
    				//return reference igGrid object
    				ui.owner.grid;
    				//return column key
    				ui.columnKey;
    				//return column index
    				ui.columnIndex;
    			});
    
    			//Initialize
                $(".selector").igGrid({
    				features: [{
    					name: "Responsive",
    					responsiveColumnShown: function (evt, ui) {...}
    				}]
    			});
          
  • responsiveModeChanged

    Cancellable:
    false

    Event which is fired when the widget detects an environment change.
    The handler function takes arguments evt and ui.
    Use ui.owner to get the reference to the igGridResponsive widget.
    Use ui.owner.grid to get the reference to the igGrid widget.
    Use ui.previousMode to get the previously assumed mode.
    Use ui.mode to get the newly assumed mode.

    Code Sample

     
    			//Delegate
    			$(document).delegate(".selector", "iggridresponsiveresponsivemodechanged", function (evt, ui) {
    				//return reference to igGridResponsive object
    				ui.owner;
    				//return reference igGrid object
    				ui.owner.grid;
    				//return the previous responsive mode
    				ui.previousMode;
    				//return the current responsive mode
    				ui.mode;
    			});
    
    			//Initialize
                $(".selector").igGrid({
    				features: [{
    					name: "Responsive",
    					responsiveModeChanged: function (evt, ui) {...}
    				}]
    			});
          
  • destroy

    .igGridResponsive( "destroy" );

    Destroys the responsive widget.

    Code Sample

     
          $(".selector").igGridResponsive("destroy");
          
  • getCurrentResponsiveMode

    .igGridResponsive( "getCurrentResponsiveMode" );

    Returns the currently active responsive mode.

    Code Sample

     
          var mode = $(".selector").igGridResponsive("getCurrentResponsiveMode");
          
  • ui-iggrid-responsive-vertical

    Classes applied to the grid table when vertical rendering is enabled.

Copyright © 1996 - 2024 Infragistics, Inc. All rights reserved.

#