datetimepicker 是 Bootstrap 生態中常用的日期時間選擇插件,支持多種視圖層級與本地化。下面說明它的引入方式、布局結構與核心參數配置。
一、引入必要文件
1. CSS 樣式:
<link href="/css/bootstrap-datetimepicker.min.css" rel="stylesheet" media="screen">
2. JS 文件(含中文語言包):
<script type="text/javascript" src="/js/bootstrap-datetimepicker.js" charset="UTF-8"></script> <script type="text/javascript" src="/js/bootstrap-datetimepicker.zh-CN.js" charset="UTF-8"></script>
二、布局代碼
通過 data 屬性可以聲明初始格式與關聯字段:
<div class="input-group date form_date col-sm-2 col-md-2 col-lg-2 floatLeft"
data-date=""
data-date-format="dd MM yyyy"
data-link-field="dtp_input2"
data-link-format="yyyy-mm-dd">
<input class="form-control" id="birthdays" size="16" type="text" value="" readonly>
<span class="input-group-addon">
<span class="glyphicon glyphicon-remove"></span>
</span>
<span class="input-group-addon">
<span class="glyphicon glyphicon-calendar"></span>
</span>
</div>
三、JS 調用與關鍵參數
最需要理解的是 startView、maxViewMode、minViewMode 這三個參數。第一個決定起始選擇範圍(0 為日、1 為月、2 為年),第二個是最大選擇範圍,第三個是最小選擇範圍,數值含義與第一個參數相同。
$(function () {
// 只選年份:把起點與最小視圖都設為年
$('.form_date').datetimepicker({
format: 'yyyy',
startView: 4,
minView: 4,
language: 'zh-CN',
forceParse: false,
autoclose: true,
pickerPosition: "bottom-left"
});
// 可選到年月日
$('.form_date').datetimepicker({
language: 'zh-CN',
minView: 'month',
format: 'yyyy-mm-dd',
autoclose: true,
startView: 2,
showMeridian: 1,
pickerPosition: "bottom-left"
});
});
幾個實用選項的作用:language 決定界面語言,需與引入的語言包對應;autoclose 在選定日期後自動關閉面板;forceParse 設為 false 可避免插件強制改寫輸入框內容;pickerPosition 控制面板相對於輸入框的彈出方位,在邊緣位置時尤為有用。
完整參數列表可查閱官方手冊:https://bootstrap-datepicker.readthedocs.org/en/latest/options.html#startdate