Extension:Graph/Interactive Graph Tutorial/fr

Dans ce tutoriel, nous allons créer un graphe interactif qui affichera les taux de fertilité historiques par pays, avec un curseur pour sélectionner l'année, et une carte pour montrer la distribution des taux partout sur la planète. Si vous voulez investiguer le code source de ce graphe uniquement, il est disponible sur une page séparée. Utilisez le bac à sable graphique pour vos tests. Vous pourriez également être intéressés par la documentation complète de Vega (en anglais).

Dessiner des formes
Nous commençons par dessiner quelques éléments (marques). Le code du graphe est encadrer par la balise, même ci celui-ci n'est pas interactif. Ouvrez le bac à sable graphique et copiez y le code suivant sans la balise &lt;graph> pour vous donner une idée.

Astuce : utilisez l'« éditeur de code » pour copier les spécifités du graphe sur l'éditeur Vega pour vous entrainer.

Signal IsDragging
Pour que l'on puisse faire glisser notre objet poignée, il faut d'abord savoir si on a cliqué dessus ou pas. For that, lets add a signal that becomes true when an object is clicked (isDragging), and a text mark to show (debug) the result:

Gérer le signal Position
Now that we know when the object is being dragged, we add a  signal that only changes its value when isDragging signal is true. We also attach the new signal to the handle's "x" coordinate via "update" section:

Echelonnage du signal de position de la poignée
Having pixel position of the handler is not very good - we would much rather have a position that is meaningful to our graph, e.g. a year. Vega scales provide a useful mechanism for converting between our data (e.g. years) and the screen coordinates, and back (invert). In this step, we add "yearsScale" linear scale for values 1960..2013, mapping it to the whole width of the graph (excluding padding). We also add a new scaledHandlePosition signal that translates from the mouse X position to the meaningful value in years.

Year value cleanup
As you might have noticed, the handle could be moved beyond the length of our graph, producing incorrect results. Also, the scaled value is not an integer that we expect of the year value. To fix this, we can introduce one more post-processing signal called "currentYear" to convert it to an integer and limit it to the needed range. We also initialize it to a reasonable value, and we tie both the "yearLabel" and the position of the handle bar back to this value. Note that the handle's position needs to be in screen coordinates, so we have to use the "yearsScale" to convert the value back:

Nettoyage final
À présent nous pouvons retirer toutes les marques de débogages. Nous n'avons également plus besoin de séparer les signaux handlePosition et scaledHandlePosition parce que la mise à l'échelle peut avoir lieu à la même étape :

Prochaine étape
Veuillez continuer sur la partie 2.