UNPKG

ng-ytl-zorro-antd

Version:

An enterprise-class UI components based on Ant Design and Angular

131 lines (130 loc) 4.96 kB
<article> <section class="markdown"><h1>TimePicker 时间选择框</h1> <section class="markdown"><p>输入或选择时间的控件。</p> <h2 id="何时使用"><span>何时使用</span> <!-- <a class="anchor">#</a> --> </h2> <p>当用户需要输入一个时间,可以点击标准输入框,弹出时间面板进行选择。</p> </section> <h2>代码演示<i class="code-box-expand-trigger anticon anticon-appstore" title="展开全部代码"></i></h2> </section> <div nz-row [nzGutter]="8"> <div nz-col [nzSpan]="12"> <nz-code-box [nzTitle]="'基本'" id="components-time-picker-demo-basic" [nzCode]="NzDemoTimePickerBasicCode"> <nz-demo-timepicker-basic demo></nz-demo-timepicker-basic> <div intro> <p>最简单的用法。</p> </div> </nz-code-box> <nz-code-box [nzTitle]="'三种大小'" id="components-time-picker-demo-size" [nzCode]="NzDemoTimePickerSizeCode"> <nz-demo-timepicker-size demo></nz-demo-timepicker-size> <div intro> <p>三种大小的输入框,大的用在表单中,中的为默认。</p> </div> </nz-code-box> <nz-code-box [nzTitle]="'禁用'" id="components-time-picker-demo-disabled" [nzCode]="NzDemoTimePickerDisabledCode"> <nz-demo-timepicker-disabled demo></nz-demo-timepicker-disabled> <div intro> <p>禁用时间选择。</p> </div> </nz-code-box> <nz-code-box [nzTitle]="'只显示部分选项'" id="components-time-picker-demo-hide-options" [nzCode]="NzDemoTimePickerHideOptionsCode"> <nz-demo-timepicker-hide-options demo></nz-demo-timepicker-hide-options> <div intro> <p>通过 <code>nzHideDisabledOptions</code> 将不可选的选项隐藏。</p> </div> </nz-code-box> </div> <div nz-col [nzSpan]="12"> <nz-code-box [nzTitle]="'受控组件'" id="components-time-picker-demo-change" [nzCode]="NzDemoTimePickerChangeCode"> <nz-demo-timepicker-change demo></nz-demo-timepicker-change> <div intro> <p>nzValue 和 nzValueChange 需要配合使用。</p> </div> </nz-code-box> <nz-code-box [nzTitle]="'不展示秒'" id="components-time-picker-demo-without-seconds" [nzCode]="NzDemoTimePickerWithoutSecondsCode"> <nz-demo-timepicker-without-seconds demo></nz-demo-timepicker-without-seconds> <div intro> <p>不展示秒,也不允许选择。</p> </div> </nz-code-box> <nz-code-box [nzTitle]="'禁止选项'" id="components-time-picker-demo-disabled-options" [nzCode]="NzDemoTimePickerDisabledOptionsCode"> <nz-demo-timepicker-disabled-options demo></nz-demo-timepicker-disabled-options> <div intro> <p>限制选择 <code>20:30</code><code>23:30</code> 这个时间段。</p> </div> </nz-code-box> </div> </div> <section class="markdown api-container"> <h2 id="API"><span>API</span> <!-- <a class="anchor">#</a> --> </h2> <table> <thead> <tr> <th>参数</th> <th>说明</th> <th>类型</th> <th>默认值</th> </tr> </thead> <tbody> <tr> <td>ngModel</td> <td>默认时间</td> <td>string or Date</td> <td></td> </tr> <tr> <td>nzSize</td> <td>设置TimePicker大小</td> <td>'large'|'small'|'default'</td> <td>'default'</td> </tr> <tr> <td>nzPlaceHolder</td> <td>没有值的时候显示的内容</td> <td>String</td> <td>"请选择时间"</td> </tr> <tr> <td>nzFormat</td> <td>展示的时间格式</td> <td>String</td> <td>"HH:mm:ss"、"HH:mm"、"mm:ss"</td> </tr> <tr> <td>nzDisabled</td> <td>禁用全部操作</td> <td>Boolean</td> <td>false</td> </tr> <tr> <td>nzDisabledHours</td> <td>禁止选择部分小时选项</td> <td>function()</td> <td></td> </tr> <tr> <td>nzDisabledMinutes</td> <td>禁止选择部分分钟选项</td> <td>function(selectedHour)</td> <td></td> </tr> <tr> <td>nzDisabledSeconds</td> <td>禁止选择部分秒选项</td> <td>function(selectedHour, selectedMinute)</td> <td></td> </tr> <tr> <td>nzHideDisabledOptions</td> <td>添加该属性来隐藏禁止选择的选项</td> <td>attribute</td> <td>-</td> </tr> </tbody> </table> </section> </article>