現在、Matrix.orgプラットフォームで会議が開催されています。
会議の議事録は、Meetings.jquery.orgで見つけることができます。
jQueryの最新バージョンは、https://jquery.com/download/で入手できます。
| バージョン | 支店 | 状態 |
|---|---|---|
| 4.x | 主要 | ベータ |
| 3.x | 3.x-stable | アクティブ |
| 2.x | 2.x-stable | 非アクティブ |
| 1.x | 1.x安定 | 非アクティブ |
4.0.0ファイナルがリリースされると、3.Xブランチは期間限定で更新を受け取り続けます。 2.xおよび1.xブランチはサポートされなくなりました。
非アクティブバージョンの商業サポートは、Herodevsから入手できます。
バージョンサポートの詳細をご覧ください。
オープンソースのソフトウェア開発の精神で、JQueryは常にコミュニティコードの貢献を奨励しています。あなたが始めるのを助けるために、そしてあなたがコードを書くことに飛び込む前に、これらの重要な貢献ガイドラインを徹底的に読むようにしてください。
Githubの問題/PRは通常、 gh-NUMBERで参照されます。ここで、 NUMBER問題/PRの数値IDです。このような問題/PRは、 https://github.com/jquery/jquery/issues/NUMBERで見つけることができます。
jQueryは、過去にTRACに基づいて、Bugs.jquery.comで利用可能な別のバグトラッカーを使用しています。過去の議論を参照することが可能になるように、読み取り専用モードに保持されています。 jQueryソースがこれらの問題の1つを参照すると、パターンtrac-NUMBER使用します。ここで、 NUMBER問題の数値IDです。このような問題はhttps://bugs.jquery.com/ticket/NUMBERで見つけることができます。
jQueryを構築するには、最新のnode.js/npmとgit 1.7以降が必要です。以前のバージョンは機能するかもしれませんが、サポートされていません。
Windowsの場合、git and node.jsをダウンロードしてインストールする必要があります。
MacOSユーザーはHomeBrewをインストールする必要があります。 HomeBrewがインストールされたら、 brew install git 、Node.jsをインストールするためにbrew install node 。
Linux/BSDユーザーは、適切なパッケージマネージャーを使用してgit and node.jsをインストールするか、そのようにスイングする場合はソースからビルドする必要があります。簡単です。
最初に、jQuery gitレポをクローンします。
次に、jQueryディレクトリを入力し、依存関係をインストールし、ビルドスクリプトを実行します。
cd jquery
npm install
npm run build jQueryの構築バージョンは、MINIFIEDコピーと関連するマップファイルとともに、 dist/ディレクトリに配置されます。
jQueryのすべてのバリエーションを構築するには、次のコマンドを実行します。
npm run build:allこれにより、 jquery.js 、 jquery.slim.js 、jquery.module.js、 jquery.module.jsなど、jquery.js、jquery.slim.js、 jquery.slim.module.jsなどのリリースに含まれるすべてのバリアントが作成されます。
jquery.module.jsおよびjquery.slim.module.jsは、 jQueryおよび$ as named exportsがdist/ directoryではなくdist-module/ディレクトリに配置されたecmascriptモジュールです。
ビルドスクリプトを使用して、必要なモジュールのみを含むjQueryのカスタムバージョンを作成できます。
coreを除いて、任意のモジュールは除外される場合があります。 selector除外する場合、削除されませんが、ネイティブquerySelectorAllの周りの小さなラッパーに置き換えられます(詳細については以下を参照)。
ビルドスクリプトの利用可能なオプションの完全なリストを表示するには、次のことを実行します。
npm run build -- --helpモジュールを除外するには、 srcフォルダー( .js拡張機能なし)に対するパスを--excludeオプションに渡します。 --includeオプションを使用する場合、デフォルトが含まれることが削除され、それらのモジュールのみでビルドが作成されます。
除外または含めることができるモジュールの例は次のとおりです。
ajax :すべてのajax機能: $.ajax() 、 $.get() 、 $.post() 、 $.ajaxSetup() 、. .load() 、transports、and ajaxイベントのショートハンドなど.ajaxStart()
ajax/xhr :xmlhttprequest ajax輸送のみ。
ajax/script : <script> ajaxトランスポートのみ。スクリプトを取得するために使用されます。
ajax/jsonp :jsonp ajax輸送のみ。 Ajax/Script Transportに依存します。
CSS : .css()メソッド。また、CSS(効果、寸法、オフセットを含む)に応じて、すべてのモジュールを削除します。
css/showhide :non aNimated .show() 、. .hide() 、および.toggle() ; displayプロパティを設定するためにクラスまたは明示的な.css()呼び出しを使用する場合は除外できます。また、エフェクトモジュールを削除します。
非推奨:廃止されたがまだ削除されていないと文書化された方法。
寸法: .width()および.height()メソッド、 inner-とouter-バリエーションを含むメソッド。
効果: .slideUp()や.hide("slow")などの.animate()メソッドとその速記。
イベント: .on()および.off()メソッドとすべてのイベント機能。
イベント/トリガー: .trigger()および.triggerHandler()メソッド。
offset :the .offset() 、. .position() 、. .offsetParent() 、. .scrollLeft() 、および.scrollTop()メソッド。
wrap :the .wrap() 、. .wrapAll() 、. .wrapInner() 、および.unwrap()メソッド。
Core/Ready :ボディの端にスクリプトを配置する場合は、Readyモジュールを除外します。 jQuery()にバインドされたすぐにコールバックは、すぐに呼び出されます。ただし、 jQuery(document).ready()関数ではなく、 .on("ready", ...)または同様はトリガーされません。
延期:jquery.deferredを除外します。これは、 AJAX 、エフェクト、キューなど、延期に依存するすべてのモジュールも除外しますが、 Core/ReadyをCore/Ready-No Deferredに置き換えます。
エクスポート/グローバル:グローバルjQuery変数($ and jQuery)の添付ファイルをウィンドウに除外します。
Exports/AMD :AMD定義を除外します。
セレクター:完全なjQueryセレクターエンジン。このモジュールが除外されると、jQueryセレクターの拡張機能または強化されたセマンティクスをサポートしないブラウザのquerySelectorAllメソッドに基づいて、初歩的なセレクターエンジンに置き換えられます。詳細については、selector-native.jsファイルを参照してください。
注:完全なselectorモジュールを除くと、すべてのjQueryセレクター拡張機能( effects/animatedSelectorやcss/hiddenVisibleSelectorsなど)も除外されます。
jQueryのAMD定義のモジュール名を設定できます。デフォルトでは、プラグインやサードパーティライブラリでうまく再生される「jQuery」に設定されていますが、これを変更したい場合があります。 --amdパラメーターに渡します:
npm run build -- --amd= " custom-name "または、匿名で定義するには、名前を空白のままにします。
npm run build -- --amd構築されたjQueryファイルのデフォルト名はjquery.jsです。 dist/ディレクトリの下に配置されます。 --filenameを使用してファイル名を変更し、 --dir使用してディレクトリを変更することができます。 --dirプロジェクトルートに関連しています。
npm run build -- --slim --filename= " jquery.slim.js " --dir= " /tmp "これにより、jQueryのスリムバージョンが作成され、 tmp/jquery.slim.jsの下に配置されます。
デフォルトでは、jQueryは通常のスクリプトJavaScriptファイルを生成します。 --esmパラメーターを使用して、 jQueryデフォルトエクスポートとしてエクスポートするECMAScriptモジュールを生成することもできます。
npm run build -- --filename=jquery.module.js --esmデフォルトでは、jQueryはグローバルwindowに依存します。環境を持っていない環境については、外部から提供できるパラメーターとしてwindowを受け入れる関数を公開する工場ビルドを生成できます(使用手順については、公開されたパッケージのREADMEを参照)。 --factoryパラメーターを使用して、そのような工場を生成できます。
npm run build -- --filename=jquery.factory.js --factoryこのオプションは、 --esmや--slimのような他のオプションと混合できます。
npm run build -- --filename=jquery.factory.slim.module.js --factory --esm --slim --dir= " /dist-module " npm run build使用してカスタムビルドを作成し、除外するモジュールをリストします。トップレベルのモジュールを除外すると、対応するモジュールのディレクトリも除外されます。
すべてのajax機能を除外します:
npm run build -- --exclude=ajaxCSSを除くと、CSSに応じてモジュールを削除します。効果、オフセット、寸法。
npm run build -- --exclude=cssたくさんのモジュールを除外します( -eは--excludeのエイリアスです):
npm run build -- -e ajax/jsonp -e css -e deprecated -e dimensions -e effects -e offset -e wrap公式のjQueryスリムビルドと同じ構成でビルドを生成するための特別なエイリアスがあります。
npm run build -- --filename=jquery.slim.js --slimまたは、ESMモジュールとしてスリムビルドを作成するには:
npm run build -- --filename=jquery.slim.module.js --slim --esm非公式のカスタムビルドは定期的にテストされていません。あなた自身の責任でそれらを使用してください。
必要な依存関係があることを確認してください。
npm install npm start 。
npm startPHPをサポートするローカルサーバーでユニットテストを実行します。 「テスト」ディレクトリではなく、ルートディレクトリからサイトを実行していることを確認してください。データベースは必要ありません。事前に構成されたPHPローカルサーバーは、WindowsおよびMacで利用できます。ここにいくつかのオプションがあります:
ソースコードはGitバージョン制御システムによって処理されるため、使用されている機能をいくつか知ることが役立ちます。
作業ディレクトリを上流のステータスに戻したい場合は、次のコマンドを使用できます(取り組んだものはすべて、これらの後に行ったことを忘れないでください):
git reset --hard upstream/main
git clean -fdx機能/トピックブランチの場合、常に--rebaseフラグを使用してgit pullを使用する必要があります。または、通常、多くの一時的な「Github Pullリクエスト」にあるために「多くの一時的な」を処理している場合は、以下を実行してこれを自動化します。
git config branch.autosetuprebase local (詳細については、 man git-config参照してください)
競合ファイルを手動で編集する代わりに、マージするときにマージ競合を取得している場合は、機能git mergetool使用できます。デフォルトのツールxxdiffはひどく/古く見えますが、かなり便利です。
以下は、そこで使用できるコマンドです。
Ctrl + Alt + Mできるだけ自動化するb次のマージ競合にジャンプしますs競合する行の順序を変更しますuマージを元に戻しますleft mouse button - ブロックを勝者にマークするmiddle mouse button - 勝者になるように線をマークしますCtrl + S保存Ctrl + Q -quit expect ( numAssertions ) ;
stop ( ) ;
start ( ) ;注:このテストスイートでは、Qunitによるストップ/スタートへの引数を最終的に追加することで、パラメーターを心配することなく開始と停止をコールバックとして渡すことができます。
ok ( value , [ message ] ) ;
equal ( actual , expected , [ message ] ) ;
notEqual ( actual , expected , [ message ] ) ;
deepEqual ( actual , expected , [ message ] ) ;
notDeepEqual ( actual , expected , [ message ] ) ;
strictEqual ( actual , expected , [ message ] ) ;
notStrictEqual ( actual , expected , [ message ] ) ;
throws ( block , [ expected ] , [ message ] ) ; test/data/testinit.jsを参照してください。
q ( ... ) ;例:
q ( "main" , "foo" , "bar" ) ;
=> [ div # main , span # foo , input # bar ] t ( testName , selector , [ "array" , "of" , "ids" ] ) ;例:
t ( "Check for something" , "//[a]" , [ "foo" , "bar" ] ) ; fireNative ( node , eventType ) ;例:
fireNative ( jQuery ( "#elem" ) [ 0 ] , "click" ) ; url ( "some/url" ) ;例:
url ( "index.html" ) ;
=> "data/index.html?10538358428943"
url ( "mock.php?foo=bar" ) ;
=> "data/mock.php?foo=bar&10538358345554"一部のテストでは、標準のテストフィクスチャ以外のドキュメントが必要になる場合があり、これらは別のIFrameで実行できます。実際のテストコードとアサーションは、jQueryのメインテストファイルに残ります。最小限のテストフィクスチャーマークアップとセットアップコードのみをiframeファイルに配置する必要があります。
testIframe ( testName , fileName ,
function testCallback (
assert , jQuery , window , document ,
[ additional args ] ) {
...
} ) ;これにより、ページがロードされ、filename "./data/" + fileNameでURLが作成されます。 iframedページは、「/test/data/data/iframetest.js」スクリプトを含め、必要に応じてstartIframeTest( [ additional args ] )呼び出すことにより、テストでコールバックがいつ発生するかを決定します。多くの場合、これはDocument Readyまたはwindow.onload Firesのいずれかの後になります。
testCallbackこのテストのためにtestIframeによって作成されたQunit assertオブジェクトを受信し、その後、IFRAMEからグローバルなjQuery 、 window 、およびdocumentが続きます。 IFRAMEコードが引数を渡すと、 startIframeTestに渡すと、 document引数に従います。
ご質問がある場合は、発展途上のJQuery Core ForumまたはLiberaの#JQueryでお気軽にお問い合わせください。