Files
ant-design/docs/spec/direct.html
T
2016-11-28 14:36:08 +08:00

76 lines
19 KiB
HTML

<!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="Ant Design - An enterprise-class UI design language and React-based implementation">
<title>Ant Design - One Design Language</title>
<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"/>
<!--[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>');
}
</script>
</head>
<body>
<div id="react-content" hidden>
<div class="page-wrapper" data-reactroot="" data-reactid="1" data-react-checksum="-194174318"><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-6 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 style="display:block;" class="ant-col-xs-0 ant-col-sm-17 ant-col-md-18 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"></span></div></li></ul></div><span class="ant-select-arrow" style="user-select:none;-webkit-user-select:none;" unselectable="unselectable" data-reactid="19"><b data-reactid="20"></b></span></div></div></div><button type="button" class="ant-btn ant-btn-ghost ant-btn-sm lang" data-reactid="21"><span data-reactid="22">中文</span></button><ul class="ant-menu ant-menu-horizontal ant-menu-light ant-menu-root" role="menu" aria-activedescendant="" id="nav" tabindex="0" data-reactid="23"><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="24"><a href="/" data-reactid="25"><span data-reactid="26">Home</span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="27"><a href="/docs/spec/introduce" data-reactid="28"><span data-reactid="29">Specification</span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="30"><a href="/docs/react/introduce" data-reactid="31"><span data-reactid="32">Components</span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="33"><a href="/docs/pattern/navigation" data-reactid="34"><span data-reactid="35">Pattern</span></a></li><li class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="36"><a href="/docs/practice/cases" data-reactid="37"><span data-reactid="38">Practice</span></a></li><li class="ant-menu-item-selected ant-menu-item" role="menuitem" aria-selected="true" data-reactid="39"><a href="/docs/resource/download" data-reactid="40"><span data-reactid="41">Resource</span></a></li></ul></div></div></header><div class="main-wrapper" data-reactid="42"><div class="ant-row" data-reactid="43"><div class="ant-col-xs-24 ant-col-sm-24 ant-col-md-6 ant-col-lg-4" data-reactid="44"><ul class="ant-menu ant-menu-inline aside-container ant-menu-light ant-menu-root" role="menu" aria-activedescendant="" tabindex="0" data-reactid="45"><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="46"><a href="docs/spec/introduce" data-reactid="47">Ant Design</a></li><li style="padding-left:24px;" class="ant-menu-item" role="menuitem" aria-selected="false" data-reactid="48"><a href="docs/spec/feature" data-reactid="49">Features</a></li><li class="ant-menu-submenu-inline ant-menu-submenu-selected ant-menu-submenu" data-reactid="50"><div style="padding-left:24px;" class="ant-menu-submenu-title" aria-open="false" aria-owns="1480314948989_61" aria-haspopup="true" data-reactid="51"><h4 data-reactid="52">Principles</h4></div><!-- react-empty: 53 --></li><li class="ant-menu-submenu-inline ant-menu-submenu" data-reactid="54"><div style="padding-left:24px;" class="ant-menu-submenu-title" aria-open="false" aria-owns="1480314948989_62" aria-haspopup="true" data-reactid="55"><h4 data-reactid="56">Design Fundamental</h4></div><!-- react-empty: 57 --></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="58"><article class="markdown" data-reactid="59"><h1 data-reactid="60"><!-- react-text: 61 -->Make it Direct<!-- /react-text --><a class="edit-button" href="https://github.com/ant-design/ant-design/blob/master/docs/spec/direct.md" data-reactid="62"><i class="anticon anticon-edit" data-reactid="63"></i></a></h1><section class="markdown" data-reactid="64"><p data-reactid="65"><!-- react-text: 66 -->正如 Alan Cooper 所言:『需要在哪里输出,就要允许在哪里输入』。这就是直接操作的原理。eg:不要为了编辑内容而打开另一个页面,应该直接在上下文中实现编辑。<!-- /react-text --></p></section><section class="toc" data-reactid="67"><ul data-reactid="68"><li data-reactid="69"><a href="#页内编辑" data-reactid="70"><!-- react-text: 71 -->页内编辑<!-- /react-text --></a></li><li data-reactid="72"><a href="#利用拖放" data-reactid="73"><!-- react-text: 74 -->利用拖放<!-- /react-text --></a></li><li data-reactid="75"><a href="#直接选择(敬请期待)" data-reactid="76"><span class="waiting" data-reactid="77"><!-- react-text: 78 -->直接选择(敬请期待)<!-- /react-text --></span></a></li></ul></section><section class="markdown" data-reactid="79"><h2 id="页内编辑" data-reactid="80"><span data-reactid="81"><!-- react-text: 82 -->页内编辑<!-- /react-text --></span><a href="#页内编辑" class="anchor" data-reactid="83">#</a></h2><div class="preview-image-boxes clearfix" data-reactid="84"><div class="preview-image-box" data-reactid="85"><div class="preview-image-wrapper false false" data-reactid="86"><img class="preview-img" src="https://os.alipayobjects.com/rmsportal/PmVuUUKeamHdveT.png" alt="单击编辑示例" data-reactid="87"/></div><div class="preview-image-title" data-reactid="88">单击编辑示例</div><div class="preview-image-description" data-reactid="89">状态一:普通的浏览模式,不区分可编辑行和不可编辑行;<br>状态二:鼠标悬停时,『指针』变为『手型』,编辑区域底色变黄,出现『Tooltips』提示单击编辑;<br>状态三:鼠标点击后,出现『输入框』、『确定』、『取消』表单元素,同时光标定位在『输入框』中。</div><!-- react-empty: 90 --></div></div><p data-reactid="91"><!-- react-text: 92 -->单字段行内编辑<!-- /react-text --></p><p data-reactid="93"><!-- react-text: 94 -->当『易读性』远比『易编辑性』重要时,可以使用『单击编辑』。<!-- /react-text --></p><p data-reactid="95"><br data-reactid="96"/></p><div class="preview-image-boxes clearfix" data-reactid="97"><div class="preview-image-box" data-reactid="98"><div class="preview-image-wrapper false false" data-reactid="99"><img class="preview-img" src="https://os.alipayobjects.com/rmsportal/ZmRlahliUbCurhu.png" alt="文字链/图标编辑示例" data-reactid="100"/></div><div class="preview-image-title" data-reactid="101">文字链/图标编辑示例</div><div class="preview-image-description" data-reactid="102">状态一:在可编辑行附近出现文字链/图标;<br>状态二:鼠标点击『编辑』后,出现『输入框』、『确定』、『取消』表单元素,同时光标定位在『输入框』中。</div><!-- react-empty: 103 --></div></div><p data-reactid="104"><!-- react-text: 105 -->当『易读性』为主,同时又要突出操作行的『易编辑性』时,可使用『文字链/图标编辑』。<!-- /react-text --></p><p data-reactid="106"><br data-reactid="107"/></p><div class="preview-image-boxes clearfix" data-reactid="108"><div class="preview-image-box" data-reactid="109"><div class="preview-image-wrapper false false" data-reactid="110"><img class="preview-img" src="https://os.alipayobjects.com/rmsportal/hGXGErepBnrwqzj.png" alt="多字段行内编辑示例" data-reactid="111"/></div><div class="preview-image-title" data-reactid="112">多字段行内编辑示例</div><div class="preview-image-description" data-reactid="113">编辑模式在不破坏整体性的前提下,可扩大空间,以便放下『输入框』等表单元素;其中,在 Table 中进行编辑模式切换时,需要保证每列的不跳动。</div><!-- react-empty: 114 --></div></div><p data-reactid="115"><!-- react-text: 116 -->多字段行内编辑<!-- /react-text --></p><blockquote data-reactid="117"><p data-reactid="118"><!-- react-text: 119 -->注:在『多字段行内编辑』的情况下,显示的内容和编辑时所需的字段会存在比较大的差异,所以更需要『巧用过渡』原则中的<!-- /react-text --><a href="../spec/transition#解释刚刚发生了什么" data-reactid="120">『解释刚刚发生了什么』</a><!-- react-text: 121 -->来消除这种视觉影响。<!-- /react-text --></p></blockquote><p data-reactid="122"><br data-reactid="123"/></p><p data-reactid="124"><!-- react-text: 125 -->更多有关『页内编辑』的模式,可查看<!-- /react-text --><a href="/docs/pattern/table#模块编辑" data-reactid="126">『模式/表格/交互』</a><!-- react-text: 127 -->中的内容。<!-- /react-text --></p><p data-reactid="128"><br data-reactid="129"/></p><hr data-reactid="130"/><h2 id="利用拖放" data-reactid="131"><span data-reactid="132"><!-- react-text: 133 -->利用拖放<!-- /react-text --></span><a href="#利用拖放" class="anchor" data-reactid="134">#</a></h2><div class="preview-image-boxes clearfix" data-reactid="135"><div class="preview-image-box" data-reactid="136"><div class="preview-image-wrapper false false" data-reactid="137"><img class="preview-img" src="https://os.alipayobjects.com/rmsportal/DjMFcqSxZrulbGF.png" alt="拖放列表示例" data-reactid="138"/></div><div class="preview-image-title" data-reactid="139">拖放列表示例</div><div class="preview-image-description" data-reactid="140">状态一:鼠标悬停该行时,出现可移动的『图标』;<br>状态二:鼠标悬停在该『图标』时,指针变为『手型』,点击即可进行拖动;<br>状态三:拖动到可放置区块,出现蓝色描边,告知用户该区块可放置该对象。</div><!-- react-empty: 141 --></div></div><p data-reactid="142"><!-- react-text: 143 -->拖放列表<!-- /react-text --></p><p data-reactid="144"><!-- react-text: 145 -->只能限制在一个维度(上/下或者左/右)进行拖放。<!-- /react-text --></p><p data-reactid="146"><br data-reactid="147"/></p><div class="preview-image-boxes clearfix" data-reactid="148"><div class="preview-image-box" data-reactid="149"><div class="preview-image-wrapper false false" data-reactid="150"><img class="preview-img" src="https://os.alipayobjects.com/rmsportal/KVhqdSoLUjXPXuN.png" alt="拖放图片/文件示例" data-reactid="151"/></div><div class="preview-image-title" data-reactid="152">拖放图片/文件示例</div><div class="preview-image-description" data-reactid="153"></div><!-- react-empty: 154 --></div></div><p data-reactid="155"><!-- react-text: 156 -->拖放图片/文件<!-- /react-text --></p><p data-reactid="157"><br data-reactid="158"/></p><p data-reactid="159"><span class="waiting" data-reactid="160"><!-- react-text: 161 -->拖放对象(敬请期待)<!-- /react-text --></span></p><p data-reactid="162"><span class="waiting" data-reactid="163"><!-- react-text: 164 -->拖放多个对象(敬请期待)<!-- /react-text --></span></p><p data-reactid="165"><br data-reactid="166"/></p><hr data-reactid="167"/><h2 id="直接选择(敬请期待)" data-reactid="168"><span data-reactid="169"><span class="waiting" data-reactid="170"><!-- react-text: 171 -->直接选择(敬请期待)<!-- /react-text --></span></span><a href="#直接选择(敬请期待)" class="anchor" data-reactid="172">#</a></h2></section></article></div></div><div class="ant-row" data-reactid="173"><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="174"><section class="prev-next-nav" data-reactid="175"><a class="prev-page" href="docs/spec/repetition" data-reactid="176">Repetition</a><a class="next-page" href="docs/spec/stay" data-reactid="177">Stay on the Page</a></section></div></div></div><footer id="footer" data-reactid="178"><ul data-reactid="179"><li data-reactid="180"><h2 data-reactid="181">GitHub</h2><div data-reactid="182"><a target="_blank " href="https://github.com/ant-design/ant-design" data-reactid="183"><span data-reactid="184">Repository</span></a></div><div data-reactid="185"><a target="_blank" rel="noopener noreferrer" href="https://github.com/dvajs/dva" data-reactid="186">dva</a><!-- react-text: 187 --> - <!-- /react-text --><span data-reactid="188">Framework</span></div><div data-reactid="189"><a target="_blank" rel="noopener noreferrer" href="https://github.com/dvajs/dva-cli" data-reactid="190">dva-cli</a><!-- react-text: 191 --> -<!-- /react-text --><span data-reactid="192">Scaffold</span></div><div data-reactid="193"><a target="_blank" rel="noopener noreferrer" href="http://ant-tool.github.io" data-reactid="194">ant-tool</a><!-- react-text: 195 --> - <!-- /react-text --><span data-reactid="196">Developer Tools</span></div></li><li data-reactid="197"><h2 data-reactid="198"><span data-reactid="199">Links</span></h2><div data-reactid="200"><a href="http://mobile.ant.design" data-reactid="201">Ant Design Mobile</a><span data-reactid="202"> - </span><span data-reactid="203">Mobile</span></div><div data-reactid="204"><a href="https://g2.alipay.com/" data-reactid="205">G2</a><span data-reactid="206"> - </span><span data-reactid="207">Data Visualization</span></div><div data-reactid="208"><a href="https://antv.alipay.com/" data-reactid="209">AntV</a><span data-reactid="210"> - </span><span data-reactid="211">Data Visualization Specification</span></div><div data-reactid="212"><a href="http://motion.ant.design" data-reactid="213">Ant Motion</a><span data-reactid="214"> - </span><span data-reactid="215">Motion</span></div><div data-reactid="216"><a href="http://library.ant.design/" data-reactid="217">AntD Library</a><span data-reactid="218"> - </span><span data-reactid="219">Axure library of Ant Design</span></div><div data-reactid="220"><a href="http://ux.ant.design" data-reactid="221">Ant UX</a><span data-reactid="222"> - </span><span data-reactid="223">Sitemap Template</span></div></li><li data-reactid="224"><h2 data-reactid="225"><span data-reactid="226">Community</span></h2><div data-reactid="227"><a rel="noopener noreferrer" href="/changelog" data-reactid="228"><span data-reactid="229">Change Log</span></a></div><div data-reactid="230"><a target="_blank" rel="noopener noreferrer" href="https://github.com/ant-design/ant-design/issues" data-reactid="231"><span data-reactid="232">Feedback</span></a></div><div data-reactid="233"><a target="_blank" rel="noopener noreferrer" href="https://gitter.im/ant-design/ant-design" data-reactid="234"><span data-reactid="235">Chat Room</span></a></div><div data-reactid="236"><a target="_blank" rel="noopener noreferrer" href="https://github.com/ant-design/ant-design/issues/new" data-reactid="237"><span data-reactid="238">Bug Report</span></a></div></li><li data-reactid="239"><div data-reactid="240"><!-- react-text: 241 -->©2016 <!-- /react-text --><span data-reactid="242">Created by Ant UED</span></div><div data-reactid="243"><!-- react-text: 244 -->Powered by <!-- /react-text --><a href="https://github.com/benjycui/bisheng" data-reactid="245">BiSheng</a></div><div style="margin-top:10px;" data-reactid="246"><span data-reactid="247">Version: </span><div class="ant-select-sm ant-select ant-select-enabled" data-reactid="248"><div class="ant-select-selection
ant-select-selection--single" role="combobox" aria-autocomplete="list" aria-haspopup="true" aria-expanded="false" tabindex="0" data-reactid="249"><div class="ant-select-selection__rendered" data-reactid="250"><div class="ant-select-selection-selected-value" title="1.11.4" style="display:block;opacity:1;" data-reactid="251">1.11.4</div></div><span class="ant-select-arrow" style="user-select:none;-webkit-user-select:none;" unselectable="unselectable" data-reactid="252"><b data-reactid="253"></b></span></div></div></div></li></ul></footer></div>
</div>
<div class="ant-site-loading" id="ant-site-loading">
<img src='https://t.alipayobjects.com/images/rmsweb/T1B9hfXcdvXXXXXXXX.svg'/>
<div id="loading-text">One Design Language</div>
</div>
<script>
(function () {
var content = document.getElementById('loading-text');
if (content) {
content.innerHTML = content.innerHTML.split('').map(function (letter, i) {
var className;
if (i > 0 && i < content.innerText.length - 1) {
className = 'yoyo-x-' + (i % 6);
}
if (letter.trim() === '') {
className += ' blank';
}
return '<span class="' + className + '">' + letter + '</span>';
}).join('');
}
})();
// 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>
<script src="/common.js"></script>
<script src="/index.js"></script>
</body>
</html>