41 lines
2.4 KiB
Plaintext
41 lines
2.4 KiB
Plaintext
MAIN GRID SPECS
|
|
|
|
OVERVIEW
|
|
Main grids show all the stuff people have entered in Raven and are used for selection to edit/ view, filter and sort for reporting and mass operations.
|
|
Proposed system is a hybrid grid system that has two modes to take into account the width of the display device:
|
|
- Xtra Small (XS ) < 600 pixels wide (my phone is 393px)
|
|
- In this mode only one column shows and it's formatted according to the Display Format Template
|
|
- DisplayFormatTemplate is specd in the core-display-format-template-system.txt doc
|
|
- So the user chooses which columns to show in a small factor themselves, default is name only or equivalent
|
|
|
|
|
|
CASES
|
|
None that are intrinsically grid related really, just 3 or so regarding specfic fields to add to grids
|
|
|
|
|
|
REQUIREMENTS
|
|
|
|
Client
|
|
- Client needs to tell the server which form of list is required, i.e. it's client window size when fetching a list
|
|
- HYBRID BIMODAL: XS or LARGE (for now but consider maybe a medium down the road in planning)
|
|
- in XS mode
|
|
- the client sends "viewport=xs" to the client with the grid data request
|
|
- Client receives two field list back (id and display field), displays the single field
|
|
- in large mode
|
|
- the client sends no viewport= parameter as it's optional and understood to be full size
|
|
- the list comes back as an object with not only the actual columns but also a separate property listing the set of columns in order to be displayed
|
|
- Also their data type
|
|
- Also need to handle links of what type of object and or ID to open maybe for each column
|
|
- Client expects an arbitrary set of columns in an arbitrary order defined by server so doesn't have a pre-ordained set of things.
|
|
- HMMM... Maybe I only need a single list object that adapts to the data being sent back
|
|
|
|
Server
|
|
- Server needs to accept a parameter from the client when a grid list is fetched that tells it if it needs to send a single column templated list
|
|
- viewport="XS" I think would be sufficient
|
|
- Grid lists need to know what their template is as more than one list might use the same template?
|
|
- SERVER SENDS LIST OF COLUMNS
|
|
- The server needs to tell the client which columns are coming back with the list and what types etc so the client can just adapt to any template setting
|
|
|
|
|
|
Back AND front end
|
|
|