Custom Buttons

Custom Buttons are a way to define your own button and action in the pager.

Calling Convention:

<script>
...
jQuery("#grid_id").navGrid("#pager",...).navButtonAdd("#pager",{parameters});
...
</script>

or using the new API

<script>
...
jQuery("#grid_id").jqGrid('navGrid',"#pager",...).jqGrid('navButtonAdd',"#pager",{parameters});
...
</script>

The default parameters are

{ caption:"NewButton", buttonicon:"ui-icon-newwin", onClickButton:null, position: "last", title:"", cursor: "pointer"} 

where

• caption: (string) the caption of the button, can be a empty string.
• buttonicon: (string) is the ui icon name from UI theme icon set. If this option is set to “none” only the text appear.
• onClickButton: (function) action to be performed when a button is clicked. Default null.
• position: (“first” or “last”) the position where the button will be added (i.e., before or after the standard buttons).
• title: (string) a tooltip for the button.
• cursor : string (default pointer) determines the cursor when we mouseover the element
• id : string (optional) - if set defines the id of the button (actually the id of TD element) for future manipulation

Multiple buttons can be added by continuing the chain.

...
jQuery("#grid_id")
.navGrid('#pager',{edit:false,add:false,del:false,search:false})
.navButtonAdd('#pager',{
   caption:"Add", 
   buttonicon:"ui-icon-add", 
   onClickButton: function(){ 
     alert("Adding Row");
   }, 
   position:"last"
})
.navButtonAdd('#pager',{
   caption:"Del", 
   buttonicon:"ui-icon-del", 
   onClickButton: function(){ 
      alert("Deleting Row");
   }, 
   position:"last"
});
...

It is possible to group some action adding separator. This can be done using the navSeparatorAdd method

Syntax:

<script>
...
jQuery("#grid_id").navGrid("#pager",...).navButtonAdd("#pager",{parameters}).navSeparatorAdd("#pager",{separator_parameters}};
...
</script>

The default separator_parameters are

{sepclass : “ui-separator”,sepcontent: ''}

Where:

• sepclass represent the separator class defined in ui-jqgrid. You cancustomize your own class
• sepcontent the content that can be put in the separator element