jQuery【 jQuery UI 】selectable を使用して複数選択が可能な項目を作成

jQuery UI の selectable を利用すると、複数選択が可能な項目を作成することができます。
今回は、selectable の使用方法について紹介します。

目次

１．selectable を使用して複数選択が可能な項目を作成
２．grid のように表示された項目の複数選択
３．selectable のオプション

１．selectable を使用して複数選択が可能な項目を作成

　
jQuery UI の selectable を使用して 複数選択が可能な項目を作成します。
マウス操作やタッチ操作 又は「 Ctrl 」キーを押しながら、複数の項目を選択してみて下さい。

• Ｎｏ．１
• Ｎｏ．２
• Ｎｏ．３
• Ｎｏ．４
• Ｎｏ．５

　
上のサンプルのソースコードは次の通りです。

<script type="text/javascript" src="https://code.jquery.com/ui/1.12.0/jquery-ui.min.js"></script>
<link rel="stylesheet" href="http://code.jquery.com/ui/1.12.1/themes/base/jquery-ui.css">

<script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui-touch-punch/0.2.3/jquery.ui.touch-punch.min.js"></script>

<script type="text/javascript">
<!--
$(function(){
  $("#wkSelectable").selectable();
});
//-->
</script>

<style>
<!--
#wkSelectable {
  background: #CCC;
  padding : 20px;
}
#wkSelectable .ui-selecting {
  background: pink;
}
#wkSelectable .ui-selected {
  background: skyblue;
  color: white;
}
-->
</style>

<ul id="wkSelectable">
  <li class="ui-widget-content">Ｎｏ．１</li>
  <li class="ui-widget-content">Ｎｏ．２</li>
  <li class="ui-widget-content">Ｎｏ．３</li>
  <li class="ui-widget-content">Ｎｏ．４</li>
  <li class="ui-widget-content">Ｎｏ．５</li>
</ul>

対象となる項目の 親要素の HTML 要素を指定して selectable を呼び出すと、複数の項目を選択できるようになります。

jQuery UI の導入についてはjQuery【 jQuery UI 】UI の導入と使用方法をご参照下さい。

また、タッチデバイスの対応についてはjQuery【 jQuery UI 】Touch Punch を使用してスマホ対応をご参照下さい。

▲目次へ戻る

　

２．grid のように表示された項目の複数選択

　
今度は、グリッドのように表示された項目について、selectable を使用します。
マウス操作やタッチ操作 又は「 Ctrl 」キーを押しながら、複数の項目を選択してみて下さい。

• Ｎｏ．１
• Ｎｏ．２
• Ｎｏ．３
• Ｎｏ．４
• Ｎｏ．５
• Ｎｏ．６
• Ｎｏ．７
• Ｎｏ．８
• Ｎｏ．９

　
上のサンプルのソースコードは次の通りです。

<script type="text/javascript" src="https://code.jquery.com/ui/1.12.0/jquery-ui.min.js"></script>
<link rel="stylesheet" href="http://code.jquery.com/ui/1.12.1/themes/base/jquery-ui.css">

<script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui-touch-punch/0.2.3/jquery.ui.touch-punch.min.js"></script>

<script type="text/javascript">
<!--
$(function(){
  $("#wkGrid").selectable();
});
//-->
</script>

<style>
<!--
#wkGrid {
  background: #CCC;
  padding : 20px;
  width: 325px;
  height: 325px;
}
#wkGrid .ui-selecting {
  background: pink;
}
#wkGrid .ui-selected {
  background: skyblue;
  color: white;
}
#wkGrid li {
  float: left;
  width: 95px;
  height: 95px;
  padding : 0px;
  margin : 0px;
  text-align: center;
}
-->
</style>

<ul id="wkGrid">
  <li class="ui-state-default">Ｎｏ．１</li>
  <li class="ui-state-default">Ｎｏ．２</li>
  <li class="ui-state-default">Ｎｏ．３</li>
  <li class="ui-state-default">Ｎｏ．４</li>
  <li class="ui-state-default">Ｎｏ．５</li>
  <li class="ui-state-default">Ｎｏ．６</li>
  <li class="ui-state-default">Ｎｏ．７</li>
  <li class="ui-state-default">Ｎｏ．８</li>
  <li class="ui-state-default">Ｎｏ．９</li>
</ul>

CSS で「 float: left; 」を設定していますので、グリッド表示の次に読み込まれる HTML 要素で CSS を「 clear:both; 」と設定して float 設定の解除を行う必要があります。

float 設定の解除についてはfloatの解除をご参照下さい。

▲目次へ戻る

　

３．selectable のオプション

　
selectable には、次のようなオプションがあります。

appendTo
選択ヘルパーを挿入する要素を指定 初期値：”body”
autoRefresh
各選択操作を開始した際に 選択要素の位置・サイズをリフレッシュするかどうかを指定 初期値：true
cancel
選択操作で対象となった場合に 選択状態にしない要素を セレクタで指定 初期値：”input,textarea,button,select,option”
delay
選択操作を開始する時間をミリ秒単位で指定 初期値：0
disabled
選択機能を無効化するかどうかを指定 初期値：false
distance
選択可能となるまでに ポインタを動かす必要のある距離をピクセル単位で指定 初期値:1
filter
選択される子要素をセレクタによってフィルタリングする指定 初期値:”*”
tolerance
選択ボックスと選択対象要素とが どのような状況で選択状態になるか モードを指定 “touch”（初期値）：少しでも重なったら選択状態 “fit”：完全に重なったら選択状態

　
selectable にオプション（下のサンプルでは「 appendTo 」）を設定する場合は、次のように記述します。

$("#wkSelectable").selectable("option", "appendTo", "#wkElm");

▲目次へ戻る