From c03f11f6e18975c66724204e7f6eb02d03dbf236 Mon Sep 17 00:00:00 2001 From: Vitaly Takmazov Date: Thu, 2 Jun 2022 08:09:03 +0300 Subject: eslint-plugin-jsdoc --- src/main/assets/scripts.js | 54 +++++++++++++++++++++++++--------------------- 1 file changed, 30 insertions(+), 24 deletions(-) (limited to 'src/main/assets') diff --git a/src/main/assets/scripts.js b/src/main/assets/scripts.js index d5ceb86e..87fdf7a4 100644 --- a/src/main/assets/scripts.js +++ b/src/main/assets/scripts.js @@ -9,13 +9,14 @@ import svg4everybody from 'svg4everybody'; /** * Autosize textarea + * * @param {HTMLTextAreaElement} el textarea element */ function autosize(el) { let offset = el.offsetHeight - el.clientHeight; el.addEventListener('input', (ev) => { - const textarea = /** @type HTMLTextAreaElement */ (ev.target); + const textarea = /** @type {HTMLTextAreaElement} */ (ev.target); textarea.style.height = 'auto'; textarea.style.height = (textarea.scrollHeight + offset) + 'px'; }); @@ -23,8 +24,9 @@ function autosize(el) { /** * Display an icon from the evil-icons set + * * @param {string} name Icon name from the iconset - * @returns HTML markup for the selected icon + * @returns {string} HTML markup for the selected icon */ function evilIcon(name) { return `
`; @@ -87,6 +89,7 @@ const translations = { /** * Detect window language + * * @returns {string} Detected language */ function getLang() { @@ -223,6 +226,7 @@ function updateRepliesCounter() { /** * Submit form on Ctrl+Enter + * * @param {HTMLElement} formEl Target form element * @param {KeyboardEvent} ev Keyboard event */ @@ -230,17 +234,18 @@ function postformListener(formEl, ev) { if (ev.ctrlKey && (ev.keyCode == 10 || ev.keyCode == 13)) { let form = formEl.closest('form'); if (!form.onsubmit || form.submit()) { - /** @type HTMLInputElement */ (form.querySelector('input[type="submit"]')).click(); + /** @type {HTMLInputElement} */ (form.querySelector('input[type="submit"]')).click(); } } } /** * Close dialog on Esc + * * @param {KeyboardEvent} ev Keyboard event */ function closeDialogListener(ev) { - ev = ev || /** @type KeyboardEvent */ (window.event); + ev = ev || /** @type {KeyboardEvent} */ (window.event); if (ev.keyCode == 27) { closeDialog(); } @@ -273,13 +278,13 @@ function showCommentForm(mid, rid) { formTarget.remove(); let form = reply.querySelector('form'); - let submitButton = /** @type HTMLInputElement */ (form.querySelector('input[type="submit"]')); + let submitButton = /** @type {HTMLInputElement} */ (form.querySelector('input[type="submit"]')); let attachButton = form.querySelector('.msg-comment .attach-photo'); - attachButton.addEventListener('click', e => attachCommentPhoto(/** @type HTMLDivElement */ (e.target))); + attachButton.addEventListener('click', e => attachCommentPhoto(/** @type {HTMLDivElement} */ (e.target))); - let textarea = /** @type HTMLTextAreaElement */ (form.querySelector('.msg-comment textarea')); - textarea.addEventListener('keypress', e => postformListener(/** @type HTMLElement */ (e.target), e)); + let textarea = /** @type {HTMLTextAreaElement} */ (form.querySelector('.msg-comment textarea')); + textarea.addEventListener('keypress', e => postformListener(/** @type {HTMLElement} */ (e.target), e)); autosize(textarea); let validateMessage = () => { @@ -318,7 +323,7 @@ function showCommentForm(mid, rid) { e.preventDefault(); }); } - /** @type HTMLTextAreaElement */ (reply.querySelector('.msg-comment textarea')).focus(); + /** @type {HTMLTextAreaElement} */ (reply.querySelector('.msg-comment textarea')).focus(); } function attachInput() { @@ -332,6 +337,7 @@ function attachInput() { /** * "Attach" button + * * @param {HTMLDivElement} div */ function attachCommentPhoto(div) { @@ -395,7 +401,7 @@ function closeDialog() { function checkUsername() { var uname = document.querySelector('#username').textContent, - style = /** @type HTMLElement */ (document.querySelector('#username')).style; + style = /** @type {HTMLElement} */ (document.querySelector('#username')).style; fetch('/api/users?uname=' + uname) .then(handleErrors) .then(function() { @@ -554,15 +560,15 @@ ready(() => { e.target.removeEventListener('click', insertPMButtons); e.preventDefault(); }; - /** @type HTMLTextAreaElement[] */ (Array.from(document.querySelectorAll('textarea.replypm'))).forEach(function(e) { + /** @type {HTMLTextAreaElement[]} */ (Array.from(document.querySelectorAll('textarea.replypm'))).forEach(function(e) { e.addEventListener('click', insertPMButtons); e.addEventListener('keypress', function(e) { - postformListener(/** @type HTMLElement */ (e.target), e); + postformListener(/** @type {HTMLElement} */ (e.target), e); }); }); - /** @type HTMLTextAreaElement[] */ (Array.from(document.querySelectorAll('#postmsg textarea'))).forEach(function(e) { + /** @type {HTMLTextAreaElement[]} */ (Array.from(document.querySelectorAll('#postmsg textarea'))).forEach(function(e) { e.addEventListener('keypress', function(e) { - postformListener(/** @type HTMLElement */ (e.target), e); + postformListener(/** @type {HTMLElement} */ (e.target), e); }); }); @@ -581,10 +587,10 @@ ready(() => { }); let opMessage = document.querySelector('.msgthread'); if (opMessage) { - let replyTextarea = /** @type HTMLTextAreaElement */ (opMessage.querySelector('textarea.reply')); + let replyTextarea = /** @type {HTMLTextAreaElement} */ (opMessage.querySelector('textarea.reply')); if (replyTextarea) { replyTextarea.addEventListener('focus', e => showCommentForm(pageMID, 0)); - replyTextarea.addEventListener('keypress', e => postformListener(/** @type HTMLElement */ (e.target), e)); + replyTextarea.addEventListener('keypress', e => postformListener(/** @type {HTMLElement} */ (e.target), e)); if (!window.location.hash) { replyTextarea.focus(); } @@ -593,7 +599,7 @@ ready(() => { } } - var postmsg = /** @type HTMLFormElement */(document.getElementById('postmsg')); + var postmsg = /** @type {HTMLFormElement} */(document.getElementById('postmsg')); if (postmsg) { Array.from(document.querySelectorAll('a')).filter(t => t.href.indexOf('?') >= 0).forEach(t => { t.addEventListener('click', e => { @@ -629,7 +635,7 @@ ready(() => { e.preventDefault(); }); } - /** @type HTMLFormElement[] */ (Array.from(document.querySelectorAll('.pmmsg'))).forEach(pmmsg => { + /** @type {HTMLFormElement[]} */ (Array.from(document.querySelectorAll('.pmmsg'))).forEach(pmmsg => { pmmsg.addEventListener('submit', e => { let formData = new FormData(pmmsg); fetch('/api/pm' + '?hash=' + document.getElementById('body').getAttribute('data-hash'), { @@ -660,13 +666,13 @@ ready(() => { e.addEventListener('click', function(e) { setPrivacy( e.target, - /** @type HTMLElement */(e.target).closest('article').getAttribute('data-mid')); + /** @type {HTMLElement} */(e.target).closest('article').getAttribute('data-mid')); e.preventDefault(); }); }); Array.from(document.querySelectorAll('.ir a[data-fname], .msg-media a[data-fname]')).forEach(function(el) { el.addEventListener('click', function(e) { - let fname = /** @type HTMLElement */ (e.target).closest('[data-fname]').getAttribute('data-fname'); + let fname = /** @type {HTMLElement} */ (e.target).closest('[data-fname]').getAttribute('data-fname'); if (!showPhotoDialog(fname)) { e.preventDefault(); } @@ -684,7 +690,7 @@ ready(() => { e.addEventListener('click', function(e) { likeMessage( e.target, - /** @type HTMLElement */(e.target).closest('article').getAttribute('data-mid')); + /** @type {HTMLElement} */(e.target).closest('article').getAttribute('data-mid')); e.preventDefault(); }); }); @@ -705,10 +711,10 @@ ready(() => { var unfoldall = document.getElementById('unfoldall'); if (unfoldall) { unfoldall.addEventListener('click', function(e) { - /** @type HTMLElement[] */ (Array.from(document.querySelectorAll('#replies>li'))).forEach(function(e) { + /** @type {HTMLElement[]} */ (Array.from(document.querySelectorAll('#replies>li'))).forEach(function(e) { e.style.display = 'block'; }); - /** @type HTMLElement[] */ (Array.from(document.querySelectorAll('#replies .msg-comments'))).forEach(function(e) { + /** @type {HTMLElement[]} */ (Array.from(document.querySelectorAll('#replies .msg-comments'))).forEach(function(e) { e.style.display = 'none'; }); e.preventDefault(); @@ -758,7 +764,7 @@ ready(() => { } }); let location = window.location.href; - /** @type HTMLLinkElement[] */ (Array.from(document.querySelectorAll('#header_wrapper a'))).forEach(el => { + /** @type {HTMLLinkElement[]} */ (Array.from(document.querySelectorAll('#header_wrapper a'))).forEach(el => { if (el.href === location) { el.classList.add('active'); el.setAttribute('disabled', 'disabled'); -- cgit v1.2.3