`jQuery.noConflict()`関数は、jQueryライブラリが制御している`$`および`jQuery`という変数の所有権を解放するために使用されます。

通常、jQueryライブラリでは、`$`は`jQuery`のエイリアス（別名）として機能し、両者は同じ意味を持ちます。例えば、`jQuery("p")`と`$("p")`は同じ操作を意味します。`$`は短く、視覚的に目立つため、jQueryを操作する際によく使われます。

しかし、Prototypeなどの他のJavaScriptライブラリも`$`という変数を使用している場合、両ライブラリ間で変数の所有権をめぐって競合が発生する可能性があります。

このような状況で、`jQuery.noConflict()`関数を呼び出すことで、jQueryライブラリが`$`変数の所有権を放棄し、その変数を以前に実装していた（Prototypeなど）ライブラリに戻すことができます。これにより、jQueryの操作には`jQuery`変数のみを使用する必要が生じます。

さらに、この関数は`$`と`jQuery`の両方の変数の所有権を解放することも可能です（詳細は下記の例を参照）。これにより、複数のjQueryバージョンを同時に使用することができます。

この関数はグローバルな`jQuery`オブジェクトに属しています。

構文

静的関数`jQuery.noConflict()`の構文は以下の通りです。

jQuery.noConflict( [ removeAll ] )

パラメータ

パラメータremoveAllを省略するか、またはfalseの場合、`$`変数の所有権のみを譲渡します。パラメータがtrueの場合、`$`と`jQuery`の両方の変数の所有権を譲渡します。

戻り値

`jQuery.noConflict()`関数の戻り値はjQueryオブジェクトです。これは、`jQuery`変数への参照を返します。

例と解説

以下は、PrototypeとjQueryライブラリを両方読み込む場合の例です。

<script type="text/javascript" src="prototype.js"></script>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript">
  // $変数の所有権を譲渡
  jQuery.noConflict();

  // jQueryを使ったDOM操作
  jQuery("#myButton").css("background-color", "green");

  // 他のライブラリ（例：myLib）を使ったDOM操作
  myLib("myDiv").doSomething();
</script>

（上記のコードは、デモンストレーションページにコピーして実行してください。同時に実行せず、個別にテストしてください）

また、独自の変数名を使ってjQueryを操作することもできます。

// $変数の所有権を譲渡し、jQueryを'jq'という新しいエイリアスに割り当てる
var jq = jQuery.noConflict();

// jQueryを使ったDOM操作（'jq'を使用）
jq("#myButton").css("background-color", "blue");

複数のライブラリが共存する場合でも、`jQuery.ready()`のコールバック関数内や、独自の関数内でローカル変数`$`をjQueryのエイリアスとして使用できます。

// jQueryライブラリが$の制御権を譲渡
jQuery.noConflict();

jQuery(document).ready(function(local$){
  // ローカル変数$を使ったjQuery操作
  local$("p").css("font-weight", "bold");
});

(function(local$){
  // ローカル変数$を使ったjQuery操作
  local$("ul li").addClass("highlighted-item");
}(jQuery));

2つのjQueryバージョンを共存させる場合、以下のようにコードを記述できます。

<script type="text/javascript" src="jquery-1.7.2.js"></script>
<script type="text/javascript" src="jquery-3.6.0.js"></script>
<script type="text/javascript">
  // jQuery-3.6.0が$とjQueryの両方の制御権を譲渡し、'jq_v2'で参照
  var jq_v2 = jQuery.noConflict(true);

  document.writeln( "新しいjQueryバージョン: " + jq_v2.fn.jquery ); // 3.6.0

  document.writeln( "元のjQueryバージョン: " + $.fn.jquery ); // 1.7.2
  document.writeln( "元のjQueryバージョン: " + jQuery.fn.jquery ); // 1.7.2

  /*
   * もしjQuery.noConflict()にtrueを渡さなければ、
   * つまり$の制御権のみを譲渡した場合、$は1.7.2を、jQueryは3.6.0を指します。
   * この場合、jQuery.fn.jqueryは3.6.0になります。
   */
</script>

3つのjQueryバージョンを共存させる場合の例は以下の通りです。

<script type="text/javascript" src="jquery-1.7.2.js"></script>
<script type="text/javascript" src="jquery-1.8.3.js"></script>
<script type="text/javascript" src="jquery-3.6.0.js"></script>
<script type="text/javascript">
  // jQuery-3.6.0が$とjQueryの両方の制御権を譲渡し、'jq_v3'で参照
  var jq_v3 = jQuery.noConflict(true);

  // jQuery-1.8.3が$の制御権を譲渡
  jQuery.noConflict();

  document.writeln( "最新のjQueryバージョン: " + jq_v3.fn.jquery ); // 3.6.0
  document.writeln( "中間のjQueryバージョン: " + jQuery.fn.jquery ); // 1.8.3
  document.writeln( "最古のjQueryバージョン: " + $.fn.jquery ); // 1.7.2
</script>

注意：複数のJavaScriptライブラリ間でグローバル変数名の競合が発生する可能性がある場合、変数の実際の所有権は通常、ライブラリの読み込み順序によって決まります。上記の3つのjQueryバージョンの例では、後から読み込まれたjQueryライブラリの変数が、以前のバージョンの変数を上書きします。そのため、変数の所有権を譲渡するたびに、その制御権は一つ前のJSライブラリに渡されます。