/* - This Source Code Form is subject to the terms of the Mozilla Public - License, v. 2.0. If a copy of the MPL was not distributed with this file, - You can obtain one at http://mozilla.org/MPL/2.0/. */ // Import globals from the files imported by the .xul files. /* import-globals-from subdialogs.js */ /* import-globals-from main.js */ /* import-globals-from search.js */ /* import-globals-from containers.js */ /* import-globals-from privacy.js */ /* import-globals-from sync.js */ /* import-globals-from findInPage.js */ /* import-globals-from ../../../base/content/utilityOverlay.js */ /* import-globals-from ../../../../toolkit/content/preferencesBindings.js */ "use strict"; ChromeUtils.import("resource://gre/modules/Services.jsm"); ChromeUtils.import("resource://gre/modules/AppConstants.jsm"); ChromeUtils.defineModuleGetter(this, "formAutofillParent", "resource://formautofill/FormAutofillParent.jsm"); var gLastHash = ""; var gCategoryInits = new Map(); function init_category_if_required(category) { let categoryInfo = gCategoryInits.get(category); if (!categoryInfo) { throw "Unknown in-content prefs category! Can't init " + category; } if (categoryInfo.inited) { return; } categoryInfo.init(); } function register_module(categoryName, categoryObject) { gCategoryInits.set(categoryName, { inited: false, init() { categoryObject.init(); this.inited = true; } }); } document.addEventListener("DOMContentLoaded", init_all, {once: true}); function init_all() { Preferences.forceEnableInstantApply(); gSubDialog.init(); register_module("paneGeneral", gMainPane); register_module("paneSearch", gSearchPane); register_module("panePrivacy", gPrivacyPane); register_module("paneContainers", gContainersPane); register_module("paneSync", gSyncPane); register_module("paneSearchResults", gSearchResultsPane); gSearchResultsPane.init(); gMainPane.preInit(); let categories = document.getElementById("categories"); categories.addEventListener("select", event => gotoPref(event.target.value)); document.documentElement.addEventListener("keydown", function(event) { if (event.keyCode == KeyEvent.DOM_VK_TAB) { categories.setAttribute("keyboard-navigation", "true"); } }); categories.addEventListener("mousedown", function() { this.removeAttribute("keyboard-navigation"); }); window.addEventListener("hashchange", onHashChange); gotoPref(); let helpButton = document.querySelector(".help-button > .text-link"); let helpUrl = Services.urlFormatter.formatURLPref("app.support.baseURL") + "preferences"; helpButton.setAttribute("href", helpUrl); document.dispatchEvent(new CustomEvent("Initialized", { "bubbles": true, "cancelable": true })); } function telemetryBucketForCategory(category) { category = category.toLowerCase(); switch (category) { case "containers": case "general": case "privacy": case "search": case "sync": case "searchresults": return category; default: return "unknown"; } } function onHashChange() { gotoPref(); } function gotoPref(aCategory) { let categories = document.getElementById("categories"); const kDefaultCategoryInternalName = "paneGeneral"; const kDefaultCategory = "general"; let hash = document.location.hash; let category = aCategory || hash.substr(1) || kDefaultCategoryInternalName; let breakIndex = category.indexOf("-"); // Subcategories allow for selecting smaller sections of the preferences // until proper search support is enabled (bug 1353954). let subcategory = breakIndex != -1 && category.substring(breakIndex + 1); if (subcategory) { category = category.substring(0, breakIndex); } category = friendlyPrefCategoryNameToInternalName(category); if (category != "paneSearchResults") { gSearchResultsPane.query = null; gSearchResultsPane.searchInput.value = ""; gSearchResultsPane.getFindSelection(window).removeAllRanges(); gSearchResultsPane.removeAllSearchTooltips(); gSearchResultsPane.removeAllSearchMenuitemIndicators(); } else if (!gSearchResultsPane.searchInput.value) { // Something tried to send us to the search results pane without // a query string. Default to the General pane instead. category = kDefaultCategoryInternalName; document.location.hash = kDefaultCategory; gSearchResultsPane.query = null; } // Updating the hash (below) or changing the selected category // will re-enter gotoPref. if (gLastHash == category && !subcategory) return; let item; if (category != "paneSearchResults") { item = categories.querySelector(".category[value=" + category + "]"); if (!item) { category = kDefaultCategoryInternalName; item = categories.querySelector(".category[value=" + category + "]"); } } try { init_category_if_required(category); } catch (ex) { Cu.reportError("Error initializing preference category " + category + ": " + ex); throw ex; } let friendlyName = internalPrefCategoryNameToFriendlyName(category); if (gLastHash || category != kDefaultCategoryInternalName || subcategory) { document.location.hash = friendlyName; } // Need to set the gLastHash before setting categories.selectedItem since // the categories 'select' event will re-enter the gotoPref codepath. gLastHash = category; if (item) { categories.selectedItem = item; } else { categories.clearSelection(); } window.history.replaceState(category, document.title); search(category, "data-category"); let mainContent = document.querySelector(".main-content"); mainContent.scrollTop = 0; spotlight(subcategory); Services.telemetry .getHistogramById("FX_PREFERENCES_CATEGORY_OPENED_V2") .add(telemetryBucketForCategory(friendlyName)); } function search(aQuery, aAttribute) { let mainPrefPane = document.getElementById("mainPrefPane"); let elements = mainPrefPane.children; for (let element of elements) { // If the "data-hidden-from-search" is "true", the // element will not get considered during search. This // should only be used when an element is still under // development and should not be shown for any reason. if (element.getAttribute("data-hidden-from-search") != "true" || element.getAttribute("data-subpanel") == "true") { let attributeValue = element.getAttribute(aAttribute); if (attributeValue == aQuery) { element.hidden = false; } else { element.hidden = true; } } element.classList.remove("visually-hidden"); } let keysets = mainPrefPane.getElementsByTagName("keyset"); for (let element of keysets) { let attributeValue = element.getAttribute(aAttribute); if (attributeValue == aQuery) element.removeAttribute("disabled"); else element.setAttribute("disabled", true); } } async function spotlight(subcategory) { let highlightedElements = document.querySelectorAll(".spotlight"); if (highlightedElements.length) { for (let element of highlightedElements) { element.classList.remove("spotlight"); } } if (subcategory) { if (!gSearchResultsPane.categoriesInitialized) { await waitForSystemAddonInjectionsFinished([{ isGoingToInject: formAutofillParent.initialized, elementId: "formAutofillGroup", }]); } scrollAndHighlight(subcategory); } /** * Wait for system addons finished their dom injections. * @param {Array} addons - The system addon information array. * For example, the element is looked like * { isGoingToInject: true, elementId: "formAutofillGroup" }. * The `isGoingToInject` means the system addon will be visible or not, * and the `elementId` means the id of the element will be injected into the dom * if the `isGoingToInject` is true. * @returns {Promise} Will resolve once all injections are finished. */ function waitForSystemAddonInjectionsFinished(addons) { return new Promise(resolve => { let elementIdSet = new Set(); for (let addon of addons) { if (addon.isGoingToInject) { elementIdSet.add(addon.elementId); } } if (elementIdSet.size) { let observer = new MutationObserver(mutations => { for (let mutation of mutations) { for (let node of mutation.addedNodes) { elementIdSet.delete(node.id); if (elementIdSet.size === 0) { observer.disconnect(); resolve(); } } } }); let mainContent = document.querySelector(".main-content"); observer.observe(mainContent, {childList: true, subtree: true}); // Disconnect the mutation observer once there is any user input. mainContent.addEventListener("scroll", disconnectMutationObserver); window.addEventListener("mousedown", disconnectMutationObserver); window.addEventListener("keydown", disconnectMutationObserver); function disconnectMutationObserver() { mainContent.removeEventListener("scroll", disconnectMutationObserver); window.removeEventListener("mousedown", disconnectMutationObserver); window.removeEventListener("keydown", disconnectMutationObserver); observer.disconnect(); } } else { resolve(); } }); } } function scrollAndHighlight(subcategory) { let element = document.querySelector(`[data-subcategory="${subcategory}"]`); if (element) { let header = getClosestDisplayedHeader(element); scrollContentTo(header); element.classList.add("spotlight"); } } /** * If there is no visible second level header it will return first level header, * otherwise return second level header. * @returns {Element} - The closest displayed header. */ function getClosestDisplayedHeader(element) { let header = element.closest("groupbox"); let searchHeader = header.querySelector("caption.search-header"); if (searchHeader && searchHeader.hidden && header.previousSibling.classList.contains("subcategory")) { header = header.previousSibling; } return header; } function scrollContentTo(element) { const SEARCH_CONTAINER_HEIGHT = document.querySelector(".search-container").clientHeight; let mainContent = document.querySelector(".main-content"); let top = element.getBoundingClientRect().top - SEARCH_CONTAINER_HEIGHT; mainContent.scroll({ top, behavior: "smooth", }); } function friendlyPrefCategoryNameToInternalName(aName) { if (aName.startsWith("pane")) return aName; return "pane" + aName.substring(0, 1).toUpperCase() + aName.substr(1); } // This function is duplicated inside of utilityOverlay.js's openPreferences. function internalPrefCategoryNameToFriendlyName(aName) { return (aName || "").replace(/^pane./, function(toReplace) { return toReplace[4].toLowerCase(); }); } // Put up a confirm dialog with "ok to restart", "revert without restarting" // and "restart later" buttons and returns the index of the button chosen. // We can choose not to display the "restart later", or "revert" buttons, // altough the later still lets us revert by using the escape key. // // The constants are useful to interpret the return value of the function. const CONFIRM_RESTART_PROMPT_RESTART_NOW = 0; const CONFIRM_RESTART_PROMPT_CANCEL = 1; const CONFIRM_RESTART_PROMPT_RESTART_LATER = 2; async function confirmRestartPrompt(aRestartToEnable, aDefaultButtonIndex, aWantRevertAsCancelButton, aWantRestartLaterButton) { let [ msg, title, restartButtonText, noRestartButtonText, restartLaterButtonText ] = await document.l10n.formatValues([ [aRestartToEnable ? "feature-enable-requires-restart" : "feature-disable-requires-restart"], ["should-restart-title"], ["should-restart-ok"], ["revert-no-restart-button"], ["restart-later"], ]); // Set up the first (index 0) button: let buttonFlags = (Services.prompt.BUTTON_POS_0 * Services.prompt.BUTTON_TITLE_IS_STRING); // Set up the second (index 1) button: if (aWantRevertAsCancelButton) { buttonFlags += (Services.prompt.BUTTON_POS_1 * Services.prompt.BUTTON_TITLE_IS_STRING); } else { noRestartButtonText = null; buttonFlags += (Services.prompt.BUTTON_POS_1 * Services.prompt.BUTTON_TITLE_CANCEL); } // Set up the third (index 2) button: if (aWantRestartLaterButton) { buttonFlags += (Services.prompt.BUTTON_POS_2 * Services.prompt.BUTTON_TITLE_IS_STRING); } else { restartLaterButtonText = null; } switch (aDefaultButtonIndex) { case 0: buttonFlags += Services.prompt.BUTTON_POS_0_DEFAULT; break; case 1: buttonFlags += Services.prompt.BUTTON_POS_1_DEFAULT; break; case 2: buttonFlags += Services.prompt.BUTTON_POS_2_DEFAULT; break; default: break; } let buttonIndex = Services.prompt.confirmEx(window, title, msg, buttonFlags, restartButtonText, noRestartButtonText, restartLaterButtonText, null, {}); // If we have the second confirmation dialog for restart, see if the user // cancels out at that point. if (buttonIndex == CONFIRM_RESTART_PROMPT_RESTART_NOW) { let cancelQuit = Cc["@mozilla.org/supports-PRBool;1"] .createInstance(Ci.nsISupportsPRBool); Services.obs.notifyObservers(cancelQuit, "quit-application-requested", "restart"); if (cancelQuit.data) { buttonIndex = CONFIRM_RESTART_PROMPT_CANCEL; } } return buttonIndex; } // This function is used to append search keywords found // in the related subdialog to the button that will activate the subdialog. function appendSearchKeywords(aId, keywords) { let element = document.getElementById(aId); let searchKeywords = element.getAttribute("searchkeywords"); if (searchKeywords) { keywords.push(searchKeywords); } element.setAttribute("searchkeywords", keywords.join(" ")); }