diff --git a/examples/widgets/lists/README.md b/examples/widgets/lists/README.md index 9d6817200..8b33ad152 100644 --- a/examples/widgets/lists/README.md +++ b/examples/widgets/lists/README.md @@ -48,117 +48,9 @@ These include: right, which is constantly updated. - list_ops.py -- Seven list views are shown at the bottom, each focusing - on one of the available operations for collection + on one of the available operations for list adapters: scroll_to, trim_to_sel, trim_left_of_sel, etc. At the top is a display that shows individual items selected across the seven lists, along with a total of all selected items for the lists. - -[TODO LIST for kivy uix-listview]: - - - *** FIXED *** Initial selection is apparently working in the associated - ListAdapter but the listview display does not show the initial - selection (red, in example code). After the listview has been clicked - for the first manual selection, the updating of selected items (in red) - works. - - - Explain why multiple levels of abstraction are needed. (Adapter, - ListAdapter, AbstractView, ListView) -- Tie discussion to inspiration - for Adapter and related classes: - - http://developer.android.com/reference/android/\ - widget/Adapter.html#getView(int,%20android/\ - .view.View,%20android.view.ViewGroup) - - There is now an ASCII drawing of the relationship between ListView and - ListAdapter, as it is now, in the docs below. - - - Divider isn't used (yet). - - - *** DONE *** Consider adding an associated SortableDataItem mixin, to - be used by list item classes in a manner similar to the - SelectableView mixin. - - - *** DONE *** (By adding DictAdapter, which as a sorted_keys argument) - - Consider a sort_by property. Review the use of the items - property. - - - Work on [TODO]s in the code. - - Examples (in examples/widgets): - - - Improve examples: - - *** DONE *** Add fruit images. - - - Add an example where selection doesn't just change background color - or font, but animates. - - Other Possibilities: - - - Consider a horizontally scrolling variant. - - - Is it possible to have dynamic item_view height, for use in a - master-detail listview in this manner? - - http://www.zkoss.org/zkdemo/grid/master_detail - - (Would this be a new widget called MasterDetailListView, or would the - listview widget having a facility for use in this way?) - - (See the list_disclosure.py file as a start.) - - - Make a separate master-detail example that works like an iphone-style - animated "source list" that has "disclosure" buttons per item_view, on - the right, that when clicked will expand to fill the entire listview - area (useful on mobile devices especially). Similar question as above -- - would listview be given expanded functionality or would this become - another kind of "master-detail" widget?) - - - look for uses of hasattr on dicts -- should be 'key' in dict - -Notes from Adapter.py: - - - Explain the design philosophy used here -- something like model-view- - adapter (MVA) as described here: - - http://en.wikipedia.org/wiki/Model-view-adapter (and link to - basis article about Java Swing design) - - Using background in references like these, compare to MVC terminology, - and how Kivy operates to fulfill the roles of mediating and coordinating - controllers, especially (terminology from the world of Cocoa). - - - *** DONE *** Consider an associated "object adapter" (a.k.a., "object - controller") that is bound to selection. It can also subclass Adapter? - - - *** DONE *** Yes, the new ObjectAdapter subclasses Adapter. - - - interfaces instead of subclassing? - - - rename get_item to get_data_item to be more explicit? (to distinguish - from view item) - - - Might there be other useful converters to put in - kivy/adapters/args_converters.py, in addition to the default simple - string converter? - -- SelectableView was moved out of adapters.mixins and into uix/listview. Was - this the correct thing to do? Are there other cases of view definitions - outside of uix? - -- Clean up Factory registrations in examples -- when needed? which classes - have been added to kivy/factory_registers.py. - -- CustomListItem, the name for the class created in the examples, list_kv.py, - and list_cascade.py, and also in the test_adapters.py file, is defined only - in the Builder.load_string() call. Better document the special nature of - this in API explanations. (You can't refer to it as a normal class). - -- In docs, for first introduction of args_converter, could use - list_item_args_converter, as used in many examples and tests, to help show - the context for use. - -- Make kwargs handling follow nice style in models.py, SimpleDataItem -