diff --git a/doc/sources/images/adapters.png b/doc/sources/images/adapters.png new file mode 100644 index 000000000..063be3ea8 Binary files /dev/null and b/doc/sources/images/adapters.png differ diff --git a/kivy/adapters/__init__.py b/kivy/adapters/__init__.py index db0d3591b..867675132 100644 --- a/kivy/adapters/__init__.py +++ b/kivy/adapters/__init__.py @@ -11,6 +11,9 @@ presented by views. Views are top-level widgets, such as a :class:`~kivy.uix.listview.ListView`, that allow users to scroll through and (optionally) interact with your data. +The Concept +----------- + Kivy adapters are modelled on the `Adapter design pattern `_. Conceptually, they play the role of a 'controller' between you data and views @@ -18,6 +21,16 @@ in a `Model-View-Controller `_ type architecture. +The role of an adapter can be depicted as follows: + +.. image:: images/adapters.png + + +The Components +-------------- + +The components involved in this process are: + - **Adapters**: The base :class:`Adapter` is subclassed by the :class:`SimpleListAdapter` and :class:`ListAdapter`. The :class:`DictAdapter` is a more advanced and flexible subclass of :class:`ListAdapter`.