Welcome!
This is the community forum for my apps Pythonista and Editorial.
For individual support questions, you can also send an email. If you have a very short question or just want to say hello — I'm @olemoritz on Twitter.
Any UI module tutorials out there?
-
@ccc You can use
ui.View
subclasses in the UI editor by setting the Custom View Class attribute in the inspector (works for the root view and "Custom View" widgets). -
-
Thank for the info @ccc it is most helpful.
-
-
@brumm Thank you for the offer, but I think I have the general idea. I'm going to play around a bit and I'll get back to you if I get stuck.
-
@ccc: Thank you so much for optimizing my code. My current project sftp-client contains thousands of globals. Next weekend I will study your pull request.
-
@omz I seem to be doing something from when setting the Custom View Class in the editor. My class does not seem to inherit the editor view.. Could I get an example?
-
# coding: utf-8 import ui class MyView(ui.View): def __init__(self): self.present() def did_load(self): self['button1'].title = 'It works ;-)' the_view = ui.load_view() # strange syntax for creating an instance of MyView but it works
-
Okay I started a tutorial. But you have to be patient because I'm starting with the very basics (and my time is limited - so the tutorial is slow-growing).
ui-tutorial -
@brumm Thank you.
-
I am getting the following warning when I try in the UI Editor to set an button's action attribute to a method of its root view:
Warning: Couldn't bind action 'self.button_tapped' of 'button1'
I have tried in the UI Editor to set the button's action attribute to:
button_tapped
,self.button_tapped
, andself.superview.button_tapped
with no success. If I uncomment the commented line below then I can set the action in Python code. I just can not figure the syntax for setting it in the UI Editor.import ui class MyView(ui.View): def __init__(self): self.present() def did_load(self): self['button1'].title = 'It works ;-)' # self['button1'].action = self.button_tapped def button_tapped(self, sender): sender.title = 'Got tapped' the_view = ui.load_view()
-
@ccc I have the same issue ended up setting it outside of the editor.
I'm not real fond of the way you call a custom view that inherits from the editor the by ui.load_view(). I'd rather create an instance of the class by view = Custom_View() How can I pass parameters to the init of my Custom view class? It seems like your previous idea of loading the view in the init of the class is better. What am I missing?
-
@ccc An action that is set from the UI editor can either be a globally visible function, or a method of the class from which you're loading the view (i.e. whatever
self
evaluates to when you callload_view
). In the latter scenario, you'd typically have some kind of controller object that loads a view and handles its actions. -
@ccc I'm trying to implement the best practices you set out. I have some queries please...
1 init() with no parameters and no final pass to View.init() is because all params are optional, right? And we know that View does nothing there other than initialise the options?
7/8 I find the act of adding a subview already makes it a member variable?
9/10 when making View the target/delegate of its subviews what style do you recommend to identify which sender/delegator of possibly many of the same class? (the neatest I've found is below)
Before making View the target/delegate:
class wvDelegate (object): def webview_did_finish_load(self, webview): if id(webview) == id(webview.superview.wv1): console.hud_alert('1') elif id(webview) == id(webview.superview.wv2): console.hud_alert('2') elif id(webview) == id(webview.superview.wv3): console.hud_alert('3')
Or... after:
def webview_did_finish_load(self, webview): if id(webview) == id(self.wv1): console.hud_alert('1') elif id(webview) == id(self.wv2): console.hud_alert('2') elif id(webview) == id(self.wv3): console.hud_alert('3')
Or... put more simply:
def webview_did_finish_load(self, webview): if webview is self.wv1: console.hud_alert('1') elif webview is self.wv2: console.hud_alert('2') elif webview is self.wv3: console.hud_alert('3')
Best practices: 1 ui.View is the only class in ui module that can be subclassed so take advantage of it. Every time you create a ui.View, consider making it a custom subclass of ui.View. It will give you the ability to build more complex yet comprehensible apps. 2 Each ui element that gets added as a subview to your ui.View should have its own make_xxx() method. 3 Consider what method parameters will maximize the reusability of your make_xxx() method. 4 Near the beginning of the make_xxx() method, there should be a local_variable = ui.xxx() type of call. 5 The make_xxx() method should not assume that the ui element will be a member variable of your ui.View. 6 The make_xxx() method should only focus on the xxx element and should not mention other ui elements. 7 Near the end of the make_xxx() method, the ui element should be attached as a subview via self.add_subview(xxx) or similar. 8 make_xxx() should return the xxx object created so your ui.View can make it a member variable if it wishes to. 9 Consider making your ui.View the target of all .actions of its subviews. 10 Consider making your ui.View the delegate of its subviews. 11 Try to keep the complexity of view logic inside the class and keep everything else (reading files, networks, complex formatting) outside the class
-
1 I am unclear what your text around this means. When I subclass View, my
__init__()
only takes self as a parameter and the method never callsView.__init__()
and it usually only contains one method call to self.present(). The real work will happen indid_load()
.7/8 I see a difference between self['save button'] and self.save_button but perhaps it is not super important. However, what I am interested to have is a single function/method that I can call to create the save, load, and delete buttons. I would lose that reusability if the function/method directly attached the newly created button to self.
9/10 My recommendation was NOT to create a separate
class wvDelegate (object)
. Instead, so far, I have seen it best to make MySuperCoolView or MySuperCoolController (the 'self' at View creation time) be the delegate. I would advocate using sender.name instead of id(sender) in your examples. Then you can do things with self[webview.name] or... names go well with dicts:def webview_did_finish_load(self, webview): webview_names = {'Apple' : 1, 'Google' : 2, 'IBM' : 3} alert_id = webview_names.get(webview.name, 0) if alert_id: console.hud_alert(str(alert_id)) else: panic()
-
@ccc Thanks.
Sorry about '1'... I meant the init we use for the subclass of View, skips the init of View itself, I think. I can't see View's init... but presumably we know it's safe to skip it?
-
Yes. Read the comments under
__init__()
in the code block at http://omz-software.com/pythonista/docs/ios/ui.html#building-custom-views "You don't have to call super.". -
In case it helps anyone following the best practices... there's currently a subtle difference between View and a sub class of View in terms of how they run between the main UI thread and the main interpreter thread... as the little test below shows (swap the comment line for the one above):
import ui import console class TestView (ui.View): pass v = ui.View() #v = TestView() v.present('popover') console.alert('Test', button1 = 'OK', hide_cancel_button = True)
-
@ccc Regarding best practice 2... is there a case for the
make_xxx()
method to be_make_xxx()
per the convention in The Python Tutorial... 8.6? -
See the notes on mixing console.alert with the ui module at http://omz-software.com/pythonista/docs/ios/ui.html#about-actions-and-delegates
Your
_make_xxx()
idea makes sense to me.