src/main/webapp/scripts/interface.js

   1
   2 // UI Definition
   3 var GuacamoleUI = {
   4
   5     /* Detection Constants */
   6
   7     "LONG_PRESS_DETECT_TIMEOUT"     : 800, /* milliseconds */
   8     "LONG_PRESS_MOVEMENT_THRESHOLD" : 10,  /* pixels */
   9     "MENU_CLOSE_DETECT_TIMEOUT"     : 500, /* milliseconds */
  10     "MENU_OPEN_DETECT_TIMEOUT"      : 325, /* milliseconds */
  11     "KEYBOARD_AUTO_RESIZE_INTERVAL" : 30,  /* milliseconds */
  12
  13     /* Animation Constants */
  14
  15     "MENU_SHADE_STEPS"    : 10, /* frames */
  16     "MENU_SHADE_INTERVAL" : 30, /* milliseconds */
  17     "MENU_SHOW_STEPS"     : 5,  /* frames */
  18     "MENU_SHOW_INTERVAL"  : 30, /* milliseconds */
  19
  20     /* OSK Mode Constants */
  21     "OSK_MODE_NATIVE" : 1, /* "Show Keyboard" will show the platform's native OSK */
  22     "OSK_MODE_GUAC"   : 2, /* "Show Keyboard" will show Guac's built-in OSK */
  23
  24     /* UI Elements */
  25
  26     "viewport"    : document.getElementById("viewportClone"),
  27     "display"     : document.getElementById("display"),
  28     "menu"        : document.getElementById("menu"),
  29     "menuControl" : document.getElementById("menuControl"),
  30     "touchMenu"   : document.getElementById("touchMenu"),
  31     "logo"        : document.getElementById("status-logo"),
  32     "eventTarget" : document.getElementById("eventTarget"),
  33
  34     "buttons": {
  35
  36         "showClipboard": document.getElementById("showClipboard"),
  37         "showKeyboard" : document.getElementById("showKeyboard"),
  38         "ctrlAltDelete": document.getElementById("ctrlAltDelete"),
  39         "reconnect"    : document.getElementById("reconnect"),
  40         "logout"       : document.getElementById("logout")
  41
  42     },
  43
  44     "containers": {
  45         "state"    : document.getElementById("statusDialog"),
  46         "clipboard": document.getElementById("clipboardDiv"),
  47         "keyboard" : document.getElementById("keyboardContainer")
  48     },
  49
  50     "state"     : document.getElementById("statusText"),
  51     "clipboard" : document.getElementById("clipboard")
  52
  53 };
  54
  55 // Constant UI initialization and behavior
  56 (function() {
  57
  58     var menu_shaded = false;
  59
  60     var shade_interval = null;
  61     var show_interval = null;
  62
  63     // Cache error image (might not be available when error occurs)
  64     var guacErrorImage = new Image();
  65     guacErrorImage.src = "images/noguacamole-logo-24.png";
  66
  67     // Function for adding a class to an element
  68     var addClass;
  69
  70     // Function for removing a class from an element
  71     var removeClass;
  72
  73     // If Node.classList is supported, implement addClass/removeClass using that
  74     if (Node.classList) {
  75
  76         addClass = function(element, classname) {
  77             element.classList.add(classname);
  78         };
  79
  80         removeClass = function(element, classname) {
  81             element.classList.remove(classname);
  82         };
  83
  84     }
  85
  86     // Otherwise, implement own
  87     else {
  88
  89         addClass = function(element, classname) {
  90
  91             // Simply add new class
  92             element.className += " " + classname;
  93
  94         };
  95
  96         removeClass = function(element, classname) {
  97
  98             // Filter out classes with given name
  99             element.className = element.className.replace(/([^ ]+)[ ]*/g,
 100                 function(match, testClassname, spaces, offset, string) {
 101
 102                     // If same class, remove
 103                     if (testClassname == classname)
 104                         return "";
 105
 106                     // Otherwise, allow
 107                     return match;
 108
 109                 }
 110             );
 111
 112         };
 113
 114     }
 115
 116
 117     GuacamoleUI.hideStatus = function() {
 118         removeClass(document.body, "guac-error");
 119         GuacamoleUI.containers.state.style.visibility = "hidden";
 120         GuacamoleUI.display.style.opacity = "1";
 121     };
 122
 123     GuacamoleUI.showStatus = function(text) {
 124         removeClass(document.body, "guac-error");
 125         GuacamoleUI.containers.state.style.visibility = "visible";
 126         GuacamoleUI.state.textContent = text;
 127         GuacamoleUI.display.style.opacity = "1";
 128     };
 129
 130     GuacamoleUI.showError = function(error) {
 131         addClass(document.body, "guac-error");
 132         GuacamoleUI.state.textContent = error;
 133         GuacamoleUI.display.style.opacity = "0.1";
 134     };
 135
 136     GuacamoleUI.shadeMenu = function() {
 137
 138         if (!menu_shaded) {
 139
 140             var step = Math.floor(GuacamoleUI.menu.offsetHeight / GuacamoleUI.MENU_SHADE_STEPS) + 1;
 141             var offset = 0;
 142             menu_shaded = true;
 143
 144             window.clearInterval(show_interval);
 145             shade_interval = window.setInterval(function() {
 146
 147                 offset -= step;
 148                 GuacamoleUI.menu.style.top = offset + "px";
 149
 150                 if (offset <= -GuacamoleUI.menu.offsetHeight) {
 151                     window.clearInterval(shade_interval);
 152                     GuacamoleUI.menu.style.visiblity = "hidden";
 153                 }
 154
 155             }, GuacamoleUI.MENU_SHADE_INTERVAL);
 156         }
 157
 158     };
 159
 160     GuacamoleUI.showMenu = function() {
 161
 162         if (menu_shaded) {
 163
 164             var step = Math.floor(GuacamoleUI.menu.offsetHeight / GuacamoleUI.MENU_SHOW_STEPS) + 1;
 165             var offset = -GuacamoleUI.menu.offsetHeight;
 166             menu_shaded = false;
 167             GuacamoleUI.menu.style.visiblity = "";
 168
 169             window.clearInterval(shade_interval);
 170             show_interval = window.setInterval(function() {
 171
 172                 offset += step;
 173
 174                 if (offset >= 0) {
 175                     offset = 0;
 176                     window.clearInterval(show_interval);
 177                 }
 178
 179                 GuacamoleUI.menu.style.top = offset + "px";
 180
 181             }, GuacamoleUI.MENU_SHOW_INTERVAL);
 182         }
 183
 184     };
 185
 186     // Show/Hide clipboard
 187     GuacamoleUI.buttons.showClipboard.onclick = function() {
 188
 189         var displayed = GuacamoleUI.containers.clipboard.style.display;
 190         if (displayed != "block") {
 191             GuacamoleUI.containers.clipboard.style.display = "block";
 192             GuacamoleUI.buttons.showClipboard.innerHTML = "Hide Clipboard";
 193         }
 194         else {
 195             GuacamoleUI.containers.clipboard.style.display = "none";
 196             GuacamoleUI.buttons.showClipboard.innerHTML = "Show Clipboard";
 197             GuacamoleUI.clipboard.onchange();
 198         }
 199
 200     };
 201
 202     // Assume no native OSK by default
 203     GuacamoleUI.oskMode = GuacamoleUI.OSK_MODE_GUAC;
 204
 205     // Show/Hide keyboard
 206     var keyboardResizeInterval = null;
 207     GuacamoleUI.buttons.showKeyboard.onclick = function() {
 208
 209         // If Guac OSK shown, hide it.
 210         var displayed = GuacamoleUI.containers.keyboard.style.display;
 211         if (displayed == "block") {
 212             GuacamoleUI.containers.keyboard.style.display = "none";
 213             GuacamoleUI.buttons.showKeyboard.textContent = "Show Keyboard";
 214
 215             window.onresize = null;
 216             window.clearInterval(keyboardResizeInterval);
 217         }
 218
 219         // If not shown ... action depends on OSK mode.
 220         else {
 221
 222             // If we think the platform has a native OSK, use the event target to
 223             // cause it to display.
 224             if (GuacamoleUI.oskMode == GuacamoleUI.OSK_MODE_NATIVE) {
 225
 226                 // ...but use the Guac OSK if clicked again
 227                 GuacamoleUI.oskMode = GuacamoleUI.OSK_MODE_GUAC;
 228
 229                 // Try to show native OSK by focusing eventTarget.
 230                 GuacamoleUI.eventTarget.focus();
 231                 return;
 232
 233             }
 234
 235             // Ensure event target is NOT focused if we are using the Guac OSK.
 236             GuacamoleUI.eventTarget.blur();
 237
 238             GuacamoleUI.containers.keyboard.style.display = "block";
 239             GuacamoleUI.buttons.showKeyboard.textContent = "Hide Keyboard";
 240
 241             // Automatically update size
 242             window.onresize = updateKeyboardSize;
 243             keyboardResizeInterval = window.setInterval(updateKeyboardSize, GuacamoleUI.KEYBOARD_AUTO_RESIZE_INTERVAL);
 244
 245             updateKeyboardSize();
 246         }
 247
 248
 249     };
 250
 251     // Logout
 252     GuacamoleUI.buttons.logout.onclick = function() {
 253         window.location.href = "logout";
 254     };
 255
 256     // Timeouts for detecting if users wants menu to open or close
 257     var detectMenuOpenTimeout = null;
 258     var detectMenuCloseTimeout = null;
 259
 260     // Clear detection timeouts
 261     GuacamoleUI.resetMenuDetect = function() {
 262
 263         if (detectMenuOpenTimeout != null) {
 264             window.clearTimeout(detectMenuOpenTimeout);
 265             detectMenuOpenTimeout = null;
 266         }
 267
 268         if (detectMenuCloseTimeout != null) {
 269             window.clearTimeout(detectMenuCloseTimeout);
 270             detectMenuCloseTimeout = null;
 271         }
 272
 273     };
 274
 275     // Initiate detection of menu open action. If not canceled through some
 276     // user event, menu will open.
 277     GuacamoleUI.startMenuOpenDetect = function() {
 278
 279         if (!detectMenuOpenTimeout) {
 280
 281             // Clear detection state
 282             GuacamoleUI.resetMenuDetect();
 283
 284             // Wait and then show menu
 285             detectMenuOpenTimeout = window.setTimeout(function() {
 286
 287                 // If menu opened via mouse, do not show native OSK
 288                 GuacamoleUI.oskMode = GuacamoleUI.OSK_MODE_GUAC;
 289
 290                 GuacamoleUI.showMenu();
 291                 detectMenuOpenTimeout = null;
 292             }, GuacamoleUI.MENU_OPEN_DETECT_TIMEOUT);
 293
 294         }
 295
 296     };
 297
 298     // Initiate detection of menu close action. If not canceled through some
 299     // user mouse event, menu will close.
 300     GuacamoleUI.startMenuCloseDetect = function() {
 301
 302         if (!detectMenuCloseTimeout) {
 303
 304             // Clear detection state
 305             GuacamoleUI.resetMenuDetect();
 306
 307             // Wait and then shade menu
 308             detectMenuCloseTimeout = window.setTimeout(function() {
 309                 GuacamoleUI.shadeMenu();
 310                 detectMenuCloseTimeout = null;
 311             }, GuacamoleUI.MENU_CLOSE_DETECT_TIMEOUT);
 312
 313         }
 314
 315     };
 316
 317     // Show menu if mouseover any part of menu
 318     GuacamoleUI.menu.addEventListener('mouseover', GuacamoleUI.showMenu, true);
 319
 320     // Stop detecting menu state change intents if mouse is over menu
 321     GuacamoleUI.menu.addEventListener('mouseover', GuacamoleUI.resetMenuDetect, true);
 322
 323     // When mouse hovers over top of screen, start detection of intent to open menu
 324     GuacamoleUI.menuControl.addEventListener('mousemove', GuacamoleUI.startMenuOpenDetect, true);
 325
 326     var long_press_start_x = 0;
 327     var long_press_start_y = 0;
 328     var menuShowLongPressTimeout = null;
 329
 330     GuacamoleUI.startLongPressDetect = function() {
 331
 332         if (!menuShowLongPressTimeout) {
 333
 334             menuShowLongPressTimeout = window.setTimeout(function() {
 335
 336                 menuShowLongPressTimeout = null;
 337
 338                 // Assume native OSK if menu shown via long-press
 339                 GuacamoleUI.oskMode = GuacamoleUI.OSK_MODE_NATIVE;
 340                 GuacamoleUI.showMenu();
 341
 342             }, GuacamoleUI.LONG_PRESS_DETECT_TIMEOUT);
 343
 344         }
 345     };
 346
 347     GuacamoleUI.stopLongPressDetect = function() {
 348         window.clearTimeout(menuShowLongPressTimeout);
 349         menuShowLongPressTimeout = null;
 350     };
 351
 352     // Reset event target (add content, reposition cursor in middle.
 353     GuacamoleUI.resetEventTarget = function() {
 354         GuacamoleUI.eventTarget.value = "";
 355     };
 356
 357     // Detect long-press at bottom of screen
 358     GuacamoleUI.display.addEventListener('touchstart', function(e) {
 359
 360         // Close menu if shown
 361         GuacamoleUI.shadeMenu();
 362
 363         // Record touch location
 364         if (e.touches.length == 1) {
 365             var touch = e.touches[0];
 366             long_press_start_x = touch.screenX;
 367             long_press_start_y = touch.screenY;
 368         }
 369
 370         // Start detection
 371         GuacamoleUI.startLongPressDetect();
 372
 373     }, true);
 374
 375     // Stop detection if touch moves significantly
 376     GuacamoleUI.display.addEventListener('touchmove', function(e) {
 377
 378         if (e.touches.length == 1) {
 379
 380             // If touch distance from start exceeds threshold, cancel long press
 381             var touch = e.touches[0];
 382             if (Math.abs(touch.screenX - long_press_start_x) >= GuacamoleUI.LONG_PRESS_MOVEMENT_THRESHOLD
 383                 || Math.abs(touch.screenY - long_press_start_y) >= GuacamoleUI.LONG_PRESS_MOVEMENT_THRESHOLD)
 384                 GuacamoleUI.stopLongPressDetect();
 385
 386         }
 387
 388     }, true);
 389
 390     // Stop detection if press stops
 391     GuacamoleUI.display.addEventListener('touchend', GuacamoleUI.stopLongPressDetect, true);
 392
 393     // Close menu on mouse movement
 394     GuacamoleUI.display.addEventListener('mousemove', GuacamoleUI.startMenuCloseDetect, true);
 395     GuacamoleUI.display.addEventListener('mousedown', GuacamoleUI.startMenuCloseDetect, true);
 396
 397     // Reconnect button
 398     GuacamoleUI.buttons.reconnect.onclick = function() {
 399         window.location.reload();
 400     };
 401
 402     // On-screen keyboard
 403     GuacamoleUI.keyboard = new Guacamole.OnScreenKeyboard("layouts/en-us-qwerty-mobile.xml");
 404     GuacamoleUI.containers.keyboard.appendChild(GuacamoleUI.keyboard.getElement());
 405
 406     // Function for automatically updating keyboard size
 407     var lastKeyboardWidth;
 408     function updateKeyboardSize() {
 409         var currentSize = GuacamoleUI.keyboard.getElement().offsetWidth;
 410         if (lastKeyboardWidth != currentSize) {
 411             GuacamoleUI.keyboard.resize(currentSize);
 412             lastKeyboardWidth = currentSize;
 413         }
 414     };
 415
 416 })();
 417
 418 // Tie UI events / behavior to a specific Guacamole client
 419 GuacamoleUI.attach = function(guac) {
 420
 421     var title_prefix = null;
 422     var connection_name = null
 423
 424     var guac_display = guac.getDisplay();
 425
 426     // Set document title appropriately, based on prefix and connection name
 427     function updateTitle() {
 428
 429         // Use title prefix if present
 430         if (title_prefix) {
 431
 432             document.title = title_prefix;
 433
 434             // Include connection name, if present
 435             if (connection_name)
 436                 document.title += " " + connection_name;
 437
 438         }
 439
 440         // Otherwise, just set to connection name
 441         else if (connection_name)
 442             document.title = connection_name;
 443
 444     }
 445
 446     // When mouse enters display, start detection of intent to close menu
 447     guac_display.addEventListener('mouseover', GuacamoleUI.startMenuCloseDetect, true);
 448
 449     guac_display.onclick = function(e) {
 450         e.preventDefault();
 451         return false;
 452     };
 453
 454     // Mouse
 455     var mouse = new Guacamole.Mouse(guac_display);
 456     mouse.onmousedown = mouse.onmouseup = mouse.onmousemove =
 457         function(mouseState) {
 458
 459             // Determine mouse position within view
 460             var mouse_view_x = mouseState.x + guac_display.offsetLeft - window.pageXOffset;
 461             var mouse_view_y = mouseState.y + guac_display.offsetTop  - window.pageYOffset;
 462
 463             // Determine viewport dimensioins
 464             var view_width  = GuacamoleUI.viewport.offsetWidth;
 465             var view_height = GuacamoleUI.viewport.offsetHeight;
 466
 467             // Determine scroll amounts based on mouse position relative to document
 468
 469             var scroll_amount_x;
 470             if (mouse_view_x > view_width)
 471                 scroll_amount_x = mouse_view_x - view_width;
 472             else if (mouse_view_x < 0)
 473                 scroll_amount_x = mouse_view_x;
 474             else
 475                 scroll_amount_x = 0;
 476
 477             var scroll_amount_y;
 478             if (mouse_view_y > view_height)
 479                 scroll_amount_y = mouse_view_y - view_height;
 480             else if (mouse_view_y < 0)
 481                 scroll_amount_y = mouse_view_y;
 482             else
 483                 scroll_amount_y = 0;
 484
 485             // Scroll (if necessary) to keep mouse on screen.
 486             window.scrollBy(scroll_amount_x, scroll_amount_y);
 487
 488             // Send mouse event
 489             guac.sendMouseState(mouseState);
 490
 491         };
 492
 493     // Keyboard
 494     var keyboard = new Guacamole.Keyboard(document);
 495
 496     function disableKeyboard() {
 497         keyboard.onkeydown = null;
 498         keyboard.onkeyup = null;
 499     }
 500
 501     function enableKeyboard() {
 502         keyboard.onkeydown =
 503             function (keysym) {
 504
 505                 // If we're using native OSK, ensure event target is reset
 506                 // on each key event.
 507                 if (GuacamoleUI.oskMode == GuacamoleUI.OSK_MODE_NATIVE)
 508                     GuacamoleUI.resetEventTarget();
 509
 510                 guac.sendKeyEvent(1, keysym);
 511             };
 512
 513         keyboard.onkeyup =
 514             function (keysym) {
 515                 guac.sendKeyEvent(0, keysym);
 516             };
 517     }
 518
 519     // Enable keyboard by default
 520     enableKeyboard();
 521
 522     // Handle client state change
 523     guac.onstatechange = function(clientState) {
 524
 525         switch (clientState) {
 526
 527             // Idle
 528             case 0:
 529                 GuacamoleUI.showStatus("Idle.");
 530                 title_prefix = "[Idle]";
 531                 break;
 532
 533             // Connecting
 534             case 1:
 535                 GuacamoleUI.shadeMenu();
 536                 GuacamoleUI.showStatus("Connecting...");
 537                 title_prefix = "[Connecting...]";
 538                 break;
 539
 540             // Connected + waiting
 541             case 2:
 542                 GuacamoleUI.showStatus("Connected, waiting for first update...");
 543                 title_prefix = "[Waiting...]";
 544                 break;
 545
 546             // Connected
 547             case 3:
 548
 549                 GuacamoleUI.hideStatus();
 550                 GuacamoleUI.display.className =
 551                     GuacamoleUI.display.className.replace(/guac-loading/, '');
 552
 553                 GuacamoleUI.menu.className = "connected";
 554
 555                 title_prefix = null;
 556                 break;
 557
 558             // Disconnecting
 559             case 4:
 560                 GuacamoleUI.showStatus("Disconnecting...");
 561                 title_prefix = "[Disconnecting...]";
 562                 break;
 563
 564             // Disconnected
 565             case 5:
 566                 GuacamoleUI.showStatus("Disconnected.");
 567                 title_prefix = "[Disconnected]";
 568                 break;
 569
 570             // Unknown status code
 571             default:
 572                 GuacamoleUI.showStatus("[UNKNOWN STATUS]");
 573
 574         }
 575
 576         updateTitle();
 577     };
 578
 579     // Name instruction handler
 580     guac.onname = function(name) {
 581         connection_name = name;
 582         updateTitle();
 583     };
 584
 585     // Error handler
 586     guac.onerror = function(error) {
 587
 588         // Disconnect, if connected
 589         guac.disconnect();
 590
 591         // Display error message
 592         GuacamoleUI.showError(error);
 593
 594     };
 595
 596     // Disconnect on close
 597     window.onunload = function() {
 598         guac.disconnect();
 599     };
 600
 601     // If text is input directly into event target without typing (as with
 602     // voice input, for example), type automatically.
 603     GuacamoleUI.eventTarget.oninput = function(e) {
 604
 605         // Get input text
 606         var text = GuacamoleUI.eventTarget.value;
 607
 608         // Send each character
 609         for (var i=0; i<text.length; i++) {
 610
 611             // Get char code
 612             var charCode = text.charCodeAt(i);
 613
 614             // Convert to keysym
 615             var keysym = 0x003F; // Default to a question mark
 616             if (charCode >= 0x0000 && charCode <= 0x00FF)
 617                 keysym = charCode;
 618             else if (charCode >= 0x0100 && charCode <= 0x10FFFF)
 619                 keysym = 0x01000000 | charCode;
 620
 621             // Press and release key
 622             guac.sendKeyEvent(1, keysym);
 623             guac.sendKeyEvent(0, keysym);
 624
 625         }
 626
 627         // Reset target
 628         GuacamoleUI.resetEventTarget();
 629
 630         // Stop event
 631         e.preventDefault();
 632         return false;
 633
 634     }
 635
 636     // Handle clipboard events
 637     GuacamoleUI.clipboard.onchange = function() {
 638
 639         var text = GuacamoleUI.clipboard.value;
 640         guac.setClipboard(text);
 641
 642     };
 643
 644     // Ignore keypresses when clipboard is focused
 645     GuacamoleUI.clipboard.onfocus = function() {
 646         disableKeyboard();
 647     };
 648
 649     // Capture keypresses when clipboard is not focused
 650     GuacamoleUI.clipboard.onblur = function() {
 651         enableKeyboard();
 652     };
 653
 654     // Server copy handler
 655     guac.onclipboard = function(data) {
 656         GuacamoleUI.clipboard.value = data;
 657     };
 658
 659     GuacamoleUI.keyboard.onkeydown = function(keysym) {
 660         guac.sendKeyEvent(1, keysym);
 661     };
 662
 663     GuacamoleUI.keyboard.onkeyup = function(keysym) {
 664         guac.sendKeyEvent(0, keysym);
 665     };
 666
 667     // Send Ctrl-Alt-Delete
 668     GuacamoleUI.buttons.ctrlAltDelete.onclick = function() {
 669
 670         var KEYSYM_CTRL   = 0xFFE3;
 671         var KEYSYM_ALT    = 0xFFE9;
 672         var KEYSYM_DELETE = 0xFFFF;
 673
 674         guac.sendKeyEvent(1, KEYSYM_CTRL);
 675         guac.sendKeyEvent(1, KEYSYM_ALT);
 676         guac.sendKeyEvent(1, KEYSYM_DELETE);
 677         guac.sendKeyEvent(0, KEYSYM_DELETE);
 678         guac.sendKeyEvent(0, KEYSYM_ALT);
 679         guac.sendKeyEvent(0, KEYSYM_CTRL);
 680     };
 681
 682 };