= !BluePrint: Data List =
[[TOC]]

== Introduction ==

In many cases, the representation of data in a table visually dissolves the structure of the information, and is therefore much more difficult to consume for user.

An alternative concept is to represent records as a list of ''cards'' with a context-adapted per-item design (typically nested DIVs which allow various styling options).

The most commonly known example for this concept is certainly the facebook-timeline, but many other websites have adopted this concept as well.

Currently, Sahana-Eden lacks a framework for these '''data lists''' - whilst there is a fairly complete framework for data tables. This !BluePrint is for a datatables-equivalent framework for data lists.

== Description ==

  - ''tbw''

== Use-Cases ==

  - active tasks for a project (or a user)
  - timeline of incident reports
  - CAP alerts
  - list of requests
  - list of projects

== Requirements ==

  - ''tbw''

== Design ==

  - ''tbw''

== Implementation ==

  - Renderer: S3DataList in s3data.py
  - CRUD integration: currently as /list_div method

== References ==

  - ...

----
BluePrint