JavaScriptでDatepickerを使う方法を現役エンジニアが解説【初心者向け】

Web制作をしていると、日付の入力欄を作りたいときがあります。

テキストで入力するのではなく、カレンダーで選択できたら便利ですよね。

本記事では、カレンダーで日付選択するWebの部品、DatePickerの作り方について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。

作り方がわからない、何を使って作るか悩むという方はぜひ読んでみてください。

目次

• DatePickerとは
• DatePickerを作る様々な手法
• jQuery UIでDatePickerを作ってみよう
• DatePickerのオプション
• まとめ
• JavaScriptを学習中の方へ

そもそもJavaScriptについてよく分からないという方は、JavaScriptとは何なのかについて解説した記事を読むとさらに理解が深まります。

 

 

DatePickerとは

日付を選択する部品のことです。
下記の画像のように、カレンダーを表示して選択した日付が入力欄に入ります。

これにより、ユーザーに日付を楽に入力してもらうことができます。

 

DatePickerを作る様々な手法

DatePickerを作るには様々な手法があり、どの手法を使うか迷ってしまいます。

jQueryやBootstrap、Vueなど様々なJavaScriptライブラリがあり、またHTML5だけでも作れます。

See the Pen
DapePickerNoJS by TAKAYOSHI (@lspuwbkv)
on CodePen.

ただし、2021年現在、HTML5標準のDatePickerを実務レベルで使うのはおすすめしません。

新しく策定された機能で、まだブラウザの実装が追い付いておらず、Safaliなどで使えないからです。

（引用 Can I Use : Date and time input types）

 

将来的に全ブラウザで対応するまで、今のところはJavaScriptライブラリを使いましょう。

本記事では、普及していて使いやすいライブラリである、jQuery UIを使ってDatePickerを作ります。

 

[PR] フロントエンドで副業する学習方法を動画で公開中

jQuery UIでDatePickerを作ってみよう

jQuery UIを使ってDatePickerを作るサンプルコードがこちらです。

See the Pen
date picker by TAKAYOSHI (@lspuwbkv)
on CodePen.

JavaScript

$('#datepicker').datepicker();

JavaScriptのコードは1行だけで、とてもシンプルですね。

 

jQuery UI はjQueryの拡張ライブラリで、様々なWebの部品を簡単に作ることができます。

jQuery UI のようなライブラリを利用するために、HTMLでライブラリファイルを読み込みます。

HTML

<!--jQuery JS-->
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.0/jquery.min.js" /></script>
<!--jQuery UI JS-->
<script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.12.1/jquery-ui.min.js"></script>
<!--jQuery UI CSS-->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.12.1/themes/base/jquery-ui.min.css">

 

jQuery UI では、「jQuery本体のJS」「jQuery UIのJS」「jQuery UIのCSS」の3つを読み込んで使います。

また、追加でテーマ と呼ばれるスタイルを読み込んで、カスタマイズすることもできるんです。

 

その後、DataPickerにするためのinput要素を作り、IDを割り振ります。

HTML

<!--Date picker element-->
<input type="text" id="datepicker">

HTMLを準備したら、JavaScriptではjQueryでinput要素をセレクト、datapicker()メソッドを呼び出します。

JavaScript

$('#datepicker').datepicker();

 

これでDatePickerを作ることができました、簡単ですね。

 

DatePickerのオプション

DatePickerは日付のフォーマットを変更したり、月の表示を「1月、2月・・・」と日本語にしたり、豊富なオプションが用意されているんです。

 

オプションの一例

オプション	機能
dateFormat	日時の表示形式
monthNames	月の表示名
defaultDate	初期値の日付
firstDay	週の始まりの曜日

 

様々な細かい挙動を、datapicker()メソッドの引数にオプションで指定してコントロールするのです。

$('#datepicker').datepicker({
  /*日付フォーマット*/
  dateFormat: 'yy-mm-dd',
  /*初期値*/
  defaultDate: '1999-12-31',
  /*月の表示を日本語に*/
  monthNames: [ "1月", "2月", "3月", "4月", "5月", "6月", "7月", "8月", "9月", "10月", "11月", "12月" ]
});

See the Pen
Datepicker with op by TAKAYOSHI (@lspuwbkv)
on CodePen.

オプションはjQuery UIを翻訳したサイトのオプション一覧ページが見やすいのでそちらで確認してみてください。

jQuery UIを翻訳したサイトのオプションページ

 

まとめ

日付の入力を助けてくれるDatePickerは、必要なCSSとJSファイル2つを読み込めば、1行のJavaScriptコードで使用できます。

オプションで見た目や動作の変更も簡単です。

日付の入力欄には積極的に使ってみてください。

 

 

JavaScriptを学習中の方へ

これで解説は終了です、お疲れさまでした。

• つまずかず「効率的に」学びたい
• 副業や転職後の「現場で使える」知識やスキルを身につけたい

プログラミングを学習していて、このように思ったことはありませんか？

テックアカデミーのフロントエンドコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。

合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、JavaScript・jQueryを使ったWebサービス開発を学べます。

まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。

時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします！