2021SC@SDUSC
TimePicker时间选择框
输入或选择时间的控件。
当用户需要输入一个时间,可以点击标准输入框,弹出时间面板进行选择。
API
import moment from 'moment';
<TimePicker defaultValue={moment('13:30:56', 'HH:mm:ss')} />;
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
allowClear | 是否展示清除按钮 | boolean | true |
autoFocus | 自动获取焦点 | boolean | false |
bordered | 是否有边框 | boolean | true |
className | 选择器类名 | string | - |
clearIcon | 自定义的清除图标 | ReactNode | - |
clearText | 清除按钮的提示文案 | string | clear |
defaultValue | 默认时间 | moment | - |
disabled | 禁用全部操作 | boolean | false |
disabledHours | 禁止选择部分小时选项 | function() | - |
disabledMinutes | 禁止选择部分分钟选项 | function(selectedHour) | - |
disabledSeconds | 禁止选择部分秒选项 | function(selectedHour, selectedMinute) | - |
format | 展示的时间格式 | string | HH:mm:ss |
getPopupContainer | 定义浮层的容器,默认为 body 上新建 div | function(trigger) | - |
hideDisabledOptions | 隐藏禁止选择的选项 | boolean | false |
hourStep | 小时选项间隔 | number | 1 |
inputReadOnly | 设置输入框为只读(避免在移动设备上打开虚拟键盘) | boolean | false |
minuteStep | 分钟选项间隔 | number | 1 |
open | 面板是否打开 | boolean | false |
placeholder | 没有值的时候显示的内容 | string | [string, string] | 请选择时间 |
popupClassName | 弹出层类名 | string | - |
popupStyle | 弹出层样式对象 | object | - |
renderExtraFooter | 选择框底部显示自定义的内容 | () => ReactNode | - |
secondStep | 秒选项间隔 | number | 1 |
showNow | 面板是否显示“此刻”按钮 | boolean | - |
suffixIcon | 自定义的选择框后缀图标 | ReactNode | - |
use12Hours | 使用 12 小时制,为 true 时 format 默认为 h:mm:ss a | boolean | false |
value | 当前时间 | moment | - |
onChange | 时间发生变化的回调 | function(time: moment, timeString: string): void | - |
onOpenChange | 面板打开/关闭时的回调 | (open: boolean) => void | - |
RangePicker
属性与 DatePicker
的 RangePicker
相同。还包含以下属性:
参数 | 说明 | 类型 | 默认值 | 版本 |
---|---|---|---|---|
order | 始末时间是否自动排序 | boolean | true | 4.1.0 |
部分源码
const { TimePicker: InternalTimePicker, RangePicker: InternalRangePicker } = DatePicker;
可以看出TimePicker与之前提到的DatePicker的关系。
import { Moment } from 'moment';
import * as React from 'react';
import DatePicker from '../date-picker';
import { PickerTimeProps, RangePickerTimeProps } from '../date-picker/generatePicker';
import devWarning from '../_util/devWarning';
引入moment以及datepicker,利用到了上次分析过的日期选择框。
export interface TimePickerLocale {
placeholder?: string;
rangePlaceholder?: [string, string];
}
export interface TimeRangePickerProps extends Omit<RangePickerTimeProps<Moment>, 'picker'> {
popupClassName?: string;
}
const RangePicker = React.forwardRef<any, TimeRangePickerProps>((props, ref) => (
<InternalRangePicker
{...props}
dropdownClassName={props.popupClassName}
picker="time"
mode={undefined}
ref={ref}
/>
));
接口,包含没有值时现实的内容,弹出层样式对象。
随后利用TimeRangePickerProps使用forwardRef函数传递ref至RangePicker。
export interface TimePickerProps extends Omit<PickerTimeProps<Moment>, 'picker'> {
addon?: () => React.ReactNode;
popupClassName?: string;
}
const TimePicker = React.forwardRef<any, TimePickerProps>(
({ addon, renderExtraFooter, popupClassName, ...restProps }, ref) => {
const internalRenderExtraFooter = React.useMemo(() => {
if (renderExtraFooter) {
return renderExtraFooter;
}
if (addon) {
devWarning(
false,
'TimePicker',
'`addon` is deprecated. Please use `renderExtraFooter` instead.',
);
return addon;
}
return undefined;
}, [addon, renderExtraFooter]);
return (
<InternalTimePicker
{...restProps}
dropdownClassName={popupClassName}
mode={undefined}
ref={ref}
renderExtraFooter={internalRenderExtraFooter}
/>
);
},
);
可以看出此处TimePicker也采用了类似RangePicker的代码结构。
TimePicker.displayName = 'TimePicker';
type MergedTimePicker = typeof TimePicker & {
RangePicker: typeof RangePicker;
};
(TimePicker as MergedTimePicker).RangePicker = RangePicker;
export default TimePicker as MergedTimePicker;
将以上的TimePicker与RangePicker类型融合,生成MergedTimePicker,融合的TimePicker,这样可以一并导出以供使用。