Mercurial > libervia-desktop-kivy
annotate cagou/core/menu.py @ 329:51520ce98154
common_widgets (DelayedBoxLayout), chat: don't delay layout on new message:
DelayedBoxLayout has a new `dont_delay_next_layouts` property to skip delaying for the
next X sizing. This is used in chat widget to avoid unpleasant flickering when a new
message is sent or received.
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Fri, 20 Dec 2019 12:29:37 +0100 |
| parents | b77792cc6d12 |
| children | 9c6fe392d623 |
| rev | line source |
|---|---|
| 51 | 1 #!/usr/bin/python |
| 2 # -*- coding: utf-8 -*- | |
| 3 | |
| 4 # Cagou: desktop/mobile frontend for Salut à Toi XMPP client | |
| 282 | 5 # Copyright (C) 2016-2019 Jérôme Poisson (goffi@goffi.org) |
| 51 | 6 |
| 7 # This program is free software: you can redistribute it and/or modify | |
| 8 # it under the terms of the GNU Affero General Public License as published by | |
| 9 # the Free Software Foundation, either version 3 of the License, or | |
| 10 # (at your option) any later version. | |
| 11 | |
| 12 # This program is distributed in the hope that it will be useful, | |
| 13 # but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
| 15 # GNU Affero General Public License for more details. | |
| 16 | |
| 17 # You should have received a copy of the GNU Affero General Public License | |
| 18 # along with this program. If not, see <http://www.gnu.org/licenses/>. | |
| 19 | |
| 20 | |
| 21 from sat.core.i18n import _ | |
| 22 from sat.core import log as logging | |
| 23 from cagou.core.constants import Const as C | |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
24 from cagou.core.common import JidToggle |
|
85
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
25 from kivy.uix.boxlayout import BoxLayout |
| 51 | 26 from kivy.uix.label import Label |
| 27 from kivy.uix.popup import Popup | |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
28 from cagou.core.utils import FilterBehavior |
| 51 | 29 from kivy import properties |
|
327
b77792cc6d12
use Kivy garden's new infrastructure for modernmenu and contextmenu:
Goffi <goffi@goffi.org>
parents:
322
diff
changeset
|
30 from kivy_garden import contextmenu, modernmenu |
| 51 | 31 from sat_frontends.quick_frontend import quick_menus |
|
168
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
32 from kivy.core.window import Window |
|
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
33 from kivy.animation import Animation |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
34 from kivy.metrics import dp |
| 222 | 35 from kivy.clock import Clock |
| 51 | 36 from cagou import G |
| 222 | 37 from functools import partial |
| 51 | 38 import webbrowser |
| 39 | |
|
302
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
40 log = logging.getLogger(__name__) |
|
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
41 |
| 312 | 42 ABOUT_TITLE = _("About {}".format(C.APP_NAME)) |
| 43 ABOUT_CONTENT = _("""[b]Cagou (Salut à Toi)[/b] | |
|
302
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
44 |
|
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
45 [u]cagou version[/u]: |
|
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
46 {version} |
|
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
47 |
|
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
48 [u]backend version[/u]: |
|
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
49 {backend_version} |
| 51 | 50 |
| 51 Cagou is a libre communication tool based on libre standard XMPP. | |
| 52 | |
|
302
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
53 Cagou is part of the "Salut à Toi" project (desktop/mobile frontend) |
| 51 | 54 more informations at [color=5500ff][ref=website]salut-a-toi.org[/ref][/color] |
| 246 | 55 """) |
| 51 | 56 |
| 57 | |
| 58 class AboutContent(Label): | |
| 59 | |
| 60 def on_ref_press(self, value): | |
| 61 if value == "website": | |
| 62 webbrowser.open("https://salut-a-toi.org") | |
| 63 | |
| 64 | |
| 65 class AboutPopup(Popup): | |
| 66 | |
| 67 def on_touch_down(self, touch): | |
| 68 if self.collide_point(*touch.pos): | |
| 69 self.dismiss() | |
| 70 return super(AboutPopup, self).on_touch_down(touch) | |
| 71 | |
| 72 | |
|
85
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
73 class MainMenu(contextmenu.AppMenu): |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
74 pass |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
75 |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
76 |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
77 class MenuItem(contextmenu.ContextMenuTextItem): |
| 51 | 78 item = properties.ObjectProperty() |
| 79 | |
| 80 def on_item(self, instance, item): | |
| 81 self.text = item.name | |
| 82 | |
| 83 def on_release(self): | |
|
85
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
84 super(MenuItem, self).on_release() |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
85 self.parent.hide() |
| 51 | 86 selected = G.host.selected_widget |
| 87 profile = None | |
| 88 if selected is not None: | |
| 89 try: | |
| 222 | 90 # FIXME: handle multi-profiles |
| 91 profile = next(iter(selected.profiles)) | |
| 51 | 92 except AttributeError: |
| 93 pass | |
| 94 | |
| 95 if profile is None: | |
| 96 try: | |
| 97 profile = list(selected.profiles)[0] | |
| 98 except (AttributeError, IndexError): | |
| 99 try: | |
| 100 profile = list(G.host.profiles)[0] | |
| 101 except IndexError: | |
| 312 | 102 log.warning("Can't find profile") |
| 51 | 103 self.item.call(selected, profile) |
| 104 | |
| 105 | |
|
85
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
106 class MenuSeparator(contextmenu.ContextMenuDivider): |
| 51 | 107 pass |
| 108 | |
| 109 | |
|
85
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
110 class RootMenuContainer(contextmenu.AppMenuTextItem): |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
111 pass |
| 51 | 112 |
| 113 | |
|
85
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
114 class MenuContainer(contextmenu.ContextMenuTextItem): |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
115 pass |
| 51 | 116 |
| 117 | |
|
85
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
118 class MenusWidget(BoxLayout): |
| 51 | 119 |
| 120 def update(self, type_, caller=None): | |
| 121 """Method to call when menus have changed | |
| 122 | |
| 123 @param type_(unicode): menu type like in sat.core.sat_main.importMenu | |
| 124 @param caller(Widget): instance linked to the menus | |
| 125 """ | |
| 126 self.menus_container = G.host.menus.getMainContainer(type_) | |
| 127 self.createMenus(caller) | |
| 128 | |
| 129 def _buildMenus(self, container, caller=None): | |
| 130 """Recursively build menus of the container | |
| 131 | |
| 132 @param container(quick_menus.MenuContainer): menu container | |
| 133 @param caller(Widget): instance linked to the menus | |
| 134 """ | |
| 135 if caller is None: | |
|
85
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
136 main_menu = MainMenu() |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
137 self.add_widget(main_menu) |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
138 caller = main_menu |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
139 else: |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
140 context_menu = contextmenu.ContextMenu() |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
141 caller.add_widget(context_menu) |
| 222 | 142 # FIXME: next line is needed after parent is set to avoid |
| 143 # a display bug in contextmenu | |
|
85
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
144 # TODO: fix this upstream |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
145 context_menu._on_visible(False) |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
146 |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
147 caller = context_menu |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
148 |
| 51 | 149 for child in container.getActiveMenus(): |
| 150 if isinstance(child, quick_menus.MenuContainer): | |
|
85
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
151 if isinstance(caller, MainMenu): |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
152 menu_container = RootMenuContainer() |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
153 else: |
|
c2a7234d13d2
menu: use of garden's contextmenu for menus
Goffi <goffi@goffi.org>
parents:
53
diff
changeset
|
154 menu_container = MenuContainer() |
| 51 | 155 menu_container.text = child.name |
| 156 caller.add_widget(menu_container) | |
| 157 self._buildMenus(child, caller=menu_container) | |
| 158 elif isinstance(child, quick_menus.MenuSeparator): | |
| 159 wid = MenuSeparator() | |
| 160 caller.add_widget(wid) | |
| 161 elif isinstance(child, quick_menus.MenuItem): | |
| 162 wid = MenuItem(item=child) | |
| 163 caller.add_widget(wid) | |
| 164 else: | |
| 312 | 165 log.error("Unknown child type: {}".format(child)) |
| 51 | 166 |
| 167 def createMenus(self, caller): | |
| 168 self.clear_widgets() | |
| 169 self._buildMenus(self.menus_container, caller) | |
| 170 | |
| 171 def onAbout(self): | |
| 172 about = AboutPopup() | |
| 173 about.title = ABOUT_TITLE | |
|
302
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
174 about.content = AboutContent( |
|
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
175 text=ABOUT_CONTENT.format( |
|
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
176 backend_version = G.host.backend_version, |
|
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
177 version=G.host.version), |
|
f55b60659ec1
core (about): improved "about" popup:
Goffi <goffi@goffi.org>
parents:
282
diff
changeset
|
178 markup=True) |
| 51 | 179 about.open() |
| 86 | 180 |
| 181 | |
|
97
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
182 class TransferItem(BoxLayout): |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
183 plug_info = properties.DictProperty() |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
184 |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
185 def on_touch_up(self, touch): |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
186 if not self.collide_point(*touch.pos): |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
187 return super(TransferItem, self).on_touch_up(touch) |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
188 else: |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
189 transfer_menu = self.parent |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
190 while not isinstance(transfer_menu, TransferMenu): |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
191 transfer_menu = transfer_menu.parent |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
192 transfer_menu.do_callback(self.plug_info) |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
193 return True |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
194 |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
195 |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
196 class SideMenu(BoxLayout): |
|
216
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
197 size_hint_close = (0, 1) |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
198 size_hint_open = (0.4, 1) |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
199 size_close = (100, 100) |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
200 size_open = (0, 0) |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
201 bg_color = properties.ListProperty([0, 0, 0, 1]) |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
202 # callback will be called with arguments relevant to menu |
| 86 | 203 callback = properties.ObjectProperty() |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
204 # call do_callback even when menu is cancelled |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
205 callback_on_close = properties.BooleanProperty(False) |
| 86 | 206 # cancel callback need to remove the widget for UI |
| 207 # will be called with the widget to remove as argument | |
| 208 cancel_cb = properties.ObjectProperty() | |
| 209 | |
| 210 def __init__(self, **kwargs): | |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
211 super(SideMenu, self).__init__(**kwargs) |
| 86 | 212 if self.cancel_cb is None: |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
213 self.cancel_cb = self.onMenuCancelled |
| 86 | 214 |
|
216
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
215 def _set_anim_kw(self, kw, size_hint, size): |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
216 """Set animation keywords |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
217 |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
218 for each value of size_hint it is used if not None, |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
219 else size is used. |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
220 If one value of size is bigger than the respective one of Window |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
221 the one of Window is used |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
222 """ |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
223 size_hint_x, size_hint_y = size_hint |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
224 width, height = size |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
225 if size_hint_x is not None: |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
226 kw['size_hint_x'] = size_hint_x |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
227 elif width is not None: |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
228 kw['width'] = min(width, Window.width) |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
229 |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
230 if size_hint_y is not None: |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
231 kw['size_hint_y'] = size_hint_y |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
232 elif height is not None: |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
233 kw['height'] = min(height, Window.height) |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
234 |
| 86 | 235 def show(self, caller_wid=None): |
|
168
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
236 Window.bind(on_keyboard=self.key_input) |
|
97
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
237 G.host.app.root.add_widget(self) |
|
216
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
238 kw = {'d': 0.3, 't': 'out_back'} |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
239 self._set_anim_kw(kw, self.size_hint_open, self.size_open) |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
240 Animation(**kw).start(self) |
|
168
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
241 |
|
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
242 def hide(self): |
|
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
243 Window.unbind(on_keyboard=self.key_input) |
|
216
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
244 kw = {'d': 0.2} |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
245 self._set_anim_kw(kw, self.size_hint_close, self.size_close) |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
246 anim = Animation(**kw) |
|
168
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
247 anim.bind(on_complete=lambda anim, menu: self.parent.remove_widget(self)) |
|
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
248 anim.start(self) |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
249 if self.callback_on_close: |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
250 self.do_callback() |
|
97
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
251 |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
252 def on_touch_down(self, touch): |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
253 # we remove the menu if we click outside |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
254 # else we want to handle the event, but not |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
255 # transmit it to parents |
|
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
256 if not self.collide_point(*touch.pos): |
|
168
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
257 self.hide() |
| 86 | 258 else: |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
259 return super(SideMenu, self).on_touch_down(touch) |
|
97
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
260 return True |
| 86 | 261 |
|
168
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
262 def key_input(self, window, key, scancode, codepoint, modifier): |
|
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
263 if key == 27: |
|
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
264 self.hide() |
|
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
265 return True |
|
397f2fb67aab
core (menu): animate transfer menu opening/closing + close it on [ESC]/back
Goffi <goffi@goffi.org>
parents:
126
diff
changeset
|
266 |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
267 def onMenuCancelled(self, wid, cleaning_cb=None): |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
268 self._closeUI(wid) |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
269 if cleaning_cb is not None: |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
270 cleaning_cb() |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
271 |
| 86 | 272 def _closeUI(self, wid): |
| 273 G.host.closeUI() | |
| 274 | |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
275 def do_callback(self, *args, **kwargs): |
| 312 | 276 log.warning("callback not implemented") |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
277 |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
278 |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
279 class TransferMenu(SideMenu): |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
280 """transfer menu which handle display and callbacks""" |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
281 # callback will be called with path to file to transfer |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
282 # profiles if set will be sent to transfer widget, may be used to get specific files |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
283 profiles = properties.ObjectProperty() |
| 312 | 284 transfer_txt = _("Beware! The file will be sent to your server and stay unencrypted " |
| 285 "there\nServer admin(s) can see the file, and they choose how, " | |
| 286 "when and if it will be deleted") | |
| 287 send_txt = _("The file will be sent unencrypted directly to your contact " | |
| 288 "(without transiting by the server), except in some cases") | |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
289 items_layout = properties.ObjectProperty() |
|
216
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
290 size_hint_close = (1, 0) |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
291 size_hint_open = (1, 0.5) |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
292 |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
293 def __init__(self, **kwargs): |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
294 super(TransferMenu, self).__init__(**kwargs) |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
295 if self.profiles is None: |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
296 self.profiles = iter(G.host.profiles) |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
297 for plug_info in G.host.getPluggedWidgets(type_=C.PLUG_TYPE_TRANSFER): |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
298 item = TransferItem( |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
299 plug_info = plug_info |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
300 ) |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
301 self.items_layout.add_widget(item) |
| 86 | 302 |
| 303 def do_callback(self, plug_info): | |
|
97
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
304 self.parent.remove_widget(self) |
| 86 | 305 if self.callback is None: |
| 312 | 306 log.warning("TransferMenu callback is not set") |
| 86 | 307 else: |
| 308 wid = None | |
|
88
3dc526bb4a5a
upload: plugin android gallery, first draft:
Goffi <goffi@goffi.org>
parents:
86
diff
changeset
|
309 external = plug_info.get('external', False) |
|
97
5d2289127bb7
menu (upload): better menu using dedicated widget:
Goffi <goffi@goffi.org>
parents:
88
diff
changeset
|
310 def onTransferCb(file_path, cleaning_cb=None): |
|
88
3dc526bb4a5a
upload: plugin android gallery, first draft:
Goffi <goffi@goffi.org>
parents:
86
diff
changeset
|
311 if not external: |
|
3dc526bb4a5a
upload: plugin android gallery, first draft:
Goffi <goffi@goffi.org>
parents:
86
diff
changeset
|
312 self._closeUI(wid) |
|
98
4d8c122b86a6
menu (upload): send transfer (i.e. P2P transfer) is now working
Goffi <goffi@goffi.org>
parents:
97
diff
changeset
|
313 self.callback( |
|
4d8c122b86a6
menu (upload): send transfer (i.e. P2P transfer) is now working
Goffi <goffi@goffi.org>
parents:
97
diff
changeset
|
314 file_path, |
| 222 | 315 transfer_type = (C.TRANSFER_UPLOAD |
|
322
e2b51663d8b8
core, android: new share widget + added Cagou to "share" menu:
Goffi <goffi@goffi.org>
parents:
312
diff
changeset
|
316 if self.ids['upload_btn'].state == "down" else C.TRANSFER_SEND), |
|
e2b51663d8b8
core, android: new share widget + added Cagou to "share" menu:
Goffi <goffi@goffi.org>
parents:
312
diff
changeset
|
317 cleaning_cb=cleaning_cb, |
|
e2b51663d8b8
core, android: new share widget + added Cagou to "share" menu:
Goffi <goffi@goffi.org>
parents:
312
diff
changeset
|
318 ) |
| 222 | 319 wid = plug_info['factory'](plug_info, |
| 320 onTransferCb, | |
| 321 self.cancel_cb, | |
| 322 self.profiles) | |
|
88
3dc526bb4a5a
upload: plugin android gallery, first draft:
Goffi <goffi@goffi.org>
parents:
86
diff
changeset
|
323 if not external: |
|
3dc526bb4a5a
upload: plugin android gallery, first draft:
Goffi <goffi@goffi.org>
parents:
86
diff
changeset
|
324 G.host.showExtraUI(wid) |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
325 |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
326 |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
327 class EntitiesSelectorMenu(SideMenu, FilterBehavior): |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
328 """allow to select entities from roster""" |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
329 profiles = properties.ObjectProperty() |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
330 layout = properties.ObjectProperty() |
| 312 | 331 instructions = properties.StringProperty(_("Please select entities")) |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
332 filter_input = properties.ObjectProperty() |
|
216
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
333 size_hint_close = (None, 1) |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
334 size_hint_open = (None, 1) |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
335 size_open = (dp(250), 100) |
|
e42e0c45d384
core (menu): allow to specify size in SideMenu:
Goffi <goffi@goffi.org>
parents:
197
diff
changeset
|
336 size_close = (0, 100) |
|
197
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
337 |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
338 def __init__(self, **kwargs): |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
339 super(EntitiesSelectorMenu, self).__init__(**kwargs) |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
340 self.filter_input.bind(text=self.do_filter_input) |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
341 if self.profiles is None: |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
342 self.profiles = iter(G.host.profiles) |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
343 for profile in self.profiles: |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
344 for jid_, jid_data in G.host.contact_lists[profile].all_iter: |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
345 jid_wid = JidToggle( |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
346 jid=jid_, |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
347 profile=profile) |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
348 self.layout.add_widget(jid_wid) |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
349 |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
350 def do_callback(self): |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
351 if self.callback is not None: |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
352 jids = [c.jid for c in self.layout.children if c.state == 'down'] |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
353 self.callback(jids) |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
354 |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
355 def do_filter_input(self, filter_input, text): |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
356 self.layout.spacing = 0 if text else dp(5) |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
357 self.do_filter(self.layout.children, |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
358 text, |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
359 lambda c: c.jid, |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
360 width_cb=lambda c: c.width, |
|
c7d15ef4bfa8
core (menu): new EntitiesSelectorMenu:
Goffi <goffi@goffi.org>
parents:
184
diff
changeset
|
361 height_cb=lambda c: dp(70)) |
| 222 | 362 |
| 363 | |
| 364 class TouchMenu(modernmenu.ModernMenu): | |
| 365 pass | |
| 366 | |
| 367 | |
| 368 class TouchMenuItemBehaviour(object): | |
| 369 """Class to use on every item where a menu may appear | |
| 370 | |
| 371 main_wid attribute must be set to the class inheriting from TouchMenuBehaviour | |
| 372 do_item_action is the method called on simple click | |
| 373 getMenuChoices must return a list of menus for long press | |
| 374 menus there are dict as expected by ModernMenu | |
| 375 (translated text, index and callback) | |
| 376 """ | |
| 377 main_wid = properties.ObjectProperty() | |
| 378 click_timeout = properties.NumericProperty(0.4) | |
| 379 | |
| 380 def on_touch_down(self, touch): | |
| 381 if not self.collide_point(*touch.pos): | |
| 382 return | |
| 383 t = partial(self.open_menu, touch) | |
| 384 touch.ud['menu_timeout'] = t | |
| 385 Clock.schedule_once(t, self.click_timeout) | |
| 386 return super(TouchMenuItemBehaviour, self).on_touch_down(touch) | |
| 387 | |
| 388 def do_item_action(self, touch): | |
| 389 pass | |
| 390 | |
| 391 def on_touch_up(self, touch): | |
| 392 if touch.ud.get('menu_timeout'): | |
| 393 Clock.unschedule(touch.ud['menu_timeout']) | |
| 394 if self.collide_point(*touch.pos) and self.main_wid.menu is None: | |
| 395 self.do_item_action(touch) | |
| 396 return super(TouchMenuItemBehaviour, self).on_touch_up(touch) | |
| 397 | |
| 398 def open_menu(self, touch, dt): | |
| 399 self.main_wid.open_menu(self, touch) | |
| 400 del touch.ud['menu_timeout'] | |
| 401 | |
| 402 def getMenuChoices(self): | |
| 403 """return choice adapted to selected item | |
| 404 | |
| 405 @return (list[dict]): choices ad expected by ModernMenu | |
| 406 """ | |
| 407 return [] | |
| 408 | |
| 409 | |
| 410 class TouchMenuBehaviour(object): | |
| 411 """Class to handle a menu appearing on long press on items | |
| 412 | |
| 413 classes using this behaviour need to have a float_layout property | |
| 414 pointing the main FloatLayout. | |
| 415 """ | |
| 416 float_layout = properties.ObjectProperty() | |
| 417 | |
| 418 def __init__(self, *args, **kwargs): | |
| 419 super(TouchMenuBehaviour, self).__init__(*args, **kwargs) | |
| 420 self.menu = None | |
| 421 self.menu_item = None | |
| 422 | |
| 423 ## menu methods ## | |
| 424 | |
| 425 def clean_fl_children(self, layout, children): | |
| 426 """insure that self.menu and self.menu_item are None when menu is dimissed""" | |
| 427 if self.menu is not None and self.menu not in children: | |
| 428 self.menu = self.menu_item = None | |
| 429 | |
| 430 def clear_menu(self): | |
| 431 """remove menu if there is one""" | |
| 432 if self.menu is not None: | |
| 433 self.menu.dismiss() | |
| 434 self.menu = None | |
| 435 self.menu_item = None | |
| 436 | |
| 437 def open_menu(self, item, touch): | |
| 438 """open menu for item | |
| 439 | |
| 440 @param item(PathWidget): item when the menu has been requested | |
| 441 @param touch(kivy.input.MotionEvent): touch data | |
| 442 """ | |
| 443 if self.menu_item == item: | |
| 444 return | |
| 445 self.clear_menu() | |
| 446 pos = self.to_widget(*touch.pos) | |
| 447 choices = item.getMenuChoices() | |
| 448 if not choices: | |
| 449 return | |
| 450 self.menu = TouchMenu(choices=choices, | |
| 451 center=pos, | |
| 452 size_hint=(None, None)) | |
| 453 self.float_layout.add_widget(self.menu) | |
| 454 self.menu.start_display(touch) | |
| 455 self.menu_item = item | |
| 456 | |
| 457 def on_float_layout(self, wid, float_layout): | |
| 458 float_layout.bind(children=self.clean_fl_children) |