/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* ***** BEGIN LICENSE BLOCK ***** * Version: MPL 1.1/GPL 2.0/LGPL 2.1 * * The contents of this file are subject to the Mozilla Public License Version * 1.1 (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * http://www.mozilla.org/MPL/ * * Software distributed under the License is distributed on an "AS IS" basis, * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License * for the specific language governing rights and limitations under the * License. * * The Original Code is Mozilla Places Organizer. * * The Initial Developer of the Original Code is Google Inc. * Portions created by the Initial Developer are Copyright (C) 2005-2006 * the Initial Developer. All Rights Reserved. * * Contributor(s): * Ben Goodger * Annie Sullivan * Asaf Romano * Ehsan Akhgari * Drew Willcoxon * * Alternatively, the contents of this file may be used under the terms of * either the GNU General Public License Version 2 or later (the "GPL"), or * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"), * in which case the provisions of the GPL or the LGPL are applicable instead * of those above. If you wish to allow use of your version of this file only * under the terms of either the GPL or the LGPL, and not to allow others to * use your version of this file under the terms of the MPL, indicate your * decision by deleting the provisions above and replace them with the notice * and other provisions required by the GPL or the LGPL. If you do not delete * the provisions above, a recipient may use your version of this file under * the terms of any one of the MPL, the GPL or the LGPL. * * ***** END LICENSE BLOCK ***** */ var PlacesOrganizer = { _places: null, _content: null, // IDs of fields from editBookmarkOverlay that should be hidden when infoBox // is minimal. IDs should be kept in sync with the IDs of the elements // observing additionalInfoBroadcaster. _additionalInfoFields: [ "editBMPanel_descriptionRow", "editBMPanel_loadInSidebarCheckbox", "editBMPanel_keywordRow", ], _initFolderTree: function() { var leftPaneRoot = PlacesUIUtils.leftPaneFolderId; this._places.place = "place:excludeItems=1&expandQueries=0&folder=" + leftPaneRoot; }, selectLeftPaneQuery: function PO_selectLeftPaneQuery(aQueryName) { var itemId = PlacesUIUtils.leftPaneQueries[aQueryName]; this._places.selectItems([itemId]); // Forcefully expand all-bookmarks if (aQueryName == "AllBookmarks") asContainer(this._places.selectedNode).containerOpen = true; }, init: function PO_init() { this._places = document.getElementById("placesList"); this._content = document.getElementById("placeContent"); this._initFolderTree(); var leftPaneSelection = "AllBookmarks"; // default to all-bookmarks if ("arguments" in window && window.arguments.length > 0) leftPaneSelection = window.arguments[0]; this.selectLeftPaneQuery(leftPaneSelection); // clear the back-stack this._backHistory.splice(0); document.getElementById("OrganizerCommand:Back").setAttribute("disabled", true); var view = this._content.treeBoxObject.view; if (view.rowCount > 0) view.selection.select(0); this._content.focus(); // Set up the search UI. PlacesSearchBox.init(); window.addEventListener("AppCommand", this, true); #ifdef XP_MACOSX // 1. Map Edit->Find command to OrganizerCommand_find:all. Need to map // both the menuitem and the Find key. var findMenuItem = document.getElementById("menu_find"); findMenuItem.setAttribute("command", "OrganizerCommand_find:all"); var findKey = document.getElementById("key_find"); findKey.setAttribute("command", "OrganizerCommand_find:all"); // 2. Disable some keybindings from browser.xul var elements = ["cmd_handleBackspace", "cmd_handleShiftBackspace"]; for (var i=0; i < elements.length; i++) { document.getElementById(elements[i]).setAttribute("disabled", "true"); } // 3. Disable the keyboard shortcut for the History menu back/forward // in order to support those in the Library var historyMenuBack = document.getElementById("historyMenuBack"); historyMenuBack.removeAttribute("key"); var historyMenuForward = document.getElementById("historyMenuForward"); historyMenuForward.removeAttribute("key"); #endif // remove the "Properties" context-menu item, we've our own details pane document.getElementById("placesContext") .removeChild(document.getElementById("placesContext_show:info")); }, QueryInterface: function PO_QueryInterface(aIID) { if (aIID.equals(Components.interfaces.nsIDOMEventListener) || aIID.equals(Components.interfaces.nsISupports)) return this; throw Components.results.NS_NOINTERFACE; }, handleEvent: function PO_handleEvent(aEvent) { if (aEvent.type != "AppCommand") return; aEvent.stopPropagation(); switch (aEvent.command) { case "Back": if (this._backHistory.length > 0) this.back(); break; case "Forward": if (this._forwardHistory.length > 0) this.forward(); break; case "Search": PlacesSearchBox.findAll(); break; } }, destroy: function PO_destroy() { }, _location: null, get location() { return this._location; }, set location(aLocation) { if (!aLocation || this._location == aLocation) return aLocation; if (this.location) { this._backHistory.unshift(this.location); this._forwardHistory.splice(0); } this._location = aLocation; this._places.selectPlaceURI(aLocation); if (!this._places.hasSelection) { // If no node was found for the given place: uri, just load it directly this._content.place = aLocation; } this.onContentTreeSelect(); // update navigation commands if (this._backHistory.length == 0) document.getElementById("OrganizerCommand:Back").setAttribute("disabled", true); else document.getElementById("OrganizerCommand:Back").removeAttribute("disabled"); if (this._forwardHistory.length == 0) document.getElementById("OrganizerCommand:Forward").setAttribute("disabled", true); else document.getElementById("OrganizerCommand:Forward").removeAttribute("disabled"); return aLocation; }, _backHistory: [], _forwardHistory: [], back: function PO_back() { this._forwardHistory.unshift(this.location); var historyEntry = this._backHistory.shift(); this._location = null; this.location = historyEntry; }, forward: function PO_forward() { this._backHistory.unshift(this.location); var historyEntry = this._forwardHistory.shift(); this._location = null; this.location = historyEntry; }, /** * Called when a place folder is selected in the left pane. * @param resetSearchBox * true if the search box should also be reset, false otherwise. * The search box should be reset when a new folder in the left * pane is selected; the search scope and text need to be cleared in * preparation for the new folder. Note that if the user manually * resets the search box, either by clicking its reset button or by * deleting its text, this will be false. */ _cachedLeftPaneSelectedURI: null, onPlaceSelected: function PO_onPlaceSelected(resetSearchBox) { // Don't change the right-hand pane contents when there's no selection. if (!this._places.hasSelection) return; var node = this._places.selectedNode; var queries = asQuery(node).getQueries(); // Items are only excluded on the left pane. var options = node.queryOptions.clone(); options.excludeItems = false; var placeURI = PlacesUtils.history.queriesToQueryString(queries, queries.length, options); // If either the place of the content tree in the right pane has changed or // the user cleared the search box, update the place, hide the search UI, // and update the back/forward buttons by setting location. if (this._content.place != placeURI || !resetSearchBox) { this._content.place = placeURI; PlacesSearchBox.hideSearchUI(); this.location = node.uri; } // Update the selected folder title where it appears in the UI: the folder // scope button, "Find in " command, and the search box // emptytext. They must be updated even if the selection hasn't changed -- // specifically when node's title changes. In that case a selection event // is generated, this method is called, but the selection does not change. var folderButton = document.getElementById("scopeBarFolder"); var folderTitle = node.title || folderButton.getAttribute("emptytitle"); folderButton.setAttribute("label", folderTitle); var cmd = document.getElementById("OrganizerCommand_find:current"); var label = PlacesUIUtils.getFormattedString("findInPrefix", [folderTitle]); cmd.setAttribute("label", label); if (PlacesSearchBox.filterCollection == "collection") PlacesSearchBox.updateCollectionTitle(folderTitle); // When we invalidate a container we use suppressSelectionEvent, when it is // unset a select event is fired, in many cases the selection did not really // change, so we should check for it, and return early in such a case. Note // that we cannot return any earlier than this point, because when // !resetSearchBox, we need to update location and hide the UI as above, // even though the selection has not changed. if (node.uri == this._cachedLeftPaneSelectedURI) return; this._cachedLeftPaneSelectedURI = node.uri; // At this point, resetSearchBox is true, because the left pane selection // has changed; otherwise we would have returned earlier. PlacesSearchBox.searchFilter.reset(); this._setSearchScopeForNode(node); if (this._places.treeBoxObject.focused) this._fillDetailsPane([node]); }, /** * Sets the search scope based on aNode's properties. * @param aNode * the node to set up scope from */ _setSearchScopeForNode: function PO__setScopeForNode(aNode) { var itemId = aNode.itemId; if (PlacesUtils.nodeIsHistoryContainer(aNode) || itemId == PlacesUIUtils.leftPaneQueries["History"]) { PlacesQueryBuilder.setScope("history"); } // Default to All Bookmarks for all other nodes, per bug 469437. else PlacesQueryBuilder.setScope("bookmarks"); // Enable or disable the folder scope button. var folderButton = document.getElementById("scopeBarFolder"); folderButton.hidden = !PlacesUtils.nodeIsFolder(aNode) || itemId == PlacesUIUtils.allBookmarksFolderId; }, /** * Handle clicks on the tree. * Single Left click, right click or modified click do not result in any * special action, since they're related to selection. * @param aEvent * The mouse event. */ onTreeClick: function PO_onTreeClick(aEvent) { // Only handle clicks on tree children. if (aEvent.target.localName != "treechildren") return; var currentView = aEvent.currentTarget; var selectedNode = currentView.selectedNode; if (selectedNode) { var doubleClickOnFlatList = (aEvent.button == 0 && aEvent.detail == 2 && aEvent.target.parentNode.flatList); var middleClick = (aEvent.button == 1 && aEvent.detail == 1); if (PlacesUtils.nodeIsURI(selectedNode) && (doubleClickOnFlatList || middleClick)) { // Open associated uri in the browser. PlacesOrganizer.openSelectedNode(aEvent); } else if (middleClick && PlacesUtils.nodeIsContainer(selectedNode)) { // The command execution function will take care of seeing if the // selection is a folder or a different container type, and will // load its contents in tabs. PlacesUIUtils.openContainerNodeInTabs(selectedNode, aEvent); } } }, /** * Handle focus changes on the trees. * When moving focus between panes we should update the details pane contents. * @param aEvent * The mouse event. */ onTreeFocus: function PO_onTreeFocus(aEvent) { var currentView = aEvent.currentTarget; var selectedNodes = currentView.selectedNode ? [currentView.selectedNode] : this._content.getSelectionNodes(); this._fillDetailsPane(selectedNodes); }, openFlatContainer: function PO_openFlatContainerFlatContainer(aContainer) { if (aContainer.itemId != -1) this._places.selectItems([aContainer.itemId]); else if (PlacesUtils.nodeIsQuery(aContainer)) this._places.selectPlaceURI(aContainer.uri); }, openSelectedNode: function PO_openSelectedNode(aEvent) { PlacesUIUtils.openNodeWithEvent(this._content.selectedNode, aEvent); }, /** * Returns the options associated with the query currently loaded in the * main places pane. */ getCurrentOptions: function PO_getCurrentOptions() { return asQuery(this._content.getResult().root).queryOptions; }, /** * Returns the queries associated with the query currently loaded in the * main places pane. */ getCurrentQueries: function PO_getCurrentQueries() { return asQuery(this._content.getResult().root).getQueries(); }, /** * Show the migration wizard for importing from a file. */ importBookmarks: function PO_import() { // XXX: ifdef it to be non-modal (non-"sheet") on mac (see bug 259039) var features = "modal,centerscreen,chrome,resizable=no"; // The migrator window will set this to true when it closes, if the user // chose to migrate from a specific file. window.fromFile = false; openDialog("chrome://browser/content/migration/migration.xul", "migration", features, "bookmarks"); if (window.fromFile) this.importFromFile(); }, /** * Open a file-picker and import the selected file into the bookmarks store */ importFromFile: function PO_importFromFile() { var fp = Cc["@mozilla.org/filepicker;1"]. createInstance(Ci.nsIFilePicker); fp.init(window, PlacesUIUtils.getString("SelectImport"), Ci.nsIFilePicker.modeOpen); fp.appendFilters(Ci.nsIFilePicker.filterHTML); if (fp.show() != Ci.nsIFilePicker.returnCancel) { if (fp.file) { var importer = Cc["@mozilla.org/browser/places/import-export-service;1"]. getService(Ci.nsIPlacesImportExportService); var file = fp.file.QueryInterface(Ci.nsILocalFile); importer.importHTMLFromFile(file, false); } } }, /** * Allows simple exporting of bookmarks. */ exportBookmarks: function PO_exportBookmarks() { var fp = Cc["@mozilla.org/filepicker;1"]. createInstance(Ci.nsIFilePicker); fp.init(window, PlacesUIUtils.getString("EnterExport"), Ci.nsIFilePicker.modeSave); fp.appendFilters(Ci.nsIFilePicker.filterHTML); fp.defaultString = "bookmarks.html"; if (fp.show() != Ci.nsIFilePicker.returnCancel) { var exporter = Cc["@mozilla.org/browser/places/import-export-service;1"]. getService(Ci.nsIPlacesImportExportService); exporter.exportHTMLToFile(fp.file); } }, /** * Populates the restore menu with the dates of the backups available. */ populateRestoreMenu: function PO_populateRestoreMenu() { let restorePopup = document.getElementById("fileRestorePopup"); let dateSvc = Cc["@mozilla.org/intl/scriptabledateformat;1"]. getService(Ci.nsIScriptableDateFormat); // Remove existing menu items. Last item is the restoreFromFile item. while (restorePopup.childNodes.length > 1) restorePopup.removeChild(restorePopup.firstChild); let backupFiles = PlacesUtils.backups.entries; if (backupFiles.length == 0) return; // Populate menu with backups. for (let i = 0; i < backupFiles.length; i++) { let backupDate = PlacesUtils.backups.getDateForFile(backupFiles[i]); let m = restorePopup.insertBefore(document.createElement("menuitem"), document.getElementById("restoreFromFile")); m.setAttribute("label", dateSvc.FormatDate("", Ci.nsIScriptableDateFormat.dateFormatLong, backupDate.getFullYear(), backupDate.getMonth() + 1, backupDate.getDate())); m.setAttribute("value", backupFiles[i].leafName); m.setAttribute("oncommand", "PlacesOrganizer.onRestoreMenuItemClick(this);"); } // Add the restoreFromFile item. restorePopup.insertBefore(document.createElement("menuseparator"), document.getElementById("restoreFromFile")); }, /** * Called when a menuitem is selected from the restore menu. */ onRestoreMenuItemClick: function PO_onRestoreMenuItemClick(aMenuItem) { let backupName = aMenuItem.getAttribute("value"); let backupFiles = PlacesUtils.backups.entries; for (let i = 0; i < backupFiles.length; i++) { if (backupFiles[i].leafName == backupName) { this.restoreBookmarksFromFile(backupFiles[i]); break; } } }, /** * Called when 'Choose File...' is selected from the restore menu. * Prompts for a file and restores bookmarks to those in the file. */ onRestoreBookmarksFromFile: function PO_onRestoreBookmarksFromFile() { var fp = Cc["@mozilla.org/filepicker;1"].createInstance(Ci.nsIFilePicker); fp.init(window, PlacesUIUtils.getString("bookmarksRestoreTitle"), Ci.nsIFilePicker.modeOpen); fp.appendFilter(PlacesUIUtils.getString("bookmarksRestoreFilterName"), PlacesUIUtils.getString("bookmarksRestoreFilterExtension")); fp.appendFilters(Ci.nsIFilePicker.filterAll); var dirSvc = Cc["@mozilla.org/file/directory_service;1"]. getService(Ci.nsIProperties); var backupsDir = dirSvc.get("Desk", Ci.nsILocalFile); fp.displayDirectory = backupsDir; if (fp.show() != Ci.nsIFilePicker.returnCancel) this.restoreBookmarksFromFile(fp.file); }, /** * Restores bookmarks from a JSON file. */ restoreBookmarksFromFile: function PO_restoreBookmarksFromFile(aFile) { // check file extension if (!aFile.leafName.match(/\.json$/)) { this._showErrorAlert(PlacesUIUtils.getString("bookmarksRestoreFormatError")); return; } // confirm ok to delete existing bookmarks var prompts = Cc["@mozilla.org/embedcomp/prompt-service;1"]. getService(Ci.nsIPromptService); if (!prompts.confirm(null, PlacesUIUtils.getString("bookmarksRestoreAlertTitle"), PlacesUIUtils.getString("bookmarksRestoreAlert"))) return; try { PlacesUtils.restoreBookmarksFromJSONFile(aFile); } catch(ex) { this._showErrorAlert(PlacesUIUtils.getString("bookmarksRestoreParseError")); } }, _showErrorAlert: function PO__showErrorAlert(aMsg) { var brandShortName = document.getElementById("brandStrings"). getString("brandShortName"); Cc["@mozilla.org/embedcomp/prompt-service;1"]. getService(Ci.nsIPromptService). alert(window, brandShortName, aMsg); }, /** * Backup bookmarks to desktop, auto-generate a filename with a date. * The file is a JSON serialization of bookmarks, tags and any annotations * of those items. */ backupBookmarks: function PO_backupBookmarks() { var fp = Cc["@mozilla.org/filepicker;1"].createInstance(Ci.nsIFilePicker); fp.init(window, PlacesUIUtils.getString("bookmarksBackupTitle"), Ci.nsIFilePicker.modeSave); fp.appendFilter(PlacesUIUtils.getString("bookmarksRestoreFilterName"), PlacesUIUtils.getString("bookmarksRestoreFilterExtension")); var dirSvc = Cc["@mozilla.org/file/directory_service;1"]. getService(Ci.nsIProperties); var backupsDir = dirSvc.get("Desk", Ci.nsILocalFile); fp.displayDirectory = backupsDir; fp.defaultString = PlacesUtils.backups.getFilenameForDate(); if (fp.show() != Ci.nsIFilePicker.returnCancel) PlacesUtils.backups.saveBookmarksToJSONFile(fp.file); }, _paneDisabled: false, _setDetailsFieldsDisabledState: function PO__setDetailsFieldsDisabledState(aDisabled) { if (aDisabled) { document.getElementById("paneElementsBroadcaster") .setAttribute("disabled", "true"); } else { document.getElementById("paneElementsBroadcaster") .removeAttribute("disabled"); } }, _detectAndSetDetailsPaneMinimalState: function PO__detectAndSetDetailsPaneMinimalState(aNode) { /** * The details of simple folder-items (as opposed to livemarks) or the * of livemark-children are not likely to fill the infoBox anyway, * thus we remove the "More/Less" button and show all details. * * the wasminimal attribute here is used to persist the "more/less" * state in a bookmark->folder->bookmark scenario. */ var infoBox = document.getElementById("infoBox"); var infoBoxExpander = document.getElementById("infoBoxExpander"); var infoBoxExpanderWrapper = document.getElementById("infoBoxExpanderWrapper"); var additionalInfoBroadcaster = document.getElementById("additionalInfoBroadcaster"); if (!aNode) { infoBoxExpanderWrapper.hidden = true; return; } if (aNode.itemId != -1 && ((PlacesUtils.nodeIsFolder(aNode) && !PlacesUtils.nodeIsLivemarkContainer(aNode)) || PlacesUtils.nodeIsLivemarkItem(aNode))) { if (infoBox.getAttribute("minimal") == "true") infoBox.setAttribute("wasminimal", "true"); infoBox.removeAttribute("minimal"); infoBoxExpanderWrapper.hidden = true; } else { if (infoBox.getAttribute("wasminimal") == "true") infoBox.setAttribute("minimal", "true"); infoBox.removeAttribute("wasminimal"); infoBoxExpanderWrapper.hidden = this._additionalInfoFields.every(function (id) document.getElementById(id).collapsed); } additionalInfoBroadcaster.hidden = infoBox.getAttribute("minimal") == "true"; }, // NOT YET USED updateThumbnailProportions: function PO_updateThumbnailProportions() { var previewBox = document.getElementById("previewBox"); var canvas = document.getElementById("itemThumbnail"); var height = previewBox.boxObject.height; var width = height * (screen.width / screen.height); canvas.width = width; canvas.height = height; }, onContentTreeSelect: function PO_onContentTreeSelect() { if (this._content.treeBoxObject.focused) this._fillDetailsPane(this._content.getSelectionNodes()); }, _fillDetailsPane: function PO__fillDetailsPane(aNodeList) { var infoBox = document.getElementById("infoBox"); var detailsDeck = document.getElementById("detailsDeck"); // Make sure the infoBox UI is visible if we need to use it, we hide it // below when we don't. infoBox.hidden = false; var aSelectedNode = aNodeList.length == 1 ? aNodeList[0] : null; // If a textbox within a panel is focused, force-blur it so its contents // are saved if (gEditItemOverlay.itemId != -1) { var focusedElement = document.commandDispatcher.focusedElement; if ((focusedElement instanceof HTMLInputElement || focusedElement instanceof HTMLTextAreaElement) && /^editBMPanel.*/.test(focusedElement.parentNode.parentNode.id)) focusedElement.blur(); // don't update the panel if we are already editing this node unless we're // in multi-edit mode if (aSelectedNode) { var concreteId = PlacesUtils.getConcreteItemId(aSelectedNode); var nodeIsSame = gEditItemOverlay.itemId == aSelectedNode.itemId || gEditItemOverlay.itemId == concreteId || (aSelectedNode.itemId == -1 && gEditItemOverlay.uri && gEditItemOverlay.uri == aSelectedNode.uri); if (nodeIsSame && detailsDeck.selectedIndex == 1 && !gEditItemOverlay.multiEdit) return; } } // Clean up the panel before initing it again. gEditItemOverlay.uninitPanel(false); if (aSelectedNode && !PlacesUtils.nodeIsSeparator(aSelectedNode)) { detailsDeck.selectedIndex = 1; // Using the concrete itemId is arguably wrong. The bookmarks API // does allow setting properties for folder shortcuts as well, but since // the UI does not distinct between the couple, we better just show // the concrete item properties for shortcuts to root nodes. var concreteId = PlacesUtils.getConcreteItemId(aSelectedNode); var isRootItem = concreteId != -1 && PlacesUtils.isRootItem(concreteId); var readOnly = isRootItem || aSelectedNode.parent.itemId == PlacesUIUtils.leftPaneFolderId; var useConcreteId = isRootItem || PlacesUtils.nodeIsTagQuery(aSelectedNode); var itemId = -1; if (concreteId != -1 && useConcreteId) itemId = concreteId; else if (aSelectedNode.itemId != -1) itemId = aSelectedNode.itemId; else itemId = PlacesUtils._uri(aSelectedNode.uri); gEditItemOverlay.initPanel(itemId, { hiddenRows: ["folderPicker"], forceReadOnly: readOnly }); // Dynamically generated queries, like history date containers, have // itemId !=0 and do not exist in history. For them the panel is // read-only, but empty, since it can't get a valid title for the object. // In such a case we force the title using the selectedNode one, for UI // polishness. if (aSelectedNode.itemId == -1 && (PlacesUtils.nodeIsDay(aSelectedNode) || PlacesUtils.nodeIsHost(aSelectedNode))) gEditItemOverlay._element("namePicker").value = aSelectedNode.title; this._detectAndSetDetailsPaneMinimalState(aSelectedNode); } else if (!aSelectedNode && aNodeList[0]) { var itemIds = []; for (var i = 0; i < aNodeList.length; i++) { if (!PlacesUtils.nodeIsBookmark(aNodeList[i]) && !PlacesUtils.nodeIsURI(aNodeList[i])) { detailsDeck.selectedIndex = 0; var selectItemDesc = document.getElementById("selectItemDescription"); var itemsCountLabel = document.getElementById("itemsCountText"); selectItemDesc.hidden = false; itemsCountLabel.value = PlacesUIUtils.getFormattedString("detailsPane.multipleItems", [aNodeList.length]); infoBox.hidden = true; return; } itemIds[i] = aNodeList[i].itemId != -1 ? aNodeList[i].itemId : PlacesUtils._uri(aNodeList[i].uri); } detailsDeck.selectedIndex = 1; gEditItemOverlay.initPanel(itemIds, { hiddenRows: ["folderPicker", "loadInSidebar", "location", "keyword", "description", "name"]}); this._detectAndSetDetailsPaneMinimalState(aSelectedNode); } else { detailsDeck.selectedIndex = 0; infoBox.hidden = true; var selectItemDesc = document.getElementById("selectItemDescription"); var itemsCountLabel = document.getElementById("itemsCountText"); var rowCount = this._content.treeBoxObject.view.rowCount; if (rowCount == 0) { selectItemDesc.hidden = true; itemsCountLabel.value = PlacesUIUtils.getString("detailsPane.noItems"); } else { selectItemDesc.hidden = false; if (rowCount == 1) itemsCountLabel.value = PlacesUIUtils.getString("detailsPane.oneItem"); else { itemsCountLabel.value = PlacesUIUtils.getFormattedString("detailsPane.multipleItems", [rowCount]); } } } }, // NOT YET USED _updateThumbnail: function PO__updateThumbnail() { var bo = document.getElementById("previewBox").boxObject; var width = bo.width; var height = bo.height; var canvas = document.getElementById("itemThumbnail"); var ctx = canvas.getContext('2d'); var notAvailableText = canvas.getAttribute("notavailabletext"); ctx.save(); ctx.fillStyle = "-moz-Dialog"; ctx.fillRect(0, 0, width, height); ctx.translate(width/2, height/2); ctx.fillStyle = "GrayText"; ctx.mozTextStyle = "12pt sans serif"; var len = ctx.mozMeasureText(notAvailableText); ctx.translate(-len/2,0); ctx.mozDrawText(notAvailableText); ctx.restore(); }, toggleAdditionalInfoFields: function PO_toggleAdditionalInfoFields() { var infoBox = document.getElementById("infoBox"); var infoBoxExpander = document.getElementById("infoBoxExpander"); var infoBoxExpanderLabel = document.getElementById("infoBoxExpanderLabel"); var additionalInfoBroadcaster = document.getElementById("additionalInfoBroadcaster"); if (infoBox.getAttribute("minimal") == "true") { infoBox.removeAttribute("minimal"); infoBoxExpanderLabel.value = infoBoxExpanderLabel.getAttribute("lesslabel"); infoBoxExpanderLabel.accessKey = infoBoxExpanderLabel.getAttribute("lessaccesskey"); infoBoxExpander.className = "expander-up"; additionalInfoBroadcaster.removeAttribute("hidden"); } else { infoBox.setAttribute("minimal", "true"); infoBoxExpanderLabel.value = infoBoxExpanderLabel.getAttribute("morelabel"); infoBoxExpanderLabel.accessKey = infoBoxExpanderLabel.getAttribute("moreaccesskey"); infoBoxExpander.className = "expander-down"; additionalInfoBroadcaster.setAttribute("hidden", "true"); } }, /** * Save the current search (or advanced query) to the bookmarks root. */ saveSearch: function PO_saveSearch() { // Get the place: uri for the query. // If the advanced query builder is showing, use that. var options = this.getCurrentOptions(); var queries = this.getCurrentQueries(); var placeSpec = PlacesUtils.history.queriesToQueryString(queries, queries.length, options); var placeURI = Cc["@mozilla.org/network/io-service;1"]. getService(Ci.nsIIOService). newURI(placeSpec, null, null); // Prompt the user for a name for the query. // XXX - using prompt service for now; will need to make // a real dialog and localize when we're sure this is the UI we want. var title = PlacesUIUtils.getString("saveSearch.title"); var inputLabel = PlacesUIUtils.getString("saveSearch.inputLabel"); var defaultText = PlacesUIUtils.getString("saveSearch.inputDefaultText"); var prompts = Cc["@mozilla.org/embedcomp/prompt-service;1"]. getService(Ci.nsIPromptService); var check = {value: false}; var input = {value: defaultText}; var save = prompts.prompt(null, title, inputLabel, input, null, check); // Don't add the query if the user cancels or clears the seach name. if (!save || input.value == "") return; // Add the place: uri as a bookmark under the bookmarks root. var txn = PlacesUIUtils.ptm.createItem(placeURI, PlacesUtils.bookmarksMenuFolderId, PlacesUtils.bookmarks.DEFAULT_INDEX, input.value); PlacesUIUtils.ptm.doTransaction(txn); // select and load the new query this._places.selectPlaceURI(placeSpec); } }; /** * A set of utilities relating to search within Bookmarks and History. */ var PlacesSearchBox = { /** * The Search text field */ get searchFilter() { return document.getElementById("searchFilter"); }, /** * Folders to include when searching. */ _folders: [], get folders() { if (this._folders.length == 0) this._folders.push(PlacesUtils.bookmarksMenuFolderId, PlacesUtils.unfiledBookmarksFolderId, PlacesUtils.toolbarFolderId); return this._folders; }, set folders(aFolders) { this._folders = aFolders; return aFolders; }, /** * Run a search for the specified text, over the collection specified by * the dropdown arrow. The default is all bookmarks, but can be * localized to the active collection. * @param filterString * The text to search for. */ search: function PSB_search(filterString) { var PO = PlacesOrganizer; // If the user empties the search box manually, reset it and load all // contents of the current scope. // XXX this might be to jumpy, maybe should search for "", so results // are ungrouped, and search box not reset if (filterString == "") { PO.onPlaceSelected(false); return; } var currentOptions = PO.getCurrentOptions(); var content = PO._content; // Search according to the current scope and folders, which were set by // PQB_setScope() switch (PlacesSearchBox.filterCollection) { case "collection": content.applyFilter(filterString, this.folders); // XXX changing the button text is badness //var scopeBtn = document.getElementById("scopeBarFolder"); //scopeBtn.label = PlacesOrganizer._places.selectedNode.title; break; case "bookmarks": content.applyFilter(filterString, this.folders); break; case "history": if (currentOptions.queryType != Ci.nsINavHistoryQueryOptions.QUERY_TYPE_HISTORY) { var query = PlacesUtils.history.getNewQuery(); query.searchTerms = filterString; var options = currentOptions.clone(); // Make sure we're getting uri results. options.resultType = currentOptions.RESULT_TYPE_URI; options.queryType = Ci.nsINavHistoryQueryOptions.QUERY_TYPE_HISTORY; content.load([query], options); } else content.applyFilter(filterString); break; default: throw "Invalid filterCollection on search"; break; } PlacesSearchBox.showSearchUI(); // Update the details panel PlacesOrganizer.onContentTreeSelect(); }, /** * Finds across all bookmarks */ findAll: function PSB_findAll() { PlacesQueryBuilder.setScope("bookmarks"); this.focus(); }, /** * Finds in the currently selected Place. */ findCurrent: function PSB_findCurrent() { PlacesQueryBuilder.setScope("collection"); this.focus(); }, /** * Updates the display with the title of the current collection. * @param title * The title of the current collection. */ updateCollectionTitle: function PSB_updateCollectionTitle(title) { if (title) this.searchFilter.emptyText = PlacesUIUtils.getFormattedString("searchCurrentDefault", [title]); else this.searchFilter.emptyText = this.filterCollection == "history" ? PlacesUIUtils.getString("searchHistory") : PlacesUIUtils.getString("searchBookmarks"); }, /** * Gets/sets the active collection from the dropdown menu. */ get filterCollection() { return this.searchFilter.getAttribute("collection"); }, set filterCollection(collectionName) { if (collectionName == this.filterCollection) return collectionName; this.searchFilter.setAttribute("collection", collectionName); var newGrayText = null; if (collectionName == "collection") { newGrayText = PlacesOrganizer._places.selectedNode.title || document.getElementById("scopeBarFolder"). getAttribute("emptytitle"); } this.updateCollectionTitle(newGrayText); return collectionName; }, /** * Focus the search box */ focus: function PSB_focus() { this.searchFilter.focus(); }, /** * Set up the gray text in the search bar as the Places View loads. */ init: function PSB_init() { this.updateCollectionTitle(); }, /** * Gets or sets the text shown in the Places Search Box */ get value() { return this.searchFilter.value; }, set value(value) { return this.searchFilter.value = value; }, showSearchUI: function PSB_showSearchUI() { // Hide the advanced search controls when the user hasn't searched var searchModifiers = document.getElementById("searchModifiers"); searchModifiers.hidden = false; }, hideSearchUI: function PSB_hideSearchUI() { var searchModifiers = document.getElementById("searchModifiers"); searchModifiers.hidden = true; } }; /** * Functions and data for advanced query builder */ var PlacesQueryBuilder = { queries: [], queryOptions: null, /** * Called when a scope button in the scope bar is clicked. * @param aButton * the scope button that was selected */ onScopeSelected: function PQB_onScopeSelected(aButton) { switch (aButton.id) { case "scopeBarHistory": this.setScope("history"); break; case "scopeBarFolder": this.setScope("collection"); break; case "scopeBarAll": this.setScope("bookmarks"); break; default: throw "Invalid search scope button ID"; break; } }, /** * Sets the search scope. This can be called when no search is active, and * in that case, when the user does begin a search aScope will be used (see * PSB_search()). If there is an active search, it's performed again to * update the content tree. * @param aScope * the search scope, "bookmarks", "collection", or "history" */ setScope: function PQB_setScope(aScope) { // Determine filterCollection, folders, and scopeButtonId based on aScope. var filterCollection; var folders = []; var scopeButtonId; switch (aScope) { case "history": filterCollection = "history"; scopeButtonId = "scopeBarHistory"; break; case "collection": // The folder scope button can only become hidden upon selecting a new // folder in the left pane, and the disabled state will remain unchanged // until a new folder is selected. See PO__setScopeForNode(). if (!document.getElementById("scopeBarFolder").hidden) { filterCollection = "collection"; scopeButtonId = "scopeBarFolder"; folders.push(PlacesUtils.getConcreteItemId( PlacesOrganizer._places.selectedNode)); break; } // Fall through. If collection scope doesn't make sense for the // selected node, choose bookmarks scope. case "bookmarks": filterCollection = "bookmarks"; scopeButtonId = "scopeBarAll"; folders.push(PlacesUtils.bookmarksMenuFolderId, PlacesUtils.toolbarFolderId, PlacesUtils.unfiledBookmarksFolderId); break; default: throw "Invalid search scope"; break; } // Check the appropriate scope button in the scope bar. document.getElementById(scopeButtonId).checked = true; // Update the search box. Re-search if there's an active search. PlacesSearchBox.filterCollection = filterCollection; PlacesSearchBox.folders = folders; var searchStr = PlacesSearchBox.searchFilter.value; if (searchStr) PlacesSearchBox.search(searchStr); } }; /** * Population and commands for the View Menu. */ var ViewMenu = { /** * Removes content generated previously from a menupopup. * @param popup * The popup that contains the previously generated content. * @param startID * The id attribute of an element that is the start of the * dynamically generated region - remove elements after this * item only. * Must be contained by popup. Can be null (in which case the * contents of popup are removed). * @param endID * The id attribute of an element that is the end of the * dynamically generated region - remove elements up to this * item only. * Must be contained by popup. Can be null (in which case all * items until the end of the popup will be removed). Ignored * if startID is null. * @returns The element for the caller to insert new items before, * null if the caller should just append to the popup. */ _clean: function VM__clean(popup, startID, endID) { if (endID) NS_ASSERT(startID, "meaningless to have valid endID and null startID"); if (startID) { var startElement = document.getElementById(startID); NS_ASSERT(startElement.parentNode == popup, "startElement is not in popup"); NS_ASSERT(startElement, "startID does not correspond to an existing element"); var endElement = null; if (endID) { endElement = document.getElementById(endID); NS_ASSERT(endElement.parentNode == popup, "endElement is not in popup"); NS_ASSERT(endElement, "endID does not correspond to an existing element"); } while (startElement.nextSibling != endElement) popup.removeChild(startElement.nextSibling); return endElement; } else { while(popup.hasChildNodes()) popup.removeChild(popup.firstChild); } return null; }, /** * Fills a menupopup with a list of columns * @param event * The popupshowing event that invoked this function. * @param startID * see _clean * @param endID * see _clean * @param type * the type of the menuitem, e.g. "radio" or "checkbox". * Can be null (no-type). * Checkboxes are checked if the column is visible. * @param propertyPrefix * If propertyPrefix is non-null: * propertyPrefix + column ID + ".label" will be used to get the * localized label string. * propertyPrefix + column ID + ".accesskey" will be used to get the * localized accesskey. * If propertyPrefix is null, the column label is used as label and * no accesskey is assigned. */ fillWithColumns: function VM_fillWithColumns(event, startID, endID, type, propertyPrefix) { var popup = event.target; var pivot = this._clean(popup, startID, endID); // If no column is "sort-active", the "Unsorted" item needs to be checked, // so track whether or not we find a column that is sort-active. var isSorted = false; var content = document.getElementById("placeContent"); var columns = content.columns; for (var i = 0; i < columns.count; ++i) { var column = columns.getColumnAt(i).element; var menuitem = document.createElement("menuitem"); menuitem.id = "menucol_" + column.id; menuitem.column = column; var label = column.getAttribute("label"); if (propertyPrefix) { var menuitemPrefix = propertyPrefix; // for string properties, use "name" as the id, instead of "title" // see bug #386287 for details var columnId = column.getAttribute("anonid"); menuitemPrefix += columnId == "title" ? "name" : columnId; label = PlacesUIUtils.getString(menuitemPrefix + ".label"); var accesskey = PlacesUIUtils.getString(menuitemPrefix + ".accesskey"); menuitem.setAttribute("accesskey", accesskey); } menuitem.setAttribute("label", label); if (type == "radio") { menuitem.setAttribute("type", "radio"); menuitem.setAttribute("name", "columns"); // This column is the sort key. Its item is checked. if (column.getAttribute("sortDirection") != "") { menuitem.setAttribute("checked", "true"); isSorted = true; } } else if (type == "checkbox") { menuitem.setAttribute("type", "checkbox"); // Cannot uncheck the primary column. if (column.getAttribute("primary") == "true") menuitem.setAttribute("disabled", "true"); // Items for visible columns are checked. if (!column.hidden) menuitem.setAttribute("checked", "true"); } if (pivot) popup.insertBefore(menuitem, pivot); else popup.appendChild(menuitem); } event.stopPropagation(); }, /** * Set up the content of the view menu. */ populateSortMenu: function VM_populateSortMenu(event) { this.fillWithColumns(event, "viewUnsorted", "directionSeparator", "radio", "view.sortBy."); var sortColumn = this._getSortColumn(); var viewSortAscending = document.getElementById("viewSortAscending"); var viewSortDescending = document.getElementById("viewSortDescending"); // We need to remove an existing checked attribute because the unsorted // menu item is not rebuilt every time we open the menu like the others. var viewUnsorted = document.getElementById("viewUnsorted"); if (!sortColumn) { viewSortAscending.removeAttribute("checked"); viewSortDescending.removeAttribute("checked"); viewUnsorted.setAttribute("checked", "true"); } else if (sortColumn.getAttribute("sortDirection") == "ascending") { viewSortAscending.setAttribute("checked", "true"); viewSortDescending.removeAttribute("checked"); viewUnsorted.removeAttribute("checked"); } else if (sortColumn.getAttribute("sortDirection") == "descending") { viewSortDescending.setAttribute("checked", "true"); viewSortAscending.removeAttribute("checked"); viewUnsorted.removeAttribute("checked"); } }, /** * Shows/Hides a tree column. * @param element * The menuitem element for the column */ showHideColumn: function VM_showHideColumn(element) { var column = element.column; var splitter = column.nextSibling; if (splitter && splitter.localName != "splitter") splitter = null; if (element.getAttribute("checked") == "true") { column.setAttribute("hidden", "false"); if (splitter) splitter.removeAttribute("hidden"); } else { column.setAttribute("hidden", "true"); if (splitter) splitter.setAttribute("hidden", "true"); } }, /** * Gets the last column that was sorted. * @returns the currently sorted column, null if there is no sorted column. */ _getSortColumn: function VM__getSortColumn() { var content = document.getElementById("placeContent"); var cols = content.columns; for (var i = 0; i < cols.count; ++i) { var column = cols.getColumnAt(i).element; var sortDirection = column.getAttribute("sortDirection"); if (sortDirection == "ascending" || sortDirection == "descending") return column; } return null; }, /** * Sorts the view by the specified column. * @param aColumn * The colum that is the sort key. Can be null - the * current sort column or the title column will be used. * @param aDirection * The direction to sort - "ascending" or "descending". * Can be null - the last direction or descending will be used. * * If both aColumnID and aDirection are null, the view will be unsorted. */ setSortColumn: function VM_setSortColumn(aColumn, aDirection) { var result = document.getElementById("placeContent").getResult(); if (!aColumn && !aDirection) { result.sortingMode = Ci.nsINavHistoryQueryOptions.SORT_BY_NONE; return; } var columnId; if (aColumn) { columnId = aColumn.getAttribute("anonid"); if (!aDirection) { var sortColumn = this._getSortColumn(); if (sortColumn) aDirection = sortColumn.getAttribute("sortDirection"); } } else { var sortColumn = this._getSortColumn(); columnId = sortColumn ? sortColumn.getAttribute("anonid") : "title"; } // This maps the possible values of columnId (i.e., anonid's of treecols in // placeContent) to the default sortingMode and sortingAnnotation values for // each column. // key: Sort key in the name of one of the // nsINavHistoryQueryOptions.SORT_BY_* constants // dir: Default sort direction to use if none has been specified // anno: The annotation to sort by, if key is "ANNOTATION" var colLookupTable = { title: { key: "TITLE", dir: "ascending" }, tags: { key: "TAGS", dir: "ascending" }, url: { key: "URI", dir: "ascending" }, date: { key: "DATE", dir: "descending" }, visitCount: { key: "VISITCOUNT", dir: "descending" }, keyword: { key: "KEYWORD", dir: "ascending" }, dateAdded: { key: "DATEADDED", dir: "descending" }, lastModified: { key: "LASTMODIFIED", dir: "descending" }, description: { key: "ANNOTATION", dir: "ascending", anno: DESCRIPTION_ANNO } }; // Make sure we have a valid column. if (!colLookupTable.hasOwnProperty(columnId)) throw("Invalid column"); // Use a default sort direction if none has been specified. If aDirection // is invalid, result.sortingMode will be undefined, which has the effect // of unsorting the tree. aDirection = (aDirection || colLookupTable[columnId].dir).toUpperCase(); var sortConst = "SORT_BY_" + colLookupTable[columnId].key + "_" + aDirection; result.sortingAnnotation = colLookupTable[columnId].anno || ""; result.sortingMode = Ci.nsINavHistoryQueryOptions[sortConst]; } };