U PeM=@s|dZddlmZddlmZddlmZdZiZee Z da dZ ddZ Gd d d eZGd d d eZGd ddeZdS)a RecycleView Views ================= .. versionadded:: 1.10.0 The adapter part of the RecycleView which together with the layout is the view part of the model-view-controller pattern. The view module handles converting the data to a view using the adapter class which is then displayed by the layout. A view can be any Widget based class. However, inheriting from RecycleDataViewBehavior adds methods for converting the data to a view. TODO: * Make view caches specific to each view class type. )ObjectProperty)EventDispatcher) defaultdict)RecycleDataViewBehaviorRecycleKVIDsDataViewBehaviorRecycleDataAdaptericCsFtdtt}tD](\}}ttdt||8a||d=qdS)zETrims _cached_views cache to half the size of `_max_cache_size`. rN)_max_cache_sizelen _cached_viewsitems _cache_countmax)max_sizeclsZ instancesr>/tmp/pip-unpacked-wheel-xzebddm3/kivy/uix/recycleview/views.py _clean_cache+src@s(eZdZdZddZddZddZdS) rzA optional base class for data views (:attr:`RecycleView`.viewclass). If a view inherits from this class, the class's functions will be called when the view needs to be updated due to a data change or layout update. cCs0tj}|D]\}}||krt|||qdS)aCalled by the :class:`RecycleAdapter` when the view is initially populated with the values from the `data` dictionary for this item. Any pos or size info should be removed because they are set subsequently with :attr:`refresh_view_layout`. :Parameters: `rv`: :class:`RecycleView` instance The :class:`RecycleView` that caused the update. `data`: dict The data dict used to populate this view. N)r _sizing_attrsr setattr)selfrvindexdata sizing_attrskeyvaluerrrrefresh_view_attrs<sz*RecycleDataViewBehavior.refresh_view_attrsc Csb|d\}}|dkr&|dk r@||_n|dkr6||_n ||f|_|D]\}}t|||qHdS)aCalled when the view's size is updated by the layout manager, :class:`RecycleLayoutManagerBehavior`. :Parameters: `rv`: :class:`RecycleView` instance The :class:`RecycleView` that caused the update. `viewport`: 4-tuple The coordinates of the bottom left and width height in layout manager coordinates. This may be larger than this view item. :raises: `LayoutChangeException`: If the sizing or data changed during a call to this method, raising a `LayoutChangeException` exception will force a refresh. Useful when data changed and we don't want to layout further since it'll be overwritten again soon. sizeN)popheightwidthrr r) rrrlayoutviewportwhnamerrrrrefresh_view_layoutOs z+RecycleDataViewBehavior.refresh_view_layoutcCsdS)Nr)rrrZ is_selectedrrrapply_selectionnsz'RecycleDataViewBehavior.apply_selectionN)__name__ __module__ __qualname____doc__rr'r(rrrrr6src@seZdZdZddZdS)ra Similar to :class:`RecycleDataViewBehavior`, except that the data keys can signify properties of an object named with an id in the root KV rule. E.g. given a KV rule:: : Label: id: name Label: id: value Then setting the data list with ``rv.data = [{'name.text': 'Kivy user', 'value.text': '12'}]`` would automatically set the corresponding labels. So, if the key doesn't have a period, the named property of the root widget will be set to the corresponding value. If there is a period, the named property of the widget with the id listed before the period will be set to the corresponding value. .. versionadded:: 2.0.0 c Csvtj}|D]b\}}||kr|d^}}|rdt|dkrLtd|dt|j||d|qt|||qdS)N.z Data key "z" has more than one periodr)rrr splitr ValueErrorrids) rrrrrrrr&r1rrrrs  z/RecycleKVIDsDataViewBehavior.refresh_view_attrsN)r)r*r+r,rrrrrrrsrcseZdZdZedddZiZeeZ ddddd d d d d ddddddddddhZ fddZ ddZ ddZ ddZd d!Zd"d#Zd$d%Zd&d'Zd(d)Zd*d+Zd,d-Zd.d/ZZS)0raThe class that converts data to a view. --- Internal details --- A view can have 3 states. * It can be completely in sync with the data, which occurs when the view is displayed. These are stored in :attr:`views`. * It can be dirty, which occurs when the view is in sync with the data, except for the size/pos parameters which is controlled by the layout. This occurs when the view is not currently displayed but the data has not changed. These views are stored in :attr:`dirty_views`. * Finally the view can be dead which occurs when the data changes and the view was not updated or when a view is just created. Such views are typically added to the internal cache. Typically what happens is that the layout manager lays out the data and then asks for views, using :meth:`set_visible_views,` for some specific data items that it displays. These views are gotten from the current views, dirty or global cache. Then depending on the view state :meth:`refresh_view_attrs` is called to bring the view up to date with the data (except for sizing parameters). Finally, the layout manager gets these views, updates their size and displays them. NT)Z allownonerr!r Z size_hintZ size_hint_xZ size_hint_yposxycenterZcenter_xZcenter_yZpos_hintZ size_hint_minZsize_hint_min_xZsize_hint_min_yZ size_hint_maxZsize_hint_max_xZsize_hint_max_yc s&i|_tt|_tt|jf|dS)z Fix for issue https://github.com/kivy/kivy/issues/5913: Scrolling RV A, then Scrolling RV B, content of A and B seemed to be getting mixed up N)viewsrdict dirty_viewssuperr__init__)rkwargs __class__rrr:s zRecycleDataAdapter.__init__cCs ||_dS)zAssociates a :class:`~kivy.uix.recycleview.RecycleViewBehavior` with this instance. It is stored in :attr:`recycleview`. N recycleview)rrrrrattach_recycleviewsz%RecycleDataAdapter.attach_recycleviewcCs d|_dS)zRemoves the :class:`~kivy.uix.recycleview.RecycleViewBehavior` associated with this instance and clears :attr:`recycleview`. Nr>)rrrrdetach_recycleviewsz%RecycleDataAdapter.detach_recycleviewcCs$|dkr dS|}|||||S)z(internal) Creates and initializes the view for the data at `index`. The returned view is synced with the data, except for the pos/size information. N)r)rr data_item viewclassviewrrr create_views zRecycleDataAdapter.create_viewcCs|j}|dkrdSd}d}||krr||}||kr>||}qt|rZt|d}}q|r|dd}}nt|rt|d}}|dkr||||}|dkrdS|r|||||S)az(internal) Returns a view instance for the data at `index` It looks through the various caches and finally creates a view if it doesn't exist. The returned view is synced with the data, except for the pos/size information. If found in the cache it's removed from the source before returning. It doesn't check the current views. NFTr.)r8rr popitemrEr)rrrBrCr8stalerDZ dirty_classrrrget_views,  zRecycleDataAdapter.get_viewcCsf|j}|tkrt|tt|<t|r6||j||n,tj}|D]\}}||krDt |||qDdS)ai(internal) Syncs the view and brings it up to date with the data. This method calls :meth:`RecycleDataViewBehavior.refresh_view_attrs` if the view inherits from :class:`RecycleDataViewBehavior`. See that method for more details. .. note:: Any sizing and position info is skipped when syncing with the data. N) r=_view_base_cache isinstancerrr?rrr r)rrrBrDrCrrrrrrrs z%RecycleDataAdapter.refresh_view_attrsc Cs|jtkrt|tt|j<t|jr8||j|||n^|d\}}|dkr^|dk rx||_n|dkrn||_n ||f|_ | D]\}}t |||qdS)aUpdates the sizing information of the view. viewport is in coordinates of the layout manager. This method calls :meth:`RecycleDataViewBehavior.refresh_view_attrs` if the view inherits from :class:`RecycleDataViewBehavior`. See that method for more details. .. note:: Any sizing and position info is skipped when syncing with the data. rN) r=rIrJrr'r?rr r!rr r) rrr"rDr#r$r%r&rrrrr'%s*    z&RecycleDataAdapter.refresh_view_layoutcCs|j|=||j|j|<dS)zw(internal) Used to flag this view as dirty, ready to be used for others. See :meth:`make_views_dirty`. N)r6r8r=)rrDrrrrmake_view_dirtyFsz"RecycleDataAdapter.make_view_dirtycCs>|j}|sdS|j}|D]\}}|||j|<qi|_dS)a$Makes all the current views dirty. Dirty views are still in sync with the corresponding data. However, the size information may go out of sync. Therefore a dirty view can be reused by the same index by just updating the sizing information. Once the underlying data of this index changes, the view should be removed from the dirty views and moved to the global cache with :meth:`invalidate`. This is typically called when the layout manager needs to re-layout all the data. N)r6r8r r=)rr6r8rrDrrrmake_views_dirtyMsz#RecycleDataAdapter.make_views_dirtycCs||jD]}t|j|td7aq |jD]&\}}t||tt |7aq2tt krht i|_|j dS)atMoves all the current views into the global cache. As opposed to making a view dirty where the view is in sync with the data except for sizing information, this will completely disconnect the view from the data, as it is assumed the data has gone out of sync with the view. This is typically called when the data changes. r.N) r6valuesr r=appendr r8r extendr r rclear)rrDrr6rrr invalidateds  zRecycleDataAdapter.invalidatec Csi}|j}g}g}|j}|D]h} || d} | dk rL| || <|| | fq|| || || d} | dkrnq| || <|| | fq|} |||_||| fS)avGets a 3-tuple of the new, remaining, and old views for the current viewport. The new views are synced to the data except for the size/pos properties. The old views need to be removed from the layout, and the new views added. The new views are not necessarily *new*, but are all the currently visible views. NrC)r6rHrrNr rL) rindicesrZ viewclassesZ visible_viewsZprevious_viewsZret_newZ ret_remainrHrrDZ old_viewsrrrset_visible_views|s*    z$RecycleDataAdapter.set_visible_viewscCs |j|S)zReturns the currently visible view associated with ``index``. If no view is currently displayed for ``index`` it returns ``None``. )r6get)rrrrrget_visible_viewsz#RecycleDataAdapter.get_visible_view)r)r*r+r,rr?r6rr7r8rr:r@rArErHrr'rKrLrQrSrU __classcell__rrr<rrsH   )!&rN)r,Zkivy.propertiesrZ kivy.eventr collectionsr__all__rIlistr r r robjectrrrrrrrs    <&