現在、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=ajax
CSSを除くと、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 start
PHPをサポートするローカルサーバーでユニットテストを実行します。 「テスト」ディレクトリではなく、ルートディレクトリからサイトを実行していることを確認してください。データベースは必要ありません。事前に構成された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でお気軽にお問い合わせください。