TimePicker 时间选择框

输入或选择时间的控件。

何时使用

当用户需要输入一个时间，可以点击标准输入框，弹出时间面板进行选择。

代码演示

基本

点击 TimePicker，然后可以在浮层中选择或者输入某一时间。

import React from 'react';
import ReactDOM from 'react-dom';
import { TimePicker } from 'choerodon-ui';
import moment from 'moment';
​
function onChange(time, timeString) {
  console.log(time, timeString);
}
​
ReactDOM.render(
  <TimePicker
    label="时间选择框"
    onChange={onChange}
    defaultOpenValue={moment('00:00:00', 'HH:mm:ss')}
  />,
  document.getElementById('container'),
);
​

受控组件

value 和 onChange 需要配合使用。

import React from 'react';
import ReactDOM from 'react-dom';
import { TimePicker } from 'choerodon-ui';
​
class Demo extends React.Component {
  state = {
    value: null,
  };
​
  onChange = (time) => {
    console.log(time);
    this.setState({ value: time });
  }
​
  render() {
    return <TimePicker value={this.state.value} onChange={this.onChange} />;
  }
}
​
ReactDOM.render(<Demo />, document.getElementById('container'));
​

三种大小

三种大小的输入框，大的用在表单中，中的为默认。

import React from 'react';
import ReactDOM from 'react-dom';
import { TimePicker } from 'choerodon-ui';
import moment from 'moment';
​
ReactDOM.render(
  <div>
    <TimePicker defaultValue={moment('12:08:23', 'HH:mm:ss')} size="large" />
    <TimePicker defaultValue={moment('12:08:23', 'HH:mm:ss')} />
    <TimePicker defaultValue={moment('12:08:23', 'HH:mm:ss')} size="small" />
  </div>,
  document.getElementById('container'));
​

禁用

禁用时间选择。

import React from 'react';
import ReactDOM from 'react-dom';
import { TimePicker } from 'choerodon-ui';
import moment from 'moment';
​
ReactDOM.render(
  <TimePicker defaultValue={moment('12:08:23', 'HH:mm:ss')} disabled />,
  document.getElementById('container'));
​

选择时分

TimePicker 浮层中的列会随着 format 变化，当略去 format 中的某部分时，浮层中对应的列也会消失。

import React from 'react';
import ReactDOM from 'react-dom';
import { TimePicker } from 'choerodon-ui';
import moment from 'moment';
​
const format = 'HH:mm';
​
ReactDOM.render(
  <TimePicker defaultValue={moment('12:08', format)} format={format} />,
  document.getElementById('container'));
​

步长选项

可以使用 hourStep minuteStep secondStep 按步长展示可选的时分秒。

import React from 'react';
import ReactDOM from 'react-dom';
import { TimePicker } from 'choerodon-ui';
​
ReactDOM.render(
  <TimePicker minuteStep={15} secondStep={10} />,
  document.getElementById('container'));
​

附加内容

在 TimePicker 选择框底部显示自定义的内容。

import React from 'react';
import ReactDOM from 'react-dom';
import { TimePicker, Button } from 'choerodon-ui';
​
class TimePickerAddonDemo extends React.Component {
  state = { open: false };
​
  handleOpenChange = (open) => {
    this.setState({ open });
  }
​
  handleClose = () => this.setState({ open: false })
​
  render() {
    return (
      <TimePicker
        open={this.state.open}
        onOpenChange={this.handleOpenChange}
        addon={() => (
          <Button size="small" type="primary" onClick={this.handleClose}>
            Ok
          </Button>
        )}
      />
    );
  }
}
​
ReactDOM.render(<TimePickerAddonDemo />, document.getElementById('container'));
​

12 小时制

12 小时制的时间选择器，默认的 format 为 h:mm:ss a。

import React from 'react';
import ReactDOM from 'react-dom';
import { TimePicker } from 'choerodon-ui';
​
function onChange(time, timeString) {
  console.log(time, timeString);
}
​
ReactDOM.render(
  <div>
    <TimePicker use12Hours onChange={onChange} />
    <TimePicker use12Hours format="h:mm:ss A" onChange={onChange} />
    <TimePicker use12Hours format="h:mm a" onChange={onChange} />
  </div>,
  document.getElementById('container'));
​

API

import moment from 'moment';
<TimePicker defaultValue={moment('13:30:56', 'HH:mm:ss')} />

方法