title: Adding jqGrid Custom Navigation to Top Toolbar
body: <p>Is it possible to add navigation items to the "top pager" in a jqGrid?  And if so, what's the syntax for doing so?</p>
  
  <p>I have an HTML snippet on my page that looks like this</p>
  
  <pre><code>&lt;table id="mygrid"&gt;
  &lt;/table&gt;
  &lt;div id="mygrid_pager"&gt;&lt;/div&gt;
  </code></pre>
  
  <p>And then an jqGrid initialization that looks something like this</p>
  
  <pre><code>$('#mygrid').jqGrid({
      ..., //full config string removed for brevity,
      pager:jQuery('#mygrid'),
      toppager:true
  }); 
  $('#mygrid').jqGrid('navGrid', '#mygrid_pager'),{
      'add':false,
      'del':false,
      'edit':false,
      'search':false,
      'refresh':false,
      'cloneToTop':true,  
  }).navButtonAdd('',{...}); //config navbutton string for button removed for brevity
  </code></pre>
  
  <p>A "top pager" with the id of #mygrid_toppager is automatically inserted into the page, but its custom buttons (which appear on the bottom pager) don't come along for the ride.</p>
  
  <p>I <a href="http://www.trirand.com/jqgridwiki/doku.php?id=wiki:navigator" rel="nofollow noreferrer">see that there's a "cloneToTop" option</a> included for the navGrid, but its description seems confusing, and I can only assume I'm using it wrong.</p>
  
  <blockquote>
    <p>Clones all the actions from the bottom pager to the top pager 
    if defined. Note that the navGrid can be applied to the top 
    pager only. The id of the top pager is a combination of grid id and
    "_toppager"</p>
  </blockquote>
  
  <p>My understanding of the option is it will take buttons added to the bottom pager, and clone them to the top. However, the description then goes on to say "the navGrid can be applied to the top pager only, which doesn't make any sense since you're cloning it.  The pont being, I clearly have a deep misunderstanding of how the API is supposed to be used.</p>
  
  <p>If anyone can point me in the right direction (even just to a working example somewhere) I'd appreciate it.  I'd prefer to do this through official APIs, as opposed <a href="https://stackoverflow.com/questions/2678904/adding-button-to-jqgrid-top-toolbar">to clever DOM manipulation</a>, as seen elsewhere on StackOverflow.</p>