/* Any copyright is dedicated to the Public Domain. http://creativecommons.org/publicdomain/zero/1.0/ */ /* import-globals-from helper_html_tooltip.js */ "use strict"; /** * Test the HTMLTooltip autofocus configuration option. */ const HTML_NS = "http://www.w3.org/1999/xhtml"; const TEST_URI = `data:text/xml;charset=UTF-8, test2 `; const {HTMLTooltip} = require("devtools/client/shared/widgets/tooltip/HTMLTooltip"); loadHelperScript("helper_html_tooltip.js"); let useXulWrapper; add_task(function* () { yield addTab("about:blank"); let [, , doc] = yield createHost("bottom", TEST_URI); info("Run tests for a Tooltip without using a XUL panel"); useXulWrapper = false; yield runTests(doc); info("Run tests for a Tooltip with a XUL panel"); useXulWrapper = true; yield runTests(doc); }); function* runTests(doc) { yield testNoAutoFocus(doc); yield testAutoFocus(doc); yield testAutoFocusPreservesFocusChange(doc); } function* testNoAutoFocus(doc) { yield focusNode(doc, "#box4-input"); ok(doc.activeElement.closest("#box4-input"), "Focus is in the #box4-input"); info("Test a tooltip without autofocus will not take focus"); let tooltip = yield createTooltip(doc, false); yield showTooltip(tooltip, doc.getElementById("box1")); ok(doc.activeElement.closest("#box4-input"), "Focus is still in the #box4-input"); yield hideTooltip(tooltip); yield blurNode(doc, "#box4-input"); tooltip.destroy(); } function* testAutoFocus(doc) { yield focusNode(doc, "#box4-input"); ok(doc.activeElement.closest("#box4-input"), "Focus is in the #box4-input"); info("Test autofocus tooltip takes focus when displayed, " + "and restores the focus when hidden"); let tooltip = yield createTooltip(doc, true); yield showTooltip(tooltip, doc.getElementById("box1")); ok(doc.activeElement.closest(".tooltip-content"), "Focus is in the tooltip"); yield hideTooltip(tooltip); ok(doc.activeElement.closest("#box4-input"), "Focus is in the #box4-input"); info("Blur the textbox before moving to the next test to reset the state."); yield blurNode(doc, "#box4-input"); tooltip.destroy(); } function* testAutoFocusPreservesFocusChange(doc) { yield focusNode(doc, "#box4-input"); ok(doc.activeElement.closest("#box4-input"), "Focus is still in the #box3-input"); info("Test autofocus tooltip takes focus when displayed, " + "but does not try to restore the active element if it is not focused when hidden"); let tooltip = yield createTooltip(doc, true); yield showTooltip(tooltip, doc.getElementById("box1")); ok(doc.activeElement.closest(".tooltip-content"), "Focus is in the tooltip"); info("Move the focus to #box3-input while the tooltip is displayed"); yield focusNode(doc, "#box3-input"); ok(doc.activeElement.closest("#box3-input"), "Focus moved to the #box3-input"); yield hideTooltip(tooltip); ok(doc.activeElement.closest("#box3-input"), "Focus is still in the #box3-input"); info("Blur the textbox before moving to the next test to reset the state."); yield blurNode(doc, "#box3-input"); tooltip.destroy(); } /** * Fpcus the node corresponding to the provided selector in the provided document. Returns * a promise that will resolve when receiving the focus event on the node. */ function focusNode(doc, selector) { let node = doc.querySelector(selector); let onFocus = once(node, "focus"); node.focus(); return onFocus; } /** * Blur the node corresponding to the provided selector in the provided document. Returns * a promise that will resolve when receiving the blur event on the node. */ function blurNode(doc, selector) { let node = doc.querySelector(selector); let onBlur = once(node, "blur"); node.blur(); return onBlur; } /** * Create an HTMLTooltip instance with the provided autofocus setting. * * @param {Document} doc * Document in which the tooltip should be created * @param {Boolean} autofocus * @return {Promise} promise that will resolve the HTMLTooltip instance created when the * tooltip content will be ready. */ function* createTooltip(doc, autofocus) { let tooltip = new HTMLTooltip(doc, {autofocus, useXulWrapper}); let div = doc.createElementNS(HTML_NS, "div"); div.classList.add("tooltip-content"); div.style.height = "50px"; div.innerHTML = ''; tooltip.setContent(div, {width: 150, height: 50}); return tooltip; }