Mercurial > libervia-web
view src/browser/sat_browser/base_panel.py @ 685:9877607c719a
2015 copyright dates update
author | Goffi <goffi@goffi.org> |
---|---|
date | Mon, 30 Mar 2015 10:28:47 +0200 |
parents | 6d3142b782c3 |
children | e4ae8e2b0afd |
line wrap: on
line source
#!/usr/bin/python # -*- coding: utf-8 -*- # Libervia: a Salut à Toi frontend # Copyright (C) 2011, 2012, 2013, 2014, 2015 Jérôme Poisson <goffi@goffi.org> # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # You should have received a copy of the GNU Affero General Public License # along with this program. If not, see <http://www.gnu.org/licenses/>. from sat.core.log import getLogger log = getLogger(__name__) from sat.core.i18n import _ from pyjamas.ui.VerticalPanel import VerticalPanel from pyjamas.ui.HorizontalPanel import HorizontalPanel from pyjamas.ui.ScrollPanel import ScrollPanel from pyjamas.ui.Button import Button from pyjamas.ui.SimplePanel import SimplePanel from pyjamas.ui.PopupPanel import PopupPanel from pyjamas.ui.StackPanel import StackPanel from pyjamas.ui.TextArea import TextArea from pyjamas.ui.Event import BUTTON_LEFT, BUTTON_MIDDLE, BUTTON_RIGHT from pyjamas import DOM ### Menus ### class PopupMenuPanel(PopupPanel): """This implementation of a popup menu (context menu) allow you to assign two special methods which are common to all the items, in order to hide certain items and also easily define their callbacks. The menu can be bound to any of the mouse button (left, middle, right). """ def __init__(self, entries, hide=None, callback=None, vertical=True, style=None, **kwargs): """ @param entries: a dict of dicts, where each sub-dict is representing one menu item: the sub-dict key can be used as the item text and description, but optional "title" and "desc" entries would be used if they exists. The sub-dicts may be extended later to do more complicated stuff or overwrite the common methods. @param hide: function with 2 args: widget, key as string and returns True if that item should be hidden from the context menu. @param callback: function with 2 args: sender, key as string @param vertical: True or False, to set the direction @param item_style: alternative CSS class for the menu items @param menu_style: supplementary CSS class for the sender widget """ PopupPanel.__init__(self, autoHide=True, **kwargs) self._entries = entries self._hide = hide self._callback = callback self.vertical = vertical self.style = {"selected": None, "menu": "itemKeyMenu", "item": "popupMenuItem"} if isinstance(style, dict): self.style.update(style) self._senders = {} def _show(self, sender): """Popup the menu relative to this sender's position. @param sender: the widget that has been clicked """ menu = VerticalPanel() if self.vertical is True else HorizontalPanel() menu.setStyleName(self.style["menu"]) def button_cb(item): """You can not put that method in the loop and rely on _key, because it is overwritten by each step. You can rely on item.key instead, which is copied from _key after the item creation. @param item: the menu item that has been clicked """ if self._callback is not None: self._callback(sender=sender, key=item.key) self.hide(autoClosed=True) for _key in self._entries.keys(): entry = self._entries[_key] if self._hide is not None and self._hide(sender=sender, key=_key) is True: continue title = entry["title"] if "title" in entry.keys() else _key item = Button(title, button_cb) item.key = _key item.setStyleName(self.style["item"]) item.setTitle(entry["desc"] if "desc" in entry.keys() else title) menu.add(item) if len(menu.getChildren()) == 0: return self.add(menu) if self.vertical is True: x = sender.getAbsoluteLeft() + sender.getOffsetWidth() y = sender.getAbsoluteTop() else: x = sender.getAbsoluteLeft() y = sender.getAbsoluteTop() + sender.getOffsetHeight() self.setPopupPosition(x, y) self.show() if self.style["selected"]: sender.addStyleDependentName(self.style["selected"]) def _onHide(popup): if self.style["selected"]: sender.removeStyleDependentName(self.style["selected"]) return PopupPanel.onHideImpl(self, popup) self.onHideImpl = _onHide def registerClickSender(self, sender, button=BUTTON_LEFT): """Bind the menu to the specified sender. @param sender: the widget to which the menu should be bound @param: BUTTON_LEFT, BUTTON_MIDDLE or BUTTON_RIGHT """ self._senders.setdefault(sender, []) self._senders[sender].append(button) if button == BUTTON_RIGHT: # WARNING: to disable the context menu is a bit tricky... # The following seems to work on Firefox 24.0, but: # TODO: find a cleaner way to disable the context menu sender.getElement().setAttribute("oncontextmenu", "return false") def _onBrowserEvent(event): button = DOM.eventGetButton(event) if DOM.eventGetType(event) == "mousedown" and button in self._senders[sender]: self._show(sender) return sender.__class__.onBrowserEvent(sender, event) sender.onBrowserEvent = _onBrowserEvent def registerMiddleClickSender(self, sender): self.registerClickSender(sender, BUTTON_MIDDLE) def registerRightClickSender(self, sender): self.registerClickSender(sender, BUTTON_RIGHT) ### Generic panels ### class ToggleStackPanel(StackPanel): """This is a pyjamas.ui.StackPanel with modified behavior. All sub-panels ca be visible at the same time, clicking a sub-panel header will not display it and hide the others but only toggle its own visibility. The argument 'visibleStack' is ignored. Note that the argument 'visible' has been added to listener's 'onStackChanged' method. """ def __init__(self, **kwargs): StackPanel.__init__(self, **kwargs) def onBrowserEvent(self, event): if DOM.eventGetType(event) == "click": index = self.getDividerIndex(DOM.eventGetTarget(event)) if index != -1: self.toggleStack(index) def add(self, widget, stackText="", asHTML=False, visible=False): StackPanel.add(self, widget, stackText, asHTML) self.setStackVisible(self.getWidgetCount() - 1, visible) def toggleStack(self, index): if index >= self.getWidgetCount(): return visible = not self.getWidget(index).getVisible() self.setStackVisible(index, visible) for listener in self.stackListeners: listener.onStackChanged(self, index, visible) class TitlePanel(ToggleStackPanel): """A toggle panel to set the message title""" def __init__(self): ToggleStackPanel.__init__(self, Width="100%") self.text_area = TextArea() self.add(self.text_area, _("Title")) self.addStackChangeListener(self) def onStackChanged(self, sender, index, visible=None): if visible is None: visible = sender.getWidget(index).getVisible() text = self.text_area.getText() suffix = "" if (visible or not text) else (": %s" % text) sender.setStackText(index, _("Title") + suffix) def getText(self): return self.text_area.getText() def setText(self, text): self.text_area.setText(text) class ScrollPanelWrapper(SimplePanel): """Scroll Panel like component, wich use the full available space to work around percent size issue, it use some of the ideas found here: http://code.google.com/p/google-web-toolkit/issues/detail?id=316 specially in code given at comment #46, thanks to Stefan Bachert""" def __init__(self, *args, **kwargs): SimplePanel.__init__(self) self.spanel = ScrollPanel(*args, **kwargs) SimplePanel.setWidget(self, self.spanel) DOM.setStyleAttribute(self.getElement(), "position", "relative") DOM.setStyleAttribute(self.getElement(), "top", "0px") DOM.setStyleAttribute(self.getElement(), "left", "0px") DOM.setStyleAttribute(self.getElement(), "width", "100%") DOM.setStyleAttribute(self.getElement(), "height", "100%") DOM.setStyleAttribute(self.spanel.getElement(), "position", "absolute") DOM.setStyleAttribute(self.spanel.getElement(), "width", "100%") DOM.setStyleAttribute(self.spanel.getElement(), "height", "100%") def setWidget(self, widget): self.spanel.setWidget(widget) def setScrollPosition(self, position): self.spanel.setScrollPosition(position) def scrollToBottom(self): self.setScrollPosition(self.spanel.getElement().scrollHeight)