/* -*- Mode: C++; tab-width: 2; 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.org code. * * The Initial Developer of the Original Code is Neil Deakin * Portions created by the Initial Developer are Copyright (C) 2006 * the Initial Developer. All Rights Reserved. * * Contributor(s): * * Alternatively, the contents of this file may be used under the terms of * either of 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 ***** */ #include "nsGkAtoms.h" #include "nsXULPopupManager.h" #include "nsMenuFrame.h" #include "nsMenuPopupFrame.h" #include "nsMenuBarFrame.h" #include "nsIPopupBoxObject.h" #include "nsMenuBarListener.h" #include "nsContentUtils.h" #include "nsIDOMDocument.h" #include "nsIDOMNSEvent.h" #include "nsIDOMNSUIEvent.h" #include "nsIDOMXULElement.h" #include "nsIXULTemplateBuilder.h" #include "nsIPrivateDOMEvent.h" #include "nsEventDispatcher.h" #include "nsEventStateManager.h" #include "nsCSSFrameConstructor.h" #include "nsLayoutUtils.h" #include "nsIViewManager.h" #include "nsILookAndFeel.h" #include "nsIComponentManager.h" #include "nsITimer.h" #include "nsFocusManager.h" #include "nsIDocShellTreeItem.h" #include "nsIDocShell.h" #include "nsPIDOMWindow.h" #include "nsIInterfaceRequestorUtils.h" #include "nsIBaseWindow.h" #include "nsIDocShellTreeItem.h" #include "nsIDOMMouseEvent.h" #include "nsCaret.h" #include "nsIDocument.h" #include "nsPIDOMWindow.h" #include "nsFrameManager.h" const nsNavigationDirection DirectionFromKeyCodeTable[2][6] = { { eNavigationDirection_Last, // NS_VK_END eNavigationDirection_First, // NS_VK_HOME eNavigationDirection_Start, // NS_VK_LEFT eNavigationDirection_Before, // NS_VK_UP eNavigationDirection_End, // NS_VK_RIGHT eNavigationDirection_After // NS_VK_DOWN }, { eNavigationDirection_Last, // NS_VK_END eNavigationDirection_First, // NS_VK_HOME eNavigationDirection_End, // NS_VK_LEFT eNavigationDirection_Before, // NS_VK_UP eNavigationDirection_Start, // NS_VK_RIGHT eNavigationDirection_After // NS_VK_DOWN } }; nsXULPopupManager* nsXULPopupManager::sInstance = nsnull; nsIContent* nsMenuChainItem::Content() { return mFrame->GetContent(); } void nsMenuChainItem::SetParent(nsMenuChainItem* aParent) { if (mParent) { NS_ASSERTION(mParent->mChild == this, "Unexpected - parent's child not set to this"); mParent->mChild = nsnull; } mParent = aParent; if (mParent) { if (mParent->mChild) mParent->mChild->mParent = nsnull; mParent->mChild = this; } } void nsMenuChainItem::Detach(nsMenuChainItem** aRoot) { // If the item has a child, set the child's parent to this item's parent, // effectively removing the item from the chain. If the item has no child, // just set the parent to null. if (mChild) { NS_ASSERTION(this != *aRoot, "Unexpected - popup with child at end of chain"); mChild->SetParent(mParent); } else { // An item without a child should be the first item in the chain, so set // the first item pointer, pointed to by aRoot, to the parent. NS_ASSERTION(this == *aRoot, "Unexpected - popup with no child not at end of chain"); *aRoot = mParent; SetParent(nsnull); } } NS_IMPL_ISUPPORTS4(nsXULPopupManager, nsIDOMKeyListener, nsIDOMEventListener, nsIMenuRollup, nsITimerCallback) nsXULPopupManager::nsXULPopupManager() : mRangeOffset(0), mCachedMousePoint(0, 0), mActiveMenuBar(nsnull), mPopups(nsnull), mNoHidePanels(nsnull), mTimerMenu(nsnull) { } nsXULPopupManager::~nsXULPopupManager() { NS_ASSERTION(!mPopups && !mNoHidePanels, "XUL popups still open"); } nsresult nsXULPopupManager::Init() { sInstance = new nsXULPopupManager(); NS_ENSURE_TRUE(sInstance, NS_ERROR_OUT_OF_MEMORY); NS_ADDREF(sInstance); return NS_OK; } void nsXULPopupManager::Shutdown() { NS_IF_RELEASE(sInstance); } nsXULPopupManager* nsXULPopupManager::GetInstance() { return sInstance; } NS_IMETHODIMP nsXULPopupManager::Rollup(PRUint32 aCount, nsIContent** aLastRolledUp) { if (aLastRolledUp) *aLastRolledUp = nsnull; nsMenuChainItem* item = GetTopVisibleMenu(); if (item) { if (aLastRolledUp) { // we need to get the popup that will be closed last, so that // widget can keep track of it so it doesn't reopen if a mouse // down event is going to processed. // Keep going up the menu chain to get the first level menu. This will // be the one that closes up last. It's possible that this menu doesn't // end up closing because the popuphiding event was cancelled, but in // that case we don't need to deal with the menu reopening as it will // already still be open. nsMenuChainItem* first = item; while (first->GetParent()) first = first->GetParent(); NS_ADDREF(*aLastRolledUp = first->Content()); } // if a number of popups to close has been specified, determine the last // popup to close nsIContent* lastPopup = nsnull; if (aCount != PR_UINT32_MAX) { nsMenuChainItem* last = item; while (--aCount && last->GetParent()) { last = last->GetParent(); } if (last) { lastPopup = last->Content(); } } HidePopup(item->Content(), PR_TRUE, PR_TRUE, PR_FALSE, lastPopup); } return NS_OK; } //////////////////////////////////////////////////////////////////////// NS_IMETHODIMP nsXULPopupManager::ShouldRollupOnMouseWheelEvent(PRBool *aShouldRollup) { // should rollup only for autocomplete widgets // XXXndeakin this should really be something the popup has more control over nsMenuChainItem* item = GetTopVisibleMenu(); *aShouldRollup = (item && !item->Frame()->IsMenu()); return NS_OK; } // a menu should not roll up if activated by a mouse activate message (eg. X-mouse) NS_IMETHODIMP nsXULPopupManager::ShouldRollupOnMouseActivate(PRBool *aShouldRollup) { *aShouldRollup = PR_FALSE; return NS_OK; } PRUint32 nsXULPopupManager::GetSubmenuWidgetChain(nsTArray *aWidgetChain) { // this method is used by the widget code to determine the list of popups // that are open. If a mouse click occurs outside one of these popups, the // panels will roll up. If the click is inside a popup, they will not roll up PRUint32 count = 0, sameTypeCount = 0; NS_ASSERTION(aWidgetChain, "null parameter"); nsMenuChainItem* item = GetTopVisibleMenu(); while (item) { nsCOMPtr widget; item->Frame()->GetWidget(getter_AddRefs(widget)); NS_ASSERTION(widget, "open popup has no widget"); aWidgetChain->AppendElement(widget.get()); // In the case when a menulist inside a panel is open, clicking in the // panel should still roll up the menu, so if a different type is found, // stop scanning. nsMenuChainItem* parent = item->GetParent(); if (!sameTypeCount) { count++; if (!parent || item->Frame()->PopupType() != parent->Frame()->PopupType() || item->IsContextMenu() != parent->IsContextMenu()) { sameTypeCount = count; } } item = parent; } return sameTypeCount; } void nsXULPopupManager::AdjustPopupsOnWindowChange() { // Panels with noautohide="true" are moved and kept aligned with the anchor // when the parent window moves. Dismissable menus and panels are expected // to roll up when a window is moved, so there is no need to check these. nsMenuChainItem* item = mNoHidePanels; while (item) { // if the auto positioning has been disabled, don't move the popup if (item->Frame()->GetAutoPosition()) item->Frame()->SetPopupPosition(nsnull, PR_TRUE); item = item->GetParent(); } } nsIFrame* nsXULPopupManager::GetFrameOfTypeForContent(nsIContent* aContent, nsIAtom* aFrameType, PRBool aShouldFlush) { nsIDocument *document = aContent->GetCurrentDoc(); if (document) { nsCOMPtr presShell = document->GetPrimaryShell(); if (presShell) { if (aShouldFlush) presShell->FlushPendingNotifications(Flush_Frames); nsIFrame* frame = aContent->GetPrimaryFrame(); if (frame && frame->GetType() == aFrameType) return frame; } } return nsnull; } nsMenuFrame* nsXULPopupManager::GetMenuFrameForContent(nsIContent* aContent) { // as ShowMenu is called from frames, don't flush to be safe. return static_cast (GetFrameOfTypeForContent(aContent, nsGkAtoms::menuFrame, PR_FALSE)); } nsMenuPopupFrame* nsXULPopupManager::GetPopupFrameForContent(nsIContent* aContent) { return static_cast (GetFrameOfTypeForContent(aContent, nsGkAtoms::menuPopupFrame, PR_TRUE)); } nsMenuChainItem* nsXULPopupManager::GetTopVisibleMenu() { nsMenuChainItem* item = mPopups; while (item && item->Frame()->PopupState() == ePopupInvisible) item = item->GetParent(); return item; } void nsXULPopupManager::GetMouseLocation(nsIDOMNode** aNode, PRInt32* aOffset) { *aNode = mRangeParent; NS_IF_ADDREF(*aNode); *aOffset = mRangeOffset; } void nsXULPopupManager::SetTriggerEvent(nsIDOMEvent* aEvent, nsIContent* aPopup) { mCachedMousePoint = nsIntPoint(0, 0); nsCOMPtr uiEvent = do_QueryInterface(aEvent); if (uiEvent) { uiEvent->GetRangeParent(getter_AddRefs(mRangeParent)); uiEvent->GetRangeOffset(&mRangeOffset); // get the event coordinates relative to the root frame of the document // containing the popup. nsCOMPtr privateEvent(do_QueryInterface(aEvent)); if (privateEvent) { NS_ASSERTION(aPopup, "Expected a popup node"); nsEvent* event; event = privateEvent->GetInternalNSEvent(); if (event) { nsIDocument* doc = aPopup->GetCurrentDoc(); if (doc) { nsIPresShell* presShell = doc->GetPrimaryShell(); if (presShell && presShell->GetPresContext()) { nsPresContext* rootDocPresContext = presShell->GetPresContext()->GetRootPresContext(); if (!rootDocPresContext) return; nsIFrame* rootDocumentRootFrame = rootDocPresContext-> PresShell()->FrameManager()->GetRootFrame(); if ((event->eventStructType == NS_MOUSE_EVENT || event->eventStructType == NS_MOUSE_SCROLL_EVENT) && !(static_cast(event))->widget) { // no widget, so just use the client point if available nsCOMPtr mouseEvent = do_QueryInterface(aEvent); nsIntPoint clientPt; mouseEvent->GetClientX(&clientPt.x); mouseEvent->GetClientY(&clientPt.y); // XXX this doesn't handle IFRAMEs in transforms nsPoint thisDocToRootDocOffset = presShell->FrameManager()->GetRootFrame()->GetOffsetTo(rootDocumentRootFrame); // convert to device pixels mCachedMousePoint.x = rootDocPresContext->AppUnitsToDevPixels( nsPresContext::CSSPixelsToAppUnits(clientPt.x) + thisDocToRootDocOffset.x); mCachedMousePoint.y = rootDocPresContext->AppUnitsToDevPixels( nsPresContext::CSSPixelsToAppUnits(clientPt.y) + thisDocToRootDocOffset.y); } else if (rootDocumentRootFrame) { nsPoint pnt = nsLayoutUtils::GetEventCoordinatesRelativeTo(event, rootDocumentRootFrame); mCachedMousePoint = nsIntPoint(rootDocPresContext->AppUnitsToDevPixels(pnt.x), rootDocPresContext->AppUnitsToDevPixels(pnt.y)); } } } } } } else { mRangeParent = nsnull; mRangeOffset = 0; } } void nsXULPopupManager::SetActiveMenuBar(nsMenuBarFrame* aMenuBar, PRBool aActivate) { if (aActivate) mActiveMenuBar = aMenuBar; else if (mActiveMenuBar == aMenuBar) mActiveMenuBar = nsnull; UpdateKeyboardListeners(); } void nsXULPopupManager::ShowMenu(nsIContent *aMenu, PRBool aSelectFirstItem, PRBool aAsynchronous) { // generate any template content first. Otherwise, the menupopup may not // have been created yet. if (aMenu) { nsIContent* element = aMenu; do { nsCOMPtr xulelem = do_QueryInterface(element); if (xulelem) { nsCOMPtr builder; xulelem->GetBuilder(getter_AddRefs(builder)); if (builder) { builder->CreateContents(aMenu, PR_TRUE); break; } } element = element->GetParent(); } while (element); } nsMenuFrame* menuFrame = GetMenuFrameForContent(aMenu); if (!menuFrame || !menuFrame->IsMenu()) return; nsMenuPopupFrame* popupFrame = menuFrame->GetPopup(); if (!popupFrame || !MayShowPopup(popupFrame)) return; // inherit whether or not we're a context menu from the parent PRBool parentIsContextMenu = PR_FALSE; PRBool onMenuBar = PR_FALSE; PRBool onmenu = menuFrame->IsOnMenu(); nsMenuParent* parent = menuFrame->GetMenuParent(); if (parent && onmenu) { parentIsContextMenu = parent->IsContextMenu(); onMenuBar = parent->IsMenuBar(); } nsAutoString position; if (onMenuBar || !onmenu) position.AssignLiteral("after_start"); else position.AssignLiteral("end_before"); popupFrame->InitializePopup(aMenu, position, 0, 0, PR_TRUE); if (aAsynchronous) { SetTriggerEvent(nsnull, nsnull); nsCOMPtr event = new nsXULPopupShowingEvent(popupFrame->GetContent(), aMenu, popupFrame->PopupType(), parentIsContextMenu, aSelectFirstItem); NS_DispatchToCurrentThread(event); } else { nsCOMPtr popupContent = popupFrame->GetContent(); FirePopupShowingEvent(popupContent, aMenu, popupFrame->PresContext(), popupFrame->PopupType(), parentIsContextMenu, aSelectFirstItem); } } void nsXULPopupManager::ShowPopup(nsIContent* aPopup, nsIContent* aAnchorContent, const nsAString& aPosition, PRInt32 aXPos, PRInt32 aYPos, PRBool aIsContextMenu, PRBool aAttributesOverride, PRBool aSelectFirstItem, nsIDOMEvent* aTriggerEvent) { nsMenuPopupFrame* popupFrame = GetPopupFrameForContent(aPopup); if (!popupFrame || !MayShowPopup(popupFrame)) return; SetTriggerEvent(aTriggerEvent, aPopup); popupFrame->InitializePopup(aAnchorContent, aPosition, aXPos, aYPos, aAttributesOverride); FirePopupShowingEvent(aPopup, nsnull, popupFrame->PresContext(), popupFrame->PopupType(), aIsContextMenu, aSelectFirstItem); } void nsXULPopupManager::ShowPopupAtScreen(nsIContent* aPopup, PRInt32 aXPos, PRInt32 aYPos, PRBool aIsContextMenu, nsIDOMEvent* aTriggerEvent) { nsMenuPopupFrame* popupFrame = GetPopupFrameForContent(aPopup); if (!popupFrame || !MayShowPopup(popupFrame)) return; SetTriggerEvent(aTriggerEvent, aPopup); popupFrame->InitializePopupAtScreen(aXPos, aYPos, aIsContextMenu); FirePopupShowingEvent(aPopup, nsnull, popupFrame->PresContext(), popupFrame->PopupType(), aIsContextMenu, PR_FALSE); } void nsXULPopupManager::ShowPopupWithAnchorAlign(nsIContent* aPopup, nsIContent* aAnchorContent, nsAString& aAnchor, nsAString& aAlign, PRInt32 aXPos, PRInt32 aYPos, PRBool aIsContextMenu) { nsMenuPopupFrame* popupFrame = GetPopupFrameForContent(aPopup); if (!popupFrame || !MayShowPopup(popupFrame)) return; SetTriggerEvent(nsnull, nsnull); popupFrame->InitializePopupWithAnchorAlign(aAnchorContent, aAnchor, aAlign, aXPos, aYPos); FirePopupShowingEvent(aPopup, nsnull, popupFrame->PresContext(), popupFrame->PopupType(), aIsContextMenu, PR_FALSE); } static void CheckCaretDrawingState() { // There is 1 caret per document, we need to find the focused // document and erase its caret. nsIFocusManager* fm = nsFocusManager::GetFocusManager(); if (fm) { nsCOMPtr window; fm->GetFocusedWindow(getter_AddRefs(window)); if (!window) return; nsCOMPtr windowInternal = do_QueryInterface(window); nsCOMPtr domDoc; nsCOMPtr focusedDoc; windowInternal->GetDocument(getter_AddRefs(domDoc)); focusedDoc = do_QueryInterface(domDoc); if (!focusedDoc) return; nsIPresShell* presShell = focusedDoc->GetPrimaryShell(); if (!presShell) return; nsRefPtr caret = presShell->GetCaret(); if (!caret) return; caret->CheckCaretDrawingState(); } } void nsXULPopupManager::ShowPopupCallback(nsIContent* aPopup, nsMenuPopupFrame* aPopupFrame, PRBool aIsContextMenu, PRBool aSelectFirstItem) { // clear these as they are no longer valid mRangeParent = nsnull; mRangeOffset = 0; nsPopupType popupType = aPopupFrame->PopupType(); PRBool ismenu = (popupType == ePopupTypeMenu); nsMenuChainItem* item = new nsMenuChainItem(aPopupFrame, aIsContextMenu, popupType); if (!item) return; // install keyboard event listeners for navigating menus. For panels, the // escape key may be used to close the panel. However, the ignorekeys // attribute may be used to disable adding these event listeners for popups // that want to handle their own keyboard events. if (aPopup->AttrValueIs(kNameSpaceID_None, nsGkAtoms::ignorekeys, nsGkAtoms::_true, eCaseMatters)) item->SetIgnoreKeys(PR_TRUE); if (ismenu) { // if the menu is on a menubar, use the menubar's listener instead nsIFrame* parent = aPopupFrame->GetParent(); if (parent && parent->GetType() == nsGkAtoms::menuFrame) { nsMenuFrame* menuFrame = static_cast(parent); item->SetOnMenuBar(menuFrame->IsOnMenuBar()); } } // use a weak frame as the popup will set an open attribute if it is a menu nsWeakFrame weakFrame(aPopupFrame); PRBool hasChildren = aPopupFrame->ShowPopup(aIsContextMenu, aSelectFirstItem); ENSURE_TRUE(weakFrame.IsAlive()); // popups normally hide when an outside click occurs. Panels may use // the noautohide attribute to disable this behaviour. It is expected // that the application will hide these popups manually. The tooltip // listener will handle closing the tooltip also. if (aPopupFrame->IsNoAutoHide() || popupType == ePopupTypeTooltip) { item->SetParent(mNoHidePanels); mNoHidePanels = item; } else { nsIContent* oldmenu = nsnull; if (mPopups) oldmenu = mPopups->Content(); item->SetParent(mPopups); mPopups = item; SetCaptureState(oldmenu); } if (hasChildren) { if (aSelectFirstItem) { nsMenuFrame* next = GetNextMenuItem(aPopupFrame, nsnull, PR_TRUE); aPopupFrame->SetCurrentMenuItem(next); } if (ismenu) UpdateMenuItems(aPopup); } // Caret visibility may have been affected, ensure that // the caret isn't now drawn when it shouldn't be. CheckCaretDrawingState(); } void nsXULPopupManager::HidePopup(nsIContent* aPopup, PRBool aHideChain, PRBool aDeselectMenu, PRBool aAsynchronous, nsIContent* aLastPopup) { // if the popup is on the nohide panels list, remove it but don't close any // other panels nsMenuPopupFrame* popupFrame = nsnull; PRBool foundPanel = PR_FALSE; nsMenuChainItem* item = mNoHidePanels; while (item) { if (item->Content() == aPopup) { foundPanel = PR_TRUE; popupFrame = item->Frame(); break; } item = item->GetParent(); } // when removing a menu, all of the child popups must be closed nsMenuChainItem* foundMenu = nsnull; item = mPopups; while (item) { if (item->Content() == aPopup) { foundMenu = item; break; } item = item->GetParent(); } nsPopupType type = ePopupTypePanel; PRBool deselectMenu = PR_FALSE; nsCOMPtr popupToHide, nextPopup, lastPopup; if (foundMenu) { // at this point, foundMenu will be set to the found item in the list. If // foundMenu is the topmost menu, the one to remove, then there are no other // popups to hide. If foundMenu is not the topmost menu, then there may be // open submenus below it. In this case, we need to make sure that those // submenus are closed up first. To do this, we scan up the menu list to // find the topmost popup with only menus between it and foundMenu and // close that menu first. In synchronous mode, the FirePopupHidingEvent // method will be called which in turn calls HidePopupCallback to close up // the next popup in the chain. These two methods will be called in // sequence recursively to close up all the necessary popups. In // asynchronous mode, a similar process occurs except that the // FirePopupHidingEvent method is called asynchronously. In either case, // nextPopup is set to the content node of the next popup to close, and // lastPopup is set to the last popup in the chain to close, which will be // aPopup, or null to close up all menus. nsMenuChainItem* topMenu = foundMenu; // Use IsMenu to ensure that foundMenu is a menu and scan down the child // list until a non-menu is found. If foundMenu isn't a menu at all, don't // scan and just close up this menu. if (foundMenu->IsMenu()) { item = topMenu->GetChild(); while (item && item->IsMenu()) { topMenu = item; item = item->GetChild(); } } deselectMenu = aDeselectMenu; popupToHide = topMenu->Content(); popupFrame = topMenu->Frame(); type = popupFrame->PopupType(); nsMenuChainItem* parent = topMenu->GetParent(); // close up another popup if there is one, and we are either hiding the // entire chain or the item to hide isn't the topmost popup. if (parent && (aHideChain || topMenu != foundMenu)) nextPopup = parent->Content(); lastPopup = aLastPopup ? aLastPopup : (aHideChain ? nsnull : aPopup); } else if (foundPanel) { popupToHide = aPopup; } if (popupFrame) { nsPopupState state = popupFrame->PopupState(); // if the popup is already being hidden, don't attempt to hide it again if (state == ePopupHiding) return; // change the popup state to hiding. Don't set the hiding state if the // popup is invisible, otherwise nsMenuPopupFrame::HidePopup will // run again. In the invisible state, we just want the events to fire. if (state != ePopupInvisible) popupFrame->SetPopupState(ePopupHiding); // for menus, popupToHide is always the frommost item in the list to hide. if (aAsynchronous) { nsCOMPtr event = new nsXULPopupHidingEvent(popupToHide, nextPopup, lastPopup, type, deselectMenu); NS_DispatchToCurrentThread(event); } else { FirePopupHidingEvent(popupToHide, nextPopup, lastPopup, popupFrame->PresContext(), type, deselectMenu); } } } void nsXULPopupManager::HidePopupCallback(nsIContent* aPopup, nsMenuPopupFrame* aPopupFrame, nsIContent* aNextPopup, nsIContent* aLastPopup, nsPopupType aPopupType, PRBool aDeselectMenu) { if (mCloseTimer && mTimerMenu == aPopupFrame) { mCloseTimer->Cancel(); mCloseTimer = nsnull; mTimerMenu = nsnull; } // The popup to hide is aPopup. Search the list again to find the item that // corresponds to the popup to hide aPopup. This is done because it's // possible someone added another item (attempted to open another popup) // or removed a popup frame during the event processing so the item isn't at // the front anymore. nsMenuChainItem* item = mNoHidePanels; while (item) { if (item->Content() == aPopup) { item->Detach(&mNoHidePanels); break; } item = item->GetParent(); } if (!item) { item = mPopups; while (item) { if (item->Content() == aPopup) { item->Detach(&mPopups); SetCaptureState(aPopup); break; } item = item->GetParent(); } } delete item; nsWeakFrame weakFrame(aPopupFrame); aPopupFrame->HidePopup(aDeselectMenu, ePopupClosed); ENSURE_TRUE(weakFrame.IsAlive()); // send the popuphidden event synchronously. This event has no default behaviour. nsEventStatus status = nsEventStatus_eIgnore; nsMouseEvent event(PR_TRUE, NS_XUL_POPUP_HIDDEN, nsnull, nsMouseEvent::eReal); nsEventDispatcher::Dispatch(aPopup, aPopupFrame->PresContext(), &event, nsnull, &status); // if there are more popups to close, look for the next one if (aNextPopup && aPopup != aLastPopup) { nsMenuChainItem* foundMenu = nsnull; nsMenuChainItem* item = mPopups; while (item) { if (item->Content() == aNextPopup) { foundMenu = item; break; } item = item->GetParent(); } // continue hiding the chain of popups until the last popup aLastPopup // is reached, or until a popup of a different type is reached. This // last check is needed so that a menulist inside a non-menu panel only // closes the menu and not the panel as well. if (foundMenu && (aLastPopup || aPopupType == foundMenu->PopupType())) { nsCOMPtr popupToHide = item->Content(); nsMenuChainItem* parent = item->GetParent(); nsCOMPtr nextPopup; if (parent && popupToHide != aLastPopup) nextPopup = parent->Content(); nsMenuPopupFrame* popupFrame = item->Frame(); nsPopupState state = popupFrame->PopupState(); if (state == ePopupHiding) return; if (state != ePopupInvisible) popupFrame->SetPopupState(ePopupHiding); FirePopupHidingEvent(popupToHide, nextPopup, aLastPopup, popupFrame->PresContext(), foundMenu->PopupType(), aDeselectMenu); } } } void nsXULPopupManager::HidePopupAfterDelay(nsMenuPopupFrame* aPopup) { // Don't close up immediately. // Kick off a close timer. KillMenuTimer(); PRInt32 menuDelay = 300; // ms aPopup->PresContext()->LookAndFeel()-> GetMetric(nsILookAndFeel::eMetric_SubmenuDelay, menuDelay); // Kick off the timer. mCloseTimer = do_CreateInstance("@mozilla.org/timer;1"); mCloseTimer->InitWithCallback(this, menuDelay, nsITimer::TYPE_ONE_SHOT); // the popup will call PopupDestroyed if it is destroyed, which checks if it // is set to mTimerMenu, so it should be safe to keep a reference to it mTimerMenu = aPopup; } void nsXULPopupManager::HidePopupsInList(const nsTArray &aFrames, PRBool aDeselectMenu) { // Create a weak frame list. This is done in a separate array with the // right capacity predetermined, otherwise the array would get resized and // move the weak frame pointers around. nsTArray weakPopups(aFrames.Length()); PRUint32 f; for (f = 0; f < aFrames.Length(); f++) { nsWeakFrame* wframe = weakPopups.AppendElement(); if (wframe) *wframe = aFrames[f]; } for (f = 0; f < weakPopups.Length(); f++) { // check to ensure that the frame is still alive before hiding it. if (weakPopups[f].IsAlive()) { nsMenuPopupFrame* frame = static_cast(weakPopups[f].GetFrame()); frame->HidePopup(PR_TRUE, ePopupInvisible); } } SetCaptureState(nsnull); } PRBool nsXULPopupManager::IsChildOfDocShell(nsIDocument* aDoc, nsIDocShellTreeItem* aExpected) { nsCOMPtr doc = aDoc->GetContainer(); nsCOMPtr docShellItem(do_QueryInterface(doc)); while(docShellItem) { if (docShellItem == aExpected) return PR_TRUE; nsCOMPtr parent; docShellItem->GetParent(getter_AddRefs(parent)); docShellItem = parent; } return PR_FALSE; } void nsXULPopupManager::HidePopupsInDocShell(nsIDocShellTreeItem* aDocShellToHide) { nsTArray popupsToHide; // iterate to get the set of popup frames to hide nsMenuChainItem* item = mPopups; while (item) { nsMenuChainItem* parent = item->GetParent(); if (item->Frame()->PopupState() != ePopupInvisible && IsChildOfDocShell(item->Content()->GetOwnerDoc(), aDocShellToHide)) { nsMenuPopupFrame* frame = item->Frame(); item->Detach(&mPopups); delete item; popupsToHide.AppendElement(frame); } item = parent; } // now look for panels to hide item = mNoHidePanels; while (item) { nsMenuChainItem* parent = item->GetParent(); if (item->Frame()->PopupState() != ePopupInvisible && IsChildOfDocShell(item->Content()->GetOwnerDoc(), aDocShellToHide)) { nsMenuPopupFrame* frame = item->Frame(); item->Detach(&mNoHidePanels); delete item; popupsToHide.AppendElement(frame); } item = parent; } HidePopupsInList(popupsToHide, PR_TRUE); } void nsXULPopupManager::ExecuteMenu(nsIContent* aMenu, nsXULMenuCommandEvent* aEvent) { CloseMenuMode cmm = CloseMenuMode_Auto; static nsIContent::AttrValuesArray strings[] = {&nsGkAtoms::none, &nsGkAtoms::single, nsnull}; switch (aMenu->FindAttrValueIn(kNameSpaceID_None, nsGkAtoms::closemenu, strings, eCaseMatters)) { case 0: cmm = CloseMenuMode_None; break; case 1: cmm = CloseMenuMode_Single; break; default: break; } // When a menuitem is selected to be executed, first hide all the open // popups, but don't remove them yet. This is needed when a menu command // opens a modal dialog. The views associated with the popups needed to be // hidden and the accesibility events fired before the command executes, but // the popuphiding/popuphidden events are fired afterwards. nsTArray popupsToHide; nsMenuChainItem* item = GetTopVisibleMenu(); if (cmm != CloseMenuMode_None) { while (item) { // if it isn't a , don't close it automatically if (!item->IsMenu()) break; nsMenuChainItem* next = item->GetParent(); popupsToHide.AppendElement(item->Frame()); if (cmm == CloseMenuMode_Single) // only close one level of menu break; item = next; } // Now hide the popups. If the closemenu mode is auto, deselect the menu, // otherwise only one popup is closing, so keep the parent menu selected. HidePopupsInList(popupsToHide, cmm == CloseMenuMode_Auto); } aEvent->SetCloseMenuMode(cmm); nsCOMPtr event = aEvent; NS_DispatchToCurrentThread(event); } void nsXULPopupManager::FirePopupShowingEvent(nsIContent* aPopup, nsIContent* aMenu, nsPresContext* aPresContext, nsPopupType aPopupType, PRBool aIsContextMenu, PRBool aSelectFirstItem) { nsCOMPtr presShell = aPresContext->PresShell(); // XXXndeakin (bug 383930) // eventually, the popup events will be a different event type with // additional fields for the anchor node and position and so forth. This // is where those details would be retrieved. This removes the need for // all the globals people keep adding to nsIDOMXULDocument. nsEventStatus status = nsEventStatus_eIgnore; nsMouseEvent event(PR_TRUE, NS_XUL_POPUP_SHOWING, nsnull, nsMouseEvent::eReal); // coordinates are relative to the root widget nsPresContext* rootPresContext = presShell->GetPresContext()->GetRootPresContext(); if (rootPresContext) { rootPresContext->PresShell()->GetViewManager()-> GetRootWidget(getter_AddRefs(event.widget)); } else { event.widget = nsnull; } event.refPoint = mCachedMousePoint; nsEventDispatcher::Dispatch(aPopup, aPresContext, &event, nsnull, &status); mCachedMousePoint = nsIntPoint(0, 0); // if a panel, blur whatever has focus so that the panel can take the focus. // This is done after the popupshowing event in case that event is cancelled. // Using noautofocus="true" will disable this behaviour, which is needed for // the autocomplete widget as it manages focus itself. if (aPopupType == ePopupTypePanel && !aPopup->AttrValueIs(kNameSpaceID_None, nsGkAtoms::noautofocus, nsGkAtoms::_true, eCaseMatters)) { nsIFocusManager* fm = nsFocusManager::GetFocusManager(); if (fm) { nsIDocument* doc = aPopup->GetCurrentDoc(); // Only remove the focus if the currently focused item is ouside the // popup. It isn't a big deal if the current focus is in a child popup // inside the popup as that shouldn't be visible. This check ensures that // a node inside the popup that is focused during a popupshowing event // remains focused. nsCOMPtr currentFocusElement; fm->GetFocusedElement(getter_AddRefs(currentFocusElement)); nsCOMPtr currentFocus = do_QueryInterface(currentFocusElement); if (doc && currentFocus && !nsContentUtils::ContentIsCrossDocDescendantOf(currentFocus, aPopup)) { fm->ClearFocus(doc->GetWindow()); } } } // it is common to append content to the menu during the popupshowing event. // Flush the notifications so that the frames are up to date before showing // the popup, otherwise the new frames will reflow after the popup appears, // causing the popup to flicker. Frame code always calls this asynchronously, // so this should be safe. nsIDocument *document = aPopup->GetCurrentDoc(); if (document) document->FlushPendingNotifications(Flush_Layout); // get the frame again in case it went away nsIFrame* frame = aPopup->GetPrimaryFrame(); if (frame && frame->GetType() == nsGkAtoms::menuPopupFrame) { nsMenuPopupFrame* popupFrame = static_cast(frame); // if the event was cancelled, don't open the popup, and reset it's // state back to closed if (status == nsEventStatus_eConsumeNoDefault) { popupFrame->SetPopupState(ePopupClosed); } else { ShowPopupCallback(aPopup, popupFrame, aIsContextMenu, aSelectFirstItem); } } } void nsXULPopupManager::FirePopupHidingEvent(nsIContent* aPopup, nsIContent* aNextPopup, nsIContent* aLastPopup, nsPresContext *aPresContext, nsPopupType aPopupType, PRBool aDeselectMenu) { nsCOMPtr presShell = aPresContext->PresShell(); nsEventStatus status = nsEventStatus_eIgnore; nsMouseEvent event(PR_TRUE, NS_XUL_POPUP_HIDING, nsnull, nsMouseEvent::eReal); nsEventDispatcher::Dispatch(aPopup, aPresContext, &event, nsnull, &status); // when a panel is closed, blur whatever has focus inside the popup if (aPopupType == ePopupTypePanel && !aPopup->AttrValueIs(kNameSpaceID_None, nsGkAtoms::noautofocus, nsGkAtoms::_true, eCaseMatters)) { nsIFocusManager* fm = nsFocusManager::GetFocusManager(); if (fm) { nsIDocument* doc = aPopup->GetCurrentDoc(); // Remove the focus from the focused node only if it is inside the popup. nsCOMPtr currentFocusElement; fm->GetFocusedElement(getter_AddRefs(currentFocusElement)); nsCOMPtr currentFocus = do_QueryInterface(currentFocusElement); if (doc && currentFocus && nsContentUtils::ContentIsCrossDocDescendantOf(currentFocus, aPopup)) { fm->ClearFocus(doc->GetWindow()); } } } // get frame again in case it went away nsIFrame* frame = aPopup->GetPrimaryFrame(); if (frame && frame->GetType() == nsGkAtoms::menuPopupFrame) { nsMenuPopupFrame* popupFrame = static_cast(frame); // if the event was cancelled, don't hide the popup, and reset it's // state back to open. Only popups in chrome shells can prevent a popup // from hiding. if (status == nsEventStatus_eConsumeNoDefault && !popupFrame->IsInContentShell()) { popupFrame->SetPopupState(ePopupOpenAndVisible); } else { HidePopupCallback(aPopup, popupFrame, aNextPopup, aLastPopup, aPopupType, aDeselectMenu); } } } PRBool nsXULPopupManager::IsPopupOpen(nsIContent* aPopup) { // a popup is open if it is in the open list. The assertions ensure that the // frame is in the correct state. If the popup is in the hiding or invisible // state, it will still be in the open popup list until it is closed. nsMenuChainItem* item = mPopups; while (item) { if (item->Content() == aPopup) { NS_ASSERTION(item->Frame()->IsOpen() || item->Frame()->PopupState() == ePopupHiding || item->Frame()->PopupState() == ePopupInvisible, "popup in open list not actually open"); return PR_TRUE; } item = item->GetParent(); } item = mNoHidePanels; while (item) { if (item->Content() == aPopup) { NS_ASSERTION(item->Frame()->IsOpen() || item->Frame()->PopupState() == ePopupHiding || item->Frame()->PopupState() == ePopupInvisible, "popup in open list not actually open"); return PR_TRUE; } item = item->GetParent(); } return PR_FALSE; } PRBool nsXULPopupManager::IsPopupOpenForMenuParent(nsMenuParent* aMenuParent) { nsMenuChainItem* item = GetTopVisibleMenu(); while (item) { nsMenuPopupFrame* popup = item->Frame(); if (popup && popup->IsOpen()) { nsIFrame* parent = popup->GetParent(); if (parent && parent->GetType() == nsGkAtoms::menuFrame) { nsMenuFrame* menuFrame = static_cast(parent); if (menuFrame->GetMenuParent() == aMenuParent) return PR_TRUE; } } item = item->GetParent(); } return PR_FALSE; } nsIFrame* nsXULPopupManager::GetTopPopup(nsPopupType aType) { if (aType == ePopupTypePanel && mNoHidePanels) return mNoHidePanels->Frame(); nsMenuChainItem* item = GetTopVisibleMenu(); while (item) { if (item->PopupType() == aType || aType == ePopupTypeAny) return item->Frame(); item = item->GetParent(); } return nsnull; } nsTArray nsXULPopupManager::GetVisiblePopups() { nsTArray popups; nsMenuChainItem* item = mPopups; while (item) { if (item->Frame()->PopupState() == ePopupOpenAndVisible) popups.AppendElement(static_cast(item->Frame())); item = item->GetParent(); } return popups; } PRBool nsXULPopupManager::MayShowPopup(nsMenuPopupFrame* aPopup) { // if a popup's IsOpen method returns true, then the popup must always be in // the popup chain scanned in IsPopupOpen. NS_ASSERTION(!aPopup->IsOpen() || IsPopupOpen(aPopup->GetContent()), "popup frame state doesn't match XULPopupManager open state"); nsPopupState state = aPopup->PopupState(); // if the popup is not in the open popup chain, then it must have a state that // is either closed, in the process of being shown, or invisible. NS_ASSERTION(IsPopupOpen(aPopup->GetContent()) || state == ePopupClosed || state == ePopupShowing || state == ePopupInvisible, "popup not in XULPopupManager open list is open"); // don't show popups unless they are closed or invisible if (state != ePopupClosed && state != ePopupInvisible) return PR_FALSE; // Don't show popups that we already have in our popup chain if (IsPopupOpen(aPopup->GetContent())) { NS_WARNING("Refusing to show duplicate popup"); return PR_FALSE; } // if the popup was just rolled up, don't reopen it nsCOMPtr widget; aPopup->GetWidget(getter_AddRefs(widget)); if (widget && widget->GetLastRollup() == aPopup->GetContent()) return PR_FALSE; nsCOMPtr cont = aPopup->PresContext()->GetContainer(); nsCOMPtr dsti = do_QueryInterface(cont); nsCOMPtr baseWin = do_QueryInterface(dsti); if (!baseWin) return PR_FALSE; PRInt32 type = -1; if (NS_FAILED(dsti->GetItemType(&type))) return PR_FALSE; // chrome shells can always open popups, but other types of shells can only // open popups when they are focused and visible if (type != nsIDocShellTreeItem::typeChrome) { // only allow popups in active windows nsCOMPtr root; dsti->GetRootTreeItem(getter_AddRefs(root)); nsCOMPtr rootWin = do_GetInterface(root); nsIFocusManager* fm = nsFocusManager::GetFocusManager(); if (!fm || !rootWin) return PR_FALSE; nsCOMPtr activeWindow; fm->GetActiveWindow(getter_AddRefs(activeWindow)); if (activeWindow != rootWin) return PR_FALSE; // only allow popups in visible frames PRBool visible; baseWin->GetVisibility(&visible); if (!visible) return PR_FALSE; } // platforms respond differently when an popup is opened in a minimized // window, so this is always disabled. nsCOMPtr mainWidget; baseWin->GetMainWidget(getter_AddRefs(mainWidget)); if (mainWidget) { PRInt32 sizeMode; mainWidget->GetSizeMode(&sizeMode); if (sizeMode == nsSizeMode_Minimized) return PR_FALSE; } // cannot open a popup that is a submenu of a menupopup that isn't open. nsIFrame* parent = aPopup->GetParent(); if (parent && parent->GetType() == nsGkAtoms::menuFrame) { nsMenuFrame* menuFrame = static_cast(parent); nsMenuParent* parentPopup = menuFrame->GetMenuParent(); if (parentPopup && !parentPopup->IsOpen()) return PR_FALSE; } return PR_TRUE; } void nsXULPopupManager::PopupDestroyed(nsMenuPopupFrame* aPopup) { // when a popup frame is destroyed, just unhook it from the list of popups if (mTimerMenu == aPopup) { if (mCloseTimer) { mCloseTimer->Cancel(); mCloseTimer = nsnull; } mTimerMenu = nsnull; } nsMenuChainItem* item = mNoHidePanels; while (item) { if (item->Frame() == aPopup) { item->Detach(&mNoHidePanels); delete item; break; } item = item->GetParent(); } nsTArray popupsToHide; item = mPopups; while (item) { nsMenuPopupFrame* frame = item->Frame(); if (frame == aPopup) { if (frame->PopupState() != ePopupInvisible) { // Iterate through any child menus and hide them as well, since the // parent is going away. We won't remove them from the list yet, just // hide them, as they will be removed from the list when this function // gets called for that child frame. nsMenuChainItem* child = item->GetChild(); while (child) { // if the popup is a child frame of the menu that was destroyed, add // it to the list of popups to hide. Don't bother with the events // since the frames are going away. If the child menu is not a child // frame, for example, a context menu, use HidePopup instead, but call // it asynchronously since we are in the middle of frame destruction. nsMenuPopupFrame* childframe = child->Frame(); if (nsLayoutUtils::IsProperAncestorFrame(frame, childframe)) { popupsToHide.AppendElement(childframe); } else { // HidePopup will take care of hiding any of its children, so // break out afterwards HidePopup(child->Content(), PR_FALSE, PR_FALSE, PR_TRUE); break; } child = child->GetChild(); } } item->Detach(&mPopups); delete item; break; } item = item->GetParent(); } HidePopupsInList(popupsToHide, PR_FALSE); } PRBool nsXULPopupManager::HasContextMenu(nsMenuPopupFrame* aPopup) { nsMenuChainItem* item = GetTopVisibleMenu(); while (item && item->Frame() != aPopup) { if (item->IsContextMenu()) return PR_TRUE; item = item->GetParent(); } return PR_FALSE; } void nsXULPopupManager::SetCaptureState(nsIContent* aOldPopup) { nsMenuChainItem* item = GetTopVisibleMenu(); if (item && aOldPopup == item->Content()) return; if (mWidget) { mWidget->CaptureRollupEvents(this, this, PR_FALSE, PR_FALSE); mWidget = nsnull; } if (item) { nsMenuPopupFrame* popup = item->Frame(); nsCOMPtr widget; popup->GetWidget(getter_AddRefs(widget)); if (widget) { widget->CaptureRollupEvents(this, this, PR_TRUE, popup->ConsumeOutsideClicks()); mWidget = widget; popup->AttachedDismissalListener(); } } UpdateKeyboardListeners(); } void nsXULPopupManager::UpdateKeyboardListeners() { nsCOMPtr newTarget; PRBool isForMenu = PR_FALSE; nsMenuChainItem* item = GetTopVisibleMenu(); if (item) { if (!item->IgnoreKeys()) newTarget = do_QueryInterface(item->Content()->GetDocument()); isForMenu = item->PopupType() == ePopupTypeMenu; } else if (mActiveMenuBar) { newTarget = do_QueryInterface(mActiveMenuBar->GetContent()->GetDocument()); isForMenu = PR_TRUE; } if (mKeyListener != newTarget) { if (mKeyListener) { mKeyListener->RemoveEventListener(NS_LITERAL_STRING("keypress"), this, PR_TRUE); mKeyListener->RemoveEventListener(NS_LITERAL_STRING("keydown"), this, PR_TRUE); mKeyListener->RemoveEventListener(NS_LITERAL_STRING("keyup"), this, PR_TRUE); mKeyListener = nsnull; nsContentUtils::NotifyInstalledMenuKeyboardListener(PR_FALSE); } if (newTarget) { newTarget->AddEventListener(NS_LITERAL_STRING("keypress"), this, PR_TRUE); newTarget->AddEventListener(NS_LITERAL_STRING("keydown"), this, PR_TRUE); newTarget->AddEventListener(NS_LITERAL_STRING("keyup"), this, PR_TRUE); nsContentUtils::NotifyInstalledMenuKeyboardListener(isForMenu); mKeyListener = newTarget; } } } void nsXULPopupManager::UpdateMenuItems(nsIContent* aPopup) { // Walk all of the menu's children, checking to see if any of them has a // command attribute. If so, then several attributes must potentially be updated. nsCOMPtr domDoc(do_QueryInterface(aPopup->GetDocument())); PRUint32 count = aPopup->GetChildCount(); for (PRUint32 i = 0; i < count; i++) { nsCOMPtr grandChild = aPopup->GetChildAt(i); if (grandChild->NodeInfo()->Equals(nsGkAtoms::menuitem, kNameSpaceID_XUL)) { // See if we have a command attribute. nsAutoString command; grandChild->GetAttr(kNameSpaceID_None, nsGkAtoms::command, command); if (!command.IsEmpty()) { // We do! Look it up in our document nsCOMPtr commandElt; domDoc->GetElementById(command, getter_AddRefs(commandElt)); nsCOMPtr commandContent(do_QueryInterface(commandElt)); if (commandContent) { nsAutoString commandValue; // The menu's disabled state needs to be updated to match the command. if (commandContent->GetAttr(kNameSpaceID_None, nsGkAtoms::disabled, commandValue)) grandChild->SetAttr(kNameSpaceID_None, nsGkAtoms::disabled, commandValue, PR_TRUE); else grandChild->UnsetAttr(kNameSpaceID_None, nsGkAtoms::disabled, PR_TRUE); // The menu's label, accesskey and checked states need to be updated // to match the command. Note that unlike the disabled state if the // command has *no* value, we assume the menu is supplying its own. if (commandContent->GetAttr(kNameSpaceID_None, nsGkAtoms::label, commandValue)) grandChild->SetAttr(kNameSpaceID_None, nsGkAtoms::label, commandValue, PR_TRUE); if (commandContent->GetAttr(kNameSpaceID_None, nsGkAtoms::accesskey, commandValue)) grandChild->SetAttr(kNameSpaceID_None, nsGkAtoms::accesskey, commandValue, PR_TRUE); if (commandContent->GetAttr(kNameSpaceID_None, nsGkAtoms::checked, commandValue)) grandChild->SetAttr(kNameSpaceID_None, nsGkAtoms::checked, commandValue, PR_TRUE); } } } } } // Notify // // The item selection timer has fired, we might have to readjust the // selected item. There are two cases here that we are trying to deal with: // (1) diagonal movement from a parent menu to a submenu passing briefly over // other items, and // (2) moving out from a submenu to a parent or grandparent menu. // In both cases, |mTimerMenu| is the menu item that might have an open submenu and // the first item in |mPopups| is the item the mouse is currently over, which could be // none of them. // // case (1): // As the mouse moves from the parent item of a submenu (we'll call 'A') diagonally into the // submenu, it probably passes through one or more sibilings (B). As the mouse passes // through B, it becomes the current menu item and the timer is set and mTimerMenu is // set to A. Before the timer fires, the mouse leaves the menu containing A and B and // enters the submenus. Now when the timer fires, |mPopups| is null (!= |mTimerMenu|) // so we have to see if anything in A's children is selected (recall that even disabled // items are selected, the style just doesn't show it). If that is the case, we need to // set the selected item back to A. // // case (2); // Item A has an open submenu, and in it there is an item (B) which also has an open // submenu (so there are 3 menus displayed right now). The mouse then leaves B's child // submenu and selects an item that is a sibling of A, call it C. When the mouse enters C, // the timer is set and |mTimerMenu| is A and |mPopups| is C. As the timer fires, // the mouse is still within C. The correct behavior is to set the current item to C // and close up the chain parented at A. // // This brings up the question of is the logic of case (1) enough? The answer is no, // and is discussed in bugzilla bug 29400. Case (1) asks if A's submenu has a selected // child, and if it does, set the selected item to A. Because B has a submenu open, it // is selected and as a result, A is set to be the selected item even though the mouse // rests in C -- very wrong. // // The solution is to use the same idea, but instead of only checking one level, // drill all the way down to the deepest open submenu and check if it has something // selected. Since the mouse is in a grandparent, it won't, and we know that we can // safely close up A and all its children. // // The code below melds the two cases together. // nsresult nsXULPopupManager::Notify(nsITimer* aTimer) { if (aTimer == mCloseTimer) KillMenuTimer(); return NS_OK; } void nsXULPopupManager::KillMenuTimer() { if (mCloseTimer && mTimerMenu) { mCloseTimer->Cancel(); mCloseTimer = nsnull; if (mTimerMenu->IsOpen()) HidePopup(mTimerMenu->GetContent(), PR_FALSE, PR_FALSE, PR_TRUE); } mTimerMenu = nsnull; } void nsXULPopupManager::CancelMenuTimer(nsMenuParent* aMenuParent) { if (mCloseTimer && mTimerMenu == aMenuParent) { mCloseTimer->Cancel(); mCloseTimer = nsnull; mTimerMenu = nsnull; } } PRBool nsXULPopupManager::HandleShortcutNavigation(nsIDOMKeyEvent* aKeyEvent, nsMenuPopupFrame* aFrame) { nsMenuChainItem* item = GetTopVisibleMenu(); if (!aFrame && item) aFrame = item->Frame(); if (aFrame) { PRBool action; nsMenuFrame* result = aFrame->FindMenuWithShortcut(aKeyEvent, action); if (result) { aFrame->ChangeMenuItem(result, PR_FALSE); if (action) { nsMenuFrame* menuToOpen = result->Enter(); if (menuToOpen) { nsCOMPtr content = menuToOpen->GetContent(); ShowMenu(content, PR_TRUE, PR_FALSE); } } return PR_TRUE; } return PR_FALSE; } if (mActiveMenuBar) { nsMenuFrame* result = mActiveMenuBar->FindMenuWithShortcut(aKeyEvent); if (result) { mActiveMenuBar->SetActive(PR_TRUE); result->OpenMenu(PR_TRUE); return PR_TRUE; } } return PR_FALSE; } PRBool nsXULPopupManager::HandleKeyboardNavigation(PRUint32 aKeyCode) { // navigate up through the open menus, looking for the topmost one // in the same hierarchy nsMenuChainItem* item = nsnull; nsMenuChainItem* nextitem = GetTopVisibleMenu(); while (nextitem) { item = nextitem; nextitem = item->GetParent(); if (nextitem) { // stop if the parent isn't a menu if (!nextitem->IsMenu()) break; // check to make sure that the parent is actually the parent menu. It won't // be if the parent is in a different frame hierarchy, for example, for a // context menu opened on another menu. nsMenuParent* expectedParent = static_cast(nextitem->Frame()); nsIFrame* parent = item->Frame()->GetParent(); if (parent && parent->GetType() == nsGkAtoms::menuFrame) { nsMenuFrame* menuFrame = static_cast(parent); if (menuFrame->GetMenuParent() != expectedParent) break; } else { break; } } } nsIFrame* itemFrame; if (item) itemFrame = item->Frame(); else if (mActiveMenuBar) itemFrame = mActiveMenuBar; else return PR_FALSE; nsNavigationDirection theDirection; NS_ASSERTION(aKeyCode >= NS_VK_END && aKeyCode <= NS_VK_DOWN, "Illegal key code"); theDirection = NS_DIRECTION_FROM_KEY_CODE(itemFrame, aKeyCode); // if a popup is open, first check for navigation within the popup if (item && HandleKeyboardNavigationInPopup(item, theDirection)) return PR_TRUE; // no popup handled the key, so check the active menubar, if any if (mActiveMenuBar) { nsMenuFrame* currentMenu = mActiveMenuBar->GetCurrentMenuItem(); if (NS_DIRECTION_IS_INLINE(theDirection)) { nsMenuFrame* nextItem = (theDirection == eNavigationDirection_End) ? GetNextMenuItem(mActiveMenuBar, currentMenu, PR_FALSE) : GetPreviousMenuItem(mActiveMenuBar, currentMenu, PR_FALSE); mActiveMenuBar->ChangeMenuItem(nextItem, PR_TRUE); return PR_TRUE; } else if (NS_DIRECTION_IS_BLOCK(theDirection)) { // Open the menu and select its first item. if (currentMenu) { nsCOMPtr content = currentMenu->GetContent(); ShowMenu(content, PR_TRUE, PR_FALSE); } return PR_TRUE; } } return PR_FALSE; } PRBool nsXULPopupManager::HandleKeyboardNavigationInPopup(nsMenuChainItem* item, nsMenuPopupFrame* aFrame, nsNavigationDirection aDir) { NS_ASSERTION(aFrame, "aFrame is null"); NS_ASSERTION(!item || item->Frame() == aFrame, "aFrame is expected to be equal to item->Frame()"); nsMenuFrame* currentMenu = aFrame->GetCurrentMenuItem(); aFrame->ClearIncrementalString(); // This method only gets called if we're open. if (!currentMenu && NS_DIRECTION_IS_INLINE(aDir)) { // We've been opened, but we haven't had anything selected. // We can handle End, but our parent handles Start. if (aDir == eNavigationDirection_End) { nsMenuFrame* nextItem = GetNextMenuItem(aFrame, nsnull, PR_TRUE); if (nextItem) { aFrame->ChangeMenuItem(nextItem, PR_FALSE); return PR_TRUE; } } return PR_FALSE; } PRBool isContainer = PR_FALSE; PRBool isOpen = PR_FALSE; if (currentMenu) { isOpen = currentMenu->IsOpen(); isContainer = currentMenu->IsMenu(); if (isOpen) { // for an open popup, have the child process the event nsMenuChainItem* child = item ? item->GetChild() : nsnull; if (child && HandleKeyboardNavigationInPopup(child, aDir)) return PR_TRUE; } else if (aDir == eNavigationDirection_End && isContainer && !currentMenu->IsDisabled()) { // The menu is not yet open. Open it and select the first item. nsCOMPtr content = currentMenu->GetContent(); ShowMenu(content, PR_TRUE, PR_FALSE); return PR_TRUE; } } // For block progression, we can move in either direction if (NS_DIRECTION_IS_BLOCK(aDir) || NS_DIRECTION_IS_BLOCK_TO_EDGE(aDir)) { nsMenuFrame* nextItem; if (aDir == eNavigationDirection_Before) nextItem = GetPreviousMenuItem(aFrame, currentMenu, PR_TRUE); else if (aDir == eNavigationDirection_After) nextItem = GetNextMenuItem(aFrame, currentMenu, PR_TRUE); else if (aDir == eNavigationDirection_First) nextItem = GetNextMenuItem(aFrame, nsnull, PR_TRUE); else nextItem = GetPreviousMenuItem(aFrame, nsnull, PR_TRUE); if (nextItem) { aFrame->ChangeMenuItem(nextItem, PR_FALSE); return PR_TRUE; } } else if (currentMenu && isContainer && isOpen) { if (aDir == eNavigationDirection_Start) { // close a submenu when Left is pressed nsMenuPopupFrame* popupFrame = currentMenu->GetPopup(); if (popupFrame) HidePopup(popupFrame->GetContent(), PR_FALSE, PR_FALSE, PR_FALSE); return PR_TRUE; } } return PR_FALSE; } nsMenuFrame* nsXULPopupManager::GetNextMenuItem(nsIFrame* aParent, nsMenuFrame* aStart, PRBool aIsPopup) { nsIFrame* immediateParent = nsnull; nsPresContext* presContext = aParent->PresContext(); presContext->PresShell()-> FrameConstructor()->GetInsertionPoint(aParent, nsnull, &immediateParent); if (!immediateParent) immediateParent = aParent; nsIFrame* currFrame = nsnull; if (aStart) currFrame = aStart->GetNextSibling(); else currFrame = immediateParent->GetFirstChild(nsnull); while (currFrame) { // See if it's a menu item. if (IsValidMenuItem(presContext, currFrame->GetContent(), aIsPopup)) { return (currFrame->GetType() == nsGkAtoms::menuFrame) ? static_cast(currFrame) : nsnull; } currFrame = currFrame->GetNextSibling(); } currFrame = immediateParent->GetFirstChild(nsnull); // Still don't have anything. Try cycling from the beginning. while (currFrame && currFrame != aStart) { // See if it's a menu item. if (IsValidMenuItem(presContext, currFrame->GetContent(), aIsPopup)) { return (currFrame->GetType() == nsGkAtoms::menuFrame) ? static_cast(currFrame) : nsnull; } currFrame = currFrame->GetNextSibling(); } // No luck. Just return our start value. return aStart; } nsMenuFrame* nsXULPopupManager::GetPreviousMenuItem(nsIFrame* aParent, nsMenuFrame* aStart, PRBool aIsPopup) { nsIFrame* immediateParent = nsnull; nsPresContext* presContext = aParent->PresContext(); presContext->PresShell()-> FrameConstructor()->GetInsertionPoint(aParent, nsnull, &immediateParent); if (!immediateParent) immediateParent = aParent; const nsFrameList& frames(immediateParent->GetChildList(nsnull)); nsIFrame* currFrame = nsnull; if (aStart) currFrame = aStart->GetPrevSibling(); else currFrame = frames.LastChild(); while (currFrame) { // See if it's a menu item. if (IsValidMenuItem(presContext, currFrame->GetContent(), aIsPopup)) { return (currFrame->GetType() == nsGkAtoms::menuFrame) ? static_cast(currFrame) : nsnull; } currFrame = currFrame->GetPrevSibling(); } currFrame = frames.LastChild(); // Still don't have anything. Try cycling from the end. while (currFrame && currFrame != aStart) { // See if it's a menu item. if (IsValidMenuItem(presContext, currFrame->GetContent(), aIsPopup)) { return (currFrame->GetType() == nsGkAtoms::menuFrame) ? static_cast(currFrame) : nsnull; } currFrame = currFrame->GetPrevSibling(); } // No luck. Just return our start value. return aStart; } PRBool nsXULPopupManager::IsValidMenuItem(nsPresContext* aPresContext, nsIContent* aContent, PRBool aOnPopup) { PRInt32 ns = aContent->GetNameSpaceID(); nsIAtom *tag = aContent->Tag(); if (ns == kNameSpaceID_XUL) { if (tag != nsGkAtoms::menu && tag != nsGkAtoms::menuitem) return PR_FALSE; } else if (ns != kNameSpaceID_XHTML || !aOnPopup || tag != nsGkAtoms::option) { return PR_FALSE; } PRBool skipNavigatingDisabledMenuItem = PR_TRUE; if (aOnPopup) { aPresContext->LookAndFeel()-> GetMetric(nsILookAndFeel::eMetric_SkipNavigatingDisabledMenuItem, skipNavigatingDisabledMenuItem); } return !(skipNavigatingDisabledMenuItem && aContent->AttrValueIs(kNameSpaceID_None, nsGkAtoms::disabled, nsGkAtoms::_true, eCaseMatters)); } nsresult nsXULPopupManager::KeyUp(nsIDOMEvent* aKeyEvent) { // don't do anything if a menu isn't open or a menubar isn't active if (!mActiveMenuBar) { nsMenuChainItem* item = GetTopVisibleMenu(); if (!item || item->PopupType() != ePopupTypeMenu) return NS_OK; } aKeyEvent->StopPropagation(); aKeyEvent->PreventDefault(); return NS_OK; // I am consuming event } nsresult nsXULPopupManager::KeyDown(nsIDOMEvent* aKeyEvent) { nsMenuChainItem* item = GetTopVisibleMenu(); if (item && item->Frame()->IsMenuLocked()) return NS_OK; // don't do anything if a menu isn't open or a menubar isn't active if (!mActiveMenuBar && (!item || item->PopupType() != ePopupTypeMenu)) return NS_OK; PRInt32 menuAccessKey = -1; // If the key just pressed is the access key (usually Alt), // dismiss and unfocus the menu. nsMenuBarListener::GetMenuAccessKey(&menuAccessKey); if (menuAccessKey) { PRUint32 theChar; nsCOMPtr keyEvent = do_QueryInterface(aKeyEvent); keyEvent->GetKeyCode(&theChar); if (theChar == (PRUint32)menuAccessKey) { PRBool ctrl = PR_FALSE; if (menuAccessKey != nsIDOMKeyEvent::DOM_VK_CONTROL) keyEvent->GetCtrlKey(&ctrl); PRBool alt=PR_FALSE; if (menuAccessKey != nsIDOMKeyEvent::DOM_VK_ALT) keyEvent->GetAltKey(&alt); PRBool shift=PR_FALSE; if (menuAccessKey != nsIDOMKeyEvent::DOM_VK_SHIFT) keyEvent->GetShiftKey(&shift); PRBool meta=PR_FALSE; if (menuAccessKey != nsIDOMKeyEvent::DOM_VK_META) keyEvent->GetMetaKey(&meta); if (!(ctrl || alt || shift || meta)) { // The access key just went down and no other // modifiers are already down. if (mPopups) Rollup(nsnull, nsnull); else if (mActiveMenuBar) mActiveMenuBar->MenuClosed(); } } } // Since a menu was open, eat the event to keep other event // listeners from becoming confused. aKeyEvent->StopPropagation(); aKeyEvent->PreventDefault(); return NS_OK; // I am consuming event } nsresult nsXULPopupManager::KeyPress(nsIDOMEvent* aKeyEvent) { // Don't check prevent default flag -- menus always get first shot at key events. // When a menu is open, the prevent default flag on a keypress is always set, so // that no one else uses the key event. nsMenuChainItem* item = GetTopVisibleMenu(); if (item && item->Frame()->IsMenuLocked()) return NS_OK; //handlers shouldn't be triggered by non-trusted events. nsCOMPtr domNSEvent = do_QueryInterface(aKeyEvent); PRBool trustedEvent = PR_FALSE; if (domNSEvent) { domNSEvent->GetIsTrusted(&trustedEvent); } if (!trustedEvent) return NS_OK; nsCOMPtr keyEvent = do_QueryInterface(aKeyEvent); PRUint32 theChar; keyEvent->GetKeyCode(&theChar); // Escape should close panels, but the other keys should have no effect. if (item && item->PopupType() != ePopupTypeMenu) { if (theChar == NS_VK_ESCAPE) { HidePopup(item->Content(), PR_FALSE, PR_FALSE, PR_FALSE); aKeyEvent->StopPropagation(); aKeyEvent->PreventDefault(); } return NS_OK; } // if a menu is open or a menubar is active, it consumes the key event PRBool consume = (mPopups || mActiveMenuBar); if (theChar == NS_VK_LEFT || theChar == NS_VK_RIGHT || theChar == NS_VK_UP || theChar == NS_VK_DOWN || theChar == NS_VK_HOME || theChar == NS_VK_END) { HandleKeyboardNavigation(theChar); } else if (theChar == NS_VK_ESCAPE) { // Pressing Escape hides one level of menus only. If no menu is open, // check if a menubar is active and inform it that a menu closed. Even // though in this latter case, a menu didn't actually close, the effect // ends up being the same. Similar for the tab key below. if (item) HidePopup(item->Content(), PR_FALSE, PR_FALSE, PR_FALSE); else if (mActiveMenuBar) mActiveMenuBar->MenuClosed(); } else if (theChar == NS_VK_TAB #ifndef XP_MACOSX || theChar == NS_VK_F10 #endif ) { // close popups or deactivate menubar when Tab or F10 are pressed if (item) Rollup(nsnull, nsnull); else if (mActiveMenuBar) mActiveMenuBar->MenuClosed(); } else if (theChar == NS_VK_ENTER || theChar == NS_VK_RETURN) { // If there is a popup open, check if the current item needs to be opened. // Otherwise, tell the active menubar, if any, to activate the menu. The // Enter method will return a menu if one needs to be opened as a result. nsMenuFrame* menuToOpen = nsnull; nsMenuChainItem* item = GetTopVisibleMenu(); if (item) menuToOpen = item->Frame()->Enter(); else if (mActiveMenuBar) menuToOpen = mActiveMenuBar->Enter(); if (menuToOpen) { nsCOMPtr content = menuToOpen->GetContent(); ShowMenu(content, PR_TRUE, PR_FALSE); } } else { HandleShortcutNavigation(keyEvent, nsnull); } if (consume) { aKeyEvent->StopPropagation(); aKeyEvent->PreventDefault(); } return NS_OK; // I am consuming event } static nsPresContext* GetPresContextFor(nsIContent* aContent) { nsIDocument *document = aContent->GetCurrentDoc(); if (document) { nsIPresShell* presShell = document->GetPrimaryShell(); if (presShell) return presShell->GetPresContext(); } return nsnull; } NS_IMETHODIMP nsXULPopupShowingEvent::Run() { nsXULPopupManager* pm = nsXULPopupManager::GetInstance(); nsPresContext* context = GetPresContextFor(mPopup); if (pm && context) { pm->FirePopupShowingEvent(mPopup, mMenu, context, mPopupType, mIsContextMenu, mSelectFirstItem); } return NS_OK; } NS_IMETHODIMP nsXULPopupHidingEvent::Run() { nsXULPopupManager* pm = nsXULPopupManager::GetInstance(); nsPresContext* context = GetPresContextFor(mPopup); if (pm && context) { pm->FirePopupHidingEvent(mPopup, mNextPopup, mLastPopup, context, mPopupType, mDeselectMenu); } return NS_OK; } NS_IMETHODIMP nsXULMenuCommandEvent::Run() { nsXULPopupManager* pm = nsXULPopupManager::GetInstance(); if (!pm) return NS_OK; // The order of the nsIViewManager and nsIPresShell COM pointers is // important below. We want the pres shell to get released before the // associated view manager on exit from this function. // See bug 54233. // XXXndeakin is this still needed? nsCOMPtr popup; nsMenuFrame* menuFrame = pm->GetMenuFrameForContent(mMenu); nsWeakFrame weakFrame(menuFrame); if (menuFrame && mFlipChecked) { if (menuFrame->IsChecked()) { mMenu->UnsetAttr(kNameSpaceID_None, nsGkAtoms::checked, PR_TRUE); } else { mMenu->SetAttr(kNameSpaceID_None, nsGkAtoms::checked, NS_LITERAL_STRING("true"), PR_TRUE); } } if (menuFrame && weakFrame.IsAlive()) { // Find the popup that the menu is inside. Below, this popup will // need to be hidden. nsIFrame* popupFrame = menuFrame->GetParent(); while (popupFrame) { if (popupFrame->GetType() == nsGkAtoms::menuPopupFrame) { popup = popupFrame->GetContent(); break; } popupFrame = popupFrame->GetParent(); } nsPresContext* presContext = menuFrame->PresContext(); nsCOMPtr shell = presContext->PresShell(); nsCOMPtr kungFuDeathGrip = shell->GetViewManager(); // Deselect ourselves. if (mCloseMenuMode != CloseMenuMode_None) menuFrame->SelectMenu(PR_FALSE); nsAutoHandlingUserInputStatePusher userInpStatePusher(mUserInput, PR_FALSE); nsContentUtils::DispatchXULCommand(mMenu, mIsTrusted, nsnull, shell, mControl, mAlt, mShift, mMeta); } if (popup && mCloseMenuMode != CloseMenuMode_None) pm->HidePopup(popup, mCloseMenuMode == CloseMenuMode_Auto, PR_TRUE, PR_FALSE); return NS_OK; } nsresult NS_NewXULPopupManager(nsISupports** aResult) { nsXULPopupManager* pm = nsXULPopupManager::GetInstance(); NS_IF_ADDREF(pm); *aResult = static_cast(pm); return NS_OK; }