Manage Learn to apply best practices and optimize your operations.

How to add keyboard functionality for Lotus Notes documents

Learn JavaScript code that adds keyboard functionality for Lotus Notes view documents so users can browse and open them via the "Up," "Down," and "Enter" buttons.

This JavaScript code will let users navigate Lotus Notes view documents using their keyboard "Up" and "Down" arrow keys. It will also allow them to open Lotus Notes documents with the "Enter" key.

To implement this functionality, just follow these simple steps:

Related resources from SearchDomino.com:
JavaScript Learning Guide

FAQ: Lotus Notes, Domino and JavaScript

JavaScript Reference Center

  1. Create a $$ViewTemplateDefault or $$ViewTemplatefor<VIEWNAME> form.
  2. Create a <div> tag with the ID "ViewBody" and mark the <div> tag as "pass-through HTML."
  3. Embed the Lotus Notes view and select "Domino Web Access" -> "Display" -> "Using View's display property."
  4. Close the <div> tag.
  5. Create a <style> tag for setting height and scrollbar controls for the <div> tag.
  6. Add this JavaScript code in the "OnLoad()" event.
  7. view_onloadfunction();
    
  8. Add this JavaScript code in the JSHeader event of the form.
var rowid=1;
var totalrows = 0;
var keypress_scroll_limit = 20; 
// Adjust this value based on the height 
of the view var viewdivid = "ViewBody"; 
var rowhighlightimage = "/icons/expand.gif";

//function to set the keypress event and 
select the first row, this function called from 
'onload()' event function view_onloadfunction() 
{ selectRow(rowid); var viewdivobj = 
document.getElementsByName(viewdivid).item(0);
viewdivobj.onkeydown = view_keypressHandler;

// to set the table border and get the totalrows 
count var tableElements = viewdivobj.
getElementsByTagName('table');
var table = tableElements[
tableElements.length - 1] ; table.border=1;
 rows = table.getElementsByTagName("tr") ; 
totalrows = rows.length; }

// VIEW KEY PRESS HANDLER
function view_keypressHandler (evt)
{
  // make sure we have a valid event variable
  if(!evt && window.event) {
    evt = window.event;
  }
  var key = evt.keyCode;
 
  var KEYUP = 38;
  var KEYDOWN = 40;

    if (key == KEYUP) {
       if(rowid != 1) 
rowid = rowid -1;   
selectRow(rowid);   
// control the scrollbar movement while KEYUP 
if(rowid >= totalrows - keypress_scroll_limit)
return false;
 }
    if (key == KEYDOWN) {
    if(rowid>=totalrows-1) {
   rowid = rowid; }
else {
rowid = rowid + 1; } 
selectRow(rowid);
 // control the scrollbar movement while KEYDOWN
  if(rowid<=keypress_scroll_limit)   
 return false;  
 }
  return true;
}

//function to select a row
function selectRow(rownum)
{
var viewdivobj = document.
getElementsByName(viewdivid).item(0);
var tableElements = viewdivobj.
getElementsByTagName('table');
var table = tableElements[
tableElements.length - 1] ;
rows = table.getElementsByTagName("tr") ;
for( i = 1; i < rows.length; i++) {
if( i == rownum) { 
Atag = rows[i].
getElementsByTagName("A");
if(Atag.length > 0) { 
Ahref = Atag[0].href;
Atag[0].focus();
// By default domino create a 
blank image  in the first column, 
// we change the image src to our custom 
arrow image
AImage = rows[i].cells[0].
getElementsByTagName("IMG");
AImage[0].height = 10;
AImage[0].src = rowhighlightimage; 
// You can also use custom arrow image
 }
}
else {
AImage = rows[i].cells[0].
getElementsByTagName("IMG");
AImage[0].height = 0
AImage[0].src = "";
  }
 }
}

Do you have comments on this tip? Let us know.

This tip was submitted to the SearchDomino.com tip library by member Manikandan C. Please let others know how useful it is via the rating scale below. Do you have a useful Lotus Notes, Domino, Workplace or WebSphere tip or code snippet to share? Submit it to our monthly tip contest and you could win a prize.

Dig Deeper on JavaScript for Lotus Notes Domino

Start the conversation

Send me notifications when other members comment.

Please create a username to comment.

-ADS BY GOOGLE

SearchWindowsServer

Search400

  • iSeries tutorials

    Search400.com's tutorials provide in-depth information on the iSeries. Our iSeries tutorials address areas you need to know about...

  • V6R1 upgrade planning checklist

    When upgrading to V6R1, make sure your software will be supported, your programs will function and the correct PTFs have been ...

  • Connecting multiple iSeries systems through DDM

    Working with databases over multiple iSeries systems can be simple when remotely connecting logical partitions with distributed ...

SearchDataCenter

SearchContentManagement

Close