const config = require( './config.json' ); const activeIndex = { index: -1, max: config.wgCitizenMaxSearchResults + 1, setMax: function ( x ) { this.max = x + 1; }, increment: function ( i ) { this.index += i; if ( this.index < 0 ) { this.setIndex( this.max - 1 ); } // Index reaches top if ( this.index === this.max ) { this.setIndex( 0 ); } // Index reaches bottom return this.index; }, setIndex: function ( i ) { if ( i <= this.max - 1 ) { this.index = i; } return this.index; }, clear: function () { this.setIndex( -1 ); } }; let typeahead, searchInput; /* * @param {HTMLElement} element * @return {void} */ function toggleActive( element ) { const typeaheadItems = typeahead.querySelectorAll( 'li > a' ), activeClass = 'citizen-typeahead-option--active'; /* eslint-disable mediawiki/class-doc */ for ( let i = 0; i < typeaheadItems.length; i++ ) { if ( element !== typeaheadItems[ i ] ) { typeaheadItems[ i ].classList.remove( activeClass ); } else { if ( element.classList.contains( activeClass ) ) { element.classList.remove( activeClass ); } else { element.classList.add( activeClass ); searchInput.setAttribute( 'aria-activedescendant', element.id ); activeIndex.setIndex( i ); } } } /* eslint-enable mediawiki/class-doc */ } /** * Keyboard events: up arrow, down arrow and enter. * moves the 'active' suggestion up and down. * * @param {Event} event */ function keyboardEvents( event ) { if ( event.defaultPrevented ) { return; // Do nothing if the event was already processed } // Is children slower? const typeaheadItems = typeahead.querySelectorAll( 'li > a' ); if ( event.key === 'ArrowDown' || event.key === 'ArrowUp' ) { if ( event.key === 'ArrowDown' ) { activeIndex.increment( 1 ); } else { activeIndex.increment( -1 ); } toggleActive( typeaheadItems[ activeIndex.index ] ); } if ( event.key === 'Enter' && typeaheadItems[ activeIndex.index ] ) { event.preventDefault(); typeaheadItems[ activeIndex.index ].click(); } } /* * Bind mouseenter and mouseleave event to reproduce mouse hover event * * @param {HTMLElement} element * @return {void} */ function bindMouseHoverEvent( element ) { element.addEventListener( 'mouseenter', ( event ) => { toggleActive( event.currentTarget ); } ); element.addEventListener( 'mouseleave', ( event ) => { toggleActive( event.currentTarget ); } ); } /** * Remove all existing suggestions from typeahead * * @return {void} */ function clearSuggestions() { const typeaheadItems = typeahead.children, nonSuggestionCount = 2; if ( typeaheadItems.length > nonSuggestionCount ) { // Splice would be cleaner but it is slower (?) const fragment = new DocumentFragment(), nonSuggestionItems = [ ...typeaheadItems ].slice( typeaheadItems.length - nonSuggestionCount, typeaheadItems.length ); nonSuggestionItems.forEach( ( item ) => { fragment.append( item ); } ); // TODO: Just use replaceChildren when browser support is >90% if ( typeof typeahead.replaceChildren !== 'undefined' ) { typeahead.replaceChildren( fragment ); } else { while ( typeahead.hasChildNodes() ) { typeahead.removeChild( typeahead.lastChild ); } typeahead.appendChild( fragment ); } } // Remove loading animation searchInput.parentNode.classList.remove( 'search-form__loading' ); searchInput.setAttribute( 'aria-activedescendant', '' ); activeIndex.clear(); } /** * Fetch suggestions from API and render the suggetions in HTML * * @param {string} searchQuery * @return {void} */ function getSuggestions( searchQuery ) { const renderSuggestions = ( results ) => { const prefix = 'citizen-typeahead-suggestion', template = document.getElementById( prefix + '-template' ), fragment = document.createDocumentFragment(), suggestionLinkPrefix = config.wgScriptPath + '/index.php?title=Special:Search&search=', sanitizedSearchQuery = mw.html.escape( mw.util.escapeRegExp( searchQuery ) ), regex = new RegExp( sanitizedSearchQuery, 'i' ); // Maybe there is a cleaner way? // Maybe there is a faster way compared to multiple querySelector? // Should I just use regular for loop for faster performance? results.forEach( ( result ) => { const suggestion = template.content.cloneNode( true ), suggestionLink = suggestion.querySelector( '.' + prefix ), suggestionThumbnail = suggestion.querySelector( '.' + prefix + '__thumbnail img' ), suggestionTitle = suggestion.querySelector( '.' + prefix + '__title' ), suggestionDescription = suggestion.querySelector( '.' + prefix + '__description' ); // Give element a unique ID suggestionLink.id = prefix + '-' + result.id; suggestionLink.setAttribute( 'href', suggestionLinkPrefix + result.title ); if ( result.thumbnail ) { suggestionThumbnail.setAttribute( 'src', result.thumbnail ); } // Highlight title suggestionTitle.innerHTML = result.title.replace( regex, '$&' ); suggestionDescription.textContent = result.description; fragment.append( suggestion ); } ); typeahead.prepend( fragment ); }; // Attach mouseenter events to newly created suggestions const attachMouseListener = () => { const suggestions = typeahead.querySelectorAll( '.citizen-typeahead-suggestion' ); suggestions.forEach( ( suggestion ) => { bindMouseHoverEvent( suggestion ); } ); }; // Add loading animation searchInput.parentNode.classList.add( 'search-form__loading' ); /* eslint-disable-next-line compat/compat */ const controller = new AbortController(), abortFetch = () => { controller.abort(); }; const gateway = require( './gateway/gateway.js' ), getResults = gateway.getResults( searchQuery, controller ); // Abort fetch if the input is detected // So that fetch request won't be queued up searchInput.addEventListener( 'input', abortFetch, { once: true } ); getResults.then( ( results ) => { searchInput.removeEventListener( 'input', abortFetch ); clearSuggestions(); if ( results !== null ) { renderSuggestions( results ); attachMouseListener(); } activeIndex.setMax( results.length ); } ).catch( ( error ) => { searchInput.removeEventListener( 'input', abortFetch ); searchInput.parentNode.classList.remove( 'search-form__loading' ); // User can trigger the abort when the fetch event is pending // There is no need for an error if ( error.name !== 'AbortError' ) { const message = 'Uh oh, a wild error appears! ' + error; throw new Error( message ); } } ); } /** * Update the typeahead element * * @param {Object} messages * @return {void} */ function updateTypeahead( messages ) { const searchQuery = searchInput.value, footer = document.getElementById( 'searchform-suggestions-footer' ), footerText = footer.querySelector( '.citizen-typeahead-footer__text' ), fullTextUrl = config.wgScriptPath + '/index.php?title=Special:Search&fulltext=1&search='; if ( searchQuery.length > 0 ) { const footerQuery = mw.html.escape( searchQuery ); footerText.innerHTML = messages.fulltext + ' ' + footerQuery + ''; footerQuery.textContent = searchQuery; footer.setAttribute( 'href', fullTextUrl + searchQuery ); getSuggestions( searchQuery ); } else { footerText.textContent = messages.empty; footer.setAttribute( 'href', fullTextUrl ); clearSuggestions(); } } /** * @param {HTMLElement} searchForm * @param {HTMLInputElement} input * @return {void} */ function initTypeahead( searchForm, input ) { const expandedClass = 'citizen-typeahead--expanded', messages = { empty: mw.message( 'citizen-search-fulltext-empty' ).text(), fulltext: mw.message( 'citizen-search-fulltext' ).text() }, template = mw.template.get( 'skins.citizen.search', 'resources/skins.citizen.search/templates/typeahead.mustache' ), data = { 'msg-citizen-search-fulltext': messages.empty }; // Since this is also used in other scripts, // maybe make this into a library? const dismissOnClickOutside = function ( event ) { if ( event.target instanceof Node && !searchForm.contains( event.target ) ) { searchForm.setAttribute( 'aria-expanded', 'false' ); searchInput.setAttribute( 'aria-activedescendant', '' ); /* eslint-disable-next-line mediawiki/class-doc */ typeahead.classList.remove( expandedClass ); searchInput.removeEventListener( 'keydown', keyboardEvents ); window.removeEventListener( 'click', dismissOnClickOutside ); } }; const onFocus = function () { searchForm.setAttribute( 'aria-expanded', 'true' ); /* eslint-disable-next-line mediawiki/class-doc */ typeahead.classList.add( expandedClass ); searchInput.addEventListener( 'keydown', keyboardEvents ); window.addEventListener( 'click', dismissOnClickOutside ); }; // Make them accessible outside of the function typeahead = template.render( data ).get()[ 1 ]; searchInput = input; searchForm.append( typeahead ); searchForm.setAttribute( 'aria-owns', 'searchform-suggestions' ); searchInput.setAttribute( 'aria-autocomplete', 'list' ); searchInput.setAttribute( 'aria-controls', 'searchform-suggestions' ); const footer = document.getElementById( 'searchform-suggestions-footer' ); bindMouseHoverEvent( footer ); // Since searchInput is focused before the event listener is set up onFocus(); searchInput.addEventListener( 'focus', onFocus ); // Run once in case there is searchQuery before eventlistener is attached if ( searchInput.value.length > 0 ) { updateTypeahead( messages ); } searchInput.addEventListener( 'input', () => { mw.util.debounce( 100, updateTypeahead( messages ) ); } ); } module.exports = { init: initTypeahead };