Stop using :even/:odd in examples on other pages

オープン
#1,147 コメント 1 件 リアクション 2 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
ドキュメント
明瞭さ
説明が足りない
活発さ
停滞
技術スタック
jquery
領域
documentation

調査の方向性

PR #1145 と、まだ :odd または :even を使用している API ページの例を確認します。まず、提案されている .even()/.odd() API を jQuery 3.5.0 に導入すべきかどうかを判断し、導入しない場合は、それらの例を別のアプローチを使うように書き換えます。意思決定が記録され、残りの例が非推奨のセレクターに依存しなくなれば完了です。

索引モデルが issue の本文から書いたものです。

説明

PR #1145 marked all positional selectors as deprecated & removed their usage from API pages for non-deprecated APIs. The only exceptions are :even & :odd selectors as there are no tiny equivalents in jQuery APIs.

We could define an .even()/.odd() API. This is the implementation that adds +25 bytes: https://github.com/mgol/jquery/commit/f45409708c6f307bf923440d09f6f2fd86df9a9d

	even: function() {
		return this.filter( function( i ) {
			return ( i + 1 ) % 2;
		} );
	},

	odd: function() {
		return this.filter( function( i ) {
			return i % 2;
		} );
	},

That said, such an API would be jQuery 3.5.0+ (unless Migrate polyfills it for earlier versions as well) only and we'd have to release that 3.5.0 before 4.0.0. Something to consider.

If that's decided against then we need to rewrite existing examples using :odd/:even to use something else.

I think I'm slightly in favor of introducing these two new methods as that'd close the gap from POS selectors & it'd simplify the migration. But let's talk about it. cc @jquery/core

主要言語
HTML
スター
324
フォーク
259
平均マージ
1日 30分
マージ済み PR(30日)
1

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

jquery/api.jquery.com のほかの issue

jquery/api.jquery.com の issue をすべて見る

似ている issue

Documentation の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。