logoAnt Design

⌘ K
  • Design
  • Development
  • Components
  • Blog
  • Resources
5.25.0
  • 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

Data Entry

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
Twitter
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
loading

Data Entry is an important interactive way to retrieve information of objects since users will frequently add, change or delete information. Diverse ways for text input entry and selection entry help users finish interactions more clearly and efficiently. Designers should pay attention to things as follows:

  • Straightforward text should be provided as "Label" for novice users and users that access occasionally, while terminology should be provided as "Label" for domain experts. When sensitive information should be provided by users, hints can be used to specify why the system need to do so. For example, when it's necessary to retrieve a user's identity (ID) or phone number.
  • Allow users to get information via context to help completing their input. It avoids users to have wild guesses from the empty input through approaches like "good default values", "structured formats", "hints", "input tips" etc.

Text Input Entry

Input is the basic and common way for data entry, which provides a text editable component for users.

Input

Preview

It uses a single line for text input with limited length.

Note: Specific styles can be applied to some text (e.g. numbers, URL). Please refer to Input.

Textarea

Preview

It's a multi-line text input for single long text.

Tips and helps

Basic style
Preview
Basic style

Hints is usually added in Input to help remind users, which can increase efficiency for the data entry.

Note: Input usually works together with label which is to the left of input by default, while it can be on top as well when the text is too long or in English context. However, it should be consistent within the same system.

Preview
You can use an 'information' icon or a tip tool when the text is long
Preview
You can put the short input tip below the input (as shorter than a sentence).

Search

Preview

Search can help users reduce the range for target and retrieve the necessary information quickly from a huge information pool.


Selection entry

Allow users to select from a specific range

Radio Button

Preview

Radio button allows a user to select only one value from several options. Radio options should not be too many because all the options are default visible to a user so that the user can make the selection via comparison.

Note: Radio Button must be more than two options, and normally less than five.

Checkbox

Preview

Checkbox is used to select multiple values from several options.

Note:

  1. Checkbox often works together with submit action for state.
  2. A single checkbox can represent the switch of two states.

Switch

Preview

It's used to switch the state of a single option. The inline label of "Switch" should be displayed clearly, e.g. Disable/Enable, Disallow/Allow etc.


Correct Sample
Preview
Correct Sample
Incorrect Sample
Preview
Incorrect Sample
'Switch' doesn't need to work with buttons because the toggle will take effect immediately.

Note: It will trigger the state change directly when a user toggle the "Switch".

Dropdown

Preview

Dropdown provides more flexibility for the number of options, allowing a user to select one or multiple values from a list of options.

Note:

  1. Used when there are more than five options.
  2. Options is listed with logical sorting and content should be fully displayed.

Slider

Preview

Slider allows to select a suitable value by moving the anchor in a continuous or discontinuous range. It's a better choice for reflecting options of intensities or grades, e.g. volume, brightness, color saturation etc.


Preview

Note: Operations can be more flexible and convenient using "Slider" when precise value is not required. "NumberInput" can be worked together with Slider for precise values.

Transfer

Preview

Transfer the elements between two columns in an intuitive and efficient way.

DatePicker

Preview

DatePicker provides a visual way to browse and select a date or date range for users.


Upload

Upload is the process of publishing information (from local or cloud storage) to a remote server via a web page or a upload tool.

Upload by simple clicks

Preview

Normally used to upload a single file which doesn't require preview. Click the button will prompt the file selection window.

Upload by displaying thumbnails

Preview

Normally used to upload images. Users can upload images and display thumbnails in the list. The upload button will disappear when the number of images is up to a threshold.

Upload by drag-and-drop

Preview

Drag files into a specific area to upload, while it supports upload by clicking as well.

Note: Specific file size and format is required for file upload, e.g.: Please select text files (support PDF, ZIP, EXL) with size no more than 5M. Progress of uploading should be displayed.