logoAnt Design

⌘ K
  • Design
  • Development
  • Components
  • Blog
  • Resources
5.25.4
  • 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
Text Input Entry
Input
Textarea
Tips and helps
Search
Selection entry
Checkbox
Switch
Dropdown
Slider
Transfer
DatePicker
Upload
Upload by simple clicks
Upload by displaying thumbnails
Upload by drag-and-drop

Data Entry

contributors
  • NavigationData Display

    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

    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.