jQuery API の jQuery . inArray( value, array[, fromIndex] ) は、arrayに指定した配列に、valueに指定した値が存在するか検索し、存在した場合、インデックス番号を返す。存在しなかった場合は、「-1」を返す。
引数
- value
検索する値。
- array
配列。この配列内から検索する。
- fromIndex
検索を開始する位置を、配列内のインデックスで指定できる。
デフォルトは「0」で、配列全体を検索する。
戻り値
- Number
数字。
valueに指定した値が存在した場合、インデックス番号を返す。
valueに指定した値が存在しなかった場合、「-1」を返す。
記述例
jQuery( '#sample' ) . text( jQuery . inArray( 1, [ 0, 1, 2, 0, 1, 2 ] ) );
idが「sample」である要素に、「1」と表示する。
jQuery( '#sample' ) . text( jQuery . inArray( 1, [ 0, 1, 2, 0, 1, 2 ], 3 ) );
idが「sample」である要素に、「4」と表示する。
実装例（サンプル）
検索する値：
検索を開始する位置（インデックス）：
検索結果：
実装例（サンプル）の動作について
「検索する値」や「検索を開始する位置（インデックス）」の選択を変更すると、「検索結果：」の右横に、インデックス番号、もしくは、「-1」を表示する。
実装例（サンプル）のソースコード
JavaScript
<script type="text/javascript">
<!--
var array = [ '月の', '下で', '、', '僕は', '君を', '想う', '。', '蒼い', '月の', '下で', '…' ];
jQuery( function() {
jQuery( '#jquery-sample-value, #jquery-sample-fromIndex' ) . change( function () {
var value = jQuery( '#jquery-sample-value' ) . val();
var fromIndex = jQuery( '#jquery-sample-fromIndex' ) . val();
jQuery( '#jquery-sample-index' ) . text( jQuery . inArray( value, array, fromIndex ) );
} ) . change();
} );
// -->
</script>
<!--
var array = [ '月の', '下で', '、', '僕は', '君を', '想う', '。', '蒼い', '月の', '下で', '…' ];
jQuery( function() {
jQuery( '#jquery-sample-value, #jquery-sample-fromIndex' ) . change( function () {
var value = jQuery( '#jquery-sample-value' ) . val();
var fromIndex = jQuery( '#jquery-sample-fromIndex' ) . val();
jQuery( '#jquery-sample-index' ) . text( jQuery . inArray( value, array, fromIndex ) );
} ) . change();
} );
// -->
</script>
CSS
<style>
<!--
#jquery-sample {
margin: 10px;
padding: 10px;
background-color: #f0f8ff;
border: 1px solid gray;
border-radius: 10px;
}
#jquery-sample-value,
#jquery-sample-fromIndex {
margin: 5px;
}
-->
</style>
<!--
#jquery-sample {
margin: 10px;
padding: 10px;
background-color: #f0f8ff;
border: 1px solid gray;
border-radius: 10px;
}
#jquery-sample-value,
#jquery-sample-fromIndex {
margin: 5px;
}
-->
</style>
HTML
<div id="jquery-sample">
<p>
検索する値：
<select id="jquery-sample-value">
<option value="月の">月の</option>
<option value="下で">下で</option>
<option value="、">、</option>
<option value="僕は" selected>僕は</option>
<option value="君を">君を</option>
<option value="想う">想う</option>
<option value="。">。</option>
<option value="蒼い">蒼い</option>
<option value="月の">月の</option>
<option value="下で">下で</option>
<option value="…">…</option>
</select>
</p>
<p>
検索を開始する位置（インデックス）：
<select id="jquery-sample-fromIndex">
<option value="0" selected>0</option>
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
<option value="6">6</option>
<option value="7">7</option>
<option value="8">8</option>
<option value="9">9</option>
<option value="10">10</option>
<option value="11">11</option>
</select>
</p>
<p>
検索結果：<span id="jquery-sample-index"></span>
</p>
</div>
<p>
検索する値：
<select id="jquery-sample-value">
<option value="月の">月の</option>
<option value="下で">下で</option>
<option value="、">、</option>
<option value="僕は" selected>僕は</option>
<option value="君を">君を</option>
<option value="想う">想う</option>
<option value="。">。</option>
<option value="蒼い">蒼い</option>
<option value="月の">月の</option>
<option value="下で">下で</option>
<option value="…">…</option>
</select>
</p>
<p>
検索を開始する位置（インデックス）：
<select id="jquery-sample-fromIndex">
<option value="0" selected>0</option>
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
<option value="6">6</option>
<option value="7">7</option>
<option value="8">8</option>
<option value="9">9</option>
<option value="10">10</option>
<option value="11">11</option>
</select>
</p>
<p>
検索結果：<span id="jquery-sample-index"></span>
</p>
</div>