List_view

A List view is a view to display collections of data.

NOTE: All List views must be placed into a Scroll_view for proper operation.

NOTE 2: From SC version 0.9.16 on, :outlet is no more, so only include it for previous versions of SC.

    <%= list_view :name_of_view, 
       :outlet => true/false, 
       :example_view => 'SC.ListItemView', 
       :is_editable => true/false,
       :content_value_key => 'nameofcontentvaluekey',
       :can_order_content => true/false,
       :content_value_editable => true/false,
       :can_reorder_content => true/false,
       :bind => { 
         :content => 'App.collectionController.arrangedObjects',
         :selection => 'App.collectionController.selection'
       }
%>

Attributes:

• name_of_view :: The name of the view for referencing in JavaScript
• outlet :: Whether or not the view needs to be available in JavaScript (needs to be true to display dynamic content)
• example_view :: The template view used to display a collection item
• is_editable :: Set to false when you don’t want the user to be able to edit the field
• content_value_key => The property of the record to be displayed. It can be a computed property.
• can_order_content :: Whether the collection view allows to order the content
• content_value_editable :: Whether the user is able to edit the value of the content
• can_reorder_content :: Whether the view can be used to reorder content (for drag and drop functionality, so leave to false if no drag and drop use is intended)
• bind
  • content :: The content of the collection controller. Set it to the arrangedObjects property of a collection controller.
  • selection :: The property of the collection controller the selection made by the user needs to be put into.

For proper operation, the CSS styling of the list view and all the parent views must be set to

#name_of_view {
  position: absolute;
}

Of course the position of the element itself is free, but it must have a top, left, height and width setting.

Comments