ant-design/docs/spec/data-list.en-US.md
lijianan 9b22fd4258
site: add translate (#42879)
* site: add translate

* add
2023-06-07 11:15:32 +08:00

8.1 KiB
Raw Permalink Blame History

group type order skip title
Design Patterns Global Rules 7 true Data List

Design goals

  • Make lists easy to scan.
  • Quickly find objects in the list.

List type

Table

Emphasis on browsing. The matrix layout tends to display complex data, and the data is aligned according to the matrix layout, which is convenient for browsing data horizontally and vertically, and studying the relationship between data. Tables are used especially when the user would benefit from more data exposure without having to go into the details of the object.

List

Consider both browsing and presentation. Arranged vertically, it tends to show the basic overview of the object, and the content is displayed hierarchically, which is suitable for quick scanning. Especially when the display space is limited, such as smaller pop-up windows, sidebars, drop-down panels and other containers, use lists.

Card list

Emphasis on presentation. The grid layout has no specific browsing order, and each object has a more equal display opportunity. The grid layout is more attractive on the page and is suitable for highlighting objects.

Operation Behavior

Search data

Select the appropriate search component.

1Identify the main search patterns of users.

  • Known Items Exploration: Start the search with verbally describable known items.
  • Exploratory query: search for a target with a defined but broad scope.

2The higher the search frequency, the higher the efficiency requirements.

3Communicate well with developers to understand system performance and select appropriate components.

Inquire

According to the preset conditions, select multiple query conditions and submit the acquisition query at one time.

Filter

Users adjust the filters and the results adjust accordingly.

Smarter search, enter keywords to query in multiple data attributes at one time, and display the results.

Paging

By default, page loading is used to reduce user waiting. The user's browsing position in the original list should be cached, and the browsed items in the list should be marked. When the user returns to the previous page, the user returns to the original browsing position.

Pagination

Recommended by default. When used, when the content of the page is less than one page, the pager will not be displayed.

same page load

This mode can be considered when users can often find the desired item at the top of the list and there is no need to locate a specific list item, such as dynamics and emails.

view all

Use when you need to jump to the page to view the complete list.

Navigate to details

mainly

By default, click on the title to navigate to the details, and you can judge how to open the details from the following angles:

  • From the perspective of natural interaction, Expand the list on the same page is more natural, and it should be noted that the height of the expanded content area should not exceed one screen;
  • From the perspective of the amount of information in the details, if the information display exceeds one screen, it is not convenient for the user to use the unfolding method. At this time, it is better to use Drawer Expand;
  • Details need to be shared with others separately, or complex immersive tasks, jump to independent page is more suitable;
  • There may be content that the user is interested in in each item of detail, so as to facilitate switching navigation, quickly view and process different items, you can use the ** double column display. **

Batch operations

When the user checks the item, the batch operation mode is triggered, and the list toolbar calls out the batch operation toolbar.

New

New button in the upper right corner

Click to trigger a new form pop-up window, drawer, page, etc. After the creation is completed, the newly created content appears in the first item of the list and is briefly highlighted.

Dashed New Button

Click New, and the object editing area will appear at the button position, and the newly created object will be displayed at this position after the creation is completed. The dotted new button position is placed at the beginning or end of the list.

delete

Delete directly

After deletion, allow user to undo.

Second Confirmation

When clicking the delete operation, a second confirmation is required.

Security check

Destructive operations require high-level security verification to confirm operations.

List Toolbar

Common features needed to integrate lists in a small space, highly recommended.

layout

List layouts are usually tiled from top to bottom, in the following order. Among them, the exclusive area provides an expansion space for solving complex data search and data statistics content that cannot be integrated in the toolbar.

Empty state

When the list has no data or no search results, an empty state should be displayed.