D3.js: API de Axis

D3 proporciona funciones para dibujar ejes. Un eje está formado por líneas, marcas y etiquetas. Un eje utiliza una escala, por lo que cada eje deberá tener una escala para trabajar.

Configuración de la API de Axis

Puede configurar la API utilizando el siguiente script.

<script src = "https://d3js.org/d3-axis.v1.min.js"></script>
<script>

</script>

Métodos de la API de Axis

D3 proporciona las siguientes funciones importantes para dibujar ejes. Se describen brevemente como sigue.

  • d3.axisTop() - Este método se utiliza para crear un eje horizontal superior.

  • d3.axisRight() - Este método se utiliza para crear un eje vertical orientado a la derecha.

  • d3.axisBottom() - Este método se utiliza para crear un eje horizontal inferior.

  • d3.axisLeft() - Crea eje vertical izquierdo.

Ejemplo de trabajo

Aprendamos a sumar los ejes xey a una gráfica. Para hacer esto, debemos seguir los pasos que se indican a continuación.

Step 1 - Define variables - Defina SVG y variables de datos utilizando el siguiente código.

var width = 400, height = 400;
var data = [100, 150, 200, 250, 280, 300];
var svg = d3.select("body")
   .append("svg")
   .attr("width", width)
   .attr("height", height);

Step 2 - Create a scale linear function - Cree una función lineal de escala para los ejes X e Y como se define a continuación.

var xscale = d3.scaleLinear()
   .domain([0, d3.max(data)])
   .range([0, width - 100]);

var yscale = d3.scaleLinear()
   .domain([0, d3.max(data)])
   .range([height/2, 0]);

Aquí, hemos creado una escala lineal y especificado el dominio y el rango.

Step 3 - Add scales to x-axis - Ahora, podemos agregar escalas al eje x usando el siguiente código.

var x_axis = d3.axisBottom()
   .scale(xscale);

Aquí, usamos d3.axisBottom para crear nuestro eje x y proporcionarle la escala, que se definió anteriormente.

Step 4 - Add scales to the y-axis - Utilice el siguiente código para agregar escalas al eje y.

var y_axis = d3.axisLeft()
   .scale(yscale);

Aquí, usamos d3.axisLeft para crear nuestro eje y y proporcionarle la escala que definimos anteriormente.

Step 5 - Apply transformation - Puede agregar un elemento de grupo e insertar el eje x, y, que se define a continuación.

svg.append("g")
   .attr("transform", "translate(50, 10)")
   .call(y_axis);

Step 6 - Append group elements - Aplicar elementos de transición y grupo usando el siguiente código.

var xAxisTranslate = height/2 + 10;
svg.append("g")
   .attr("transform", "translate(50, " + xAxisTranslate  +")")
   .call(x_axis)

Step 7 - Working Example- La lista completa de códigos se proporciona en el siguiente bloque de código. Crea una pagina webaxes.html y agregue los siguientes cambios.

<html>
   <head>
      <script type = "text/javascript" src = "https://d3js.org/d3.v4.min.js"></script>
      <style>
         svg text {
            fill: purple;
            font: 12px sans-serif;
            text-anchor: end;
         }
      </style>
   </head>

   <body>
      <script>
         var width = 400, height = 400;
         var data = [100, 120, 140, 160, 180, 200];
         var svg = d3.select("body")
            .append("svg")
            .attr("width", width)
            .attr("height", height);
         
         var xscale = d3.scaleLinear()
            .domain([0, d3.max(data)])
            .range([0, width - 100]);
         
         var yscale = d3.scaleLinear()
            .domain([0, d3.max(data)])
            .range([height/2, 0]);
    
         var x_axis = d3.axisBottom().scale(xscale);
         
         var y_axis = d3.axisLeft().scale(yscale);
         
         svg.append("g")
            .attr("transform", "translate(50, 10)")
            .call(y_axis);
         
         var xAxisTranslate = height/2 + 10;
         
         svg.append("g")
            .attr("transform", "translate(50, " + xAxisTranslate  +")")
            .call(x_axis)
      </script>
   </body>
</html>

Ahora, solicita el navegador y veremos los siguientes cambios.