logoAnt Design

⌘ K
  • Design
  • Development
  • Components
  • Blog
  • Resources
5.26.1
  • Ant Design
    • Introduction
    • Design Values
    • Cases
  • Global Styles
    • Colors
    • Layout
    • Font
    • Icons
    • Dark Mode
    • Shadow
  • Design Patterns
    • Overview
    • Global Rules
      • Feedback
      • Navigation
      • Data Entry
      • Data Display
      • Copywriting
      • Data format
      • Button
      • Data List
    • Principles
      • Proximity
      • Alignment
      • Contrast
      • Repetition
      • Make it Direct
      • Stay on the Page
      • Keep it Lightweight
      • Provide an Invitation
      • Use Transition
      • React Immediately
    • Template Document
      • Visualization Page
      • Detail Page
  • Design Patterns (Research)
    • Overview
    • Template Document
      • Form Page
      • Workbench
      • List Page
      • Result Page
      • Exception Page
    • Global Rules
      • Navigation
      • Message and Feedback
      • Empty Status
  • Visualization
  • Motion
  • Illustrations
Design goals
List type
Table
List
Card list
Operation Behavior
Search data
Search
Paging
Navigate to details
Batch operations
New
delete
List Toolbar
layout
Empty state

Data List

contributors
  • ButtonProximity

    Resources

    Ant Design X
    Ant Design Charts
    Ant Design Pro
    Pro Components
    Ant Design Mobile
    Ant Design Mini
    Ant Design Web3
    Ant Design Landing-Landing Templates
    Scaffolds-Scaffold Market
    Umi-React Application Framework
    dumi-Component doc generator
    qiankun-Micro-Frontends Framework
    Ant Motion-Motion Solution
    China Mirror 🇨🇳

    Community

    Awesome Ant Design
    Medium
    X
    yuque logoAnt Design in YuQue
    Ant Design in Zhihu
    Experience Cloud Blog
    seeconf logoSEE Conf-Experience Tech Conference

    Help

    GitHub
    Change Log
    FAQ
    Bug Report
    Issues
    Discussions
    StackOverflow
    SegmentFault

    Ant XTech logoMore Products

    yuque logoYuQue-Document Collaboration Platform
    AntV logoAntV-Data Visualization
    Egg logoEgg-Enterprise Node.js Framework
    Kitchen logoKitchen-Sketch Toolkit
    Galacean logoGalacean-Interactive Graphics Solution
    xtech logoAnt Financial Experience Tech
    Theme Editor
    Made with ❤ by
    Ant Group and Ant Design Community

    Design goals

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

    List type

    Table

    Preview

    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

    Preview

    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

    Preview

    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

    Preview

    Select the appropriate search component.

    1)Identify 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.

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

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

    Inquire

    Preview

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

    Filter

    Preview

    Users adjust the filters and the results adjust accordingly.

    Search

    Preview

    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

    Preview

    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

    Preview

    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

    Preview

    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

    Preview

    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

    Preview

    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

    Preview

    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

    Preview

    After deletion, allow user to undo.

    Second Confirmation

    Preview

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

    Security check

    Preview

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

    List Toolbar

    Preview

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

    layout

    Preview

    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

    Preview

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