fckkeystrokehandler.js
上传用户:dbstep
上传日期:2022-08-06
资源大小:2803k
文件大小:4k
源码类别:

WEB源码(ASP,PHP,...)

开发平台:

ASP/ASPX

  1. /*
  2.  * FCKeditor - The text editor for Internet - http://www.fckeditor.net
  3.  * Copyright (C) 2003-2009 Frederico Caldeira Knabben
  4.  *
  5.  * == BEGIN LICENSE ==
  6.  *
  7.  * Licensed under the terms of any of the following licenses at your
  8.  * choice:
  9.  *
  10.  *  - GNU General Public License Version 2 or later (the "GPL")
  11.  *    http://www.gnu.org/licenses/gpl.html
  12.  *
  13.  *  - GNU Lesser General Public License Version 2.1 or later (the "LGPL")
  14.  *    http://www.gnu.org/licenses/lgpl.html
  15.  *
  16.  *  - Mozilla Public License Version 1.1 or later (the "MPL")
  17.  *    http://www.mozilla.org/MPL/MPL-1.1.html
  18.  *
  19.  * == END LICENSE ==
  20.  *
  21.  * Control keyboard keystroke combinations.
  22.  */
  23. var FCKKeystrokeHandler = function( cancelCtrlDefaults )
  24. {
  25. this.Keystrokes = new Object() ;
  26. this.CancelCtrlDefaults = ( cancelCtrlDefaults !== false ) ;
  27. }
  28. /*
  29.  * Listen to keystroke events in an element or DOM document object.
  30.  * @target: The element or document to listen to keystroke events.
  31.  */
  32. FCKKeystrokeHandler.prototype.AttachToElement = function( target )
  33. {
  34. // For newer browsers, it is enough to listen to the keydown event only.
  35. // Some browsers instead, don't cancel key events in the keydown, but in the
  36. // keypress. So we must do a longer trip in those cases.
  37. FCKTools.AddEventListenerEx( target, 'keydown', _FCKKeystrokeHandler_OnKeyDown, this ) ;
  38. if ( FCKBrowserInfo.IsGecko10 || FCKBrowserInfo.IsOpera || ( FCKBrowserInfo.IsGecko && FCKBrowserInfo.IsMac ) )
  39. FCKTools.AddEventListenerEx( target, 'keypress', _FCKKeystrokeHandler_OnKeyPress, this ) ;
  40. }
  41. /*
  42.  * Sets a list of keystrokes. It can receive either a single array or "n"
  43.  * arguments, each one being an array of 1 or 2 elemenst. The first element
  44.  * is the keystroke combination, and the second is the value to assign to it.
  45.  * If the second element is missing, the keystroke definition is removed.
  46.  */
  47. FCKKeystrokeHandler.prototype.SetKeystrokes = function()
  48. {
  49. // Look through the arguments.
  50. for ( var i = 0 ; i < arguments.length ; i++ )
  51. {
  52. var keyDef = arguments[i] ;
  53. // If the configuration for the keystrokes is missing some element or has any extra comma
  54. // this item won't be valid, so skip it and keep on processing.
  55. if ( !keyDef )
  56. continue ;
  57. if ( typeof( keyDef[0] ) == 'object' ) // It is an array with arrays defining the keystrokes.
  58. this.SetKeystrokes.apply( this, keyDef ) ;
  59. else
  60. {
  61. if ( keyDef.length == 1 ) // If it has only one element, remove the keystroke.
  62. delete this.Keystrokes[ keyDef[0] ] ;
  63. else // Otherwise add it.
  64. this.Keystrokes[ keyDef[0] ] = keyDef[1] === true ? true : keyDef ;
  65. }
  66. }
  67. }
  68. function _FCKKeystrokeHandler_OnKeyDown( ev, keystrokeHandler )
  69. {
  70. // Get the key code.
  71. var keystroke = ev.keyCode || ev.which ;
  72. // Combine it with the CTRL, SHIFT and ALT states.
  73. var keyModifiers = 0 ;
  74. if ( ev.ctrlKey || ev.metaKey )
  75. keyModifiers += CTRL ;
  76. if ( ev.shiftKey )
  77. keyModifiers += SHIFT ;
  78. if ( ev.altKey )
  79. keyModifiers += ALT ;
  80. var keyCombination = keystroke + keyModifiers ;
  81. var cancelIt = keystrokeHandler._CancelIt = false ;
  82. // Look for its definition availability.
  83. var keystrokeValue = keystrokeHandler.Keystrokes[ keyCombination ] ;
  84. // FCKDebug.Output( 'KeyDown: ' + keyCombination + ' - Value: ' + keystrokeValue ) ;
  85. // If the keystroke is defined
  86. if ( keystrokeValue )
  87. {
  88. // If the keystroke has been explicitly set to "true" OR calling the
  89. // "OnKeystroke" event, it doesn't return "true", the default behavior
  90. // must be preserved.
  91. if ( keystrokeValue === true || !( keystrokeHandler.OnKeystroke && keystrokeHandler.OnKeystroke.apply( keystrokeHandler, keystrokeValue ) ) )
  92. return true ;
  93. cancelIt = true ;
  94. }
  95. // By default, it will cancel all combinations with the CTRL key only (except positioning keys).
  96. if ( cancelIt || ( keystrokeHandler.CancelCtrlDefaults && keyModifiers == CTRL && ( keystroke < 33 || keystroke > 40 ) ) )
  97. {
  98. keystrokeHandler._CancelIt = true ;
  99. if ( ev.preventDefault )
  100. return ev.preventDefault() ;
  101. ev.returnValue = false ;
  102. ev.cancelBubble = true ;
  103. return false ;
  104. }
  105. return true ;
  106. }
  107. function _FCKKeystrokeHandler_OnKeyPress( ev, keystrokeHandler )
  108. {
  109. if ( keystrokeHandler._CancelIt )
  110. {
  111. // FCKDebug.Output( 'KeyPress Cancel', 'Red') ;
  112. if ( ev.preventDefault )
  113. return ev.preventDefault() ;
  114. return false ;
  115. }
  116. return true ;
  117. }