dojox.grid.EnhancedGrid.plugins.Cookie

Authors:Zhu Xiao Wen Project owner:Nathan Toone Available:since V.1.6

Cookie plugin provides a convenient ways to persist grid properties like column width, sorting order, etc, so the grid will look same when the page is reloaded, or when the grid is re-created with the same id.

Contents

• dojox.grid.EnhancedGrid.plugins.Cookie
  • Introduction
  • Configuration
  • Usage
  • See Also

Introduction

Cookie is a plugin for dojox.grid.EnhancedGrid. It is used to persist grid properties in browser cookie.

Configuration

Prerequisites

This cookie plugin is only available for EnhancedGrid, so use the following statement in the head of your HTML file:

dojo.require("dojox.grid.EnhancedGrid");
dojo.require("dojox.grid.enhanced.plugins.Cookie");

Plugin Declaration

The declaration name of this plugin is cookie . It is declared in the plugins property of grid.

If your grid is created declaratively:

<div id="grid" dojoType="dojox.grid.EnhancedGrid"
  store="mystore" structure="mystructure"
  plugins="{
    cookie: /* a Boolean value or an configuration object */{}
}" ></div>

If your grid is created in JavaScript:

var grid = new dojox.grid.EnhancedGrid({
  id:"grid",
  store:"mystore",
  structure:"mystructure",
  plugins:{
    cookie: /* a Boolean value or an configuration object */{}
  }
});

The available configuration properties are:

Property	Type	Default Value	Description
cookieProps	dojo.__cookieProps	{}	Set the cookie properties. See dojo.cookie.js

All the persistable grid features will be stored in cookie by default. If you'd like to disable some of them, you can declare in the configuration object:

var grid = new dojox.grid.EnhancedGrid({
  id:"grid",
  store:"mystore",
  structure:"mystructure",
  plugins:{
    cookie: {
      cellWidth: false  //Do not persist column width.
    }
  }
});

The cookie names of currently supported grid features are:

• cellWidth
• sortProps
• columnOrder
• nestedSortProps (only available when nestedSorting plugin is used)

Usage

This plugin exposes the following methods to the grid:

cookieEnabled(cookieName, toEnable):

If a grid feature (maybe a plugin) wants to persist something in the cookie, it will provide a name for this feature. Users can use this name to enable/disable the persistance of this feature.

Arguments	Type	Optional/Mandatory	Description
cookieName	String	Optional	A name of a grid feature. If omitted, this function will apply to all supported grid features.
toEnable	Boolean	Optional	To enable cookie for a grid feature or not. If omitted, this function is a getter.
[return]	Boolean|undefined		Return boolean when toEnable is undefined. If cookieName is valid, return whether the cookie of this grid feature is enabled. If no arguments exist, return whether cookie is enabled for this grid.

removeCookie():

Clear the grid cookie.

Here is some examples on how to use the API:

//Do not persist column width
grid.cookieEnabled("cellWidth", false);

//Check whether cookie is used in this grid
var isEnabled = grid.cookieEnabled();

See Also

• dojox.grid.DataGrid - The base grid
• dojox.grid.EnhancedGrid - The enhanced grid supporting plugins
• dojox.grid.EnhancedGrid.plugins - Overview of the plugins of enhanced grid
• dojox.grid.TreeGrid - Grid with collapsable rows and model-based (dijit.tree.ForestStoreModel) structure

Table of Contents

• dojox.grid.EnhancedGrid.plugins.Cookie
  • Introduction
  • Configuration
    • Prerequisites
    • Plugin Declaration
  • Usage
  • See Also