D3.js - interfejs API wartości oddzielonych ogranicznikami

Separator to sekwencja jednego lub więcej znaków używanych do określenia granicy między oddzielnymi, niezależnymi regionami w postaci zwykłego tekstu lub innych danych. Separator pola to sekwencja wartości oddzielonych przecinkami. Cóż, wartości oddzielone ogranicznikami sącomma separated values (CSV) lub tab-separated values(TSV). W tym rozdziale szczegółowo opisano wartości rozdzielane ogranicznikami.

Konfigurowanie API

Możemy łatwo załadować API, używając następującej składni.

<script src = "https://d3js.org/d3-dsv.v1.min.js"></script>
<script>
   var data = d3.csvParse(string);
</script>

Metody API

Poniżej przedstawiono różne metody interfejsu API wartości rozdzielanych ogranicznikami.

d3.csvParse (ciąg [, wiersz])
d3.csvParseRows (ciąg [, wiersz])
d3.csvFormat (wiersze [, kolumny])
d3.csvFormatRows(rows)
d3.tsvParse (ciąg [, wiersz])
d3.tsvParseRows (ciąg [, wiersz])
d3.tsvFormat (wiersze [, kolumny])
d3.tsvFormatRows(rows)

Przyjrzyjmy się szczegółowo każdej z tych metod API.

d3.csvParse (ciąg [, wiersz])

Ta metoda służy do analizowania formatu csv. Rozważ plikdata.csv to jest pokazane poniżej.

year,population
2006,40
2008,45
2010,48
2012,51
2014,53
2016,57
2017,62

Teraz możemy zastosować powyższą funkcję.

Example - Rozważmy następujący przykład.

var data = d3.csvParse(string, function(d) {
   return {
      year: new Date(+d.Year, 0, 1), // lowercase and convert "Year" to Date
      population: d.population
   };
});

Tutaj analizuje określony ciąg w wartościach oddzielonych ogranicznikami. Zwraca tablicę obiektów reprezentujących przeanalizowane wiersze.

d3.csvParseRows (ciąg [, wiersz])

Ta metoda służy do analizowania formatu csv odpowiadającego wierszom.

var data = d3.csvParseRows(string, function(d, i) {
   return {
      year: new Date(+d[0], 0, 1), // convert first colum column to Date
      population: d[1],
   };
});

Analizuje każdy wiersz w pliku csv.

d3.csvFormat (wiersze [, kolumny])

Ta metoda służy do formatowania wierszy i kolumn CSV.

Example - Rozważmy następujący przykład.

var string = d3.csvFormat(data, ["year", "population"]);

Tutaj, jeśli kolumny nie są określone, lista nazw kolumn tworzących wiersz nagłówka jest określana przez sumę wszystkich właściwości wszystkich obiektów w wierszach. Jeśli określono kolumny, jest to tablica ciągów reprezentująca nazwy kolumn.

d3.csvFormatRows (wiersze)

Ta metoda służy do formatowania wierszy CSV.

Example - Rozważmy następujący przykład.

var string = d3.csvFormatRows(data.map(function(d, i) {
   return [
      d.year.getFullYear(), // Assuming d.year is a Date object.
      d.population
   ];
}));

Tutaj formatuje określoną tablicę wierszy ciągów jako wartości rozdzielane ogranicznikami, zwracając ciąg.