List views & presentation
Table of contents
- Pop-up detail
- In-page detail (Master-Detail)
- Sorting list records
- Full-text search
- Data filtering by category
- Calendar view
The List view is the core component for displaying collections of records. You can link a list view to a detail view so that tapping any list item displays that item’s complete record.
Depending on the device screen size and UX requirements, Doypp supports two distinct master-detail presentation patterns:
- Pop-up Detail: Opens an overlay modal sheet on top of the list (optimal for smartphones).
- In-Page Detail: Displays the list and detail side-by-side in a dual-pane layout (optimal for tablets and desktop screens).
Pop-up detail
In a pop-up detail pattern, tapping an item opens a focused modal page over the current view. Tapping the “Back” button closes the popup and immediately restores the user’s position in the list.
This pattern is best suited for mobile phones, where screen real estate is limited and focused single-task views prevent visual clutter.
In-page detail (Master-Detail)
In an in-page detail pattern, the record list (master) and the selected record’s content (detail) sit side by side on the same screen. Tapping an item in the list dynamically refreshes the adjacent detail panel without page transitions.
This layout maximizes productivity on larger tablet and desktop screens by eliminating navigation round-trips.
Sorting list records
By default, list items are sorted in reverse chronological order based on their creation timestamp (created_at).
You can customize this behavior or allow end users to re-order items dynamically:
- Enable Sortable Properties: Mark desired fields (e.g.,
price,rating,due_date) as Sortable in the data model. - Set Default Ordering: Choose a primary sort field and direction (ascending or descending) in the list settings.
- Enable User Sorting: Check “Enable user sorting” and pick the fields you want to expose. An interactive sort button will appear on the view bar for users to toggle.
Full-text search
You can add real-time search capabilities to any list view with two quick steps:
- Mark Fields as Searchable: In the Data Model editor, enable the Searchable property on text fields (e.g.,
title,description,author_name). - Enable Search in View Settings: Toggle “Enable search” in the list configuration.
A search bar will appear above the list, allowing users to filter items dynamically as they type keywords.
Data filtering by category
Data filters allow you to segment list items based on categorical criteria—such as displaying work items segmented by status (New, In Progress, or Done).
To configure category filters:
- Ensure the data model includes a Choice field defining the valid categories or statuses.
- In the list view settings, select the Choice field and choose which values to filter by.
- If no specific values are selected, the list displays all records unconditionally.
Calendar view
For date-driven content (such as events, bookings, or scheduled tasks), you can transform a standard list view into an interactive Calendar view:
- In the list view settings, check “Enable calendar view”.
- Select the target Date or Date & Time field and specify which text field serves as the calendar label.
- If your model includes a Choice field with custom badge colors, Doypp uses those colors to highlight calendar entries automatically.