Files
ant-design/components/datepicker/index.html
T
2015-07-22 15:35:36 +08:00

687 lines
21 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black">
<meta name="format-detection" content="telephone=no">
<meta name="description" content="一个设计&前端框架"/>
<title>
Datepicker 日期选择框 - Ant Design
</title>
<link rel="icon" href="https://t.alipayobjects.com/images/T1QUBfXo4fXXXXXXXX.png" type="image/x-icon">
<link rel="shortcut icon" href="https://t.alipayobjects.com/images/T1QUBfXo4fXXXXXXXX.png" type="image/x-icon">
<link rel="stylesheet" href="/dist/antd-0.7.1.css">
<link rel="stylesheet" href="/static/style.css">
<link rel="stylesheet" href="/static/tomorrow.css">
<script>
(function (con) {
'use strict';
var prop, method;
var empty = {};
var dummy = function () {
};
var properties = 'memory'.split(',');
var methods = ('assert,clear,count,debug,dir,dirxml,error,exception,group,' +
'groupCollapsed,groupEnd,info,log,markTimeline,profile,profiles,profileEnd,' +
'show,table,time,timeEnd,timeline,timelineEnd,timeStamp,trace,warn').split(',');
while (prop = properties.pop()) {
con[prop] = con[prop] || empty;
}
while (method = methods.pop()) {
con[method] = con[method] || dummy;
}
})(this.console = this.console || {});
</script>
<script src="https://a.alipayobjects.com/??bluebird/2.9.30/bluebird.js,jquery/jquery/1.11.1/jquery.js,es5-shim/4.0.5/es5-shim-debug.js,es5-shim/4.0.5/es5-sham-debug.js,html5shiv/3.7.2/src/html5shiv.js,react/0.13.3/react.js,react-router/0.13.3/ReactRouter.js"></script>
<script>
var ANT_COMPONENTS = [];
ANT_COMPONENTS.push({
title: 'Layout',
desc: '布局'
});
ANT_COMPONENTS.push({
title: 'Checkbox',
desc: '多选框'
});
ANT_COMPONENTS.push({
title: 'Iconfont',
desc: '字体图标'
});
ANT_COMPONENTS.push({
title: 'Button',
desc: '按钮'
});
ANT_COMPONENTS.push({
title: 'Radio',
desc: '单选框'
});
ANT_COMPONENTS.push({
title: 'Form',
desc: '表单'
});
ANT_COMPONENTS.push({
title: 'Switch',
desc: '开关'
});
ANT_COMPONENTS.push({
title: 'InputNumber',
desc: '数字输入框'
});
ANT_COMPONENTS.push({
title: 'Motion',
desc: '组件动画'
});
ANT_COMPONENTS.push({
title: 'Slider',
desc: '滑动输入条'
});
ANT_COMPONENTS.push({
title: 'Datepicker',
desc: '日期选择框'
});
ANT_COMPONENTS.push({
title: 'Select',
desc: '选择器'
});
ANT_COMPONENTS.push({
title: 'Tabs',
desc: '标签页'
});
ANT_COMPONENTS.push({
title: 'Steps',
desc: '步骤条'
});
ANT_COMPONENTS.push({
title: 'Breadcrumb',
desc: '面包屑'
});
ANT_COMPONENTS.push({
title: 'Collapse',
desc: '折叠面板'
});
ANT_COMPONENTS.push({
title: 'Alert',
desc: '通知栏'
});
ANT_COMPONENTS.push({
title: 'Notification',
desc: '系统通知框'
});
ANT_COMPONENTS.push({
title: 'Pagination',
desc: '分页'
});
ANT_COMPONENTS.push({
title: 'Tree',
desc: '树形控件'
});
ANT_COMPONENTS.push({
title: 'Carousel',
desc: '走马灯'
});
ANT_COMPONENTS.push({
title: 'Menu',
desc: '导航菜单'
});
ANT_COMPONENTS.push({
title: 'Tag',
desc: '标签'
});
ANT_COMPONENTS.push({
title: 'Affix',
desc: '固定'
});
ANT_COMPONENTS.push({
title: 'Upload',
desc: '文件上传'
});
ANT_COMPONENTS.push({
title: 'Modal',
desc: '对话框'
});
ANT_COMPONENTS.push({
title: 'Message',
desc: '全局提示'
});
ANT_COMPONENTS.push({
title: 'Dropdown',
desc: '下拉菜单'
});
ANT_COMPONENTS.push({
title: 'Popover',
desc: '气泡卡片'
});
ANT_COMPONENTS.push({
title: 'Popconfirm',
desc: '气泡确认框'
});
ANT_COMPONENTS.push({
title: 'Tooltip',
desc: '文字提示'
});
ANT_COMPONENTS.push({
title: 'Progress',
desc: '进度条'
});
ANT_COMPONENTS.push({
title: 'Table',
desc: '表格'
});
</script>
<script src="/static/script.js"></script>
<script>
window.antdVersion = {
latest: '0.7.1',
stable: '0.7.0'
};
</script>
<script src="/dist/antd-0.7.1.js"></script>
<script src="/dist/demo.js"></script>
<script>
window.require = function (path) {
var result = window;
var namespaces = path.split('/');
namespaces.forEach(function (key, i) {
if (i !== 0 && i === namespaces.length - 1) {
key = capitalizeFirstLetter(key);
}
if (key !== 'lib') {
if (result[key]) {
result = result[key];
} else {
throw 'There should not have modules here 2.';
}
}
});
function capitalizeFirstLetter(string) {
return string.charAt(0).toUpperCase() + string.slice(1);
}
return result;
};
</script>
</head>
<body >
<header id="header">
<a class="logo" href="/">
<img width="60" src="https://t.alipayobjects.com/images/rmsweb/T1B9hfXcdvXXXXXXXX.svg">
Ant Design
</a>
<div class="search">
<div id="autoComplete"></div>
</div>
<nav class="nav">
<span class="bar"></span>
<ul>
<li class="">
<a href="/">首页</a>
</li>
<li class="">
<a href="/docs/introduce">使用</a>
</li>
<li class="">
<a class="disabled" href="/design/">设计</a>
</li>
<li class="current">
<a href="/components">组件</a>
</li>
<li>
<a target="_blank" href="https://github.com/ant-design/ant-design">Github</a>
</li>
</ul>
</nav>
</header>
<div class="main-wrapper">
<aside class="aside-container">
<ul>
<li>
<h4>CSS</h4>
<ul class="">
<li class="">
<a href="../layout/">
Layout
<span class="chinese">布局</span>
</a>
</li>
<li class="">
<a href="../iconfont/">
Iconfont
<span class="chinese">字体图标</span>
</a>
</li>
<li class="">
<a href="../button/">
Button
<span class="chinese">按钮</span>
</a>
</li>
<li class="">
<a href="../form/">
Form
<span class="chinese">表单</span>
</a>
</li>
<li class="">
<a href="../motion/">
Motion
<span class="chinese">组件动画</span>
</a>
</li>
<li class="">
<a href="../alert/">
Alert
<span class="chinese">通知栏</span>
</a>
</li>
</ul>
</li>
<li>
<h4>Components</h4>
<ul class="aside-list-show">
<li class="">
<a href="../checkbox/">
Checkbox
<span class="chinese">多选框</span>
</a>
</li>
<li class="">
<a href="../radio/">
Radio
<span class="chinese">单选框</span>
</a>
</li>
<li class="">
<a href="../switch/">
Switch
<span class="chinese">开关</span>
</a>
</li>
<li class="">
<a href="../slider/">
Slider
<span class="chinese">滑动输入条</span>
</a>
</li>
<li class="">
<a href="../input-number/">
InputNumber
<span class="chinese">数字输入框</span>
</a>
</li>
<li class="">
<a href="../select/">
Select
<span class="chinese">选择器</span>
</a>
</li>
<li class="current">
<a href="./">
Datepicker
<span class="chinese">日期选择框</span>
</a>
</li>
<li class="">
<a href="../tabs/">
Tabs
<span class="chinese">标签页</span>
</a>
</li>
<li class="">
<a href="../steps/">
Steps
<span class="chinese">步骤条</span>
</a>
</li>
<li class="">
<a href="../breadcrumb/">
Breadcrumb
<span class="chinese">面包屑</span>
</a>
</li>
<li class="">
<a href="../collapse/">
Collapse
<span class="chinese">折叠面板</span>
</a>
</li>
<li class="">
<a href="../affix/">
Affix
<span class="chinese">固定</span>
</a>
</li>
<li class="">
<a href="../pagination/">
Pagination
<span class="chinese">分页</span>
</a>
</li>
<li class="">
<a href="../tree/">
Tree
<span class="chinese">树形控件</span>
</a>
</li>
<li class="">
<a href="../carousel/">
Carousel
<span class="chinese">走马灯</span>
</a>
</li>
<li class="">
<a href="../menu/">
Menu
<span class="chinese">导航菜单</span>
</a>
</li>
<li class="">
<a href="../tag/">
Tag
<span class="chinese">标签</span>
</a>
</li>
<li class="">
<a href="../upload/">
Upload
<span class="chinese">文件上传</span>
</a>
</li>
<li class="">
<a href="../notification/">
Notification
<span class="chinese">系统通知框</span>
</a>
</li>
<li class="">
<a href="../modal/">
Modal
<span class="chinese">对话框</span>
</a>
</li>
<li class="">
<a href="../message/">
Message
<span class="chinese">全局提示</span>
</a>
</li>
<li class="">
<a href="../dropdown/">
Dropdown
<span class="chinese">下拉菜单</span>
</a>
</li>
<li class="">
<a href="../popover/">
Popover
<span class="chinese">气泡卡片</span>
</a>
</li>
<li class="">
<a href="../popconfirm/">
Popconfirm
<span class="chinese">气泡确认框</span>
</a>
</li>
<li class="">
<a href="../tooltip/">
Tooltip
<span class="chinese">文字提示</span>
</a>
</li>
<li class="">
<a href="../progress/">
Progress
<span class="chinese">进度条</span>
</a>
</li>
<li class="">
<a href="../table/">
Table
<span class="chinese">表格</span>
</a>
</li>
</ul>
</li>
</ul>
</aside>
<section class="main-container">
<article class="markdown">
<h1>
Datepicker 日期选择框
</h1>
<p>输入或选择日期/时间的控件。</p>
<h2 id="何时使用">何时使用</h2><p>当用户需要输入一个日期/时间,可以点击标准输入框,弹出日期面板进行选择。支持键盘操作。</p>
<div class="highlight"><pre><code class="xml"><span class="tag">&lt;<span class="title">Datepicker</span> <span class="attribute">value</span>=<span class="value">"2015-01-01"</span> /&gt;</span></code></pre></div><h2 id="api">API</h2><table>
<thead>
<tr>
<th>参数</th>
<th>说明</th>
<th>类型</th>
<th>默认值</th>
</tr>
</thead>
<tbody>
<tr>
<td>value</td>
<td>日期</td>
<td>string</td>
<td></td>
</tr>
<tr>
<td>format</td>
<td>展示的日期格式</td>
<td>string</td>
<td>&quot;yyyy-MM-dd&quot;</td>
</tr>
<tr>
<td>disabledDate</td>
<td>不可选择的日期</td>
<td>function</td>
<td></td>
</tr>
<tr>
<td>onSelect</td>
<td>选择日期的回调</td>
<td>function</td>
<td></td>
</tr>
<tr>
<td>showTime</td>
<td>显示时间选择条</td>
<td>boolean</td>
<td>false</td>
</tr>
<tr>
<td>disabled</td>
<td>禁用</td>
<td>bool</td>
<td>false</td>
</tr>
</tbody>
</table>
<style>
.code-box-demo .ant-calendar-picker-input {
width: 200px;
}
</style>
</article><h2 class="component-demos">
组件演示
<i class="iconfont-home icon-all" title="展开全部代码"></i>
</h2>
<div class="code-boxes clearfix">
<div class="code-boxes-col-2-1"><div class="code-box">
<div class="code-box-demo">
<div id="components-datepicker-demo-basic"></div>
<script>(function(){// or require('antd/lib/datepicker');
"use strict";
var Datepicker = antd.Datepicker;
React.render(React.createElement(Datepicker, { value: "" }), document.getElementById('components-datepicker-demo-basic'));})()</script><div class="highlight"><pre><code class="javascript"><span class="comment">// or require('antd/lib/datepicker');</span>
<span class="keyword">var</span> Datepicker = antd.Datepicker;
React.render(
<span class="xml"><span class="tag">&lt;<span class="title">Datepicker</span> <span class="attribute">value</span>=<span class="value">""</span> /&gt;</span>
, document.getElementById('components-datepicker-demo-basic'));</span></code></pre></div>
</div>
<div class="code-box-meta markdown">
<div class="code-box-title">基本</div>
<p>最简单的用法。</p>
<span class="collapse anticon anticon-circle-o-right"></span>
</div>
</div><div class="code-box">
<div class="code-box-demo">
<div id="components-datepicker-demo-select"></div>
<script>(function(){'use strict';
var Datepicker = antd.Datepicker;
var Picker = React.createClass({
displayName: 'Picker',
handleChange: function handleChange(value) {
console.log(new Date(value.getTime()));
},
render: function render() {
return React.createElement(Datepicker, { onSelect: this.handleChange });
}
});
React.render(React.createElement(Picker, null), document.getElementById('components-datepicker-demo-select'));})()</script><div class="highlight"><pre><code class="javascript"><span class="keyword">var</span> Datepicker = antd.Datepicker;
<span class="keyword">var</span> Picker = React.createClass({
handleChange: <span class="function"><span class="keyword">function</span><span class="params">(value)</span> {</span>
console.log(<span class="keyword">new</span> Date(value.getTime()));
},
render: <span class="function"><span class="keyword">function</span><span class="params">()</span> {</span>
<span class="keyword">return</span> <span class="xml"><span class="tag">&lt;<span class="title">Datepicker</span> <span class="attribute">onSelect</span>=<span class="value">{this.handleChange}</span> /&gt;</span>
}
});
React.render(
<span class="tag">&lt;<span class="title">Picker</span> /&gt;</span>
, document.getElementById('components-datepicker-demo-select'));</span></code></pre></div>
</div>
<div class="code-box-meta markdown">
<div class="code-box-title">选择日期</div>
<p>通过设置选择日期的回调事件 <code>onSelect</code>,完成交互行为。</p>
<span class="collapse anticon anticon-circle-o-right"></span>
</div>
</div><div class="code-box">
<div class="code-box-demo">
<div id="components-datepicker-demo-time"></div>
<script>(function(){"use strict";
var Datepicker = antd.Datepicker;
React.render(React.createElement(Datepicker, { showTime: true, format: "yyyy-MM-dd HH:mm:ss" }), document.getElementById('components-datepicker-demo-time'));})()</script><div class="highlight"><pre><code class="javascript"><span class="keyword">var</span> Datepicker = antd.Datepicker;
React.render(
<span class="xml"><span class="tag">&lt;<span class="title">Datepicker</span> <span class="attribute">showTime</span>=<span class="value">{true}</span> <span class="attribute">format</span>=<span class="value">"yyyy-MM-dd HH:mm:ss"</span> /&gt;</span>
, document.getElementById('components-datepicker-demo-time'));</span></code></pre></div>
</div>
<div class="code-box-meta markdown">
<div class="code-box-title">时间选择</div>
<p>准确到秒的时间选择面板。</p>
<span class="collapse anticon anticon-circle-o-right"></span>
</div>
</div>
</div>
<div class="code-boxes-col-2-1"><div class="code-box">
<div class="code-box-demo">
<div id="components-datepicker-demo-formatter"></div>
<script>(function(){"use strict";
var Datepicker = antd.Datepicker;
React.render(React.createElement(Datepicker, { value: "2015/01/01", format: "yyyy/MM/dd" }), document.getElementById('components-datepicker-demo-formatter'));})()</script><div class="highlight"><pre><code class="javascript"><span class="keyword">var</span> Datepicker = antd.Datepicker;
React.render(
<span class="xml"><span class="tag">&lt;<span class="title">Datepicker</span> <span class="attribute">value</span>=<span class="value">"2015/01/01"</span> <span class="attribute">format</span>=<span class="value">"yyyy/MM/dd"</span> /&gt;</span>
, document.getElementById('components-datepicker-demo-formatter'));</span></code></pre></div>
</div>
<div class="code-box-meta markdown">
<div class="code-box-title">日期格式</div>
<p>使用 <code>format</code> 属性,可以自定义你需要的日期显示格式,如 <code>yyyy/MM/dd</code></p>
<span class="collapse anticon anticon-circle-o-right"></span>
</div>
</div><div class="code-box">
<div class="code-box-demo">
<div id="components-datepicker-demo-range"></div>
<script>(function(){'use strict';
var Datepicker = antd.Datepicker;
var disabledDate = function disabledDate(current, value) {
// can not select days after today
return current.getTime() > Date.now();
};
React.render(React.createElement(Datepicker, { disabledDate: disabledDate }), document.getElementById('components-datepicker-demo-range'));})()</script><div class="highlight"><pre><code class="javascript"><span class="keyword">var</span> Datepicker = antd.Datepicker;
<span class="keyword">var</span> disabledDate = <span class="function"><span class="keyword">function</span><span class="params">(current, value)</span> {</span>
<span class="comment">// can not select days after today</span>
<span class="keyword">return</span> current.getTime() &gt; Date.now();
};
React.render(
<span class="xml"><span class="tag">&lt;<span class="title">Datepicker</span> <span class="attribute">disabledDate</span>=<span class="value">{disabledDate}</span> /&gt;</span>
, document.getElementById('components-datepicker-demo-range'));</span></code></pre></div>
</div>
<div class="code-box-meta markdown">
<div class="code-box-title">范围</div>
<p>设置 <code>disabledDate</code> 方法,来确定不可选时段。</p>
<p>如上例:不可选择今天之后的日期。</p>
<span class="collapse anticon anticon-circle-o-right"></span>
</div>
</div><div class="code-box">
<div class="code-box-demo">
<div id="components-datepicker-demo-disabled"></div>
<script>(function(){"use strict";
var Datepicker = antd.Datepicker;
React.render(React.createElement(Datepicker, { value: "2015-06-06", disabled: true }), document.getElementById('components-datepicker-demo-disabled'));})()</script><div class="highlight"><pre><code class="javascript"><span class="keyword">var</span> Datepicker = antd.Datepicker;
React.render(
<span class="xml"><span class="tag">&lt;<span class="title">Datepicker</span> <span class="attribute">value</span>=<span class="value">"2015-06-06"</span> <span class="attribute">disabled</span>=<span class="value">{true}</span> /&gt;</span>
, document.getElementById('components-datepicker-demo-disabled'));</span></code></pre></div>
</div>
<div class="code-box-meta markdown">
<div class="code-box-title">禁用</div>
<p>选择框的不可用状态。</p>
<span class="collapse anticon anticon-circle-o-right"></span>
</div>
</div>
</div>
</div>
</section>
</div><footer id="footer">
<ul>
<li>
<h2>GitHub</h2>
<a target="_blank "href="https://github.com/ant-design/ant-design">仓库</a>
<a target="_blank" href="https://github.com/ant-design/ant-design/tree/master/style">样式</a>
<a target="_blank" href="https://github.com/ant-design/antd-bin">开发工具</a>
</li>
<li>
<h2>关于我们</h2>
<a href="http://www.atatech.org/teams/79">博客 - Ant UED</a>
</li>
<li>
<h2>联系我们</h2>
<a target="_blank" href="https://github.com/ant-design/ant-design/issues">问题与建议 - Issues</a>
</li>
<li>
<h3>©2015 蚂蚁金服体验技术部出品</h3>
</li>
</ul>
</footer>
</body>
</html>