/* * This implements link hinting. Typing "F" will enter link-hinting mode, where all clickable items on * the page have a hint marker displayed containing a sequence of letters. Typing those letters will select * a link. * * The characters we use to show link hints are a user-configurable option. By default they're the home row. * The CSS which is used on the link hints is also a configurable option. */ var hintMarkers = []; var hintMarkerContainingDiv = null; // The characters that were typed in while in "link hints" mode. var hintKeystrokeQueue = []; var linkHintsModeActivated = false; var shouldOpenLinkHintInNewTab = false; // Whether we have added to the page the CSS needed to display link hints. var linkHintsCssAdded = false; // An XPath describing what a clickable element is. We could also look for images with an onclick // attribute, but let's wait to see if that really is necessary. var clickableElementsXPath = "//a | //textarea | //button | //select | //input[not(@type='hidden')] | //*[@onclick]"; // We need this as a top-level function because our command system doesn't yet support arguments. function activateLinkHintsModeToOpenInNewTab() { activateLinkHintsMode(true); } function activateLinkHintsMode(openInNewTab) { if (!linkHintsCssAdded) addCssToPage(linkHintCss); // linkHintCss is declared by vimiumFrontend.js linkHintCssAdded = true; linkHintsModeActivated = true; shouldOpenLinkHintInNewTab = openInNewTab buildLinkHints(); document.addEventListener("keydown", onKeyDownInLinkHintsMode, true); } /* * Builds and displays link hints for every visible clickable item on the page. */ function buildLinkHints() { var visibleElements = getVisibleClickableElements(); // Initialize the number used to generate the character hints to be as many digits as we need to // highlight all the links on the page; we don't want some link hints to have more chars than others. var digitsNeeded = Math.ceil(logXOfBase(visibleElements.length, settings.linkHintCharacters.length)); var linkHintNumber = 0; for (var i = 0; i < visibleElements.length; i++) { hintMarkers.push(createMarkerFor(visibleElements[i], linkHintNumber, digitsNeeded)); linkHintNumber++; } // Note(philc): Append these markers as top level children instead of as child nodes to the link itself, // because some clickable elements cannot contain children, e.g. submit buttons. This has the caveat // that if you scroll the page and the link has position=fixed, the marker will not stay fixed. // Also note that adding these nodes to document.body all at once is significantly faster than one-by-one. hintMarkerContainingDiv = document.createElement("div"); hintMarkerContainingDiv.className = "internalVimiumHintMarker"; for (var i = 0; i < hintMarkers.length; i++) hintMarkerContainingDiv.appendChild(hintMarkers[i]); document.body.appendChild(hintMarkerContainingDiv); } function logXOfBase(x, base) { return Math.log(x) / Math.log(base); } /* * Returns all clickable elements that are not hidden and are in the current viewport. * We prune invisible elements partly for performance reasons, but moreso it's to decrease the number * of digits needed to enumerate all of the links on screen. */ function getVisibleClickableElements() { var resultSet = document.evaluate(clickableElementsXPath, document.body, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null); var visibleElements = []; // Prune all invisible clickable elements. for (var i = 0; i < resultSet.snapshotLength; i++) { var element = resultSet.snapshotItem(i); // Note that getBoundingClientRect() is relative to the viewport var boundingRect = element.getBoundingClientRect(); // Exclude links which have just a few pixels on screen, because the link hints won't show for them anyway. if (boundingRect.bottom <= 4 || boundingRect.top >= window.innerHeight - 4 || boundingRect.left <= 0 || boundingRect.right >= window.innerWidth - 4) continue; if (boundingRect.width < 3 || boundingRect.height < 3) continue; // eliminate invisible elements var computedStyle = window.getComputedStyle(element, null); if (computedStyle.getPropertyValue('visibility') != 'visible' || computedStyle.getPropertyValue('display') == 'none') continue; visibleElements.push(element); } return visibleElements; } function onKeyDownInLinkHintsMode(event) { var keyChar = getKeyChar(event); if (!keyChar) return; // TODO(philc): Ignore keys that have modifiers. if (isEscape(event)) { deactivateLinkHintsMode(); } else if (event.keyCode == keyCodes.backspace || event.keyCode == keyCodes.deleteKey) { if (hintKeystrokeQueue.length == 0) { deactivateLinkHintsMode(); } else { hintKeystrokeQueue.pop(); updateLinkHints(); } } else if (settings.linkHintCharacters.indexOf(keyChar) >= 0) { hintKeystrokeQueue.push(keyChar); updateLinkHints(); } else { return; } event.stopPropagation(); event.preventDefault(); } /* * Updates the visibility of link hints on screen based on the keystrokes typed thus far. If only one * link hint remains, click on that link and exit link hints mode. */ function updateLinkHints() { var matchString = hintKeystrokeQueue.join(""); var linksMatched = highlightLinkMatches(matchString); if (linksMatched.length == 0) deactivateLinkHintsMode(); else if (linksMatched.length == 1) { var matchedLink = linksMatched[0]; if (isSelectable(matchedLink)) { matchedLink.focus(); // When focusing a textbox, put the selection caret at the end of the textbox's contents. matchedLink.setSelectionRange(matchedLink.value.length, matchedLink.value.length); } else { // When we're opening the link in the current tab, don't navigate to the selected link immediately; // we want to give the user some feedback depicting which link they've selected by focusing it. if (!shouldOpenLinkHintInNewTab) setTimeout(function() { simulateClick(matchedLink); }, 400); else simulateClick(matchedLink); matchedLink.focus(); } deactivateLinkHintsMode(); } } /* * Selectable means the element has a text caret; this is not the same as "focusable". */ function isSelectable(element) { var selectableTypes = ["search", "text", "password"]; return (element.tagName == "INPUT" && selectableTypes.indexOf(element.type) >= 0) || element.tagName == "TEXTAREA"; } /* * Hides link hints which do not match the given search string. To allow the backspace key to work, this * will also show link hints which do match but were previously hidden. */ function highlightLinkMatches(searchString) { var linksMatched = []; for (var i = 0; i < hintMarkers.length; i++) { var linkMarker = hintMarkers[i]; if (linkMarker.getAttribute("hintString").indexOf(searchString) == 0) { if (linkMarker.style.display == "none") linkMarker.style.display = ""; for (var j = 0; j < linkMarker.childNodes.length; j++) linkMarker.childNodes[j].className = (j >= searchString.length) ? "" : "matchingCharacter"; linksMatched.push(linkMarker.clickableItem); } else { linkMarker.style.display = "none"; } } return linksMatched; } /* * Converts a number like "8" into a hint string like "JK". This is used to sequentially generate all of * the hint text. The hint string will be "padded with zeroes" to ensure its length is equal to numHintDigits. */ function numberToHintString(number, numHintDigits) { var base = settings.linkHintCharacters.length; var hintString = []; var remainder = 0; do { remainder = number % base; hintString.unshift(settings.linkHintCharacters[remainder]); number -= remainder; number /= Math.floor(base); } while (number > 0); // Pad the hint string we're returning so that it matches numHintDigits. var hintStringLength = hintString.length; for (var i = 0; i < numHintDigits - hintStringLength; i++) hintString.unshift(settings.linkHintCharacters[0]); return hintString.join(""); } function simulateClick(link) { var event = document.createEvent("MouseEvents"); // When "clicking" on a link, dispatch the event with the appropriate meta key (CMD on Mac, CTRL on windows) // to open it in a new tab if necessary. var metaKey = (platform == "Mac" && shouldOpenLinkHintInNewTab); var ctrlKey = (platform != "Mac" && shouldOpenLinkHintInNewTab); event.initMouseEvent("click", true, true, window, 1, 0, 0, 0, 0, ctrlKey, false, false, metaKey, 0, null); // Debugging note: Firefox will not execute the link's default action if we dispatch this click event, // but Webkit will. Dispatching a click on an input box does not seem to focus it; we do that separately link.dispatchEvent(event); } function deactivateLinkHintsMode() { if (hintMarkerContainingDiv) hintMarkerContainingDiv.parentNode.removeChild(hintMarkerContainingDiv); hintMarkerContainingDiv = null; hintMarkers = []; hintKeystrokeQueue = []; document.removeEventListener("keydown", onKeyDownInLinkHintsMode, true); linkHintsModeActivated = false; } /* * Creates a link marker for the given link. */ function createMarkerFor(link, linkHintNumber, linkHintDigits) { var hintString = numberToHintString(linkHintNumber, linkHintDigits); var marker = document.createElement("div"); marker.className = "internalVimiumHintMarker vimiumHintMarker"; var innerHTML = []; // Make each hint character a span, so that we can highlight the typed characters as you type them. for (var i = 0; i < hintString.length; i++) innerHTML.push("" + hintString[i].toUpperCase() + ""); marker.innerHTML = innerHTML.join(""); marker.setAttribute("hintString", hintString); // Note: this call will be expensive if we modify the DOM in between calls. var clientRect = link.getClientRects()[0]; // The coordinates given by the window do not have the zoom factor included since the zoom is set only on // the document node. var zoomFactor = currentZoomLevel / 100.0; marker.style.left = clientRect.left + window.scrollX / zoomFactor + "px"; marker.style.top = clientRect.top + window.scrollY / zoomFactor + "px"; marker.clickableItem = link; return marker; }