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

Ouverte
#1,147 1 commentaire 2 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
5/5
Temps estimé
Plus d'une semaine
Accessibilité débutants
35/100
Type d'issue
Documentation
Clarté
À clarifier
Activité
À l'abandon
Stack technique
jquery
Domaine
documentation

Piste de recherche

Examinez la PR #1145 et les exemples de la page API qui utilisent encore :odd ou :even. Déterminez d’abord si les API .even()/.odd() proposées doivent être introduites pour jQuery 3.5.0 ; dans le cas contraire, réécrivez ces exemples en utilisant une autre approche. C’est terminé lorsque la décision est consignée et que les exemples restants ne dépendent plus des sélecteurs obsolètes.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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

Langage dominant
HTML
Étoiles
324
Forks
259
Merge moyen
1 j 30 min
PR mergées (30 j)
1

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de jquery/api.jquery.com

Toutes les issues de jquery/api.jquery.com

Issues similaires

Plus d'issues Documentation

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.