/* * * (c) Copyright Ascensio System SIA 2010-2021 * * This program is a free software product. You can redistribute it and/or * modify it under the terms of the GNU Affero General Public License (AGPL) * version 3 as published by the Free Software Foundation. In accordance with * Section 7(a) of the GNU AGPL its Section 15 shall be amended to the effect * that Ascensio System SIA expressly excludes the warranty of non-infringement * of any third-party rights. * * This program is distributed WITHOUT ANY WARRANTY; without even the implied * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. For * details, see the GNU AGPL at: http://www.gnu.org/licenses/agpl-3.0.html * * You can contact Ascensio System SIA at 20A-12 Ernesta Birznieka-Upisha * street, Riga, Latvia, EU, LV-1050. * * The interactive user interfaces in modified source and object code versions * of the Program must display Appropriate Legal Notices, as required under * Section 5 of the GNU AGPL version 3. * * Pursuant to Section 7(b) of the License you must retain the original Product * logo when distributing the program. Pursuant to Section 7(e) we decline to * grant you any rights under trademark law for use of our trademarks. * * All the Product's GUI elements, including illustrations and icon sets, as * well as technical writing content are licensed under the terms of the * Creative Commons Attribution-ShareAlike 4.0 International. See the License * terms at http://creativecommons.org/licenses/by-sa/4.0/legalcode * */ /** * HintManager.js * * Created by Julia Radzhabova on 21.04.2021 * Copyright (c) 2021 Ascensio System SIA. All rights reserved. * */ /** * Example usage with simple items: * * * * * Example usage with components: * * new Common.UI.Button({ * ... * dataHint: '1', // '0' - tabs in toolbar, left and right menu, statusbar; * // '1' - file menu, contents of toolbar tabs, contents of right and left panels * dataHintDirection: 'bottom', // top, bottom, right, left, left-top * dataHintOffset: 'small', // big - 6px, medium - 4px, small - 2px * dataHintTitle : 'S' * }); * * new Common.UI.CheckBox({ * ... * dataHint: '1', * dataHintDirection: 'left', * dataHintOffset: 'small' * }); * * new Common.UI.ComboBox({ * ... * dataHint: '1', * dataHintDirection: 'bottom', * dataHintOffset: 'big' * }); * * new Common.UI.InputField({ * ... * dataHint: '1', * dataHintDirection: 'left', * dataHintOffset: 'small' * }); * * new Common.UI.MetricSpinner({ * ... * dataHint: '1', * dataHintDirection: 'bottom', * dataHintOffset: 'big' * }); * * new Common.UI.RadioBox({ * ... * dataHint: '1', * dataHintDirection: 'left', * dataHintOffset: 'small' * }); */ if (Common === undefined) var Common = {}; if (Common.UI === undefined) { Common.UI = {}; } Common.UI.HintManager = new(function() { var _lang = 'en', _arrAlphabet = [], _arrEnAlphabet = [], _arrQwerty = [], _arrEnQwerty = [], _needShow = false, _hintVisible = false, _currentLevel = 0, _currentSection = document, _currentControls = [], _currentHints = [], _inputLetters = '', _isComplete = false, _isLockedKeyEvents = false, _inputTimer, _isDocReady = false, _isEditDiagram = false, _usedTitles = []; var _api; var _setCurrentSection = function (btn, section) { if (section) { _currentSection = section; return; } if (btn === 'esc') { if (_currentLevel === 0) { _currentSection = document; } return; } if (_isEditDiagram) { _currentSection = [$(window.parent.document).find('.advanced-settings-dlg')[0], window.document]; } else if ($('#file-menu-panel').is(':visible')) { _currentSection = $('#file-menu-panel'); } else { _currentSection = (btn && btn.closest('.hint-section')) || document; } }; var _lockedKeyEvents = function (isLocked) { if (_api) { _isLockedKeyEvents = isLocked; _api.asc_enableKeyEvents(!isLocked); } }; var _showHints = function () { _inputLetters = ''; if (_currentLevel === 0) { Common.NotificationCenter.trigger('toolbar:collapse'); } if (_currentHints.length === 0 || ($('#file-menu-panel').is(':visible' || _isEditDiagram) && _currentLevel === 1)) { _getHints(); } if (_currentHints.length > 0) { !_isLockedKeyEvents && _lockedKeyEvents(true); _hintVisible = true; _currentHints.forEach(function(item) { item.show(); }); _inputTimer = setInterval(function () { if (_inputLetters.length > 0) { _inputLetters = ''; } }, 5000); } else { _hintVisible = false; } }; var _hideHints = function() { _hintVisible = false; _currentHints && _currentHints.forEach(function(item) { item.remove() }); clearInterval(_inputTimer); }; var _nextLevel = function(level) { _removeHints(); _currentHints.length = 0; _currentControls.length = 0; if (level !== undefined) { _currentLevel = level; } else { _currentLevel++; } }; var _prevLevel = function() { _removeHints(); _currentHints.length = 0; _currentControls.length = 0; _currentLevel--; }; var _getLetters = function(countButtons) { var arr = _arrAlphabet.slice(), firstFreeLetter, ind; for (var i = 0; i < _arrAlphabet.length, !firstFreeLetter; i++) { if (_usedTitles.indexOf(_arrAlphabet[i]) === -1) { firstFreeLetter = _arrAlphabet[i]; ind = i; } } arr[ind] = firstFreeLetter + _arrAlphabet[0]; for (var i = 0; arr.length < countButtons; i++) { var addTip = firstFreeLetter + _arrAlphabet[i]; if (addTip !== arr[ind]) { arr.push(firstFreeLetter + _arrAlphabet[i]); } } return arr; }; var _isItemDisabled = function (item) { return (item.hasClass('disabled') || item.parent().hasClass('disabled') || item.attr('disabled')); }; var _getControls = function() { _currentControls = []; _usedTitles = []; var arr = [], arrItemsWithTitle = []; if (_.isArray(_currentSection)) { _currentSection.forEach(function (section) { arr = arr.concat($(section).find('[data-hint=' + (_currentLevel) + ']').toArray()); arrItemsWithTitle = arrItemsWithTitle.concat($(section).find('[data-hint-title][data-hint=' + (_currentLevel) + ']').toArray()); }); } else { arr = $(_currentSection).find('[data-hint=' + (_currentLevel) + ']').toArray(); arrItemsWithTitle = $(_currentSection).find('[data-hint-title][data-hint=' + (_currentLevel) + ']').toArray(); } var visibleItems = arr.filter(function (item) { return $(item).is(':visible'); }); var visibleItemsWithTitle = arrItemsWithTitle.filter(function (item) { return $(item).is(':visible'); }); if (visibleItems.length === visibleItemsWithTitle.length) { // all buttons have data-hint-title visibleItems.forEach(function (item) { var el = $(item); if (_lang !== 'en') { var title = el.attr('data-hint-title').toLowerCase(), firstLetter = title.substr(0, 1); if (_arrAlphabet.indexOf(firstLetter) === -1) { // tip is in English var newTip = ''; for (var i = 0; i < title.length; i++) { var letter = title.substr(i, 1), ind = _arrEnAlphabet.indexOf(letter); newTip = newTip + _arrAlphabet[ind].toUpperCase(); } el.attr('data-hint-title', newTip); } } _currentControls.push(el); }); return; } var _arrLetters = []; if (visibleItems.length > _arrAlphabet.length) { visibleItemsWithTitle.forEach(function (item) { var t = $(item).data('hint-title').toLowerCase(); if (_arrAlphabet.indexOf(t) === -1) { var ind = _arrEnAlphabet.indexOf(t); t = _arrAlphabet[ind]; } _usedTitles.push(t); }); _arrLetters = _getLetters(visibleItems.length); } else { _arrLetters = _arrAlphabet.slice(); } var usedLetters = []; if (arrItemsWithTitle.length > 0) { visibleItems.forEach(function (item) { var el = $(item); var title = el.attr('data-hint-title'); if (title) { var ind = _arrEnAlphabet.indexOf(title.toLowerCase()); if (ind === -1) { // we have already changed usedLetters.push(_arrAlphabet.indexOf(title.toLowerCase())); } else { usedLetters.push(ind); if (_lang !== 'en') { el.attr('data-hint-title', _arrLetters[ind].toUpperCase()); } } } }); } var index = 0; visibleItems.forEach(function (item) { var el = $(item); while (usedLetters.indexOf(index) !== -1) { index++; } var title = el.attr('data-hint-title'); if (!title) { el.attr('data-hint-title', _arrLetters[index].toUpperCase()); index++; } _currentControls.push(el); }); }; var _getHints = function() { var docH = _isEditDiagram ? (window.parent.innerHeight * Common.Utils.zoom()) : (Common.Utils.innerHeight() - 20), docW = _isEditDiagram ? (window.parent.innerWidth * Common.Utils.zoom()) : (Common.Utils.innerWidth()), section = _isEditDiagram ? _currentSection[0] : _currentSection, topSection = _currentLevel !== 0 && $(section).length > 0 && !_isEditDiagram ? $(section).offset().top : 0, bottomSection = _currentLevel !== 0 && $(section).length > 0 && !_isEditDiagram ? topSection + $(section).height() : docH; if ($(section).prop('id') === 'toolbar' && $(section).outerHeight() < $(section).find('.box-controls').outerHeight()) { bottomSection += $(section).find('.box-controls').outerHeight(); } if (_currentControls.length === 0) _getControls(); _currentControls.forEach(function(item, index) { if (!_isItemDisabled(item)) { var leftBorder = 0, rightBorder = docW; if (!_isEditDiagram && $(_currentSection).prop('id') === 'toolbar' && ($(_currentSection).find('.toolbar-mask').length > 0) || ($('#about-menu-panel').is(':visible') && item.closest('.hint-section').prop('id') === 'right-menu')) { // don't show right menu hints when about is visible return; } if (window.SSE && item.parent().prop('id') === 'statusbar_bottom') { var $statusbar = item.parent(); if (item.offset().left > $statusbar.offset().left + $statusbar.width()) { return; } } if (_currentLevel === 0 && item.closest('.tabs.short').length > 0) { var blockTabs = item.closest('.tabs.short'); leftBorder = blockTabs.offset().left; rightBorder = leftBorder + blockTabs.width(); if (!item.hasClass('scroll')) { leftBorder += 20; rightBorder -= 20; } } var hint = $('
' + item.attr('data-hint-title') + '
'); var direction = item.attr('data-hint-direction'); // exceptions if (window.SSE && !_isEditDiagram && _currentSection.nodeType !== 9 && _currentSection.prop('id') === 'toolbar' && item.closest('.panel').attr('data-tab') === 'data') { if (item.parent().hasClass('slot-sortdesc') || item.parent().hasClass('slot-btn-setfilter')) { direction = 'top'; item.attr('data-hint-direction', 'top'); } else if (item.parent().hasClass('slot-btn-clear-filter') || item.parent().hasClass('slot-sortasc')) { direction = 'bottom'; item.attr('data-hint-direction', 'bottom'); } } var maxHeight = docH; if ($('#file-menu-panel').is(':visible') && _currentLevel > 1 && ($('.fms-flex-apply').is(':visible') || $('#fms-flex-apply').is(':visible')) && item.closest('.fms-flex-apply').length < 1 && item.closest('#fms-flex-apply').length < 1) { maxHeight = docH - $('.fms-flex-apply').height(); } var offsets = item.attr('data-hint-offset'); var applyOffset = offsets === 'big' ? 6 : (offsets === 'medium' ? 4 : (offsets === 'small' ? 2 : 0)); if (applyOffset) { switch (direction) { case 'bottom': offsets = [-applyOffset, 0]; break; case 'top': offsets = [applyOffset, 0]; break; case 'right': offsets = [0, -applyOffset]; break; case 'left': offsets = [0, applyOffset]; break; } } else { offsets = offsets ? item.attr('data-hint-offset').split(',').map(function (item) { return parseInt(item); }) : [0, 0]; } var offset = item.offset(); var top, left; if (direction === 'left-top') { top = offset.top - 10 + offsets[0]; left = offset.left - 10 + offsets[1]; } else if (direction === 'top') { top = offset.top - 18 + offsets[0]; left = offset.left + (item.outerWidth() - 18) / 2 + offsets[1]; } else if (direction === 'right') { top = offset.top + (item.outerHeight() - 18) / 2 + offsets[0]; left = offset.left + item.outerWidth() + offsets[1]; } else if (direction === 'left') { top = offset.top + (item.outerHeight() - 18) / 2 + offsets[0]; left = offset.left - 18 + offsets[1]; } else { top = offset.top + item.outerHeight() + offsets[0]; left = offset.left + (item.outerWidth() - 18) / 2 + offsets[1]; } if (top < maxHeight && left < docW && top > topSection && top < bottomSection && left > leftBorder && left + 18 < rightBorder) { hint.css({ top: top, left: left }); if (_isEditDiagram && index < 2) { hint.css('z-index', '1060'); $(window.parent.document.body).append(hint); } else { $(document.body).append(hint); } } _currentHints.push(hint); } }); }; var _removeHints = function() { _currentHints && _currentHints.forEach(function(item) { item.remove() }); }; var _resetToDefault = function() { _currentLevel = ($('#file-menu-panel').is(':visible') || _isEditDiagram) ? 1 : 0; _setCurrentSection(); _currentHints.length = 0; _currentControls.length = 0; }; var _init = function(api) { _api = api; Common.NotificationCenter.on({ 'app:ready': function (mode) { var lang = mode.lang ? mode.lang.toLowerCase() : 'en'; _getAlphabetLetters(lang); _isDocReady = true; }, 'hints:clear': _clearHints, 'window:resize': _clearHints }); $('#editor_sdk').on('click', function () { _clearHints(); }); $(document).on('mousedown', function () { _clearHints(); }); $(document).on('keyup', function(e) { if (e.keyCode == Common.UI.Keys.ALT && _needShow && !(window.SSE && window.SSE.getController('Statusbar').getIsDragDrop())) { e.preventDefault(); if (!_hintVisible) { $('input:focus').blur(); // to change value in inputField _currentLevel = ($('#file-menu-panel').is(':visible') || _isEditDiagram) ? 1 : 0; _setCurrentSection(); _showHints(); } else { _hideHints(); _resetToDefault(); if (_isLockedKeyEvents) { _isLockedKeyEvents = false; _api.asc_enableKeyEvents(true); } } } else if (_hintVisible) { e.preventDefault(); } _needShow = false; }); $(document).on('keydown', function(e) { if (_hintVisible) { e.preventDefault(); if (e.keyCode == Common.UI.Keys.ESC ) { setTimeout(function () { if (_currentLevel === 0) { _hideHints(); _resetToDefault(); _lockedKeyEvents(false); } else { _prevLevel(); _setCurrentSection('esc'); _showHints(); } }, 10); } else { var curLetter = null, match = false; var keyCode = e.keyCode; if (keyCode !== 16 && keyCode !== 17 && keyCode !== 18 && keyCode !== 91) { curLetter = _lang === 'en' ? ((keyCode > 47 && keyCode < 58 || keyCode > 64 && keyCode < 91) ? String.fromCharCode(e.keyCode) : null) : e.key; } if (curLetter) { var curr; if (_lang !== 'en' && _arrAlphabet.indexOf(curLetter.toLowerCase()) === -1) { var ind = _arrEnQwerty.indexOf(curLetter.toLowerCase()); if (ind !== -1) { curLetter = _arrQwerty[ind]; } } _inputLetters = _inputLetters + curLetter.toUpperCase(); for (var i = 0; i < _currentControls.length; i++) { var item = _currentControls[i]; if (!_isItemDisabled(item)) { var title = item.attr('data-hint-title'), regExp = new RegExp('^' + _inputLetters + ''); if (regExp.test(title)) { match = true; } if (title === _inputLetters) { curr = item; break; } } } if (curr) { var tag = curr.prop("tagName").toLowerCase(); if (window.SSE && curr.parent().prop('id') === 'statusbar_bottom') { _hideHints(); curr.contextmenu(); _resetToDefault(); } else if (tag === 'input' || tag === 'textarea') { _hideHints(); curr.trigger(jQuery.Event('click', {which: 1})); curr.focus(); _resetToDefault(); } else if (curr.hasClass('listview')) { _hideHints(); curr.focus(); _resetToDefault(); } else { _isComplete = false; _hideHints(); if (!_isEditDiagram && $(_currentSection).prop('id') === 'toolbar' && ($(_currentSection).find('.toolbar-mask').length > 0)) { _resetToDefault(); return; } var needOpenPanel = (curr.attr('content-target') && !$('#' + curr.attr('content-target')).is(':visible') || (curr.parent().prop('id') === 'slot-btn-chat' && !$('#left-panel-chat').is(':visible')) || (curr.parent().hasClass('ribtab') && !$('#toolbar').children('.toolbar').hasClass('expanded'))); if ((!curr.attr('content-target') && curr.parent().prop('id') !== 'slot-btn-chat') || needOpenPanel) { // need to open panel if (!($('#file-menu-panel').is(':visible') && (curr.parent().prop('id') === 'fm-btn-info' && $('#panel-info').is(':visible') || curr.parent().prop('id') === 'fm-btn-settings' && $('#panel-settings').is(':visible')))) { if (curr.attr('for')) { // to trigger event in checkbox $('#' + curr.attr('for')).trigger(jQuery.Event('click', {which: 1})); } else { curr.trigger(jQuery.Event('click', {which: 1})); if (needOpenPanel) _isComplete = false; // to show next level of hints } } } if (curr.prop('id') === 'btn-goback' || curr.closest('.btn-slot').prop('id') === 'slot-btn-options' || curr.closest('.btn-slot').prop('id') === 'slot-btn-mode' || curr.prop('id') === 'btn-favorite' || curr.parent().prop('id') === 'tlb-box-users' || curr.prop('id') === 'left-btn-thumbs' || curr.hasClass('scroll') || curr.prop('id') === 'left-btn-about' || curr.prop('id') === 'left-btn-support') { _resetToDefault(); return; } if (curr.prop('id') === 'add-comment-doc') { _removeHints(); _currentHints.length = 0; _currentControls.length = 0; _showHints(); return; } if (!_isComplete) { if (curr.parent().prop('id') === 'slot-btn-chat') { _nextLevel(1); _setCurrentSection(undefined, $('#left-menu.hint-section')); } else if (curr.prop('id') === 'id-right-menu-signature') { _nextLevel(2); _setCurrentSection(curr); } else { _nextLevel(); _setCurrentSection(curr); } _showHints(); if (_currentHints.length < 1) { _resetToDefault(); } } } } else if (!match) { _inputLetters = ''; } } } } var isAlt = e.altKey; _needShow = (isAlt && !Common.Utils.ModalWindow.isVisible() && _isDocReady && _arrAlphabet.length > 0); if (isAlt && e.keyCode !== 115) { e.preventDefault(); } }); }; var _getAlphabetLetters = function (lng) { Common.Utils.loadConfig('../../common/main/resources/alphabetletters/alphabetletters.json', function (langsJson) { _arrEnAlphabet = langsJson['en']; var _setAlphabet = function (lang) { _lang = lang; _arrAlphabet = langsJson[lang]; return _arrAlphabet; }; return !_setAlphabet(lng) ? (!_setAlphabet(lng.split(/[\-_]/)[0]) ? _setAlphabet('en') : true) : true; }); Common.Utils.loadConfig('../../common/main/resources/alphabetletters/qwertyletters.json', function (langsJson) { _arrQwerty = langsJson[_lang]; if (_lang !== 'en') { _arrEnQwerty = langsJson['en']; } }); }; var _needCloseFileMenu = function () { return !(_hintVisible && _currentLevel > 1); }; var _clearHints = function (isComplete) { _hintVisible && _hideHints(); if (_currentHints.length > 0) { _resetToDefault(); } _isLockedKeyEvents && _lockedKeyEvents(false); if (isComplete) { _isComplete = true; } if ($('.hint-div').length > 0) { $('.hint-div').remove(); } if ($('iframe').length > 0) { $('iframe').contents().find('.hint-div').remove(); } }; var _isHintVisible = function () { return _hintVisible; }; var _setMode = function (mode) { _isEditDiagram = mode.isEditDiagram; }; return { init: _init, setMode: _setMode, clearHints: _clearHints, needCloseFileMenu: _needCloseFileMenu, isHintVisible: _isHintVisible } })();