Files
ant-design/docs/spec/data-entry.html
T
2017-06-13 15:28:13 +08:00

125 lines
39 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="An enterprise-class UI design language and React-based implementation">
<meta name="description" content="A set of high-quality React components">
<meta name="description" content="One of best React UI library for enterprise background">
<title>Ant Design - A UI Design Language</title>
<script>
(function() {
function isLocalStorageNameSupported() {
var testKey = 'test';
var storage = window.localStorage;
try {
storage.setItem(testKey, '1');
storage.removeItem(testKey);
return true;
} catch (error) {
return false;
}
}
// 优先级提高到所有静态资源的前面,语言不对,加载其他静态资源没意义
var pathname = location.pathname;
function isZhCN(pathname) {
return /-cn\/?$/.test(pathname);
}
function getLocalizedPathname(path, zhCN) {
var pathname = path.startsWith('/') ? path : '/' + path;
if (!zhCN) { // to enUS
return /\/?index-cn/.test(pathname) ? '/' : pathname.replace('-cn', '');
} else if (pathname === '/') {
return '/index-cn';
} else if (pathname.endsWith('/')) {
return pathname.replace(/\/$/, '-cn/');
}
return pathname + '-cn';
}
// 兼容旧的 URL `?locale=...`
var queryString = location.search;
if (queryString) {
var isZhCNConfig = queryString.indexOf('zh-CN') > -1;
if (isZhCNConfig && !isZhCN(pathname)) {
location.pathname = getLocalizedPathname(pathname, isZhCNConfig)
}
}
// 首页无视链接里面的语言设置 https://github.com/ant-design/ant-design/issues/4552
if (isLocalStorageNameSupported() && (pathname === '/' || pathname === '/index-cn')) {
var lang = (window.localStorage && localStorage.getItem('locale')) || (navigator.language.toLowerCase() === 'zh-cn' ? 'zh-CN' : 'en-US');
// safari is 'zh-cn', while other browser is 'zh-CN';
if ((lang === 'zh-CN') !== isZhCN(pathname)) {
location.pathname = getLocalizedPathname(pathname, lang === 'zh-CN');
}
}
document.documentElement.className += isZhCN(pathname) ? 'zh-cn' : 'en-us';
})()
</script>
<link rel="icon" href="https://t.alipayobjects.com/images/T1QUBfXo4fXXXXXXXX.png" type="image/x-icon">
<link rel="stylesheet" type="text/css" href="https://fonts.googleapis.cnpmjs.org/css?family=Lato:400,700|Raleway"/>
<link rel="stylesheet" type="text/css" href="/index-1.css"/>
<link rel="stylesheet" type="text/css" href="/index-2.css"/>
<style id="nprogress-style">
#nprogress { display: none }
</style>
<!--[if lte IE 10]>
<script
src="https://as.alipayobjects.com/g/component/??console-polyfill/0.2.2/index.js,media-match/2.0.2/media.match.min.js"></script>
<![endif]-->
<script>
if (!window.Intl) {
document.writeln('<script src="https://as.alipayobjects.com/g/component/intl/1.0.1/??Intl.js,locale-data/jsonp/en.js,locale-data/jsonp/zh.js">' + '<' + '/script>');
}
if (!window.Promise) {
document.writeln('<script src="https://as.alipayobjects.com/g/component/es6-promise/3.2.2/es6-promise.min.js"' + '>' + '<' + '/' + 'script>');
}
// Enable Google Analytics
if (!location.port) {
/* eslint-disable */
(function (i, s, o, g, r, a, m) {
i['GoogleAnalyticsObject'] = r;
i[r] = i[r] || function () {
(i[r].q = i[r].q || []).push(arguments)
}, i[r].l = 1 * new Date();
a = s.createElement(o),
m = s.getElementsByTagName(o)[0];
a.async = 1;
a.src = g;
m.parentNode.insertBefore(a, m)
})(window, document, 'script', '//www.google-analytics.com/analytics.js', 'ga');
ga('create', 'UA-72788897-1', 'auto');
ga('send', 'pageview');
/* eslint-enable */
}
</script>
<!-- Hotjar Tracking Code for ant.design -->
<script>
(function(h,o,t,j,a,r){
h.hj=h.hj||function(){(h.hj.q=h.hj.q||[]).push(arguments)};
h._hjSettings={hjid:473408,hjsv:5};
a=o.getElementsByTagName('head')[0];
r=o.createElement('script');r.async=1;
r.src=t+h._hjSettings.hjid+j+h._hjSettings.hjsv;
a.appendChild(r);
})(window,document,'//static.hotjar.com/c/hotjar-','.js?sv=');
</script>
</head>
<body>
<div id="react-content">
<div class="page-wrapper" data-reactroot="" data-reactid="1" data-react-checksum="1101401311"><header id="header" class="clearfix" data-reactid="2"><div class="ant-row" data-reactid="3"><div class="ant-col-xs-24 ant-col-sm-24 ant-col-md-5 ant-col-lg-4" data-reactid="4"><a id="logo" href="/" data-reactid="5"><img alt="logo" src="https://t.alipayobjects.com/images/rmsweb/T1B9hfXcdvXXXXXXXX.svg" data-reactid="6"/><span data-reactid="7">Ant Design</span></a></div><div class="ant-col-xs-0 ant-col-sm-0 ant-col-md-19 ant-col-lg-20" data-reactid="8"><div id="search-box" data-reactid="9"><div class="ant-select ant-select-combobox ant-select-enabled" data-reactid="10"><div class="ant-select-selection
ant-select-selection--single" role="combobox" aria-autocomplete="list" aria-haspopup="true" aria-expanded="false" data-reactid="11"><div class="ant-select-selection__rendered" data-reactid="12"><div style="display:block;user-select:none;-webkit-user-select:none;" unselectable="unselectable" class="ant-select-selection__placeholder" data-reactid="13">Search Components...</div><ul data-reactid="14"><li class="ant-select-search ant-select-search--inline" data-reactid="15"><div class="ant-select-search__field__wrap" data-reactid="16"><input value="" class="ant-select-search__field" data-reactid="17"/><span class="ant-select-search__field__mirror" data-reactid="18"><!-- react-text: 19 --><!-- /react-text --><!-- react-text: 20 --> <!-- /react-text --></span></div></li></ul></div><span class="ant-select-arrow" style="user-select:none;-webkit-user-select:none;" unselectable="unselectable" data-reactid="21"><b data-reactid="22"></b></span></div></div></div><button type="button" class="ant-btn ant-btn-ghost ant-btn-sm lang" data-reactid="23"><span data-reactid="24">中文</span></button><div class="ant-select-sm version ant-select ant-select-enabled" data-reactid="25"><div class="ant-select-selection
ant-select-selection--single" role="combobox" aria-autocomplete="list" aria-haspopup="true" aria-expanded="false" tabindex="0" data-reactid="26"><div class="ant-select-selection__rendered" data-reactid="27"><div class="ant-select-selection-selected-value" title="2.11.0" style="display:block;opacity:1;" data-reactid="28">2.11.0</div></div><span class="ant-select-arrow" style="user-select:none;-webkit-user-select:none;" unselectable="unselectable" data-reactid="29"><b data-reactid="30"></b></span></div></div><ul class="ant-menu ant-menu-horizontal ant-menu-light ant-menu-root" role="menu" aria-activedescendant="" id="nav" tabindex="0" data-reactid="31"><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="32"><a href="/" data-reactid="33"><span data-reactid="34">Home</span></a></li><li class="ant-menu-item-selected ant-menu-item" role="menuitem" aria-selected="true" data-reactid="35"><a href="/docs/spec/introduce" data-reactid="36"><span data-reactid="37">Guidelines</span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="38"><a href="/docs/react/introduce" data-reactid="39"><span data-reactid="40">Components</span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="41"><a href="/docs/pattern/navigation" data-reactid="42"><span data-reactid="43">Patterns</span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="44"><a href="/docs/resource/download" data-reactid="45"><span data-reactid="46">Resources</span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="47"><a href="//mobile.ant.design" data-reactid="48"><span data-reactid="49">Mobile</span></a></li></ul></div></div></header><div class="main-wrapper" data-reactid="50"><div class="ant-row" data-reactid="51"><div class="ant-col-xs-24 ant-col-sm-24 ant-col-md-6 ant-col-lg-4" data-reactid="52"><ul class="ant-menu ant-menu-inline aside-container ant-menu-light ant-menu-root" role="menu" aria-activedescendant="" tabindex="0" data-reactid="53"><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="54"><a href="/docs/spec/introduce" data-reactid="55">Ant Design</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="56"><a href="/docs/spec/feature" data-reactid="57">Features</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="58"><a href="/docs/spec/cases" data-reactid="59">Cases</a></li><li class="ant-menu-submenu-inline ant-menu-submenu-open ant-menu-submenu" data-reactid="60"><div style="padding-left:24px;" class="ant-menu-submenu-title" aria-expanded="true" aria-owns="Principles$Menu" aria-haspopup="true" data-reactid="61"><h4 data-reactid="62">Principles</h4></div><ul class="ant-menu ant-menu-inline ant-menu-sub" role="menu" aria-activedescendant="" id="Principles$Menu" data-reactid="63"><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="64"><a href="/docs/spec/proximity" data-reactid="65">Proximity</a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="66"><a href="/docs/spec/alignment" data-reactid="67">Alignment</a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="68"><a href="/docs/spec/contrast" data-reactid="69">Contrast</a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="70"><a href="/docs/spec/repetition" data-reactid="71">Repetition</a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="72"><a href="/docs/spec/direct" data-reactid="73">Make it Direct</a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="74"><a href="/docs/spec/stay" data-reactid="75">Stay on the Page</a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="76"><a href="/docs/spec/lightweight" data-reactid="77">Keep it Lightweight</a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="78"><a href="/docs/spec/invitation" data-reactid="79">Provide an Invitation</a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="80"><a href="/docs/spec/transition" data-reactid="81">Use Transition</a></li><li style="padding-left:48px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="82"><a href="/docs/spec/reaction" data-reactid="83">React Immediately</a></li></ul></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="84"><a href="/docs/spec/colors" data-reactid="85">Colors</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="86"><a href="/docs/spec/icon" data-reactid="87">Icons</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="88"><a href="/docs/spec/font" data-reactid="89">Font</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="90"><a href="/docs/spec/copywriting" data-reactid="91">Copywriting</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="92"><a href="/docs/spec/layout" data-reactid="93">Layout</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="94"><a href="/docs/spec/navigation" data-reactid="95">Navigation</a></li><li style="padding-left:24px;" class="ant-menu-item-selected ant-menu-item" role="menuitem" aria-selected="true" data-reactid="96"><a href="/docs/spec/data-entry" data-reactid="97">Data Entry</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="98"><a href="/docs/spec/data-display" data-reactid="99">Data Display</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="100"><a href="/docs/spec/feedback" data-reactid="101">Feedback</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="102"><a href="http://motion.ant.design" target="_blank" rel="noopener noreferrer" class="menu-item-link-outside" data-reactid="103"><!-- react-text: 104 -->Motion<!-- /react-text --><!-- react-text: 105 --> <!-- /react-text --><i class="anticon anticon-export" data-reactid="106"></i></a></li></ul></div><div class="main-container ant-col-xs-24 ant-col-sm-24 ant-col-md-18 ant-col-lg-20" data-reactid="107"><article class="markdown" data-reactid="108"><div data-show="true" class="ant-alert ant-alert-warning ant-alert-no-icon" data-reactid="109"><span class="ant-alert-message" data-reactid="110"><span data-reactid="111"><!-- react-text: 112 -->This article has not been translated, hope that your can PR to translated it.<!-- /react-text --><a href="https://github.com/ant-design/ant-design/issues/1471" data-reactid="113"> Help us!</a></span></span><span class="ant-alert-description" data-reactid="114"></span></div><h1 data-reactid="115"><!-- react-text: 116 -->Data Entry<!-- /react-text --><a class="edit-button" href="https://github.com/ant-design/ant-design/edit/master/docs/spec/data-entry.md" data-reactid="117"><i class="anticon anticon-edit" data-reactid="118"></i></a></h1><section class="markdown" data-reactid="119"><p data-reactid="120"><!-- react-text: 121 -->数据录入是获取对象信息的重要交互方式,用户会频繁的增加、修改或删除信息。多种多样的文本录入和选择录入方式帮助用户更加清晰和高效的完成这项体验。设计者应当注意这几点:<!-- /react-text --></p><ul data-reactid="122"><li data-reactid="123"><p data-reactid="124"><!-- react-text: 125 -->为初级用户/偶尔访问的用户提供简单易懂的文案作为『标签(Label) 』;为领域专家提供专业术语作为『标签(Label) 』。当需要用户提供敏感信息时,通过『暗提示』来说明系统为什么要这么做,例如:需要获取身份证号码、手机号码时;<!-- /react-text --></p></li><li data-reactid="126"><p data-reactid="127"><!-- react-text: 128 -->让用户能在上下文中获取信息,帮助他完成输入。使用『良好的默认值』、『结构化的格式』、『暗提示』、『输入提醒』等方式,避免让用户在空白中猜测输入。<!-- /react-text --></p></li></ul></section><section class="toc" data-reactid="129"><ul data-reactid="130"><li data-reactid="131"><a class="bisheng-toc-h2" href="#文本录入" title="文本录入" data-reactid="132"><!-- react-text: 133 -->文本录入<!-- /react-text --></a></li><li data-reactid="134"><a class="bisheng-toc-h2" href="#选择录入" title="选择录入" data-reactid="135"><!-- react-text: 136 -->选择录入<!-- /react-text --></a></li><li data-reactid="137"><a class="bisheng-toc-h2" href="#文件上传(Upload" title="文件上传(Upload" data-reactid="138"><!-- react-text: 139 -->文件上传(Upload<!-- /react-text --></a></li></ul></section><section class="markdown" data-reactid="140"><h2 id="文本录入" data-reactid="141"><span data-reactid="142"><!-- react-text: 143 -->文本录入<!-- /react-text --></span><a href="#文本录入" class="anchor" data-reactid="144">#</a></h2><p data-reactid="145"><!-- react-text: 146 -->输入框为用户提供了编辑文本的控件,是录入数据最基础和常见的方式。<!-- /react-text --></p><h3 id="文本框(Input" data-reactid="147"><span data-reactid="148"><!-- react-text: 149 -->文本框(Input<!-- /react-text --></span><a href="#文本框(Input" class="anchor" data-reactid="150">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="151"><div class="preview-image-box" data-reactid="152"><div class="preview-image-wrapper" data-reactid="153"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/BPMNkGkHFqbBCRMUdfRh.png" data-reactid="154"/></div><div class="preview-image-title" data-reactid="155"></div><div class="preview-image-description" data-reactid="156"></div><!-- react-empty: 157 --></div></div><p data-reactid="158"><!-- react-text: 159 -->输入较少的字符总数,使用单行的输入形式。<!-- /react-text --></p><blockquote data-reactid="160"><p data-reactid="161"><!-- react-text: 162 -->注:可以对一些文本(如数字和网址)运用特别的样式。详见 <!-- /react-text --><a href="/components/input/" data-reactid="163">输入框(Input</a><!-- react-text: 164 --><!-- /react-text --></p></blockquote><h3 id="文本域(Textarea" data-reactid="165"><span data-reactid="166"><!-- react-text: 167 -->文本域(Textarea<!-- /react-text --></span><a href="#文本域(Textarea" class="anchor" data-reactid="168">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="169"><div class="preview-image-box" data-reactid="170"><div class="preview-image-wrapper" data-reactid="171"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/QVRSSdYrWjthpCOupqON.png" data-reactid="172"/></div><div class="preview-image-title" data-reactid="173"></div><div class="preview-image-description" data-reactid="174"></div><!-- react-empty: 175 --></div></div><p data-reactid="176"><!-- react-text: 177 -->录入长篇幅的单一的文本使用多行的文本区域。<!-- /react-text --></p><h3 id="提示与帮助" data-reactid="178"><span data-reactid="179"><!-- react-text: 180 -->提示与帮助<!-- /react-text --></span><a href="#提示与帮助" class="anchor" data-reactid="181">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="182"><div class="preview-image-box" data-reactid="183"><div class="preview-image-wrapper" data-reactid="184"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/KSWwgpyjPkbwclNvbvvR.png" alt="基本样式" data-reactid="185"/></div><div class="preview-image-title" data-reactid="186">基本样式</div><div class="preview-image-description" data-reactid="187"></div><!-- react-empty: 188 --></div></div><p data-reactid="189"><!-- react-text: 190 -->为提升数据录入效率,通常可以在输入框内增加暗提示以帮助提醒用户。<!-- /react-text --></p><blockquote data-reactid="191"><p data-reactid="192"><!-- react-text: 193 -->注:输入框通常与标签(label)搭配使用,标签(label)默认放于输入区域的左侧,当文案过长或英文环境下也可放于在上方,但同个系统中需保持统一。<!-- /react-text --></p></blockquote><div class="preview-image-boxes clearfix" data-reactid="194"><div class="preview-image-box" data-reactid="195"><div class="preview-image-wrapper" data-reactid="196"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/RtFCPKSMfRlgISbMJJRy.png" data-reactid="197"/></div><div class="preview-image-title" data-reactid="198"></div><div class="preview-image-description" data-reactid="199">当说明文案较长时,你可以使用一个『信息』图标或者提示工具。</div><!-- react-empty: 200 --></div></div><div class="preview-image-boxes clearfix" data-reactid="201"><div class="preview-image-box" data-reactid="202"><div class="preview-image-wrapper" data-reactid="203"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/rElfIRpcmLsCTFzZDINy.png" data-reactid="204"/></div><div class="preview-image-title" data-reactid="205"></div><div class="preview-image-description" data-reactid="206">对于那些短的输入提醒(短于一句),你可以将其放置在输入框的下方。</div><!-- react-empty: 207 --></div></div><h3 id="搜索(Search" data-reactid="208"><span data-reactid="209"><!-- react-text: 210 -->搜索(Search<!-- /react-text --></span><a href="#搜索(Search" class="anchor" data-reactid="211">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="212"><div class="preview-image-box" data-reactid="213"><div class="preview-image-wrapper" data-reactid="214"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/ycPmRlbZtsoYAibbwMCZ.png" data-reactid="215"/></div><div class="preview-image-title" data-reactid="216"></div><div class="preview-image-description" data-reactid="217"></div><!-- react-empty: 218 --></div></div><p data-reactid="219"><!-- react-text: 220 -->搜索可以让用户在巨大的信息池中缩小目标范围,并快速获取需要的信息。<!-- /react-text --></p><hr data-reactid="221"/><h2 id="选择录入" data-reactid="222"><span data-reactid="223"><!-- react-text: 224 -->选择录入<!-- /react-text --></span><a href="#选择录入" class="anchor" data-reactid="225">#</a></h2><p data-reactid="226"><!-- react-text: 227 -->让用户在一个预定的范围中进行选择。<!-- /react-text --></p><h4 id="单选框(Radio-Button" data-reactid="228"><span data-reactid="229"><!-- react-text: 230 -->单选框(Radio Button<!-- /react-text --></span><a href="#单选框(Radio-Button" class="anchor" data-reactid="231">#</a></h4><div class="preview-image-boxes clearfix" data-reactid="232"><div class="preview-image-box" data-reactid="233"><div class="preview-image-wrapper" data-reactid="234"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/EvxgOJzHiQAxpuRaEhbH.png" data-reactid="235"/></div><div class="preview-image-title" data-reactid="236"></div><div class="preview-image-description" data-reactid="237"></div><!-- react-empty: 238 --></div></div><p data-reactid="239"><!-- react-text: 240 -->单选按钮允许用户从多个选项中选择一个选项。Radio 所有选项默认可见,方便用户在比较中选择,因此选项不宜过多。<!-- /react-text --></p><blockquote data-reactid="241"><p data-reactid="242"><!-- react-text: 243 -->注:单选框(Radio Button)一定多于 2 个,一般少于 5 个。<!-- /react-text --></p></blockquote><h3 id="复选框(Checkbox" data-reactid="244"><span data-reactid="245"><!-- react-text: 246 -->复选框(Checkbox<!-- /react-text --></span><a href="#复选框(Checkbox" class="anchor" data-reactid="247">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="248"><div class="preview-image-box" data-reactid="249"><div class="preview-image-wrapper" data-reactid="250"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/duKUrQDKiyPnYaWtvkQK.png" data-reactid="251"/></div><div class="preview-image-title" data-reactid="252"></div><div class="preview-image-description" data-reactid="253"></div><!-- react-empty: 254 --></div></div><p data-reactid="255"><!-- react-text: 256 -->复选框用于在一组可选项中进行多项选择时。<!-- /react-text --></p><blockquote data-reactid="257"><p data-reactid="258"><!-- react-text: 259 -->注:
1. 复选框(Checkbox)一般用于状态标记,需要和提交操作配合;
2. 单个复选框可以表示两种状态之间的切换。<!-- /react-text --></p></blockquote><h3 id="开关(Switch" data-reactid="260"><span data-reactid="261"><!-- react-text: 262 -->开关(Switch<!-- /react-text --></span><a href="#开关(Switch" class="anchor" data-reactid="263">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="264"><div class="preview-image-box" data-reactid="265"><div class="preview-image-wrapper" data-reactid="266"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/aIdIORGzFNjqMwrmiguZ.png" data-reactid="267"/></div><div class="preview-image-title" data-reactid="268"></div><div class="preview-image-description" data-reactid="269"></div><!-- react-empty: 270 --></div></div><p data-reactid="271"><!-- react-text: 272 -->用于切换单个选项的状态。『开关』的内联标签应该显示清楚,例如:禁用/启用,不允许/允许等。<!-- /react-text --></p><p data-reactid="273"><br data-reactid="274"/></p><div class="preview-image-boxes clearfix" data-reactid="275"><div class="preview-image-box" style="width:50%;" data-reactid="276"><div class="preview-image-wrapper good" data-reactid="277"><img class="preview-img no-padding good" src="https://zos.alipayobjects.com/rmsportal/qoqGjsZYATDiXiWEjNIK.png" alt="正确示范" data-reactid="278"/></div><div class="preview-image-title" data-reactid="279">正确示范</div><div class="preview-image-description" data-reactid="280"></div><!-- react-empty: 281 --></div><div class="preview-image-box" style="width:50%;" data-reactid="282"><div class="preview-image-wrapper bad" data-reactid="283"><img class="preview-img no-padding bad" src="https://zos.alipayobjects.com/rmsportal/ZcWvStIELApkpnkDOWDG.png" alt="错误示范" data-reactid="284"/></div><div class="preview-image-title" data-reactid="285">错误示范</div><div class="preview-image-description" data-reactid="286">切换『开关』结果会立即生效,无需与操作按钮搭配使用。</div><!-- react-empty: 287 --></div></div><blockquote data-reactid="288"><p data-reactid="289"><!-- react-text: 290 -->注:当用户切换『开关』按钮将直接触发状态改变。<!-- /react-text --></p></blockquote><h3 id="选择列表(Dropdown" data-reactid="291"><span data-reactid="292"><!-- react-text: 293 -->选择列表(Dropdown<!-- /react-text --></span><a href="#选择列表(Dropdown" class="anchor" data-reactid="294">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="295"><div class="preview-image-box" data-reactid="296"><div class="preview-image-wrapper" data-reactid="297"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/iGSmUHkADwVyhuTOBkpJ.png" data-reactid="298"/></div><div class="preview-image-title" data-reactid="299"></div><div class="preview-image-description" data-reactid="300"></div><!-- react-empty: 301 --></div></div><p data-reactid="302"><!-- react-text: 303 -->选择列表(通常称为下拉菜单)允许用户从列表中选择一个选项或多个选项,为用户在选项的数量上提供了更多的灵活性。<!-- /react-text --></p><blockquote data-reactid="304"><p data-reactid="305"><!-- react-text: 306 -->注:
1. 当选项多于 5 项时使用;
2. 列表选项按照逻辑排序,并尽量让内容显示完整。<!-- /react-text --></p></blockquote><h3 id="滑块选择(Slider" data-reactid="307"><span data-reactid="308"><!-- react-text: 309 -->滑块选择(Slider<!-- /react-text --></span><a href="#滑块选择(Slider" class="anchor" data-reactid="310">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="311"><div class="preview-image-box" data-reactid="312"><div class="preview-image-wrapper" data-reactid="313"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/JJZycUHtpopKCMxXyQpx.png" data-reactid="314"/></div><div class="preview-image-title" data-reactid="315"></div><div class="preview-image-description" data-reactid="316"></div><!-- react-empty: 317 --></div></div><p data-reactid="318"><!-- react-text: 319 -->滑块选择可以在连续或间断的区间内,通过滑动锚点来选择一个合适的数值。这种交互特性使得它在设置诸如音量,亮度,色彩饱和度等需要反映强度等级的选项时是一种极好的选择。<!-- /react-text --></p><p data-reactid="320"><br data-reactid="321"/></p><div class="preview-image-boxes clearfix" data-reactid="322"><div class="preview-image-box" data-reactid="323"><div class="preview-image-wrapper" data-reactid="324"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/hWhUUUzikHarZSBhefDI.png" data-reactid="325"/></div><div class="preview-image-title" data-reactid="326"></div><div class="preview-image-description" data-reactid="327"></div><!-- react-empty: 328 --></div></div><blockquote data-reactid="329"><p data-reactid="330"><!-- react-text: 331 -->注:在不要求精准数值的场景下用户使用『连续滑块』可得到更灵活便捷的操作;在用户需要精确数值时,可与『数字输入框』搭配使用。<!-- /react-text --></p></blockquote><h3 id="穿梭框(Transfer" data-reactid="332"><span data-reactid="333"><!-- react-text: 334 -->穿梭框(Transfer<!-- /react-text --></span><a href="#穿梭框(Transfer" class="anchor" data-reactid="335">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="336"><div class="preview-image-box" data-reactid="337"><div class="preview-image-wrapper" data-reactid="338"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/VpfyicZPlNugqEjQKSDf.png" data-reactid="339"/></div><div class="preview-image-title" data-reactid="340"></div><div class="preview-image-description" data-reactid="341"></div><!-- react-empty: 342 --></div></div><p data-reactid="343"><!-- react-text: 344 -->穿梭框用直观的方式在两栏中移动元素,完成选择行为。<!-- /react-text --></p><h3 id="日期选择器(DatePicker" data-reactid="345"><span data-reactid="346"><!-- react-text: 347 -->日期选择器(DatePicker<!-- /react-text --></span><a href="#日期选择器(DatePicker" class="anchor" data-reactid="348">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="349"><div class="preview-image-box" data-reactid="350"><div class="preview-image-wrapper" data-reactid="351"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/gaaLemRmjgNpcnlthmkr.png" data-reactid="352"/></div><div class="preview-image-title" data-reactid="353"></div><div class="preview-image-description" data-reactid="354"></div><!-- react-empty: 355 --></div></div><p data-reactid="356"><!-- react-text: 357 -->日期选择器为用户提供了一种可视化的方式去浏览和选择一个日期或者日期范围。<!-- /react-text --></p><hr data-reactid="358"/><h2 id="文件上传(Upload" data-reactid="359"><span data-reactid="360"><!-- react-text: 361 -->文件上传(Upload<!-- /react-text --></span><a href="#文件上传(Upload" class="anchor" data-reactid="362">#</a></h2><p data-reactid="363"><!-- react-text: 364 -->上传是将本地的相应信息(包含本地和云储存)通过网页或者上传工具发布到远程服务器上的过程。<!-- /react-text --></p><h3 id="简单点击上传" data-reactid="365"><span data-reactid="366"><!-- react-text: 367 -->简单点击上传<!-- /react-text --></span><a href="#简单点击上传" class="anchor" data-reactid="368">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="369"><div class="preview-image-box" data-reactid="370"><div class="preview-image-wrapper" data-reactid="371"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/aqMzAypQRBkmWfMOpOCE.png" data-reactid="372"/></div><div class="preview-image-title" data-reactid="373"></div><div class="preview-image-description" data-reactid="374"></div><!-- react-empty: 375 --></div></div><p data-reactid="376"><!-- react-text: 377 -->一般用于单个上传且不需要预览效果的文件上传,点击按钮弹出文件选择框。<!-- /react-text --></p><h3 id="显示缩略图上传" data-reactid="378"><span data-reactid="379"><!-- react-text: 380 -->显示缩略图上传<!-- /react-text --></span><a href="#显示缩略图上传" class="anchor" data-reactid="381">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="382"><div class="preview-image-box" data-reactid="383"><div class="preview-image-wrapper" data-reactid="384"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/oUsyeTsjadJfieTspgVq.png" data-reactid="385"/></div><div class="preview-image-title" data-reactid="386"></div><div class="preview-image-description" data-reactid="387"></div><!-- react-empty: 388 --></div></div><p data-reactid="389"><!-- react-text: 390 -->一般用于图片文件上传,用户可以上传图片并在列表中显示缩略图。当上传照片数到达限制后,上传按钮消失。<!-- /react-text --></p><h3 id="拖拽上传" data-reactid="391"><span data-reactid="392"><!-- react-text: 393 -->拖拽上传<!-- /react-text --></span><a href="#拖拽上传" class="anchor" data-reactid="394">#</a></h3><div class="preview-image-boxes clearfix" data-reactid="395"><div class="preview-image-box" data-reactid="396"><div class="preview-image-wrapper" data-reactid="397"><img class="preview-img no-padding" src="https://zos.alipayobjects.com/rmsportal/euEBewdgKmhThFWrWHIm.png" data-reactid="398"/></div><div class="preview-image-title" data-reactid="399"></div><div class="preview-image-description" data-reactid="400"></div><!-- react-empty: 401 --></div></div><p data-reactid="402"><!-- react-text: 403 -->把文件拖入指定区域,完成上传,同样支持点击上传。<!-- /react-text --></p><blockquote data-reactid="404"><p data-reactid="405"><!-- react-text: 406 -->注:文件上传需要提供明确的文件大小和文件格式,例如:请选择大小不超过 5M 的文本文件(支持 PDF.ZIP.EXL),上传时需要有明确的进度提示。<!-- /react-text --></p></blockquote></section><section class="markdown api-container" data-reactid="407"></section></article></div></div><div class="ant-row" data-reactid="408"><div class="ant-col-xs-24 ant-col-sm-24 ant-col-md-18 ant-col-md-offset-6 ant-col-lg-20 ant-col-lg-offset-4" data-reactid="409"><section class="prev-next-nav" data-reactid="410"><a class="prev-page" href="/docs/spec/navigation" data-reactid="411">Navigation</a><a class="next-page" href="/docs/spec/data-display" data-reactid="412">Data Display</a></section></div></div></div><footer id="footer" data-reactid="413"><ul data-reactid="414"><li data-reactid="415"><h2 data-reactid="416"><i class="anticon anticon-github" data-reactid="417"></i><!-- react-text: 418 --> GitHub<!-- /react-text --></h2><div data-reactid="419"><a target="_blank " href="https://github.com/ant-design/ant-design" data-reactid="420"><span data-reactid="421">Repository</span></a></div><div data-reactid="422"><a target="_blank " href="https://ant.design/docs/react/customize-theme" data-reactid="423"><span data-reactid="424">Customize Theme</span></a></div><div data-reactid="425"><a target="_blank " href="https://github.com/websemantics/awesome-ant-design" data-reactid="426"><span data-reactid="427">Awesome Ant Design</span></a></div></li><li data-reactid="428"><h2 data-reactid="429"><i class="anticon anticon-link" data-reactid="430"></i><!-- react-text: 431 --> <!-- /react-text --><span data-reactid="432">Links</span></h2><div data-reactid="433"><a href="https://design.alipay.com/" data-reactid="434"><span data-reactid="435">Ant Financial Design Platform</span></a></div><div data-reactid="436"><a href="http://mobile.ant.design" data-reactid="437">Ant Design Mobile</a><span data-reactid="438"> - </span><span data-reactid="439">Mobile UI</span></div><div data-reactid="440"><a href="http://scaffold.ant.design" data-reactid="441">Scaffolds</a><span data-reactid="442"> - </span><span data-reactid="443">Scaffold Market</span></div><div data-reactid="444"><a target="_blank" rel="noopener noreferrer" href="https://github.com/dvajs/dva" data-reactid="445">dva</a><!-- react-text: 446 --> - <!-- /react-text --><span data-reactid="447">Framework</span></div><div data-reactid="448"><a target="_blank" rel="noopener noreferrer" href="https://github.com/dvajs/dva-cli" data-reactid="449">dva-cli</a><!-- react-text: 450 --> -<!-- /react-text --><span data-reactid="451">Developer Tools</span></div><div data-reactid="452"><a target="_blank" rel="noopener noreferrer" href="https://eggjs.org/" data-reactid="453">Egg</a><span data-reactid="454"> - </span><span data-reactid="455">Enterprise Node Framework</span></div><div data-reactid="456"><a target="_blank" rel="noopener noreferrer" href="https://antv.alipay.com/" data-reactid="457">AntV</a><span data-reactid="458"> - </span><span data-reactid="459">Data Visualization</span></div><div data-reactid="460"><a target="_blank" rel="noopener noreferrer" href="http://motion.ant.design" data-reactid="461">Ant Motion</a><span data-reactid="462"> - </span><span data-reactid="463">Motion Solution</span></div><div data-reactid="464"><a target="_blank" rel="noopener noreferrer" href="http://library.ant.design/" data-reactid="465">AntD Library</a><span data-reactid="466"> - </span><span data-reactid="467">Axure library</span></div><div data-reactid="468"><a target="_blank" rel="noopener noreferrer" href="http://ux.ant.design" data-reactid="469">Ant UX</a><span data-reactid="470"> - </span><span data-reactid="471">Sitemap Template</span></div></li><li data-reactid="472"><h2 data-reactid="473"><i class="anticon anticon-customer-service" data-reactid="474"></i><!-- react-text: 475 --> <!-- /react-text --><span data-reactid="476">Community</span></h2><div data-reactid="477"><a href="/changelog" data-reactid="478"><span data-reactid="479">Change Log</span></a></div><div data-reactid="480"><a target="_blank" rel="noopener noreferrer" href="https://github.com/ant-design/ant-design/wiki/FAQ" data-reactid="481"><span data-reactid="482">FAQ</span></a></div><div data-reactid="483"><a target="_blank" rel="noopener noreferrer" href="https://gitter.im/ant-design/ant-design" data-reactid="484"><span data-reactid="485">Chat Room (中文)</span></a></div><div data-reactid="486"><a target="_blank" rel="noopener noreferrer" href="https://gitter.im/ant-design/ant-design-english" data-reactid="487"><span data-reactid="488">Chat Room (English)</span></a></div><div data-reactid="489"><a target="_blank" rel="noopener noreferrer" href="http://new-issue.ant.design/" data-reactid="490"><span data-reactid="491">Bug Report</span></a></div><div data-reactid="492"><a target="_blank" rel="noopener noreferrer" href="https://github.com/ant-design/ant-design/issues" data-reactid="493"><span data-reactid="494">Issues</span></a></div><div data-reactid="495"><a target="_blank" rel="noopener noreferrer" href="http://stackoverflow.com/questions/tagged/antd" data-reactid="496"><span data-reactid="497">StackOverflow</span></a></div><div data-reactid="498"><a target="_blank" rel="noopener noreferrer" href="https://segmentfault.com/t/antd" data-reactid="499"><span data-reactid="500">SegmentFault</span></a></div></li><li data-reactid="501"><h2 data-reactid="502"><!-- react-text: 503 -->Copyright © <!-- /react-text --><!-- react-text: 504 -->2017<!-- /react-text --></h2><div data-reactid="505"><span data-reactid="506">Created by AFUX</span></div><div data-reactid="507"><!-- react-text: 508 -->Built with <!-- /react-text --><a target="_blank" rel="noopener noreferrer" href="https://github.com/benjycui/bisheng" data-reactid="509">BiSheng</a></div></li></ul></footer></div>
</div>
<script src="/common.js"></script>
<script src="/index.js"></script>
</body>
</html>