/* * * (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 = [], _isAlt = false, _hintVisible = false, _currentLevel = 0, _currentSection = document, _currentControls = [], _currentHints = [], _inputLetters = '', _isComplete = false, _isLockedKeyEvents = false, _inputTimer; var _api; var _setCurrentSection = function (btn) { if (btn === 'esc') { if (_currentLevel === 0) { _currentSection = document; } return; } 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 (_currentHints.length === 0 || ($('#file-menu-panel').is(':visible') && _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.hide() }); clearInterval(_inputTimer); }; var _nextLevel = function() { _removeHints(); _currentHints.length = 0; _currentControls.length = 0; _currentLevel++; }; var _prevLevel = function() { _removeHints(); _currentHints.length = 0; _currentControls.length = 0; _currentLevel--; }; var _getLetters = function(countButtons) { var arr = _arrAlphabet.slice(); arr[0] = _arrAlphabet[0] + _arrAlphabet[0]; for (var i = 1; arr.length < countButtons; i++) { arr.push(_arrAlphabet[0] + _arrAlphabet[i]); } return arr; }; var _isItemDisabled = function (item) { return (item.hasClass('disabled') || item.parent().hasClass('disabled') || item.attr('disabled')); }; var _getControls = function() { _currentControls = []; var arr = $(_currentSection).find('[data-hint=' + (_currentLevel) + ']').toArray(); var visibleItems = arr.filter(function (item) { return $(item).is(':visible'); }); var visibleItemsWithTitle = $(_currentSection).find('[data-hint-title][data-hint=' + (_currentLevel) + ']').toArray().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); _currentControls.push(el); }); return; } var _arrLetters = []; if (visibleItems.length > _arrAlphabet.length) { _arrLetters = _getLetters(visibleItems.length); } else { _arrLetters = _arrAlphabet.slice(); } var usedLetters = []; if ($(_currentSection).find('[data-hint-title]').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() { if (_currentControls.length === 0) _getControls(); _currentControls.forEach(function(item, index) { if (!_isItemDisabled(item)) { if ($(_currentSection).prop('id') === 'toolbar' && ($(_currentSection).find('.toolbar-mask').length > 0 || item.closest('.group').find('.toolbar-group-mask').length > 0)) { return; } if (window.SSE && item.parent().prop('id') === 'statusbar_bottom') { var $statusbar = item.parent(); if (item.offset().left > $statusbar.offset().left + $statusbar.width()) { return; } } var hint = $('