contextmenu.js 9.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296
  1. // Generated by CoffeeScript 2.0.0-beta4
  2. (function() {
  3. // ------------------------------------------------------------------------
  4. // 變數與常數設置
  5. // ------------------------------------------------------------------------
  6. // 模組名稱。
  7. var ClassName, EVENT_NAMESPACE, Error, Event, MODULE_NAMESPACE, Metadata, NAME, Selector, Settings;
  8. NAME = 'contextmenu';
  9. // 模組事件鍵名。
  10. EVENT_NAMESPACE = `.${NAME}`;
  11. // 模組命名空間。
  12. MODULE_NAMESPACE = `module-${NAME}`;
  13. // 模組設定。
  14. Settings = {
  15. // 消音所有提示,甚至是錯誤訊息。
  16. silent: false,
  17. // 顯示除錯訊息。
  18. debug: true,
  19. // 監聽 DOM 結構異動並自動重整快取。
  20. observeChanges: true,
  21. // 目標選擇器。
  22. target: null,
  23. // 複合式選單是否可因為使用者點擊選單外面而自動關閉。
  24. closable: true,
  25. // 複合式選單是否可以因為在觸控裝置上長按而顯示。
  26. touch: true,
  27. // 當複合式選單出現時所會呼叫的回呼函式。
  28. onShow: (event, target, x, y) => {
  29. return true;
  30. },
  31. // 當複合式選單隱藏時所會呼叫的回呼函式。
  32. onHide: () => {
  33. return true;
  34. },
  35. // 當複合式選單被停用時所會呼叫的回呼函式。
  36. onDisable: () => {},
  37. // 當複合式選單被啟用時所會呼叫的回呼函式。
  38. onEnable: () => {},
  39. // 當複合式選單被點擊項目時所會呼叫的回呼函式。
  40. onSelect: (event, value, element) => {}
  41. };
  42. // 中繼資料名稱。
  43. Metadata = {
  44. DISABLE: 'disable'
  45. };
  46. // 事件名稱。
  47. Event = {
  48. SHOW: `show${EVENT_NAMESPACE}`,
  49. HIDE: `hide${EVENT_NAMESPACE}`,
  50. DISABLE: `disable${EVENT_NAMESPACE}`,
  51. ENABLE: `enable${EVENT_NAMESPACE}`,
  52. SELECT: `select${EVENT_NAMESPACE}`,
  53. CONTEXTMENU: `contextmenu${EVENT_NAMESPACE}`,
  54. CLICK: `click${EVENT_NAMESPACE}`
  55. };
  56. // 樣式名稱。
  57. ClassName = {
  58. VISIBLE: 'visible',
  59. ANIMATING: 'animating',
  60. DOWNWARD: 'downward',
  61. UPWARD: 'upward',
  62. RIGHTWARD: 'rightward',
  63. LEFTWARD: 'leftward',
  64. HIDDEN: 'hidden'
  65. };
  66. // 選擇器名稱。
  67. Selector = {
  68. BODY: 'body',
  69. ITEM: ':scope > .item'
  70. };
  71. // 錯誤訊息。
  72. Error = {};
  73. // ------------------------------------------------------------------------
  74. // 模組註冊
  75. // ------------------------------------------------------------------------
  76. ts.register({NAME, MODULE_NAMESPACE, Error, Settings}, ({$allModules, $this, element, debug, settings}) => {
  77. var $body, $item, $parent, duration, module, padding;
  78. // ------------------------------------------------------------------------
  79. // 區域變數
  80. // ------------------------------------------------------------------------
  81. $item = $this.find(Selector.ITEM);
  82. $body = ts(Selector.BODY);
  83. $parent = !settings.target ? $this.parent() : ts(settings.target);
  84. padding = 10;
  85. duration = {
  86. hidden: 80,
  87. visible: 10
  88. };
  89. // ------------------------------------------------------------------------
  90. // 模組定義
  91. // ------------------------------------------------------------------------
  92. return module = {
  93. show: (x, y) => {
  94. debug('顯示複合式選單', element);
  95. module.set.position(x, y);
  96. module.animate.show(() => {
  97. return module.remove.animating();
  98. });
  99. return $allModules;
  100. },
  101. hide: () => {
  102. debug('隱藏複合式選單', element);
  103. if (module.is.hidden()) {
  104. return;
  105. }
  106. if (!module.trigger.hide()) {
  107. return;
  108. }
  109. module.animate.hide(() => {
  110. return module.remove.animating();
  111. });
  112. return $allModules;
  113. },
  114. animate: {
  115. show: (callback) => {
  116. return $this.off('animationend').removeClass(ClassName.HIDDEN).addClass(ClassName.VISIBLE, ClassName.ANIMATING).one('animationend', () => {
  117. if (callback != null) {
  118. return callback.call();
  119. }
  120. }).emulate('animationend', duration.visible);
  121. },
  122. hide: (callback) => {
  123. return $this.off('animationend').removeClass(ClassName.VISIBLE).addClass(ClassName.HIDDEN, ClassName.ANIMATING).one('animationend', () => {
  124. if (callback != null) {
  125. return callback.call();
  126. }
  127. }).emulate('animationend', duration.hidden);
  128. }
  129. },
  130. disable: () => {
  131. debug('停用複合式選單', element);
  132. module.set.disable();
  133. return $allModules;
  134. },
  135. enable: () => {
  136. debug('啟用複合式選單', element);
  137. module.set.enable();
  138. return $allModules;
  139. },
  140. set: {
  141. position: (x, y) => {
  142. var h, left, r, top, w;
  143. r = module.get.rect();
  144. w = window.innerWidth;
  145. h = window.innerHeight;
  146. if (!module.trigger.show(x, y)) {
  147. return;
  148. }
  149. if (x < padding) {
  150. left = padding;
  151. } else if (x + r.width + padding > w) {
  152. left = w - r.width - padding;
  153. } else {
  154. left = x;
  155. }
  156. if (y < padding) {
  157. top = padding;
  158. } else if (y + r.height + padding > h) {
  159. top = h - r.height - padding;
  160. } else {
  161. top = y;
  162. }
  163. return $this.css('left', `${left}px`).css('top', `${top}px`);
  164. },
  165. visible: () => {
  166. return $this.addClass(ClassName.VISIBLE);
  167. },
  168. hidden: () => {
  169. return $this.removeClass(ClassName.VISIBLE);
  170. },
  171. disable: () => {
  172. return $this.trigger(Event.DISABLE, element).data(Metadata.DISABLE, true);
  173. },
  174. enable: () => {
  175. return $this.trigger(Event.ENABLE, element).data(Metadata.DISABLE, false);
  176. }
  177. },
  178. remove: {
  179. animating: () => {
  180. return $this.removeClass(ClassName.ANIMATING);
  181. }
  182. },
  183. is: {
  184. disable: () => {
  185. return $this.data(Metadata.DISABLE);
  186. },
  187. enable: () => {
  188. return !$this.data(Metadata.DISABLE);
  189. },
  190. visible: () => {
  191. return $this.hasClass(ClassName.VISIBLE);
  192. },
  193. hidden: () => {
  194. return !$this.hasClass(ClassName.VISIBLE);
  195. },
  196. closable: () => {
  197. return settings.closable;
  198. }
  199. },
  200. get: {
  201. rect: () => {
  202. var rect;
  203. module.set.visible();
  204. rect = element.getBoundingClientRect();
  205. module.set.hidden();
  206. return rect;
  207. },
  208. value: (element) => {
  209. return ts(element).attr('data-value');
  210. }
  211. },
  212. trigger: {
  213. show: (x, y) => {
  214. debug('發生 SHOW 事件', element, document.elementFromPoint(x, y), x, y);
  215. return settings.onShow.call(element, document.elementFromPoint(x, y), x, y);
  216. },
  217. hide: () => {
  218. debug('發生 HIDE 事件', element);
  219. return settings.onHide.call(element);
  220. }
  221. },
  222. bind: {
  223. events: () => {
  224. // FIX: 重複的 Event Listner。
  225. $body.on(Event.CLICK, () => {
  226. debug('發生 CLICK 事件', element);
  227. if (module.is.closable()) {
  228. return module.hide();
  229. }
  230. });
  231. $parent.on(Event.CONTEXTMENU, (event) => {
  232. debug('發生 CONTEXTMENU 事件', element);
  233. event.preventDefault();
  234. if (module.is.disable()) {
  235. return;
  236. }
  237. if (!settings.touch && ts.isTouchDevice()) {
  238. return;
  239. }
  240. return module.show(event.clientX, event.clientY);
  241. });
  242. $item.on(Event.CLICK, function() {
  243. debug('發生 CLICK 事件', element);
  244. return $this.trigger(Event.SELECT, element, module.get.value(this), this);
  245. });
  246. $this.on(Event.SELECT, (event, context, value, element) => {
  247. debug('發生 SELECT 事件', element, value);
  248. return settings.onSelect.call(context, event, value, element);
  249. });
  250. $this.on(Event.DISABLE, (event, context) => {
  251. debug('發生 DISABLE 事件', element);
  252. return settings.onDisable.call(context, event);
  253. });
  254. return $this.on(Event.ENABLE, (event, context) => {
  255. debug('發生 ENABLE 事件', element);
  256. return settings.onEnable.call(context, event);
  257. });
  258. }
  259. },
  260. // ------------------------------------------------------------------------
  261. // 基礎方法
  262. // ------------------------------------------------------------------------
  263. initialize: () => {
  264. debug('初始化複合式選單', element);
  265. module.set.enable();
  266. return module.bind.events();
  267. },
  268. instantiate: () => {
  269. return debug('實例化複合式選單', element);
  270. },
  271. refresh: () => {
  272. return $allModules;
  273. },
  274. destroy: () => {
  275. debug('摧毀複合式選單', element);
  276. $this.removeData(MODULE_NAMESPACE).off(EVENT_NAMESPACE);
  277. $body.off(EVENT_NAMESPACE);
  278. $item.off(EVENT_NAMESPACE);
  279. $parent.off(EVENT_NAMESPACE);
  280. return $allModules;
  281. }
  282. };
  283. });
  284. }).call(this);