mirror of https://github.com/kivy/kivy.git
Removed notes from examples readme.
This commit is contained in:
geojeff
parent
3f76ea8d3a
commit
0a64656bdb
|
|
@ -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
|
||||
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue