Componenti di visualizzazione di Looker

I componenti di visualizzazione di Looker sono una suite di componenti basati su React disponibili nel pacchetto @looker/visualizations open source.

I componenti di visualizzazione accettano un valore Query.client_id o un ID query da un'esplorazione di Looker o un ID dashboard da una dashboard di Looker e restituiscono una visualizzazione lato client senza un iframe.

Questi componenti possono essere utilizzati così come sono, personalizzati o trattati come semplici formattatori di dati per trasmettere i dati puliti da un'esplorazione di Looker e semplificare la creazione di visualizzazioni personalizzate.

I componenti di visualizzazione di Looker sono progettati per essere utilizzati in un ambiente React autenticato con l'API di Looker utilizzando l'SDK TypeScript/JavaScript. Questo passaggio viene gestito automaticamente quando esegui la compilazione con il framework di estensione di Looker.

Creazione di visualizzazioni con i componenti di visualizzazione di Looker

La suite di componenti di visualizzazione di Looker fornisce due componenti di alto livello per lavorare con i dati:

  • Query: gestisce il recupero dei dati e carica la risposta nel contesto di React
  • Visualization: accetta i dati restituiti da Query e utilizza gli adattatori di configurazione per eseguire il rendering del grafico personalizzato in modo appropriato in una pagina

Al momento, i dati possono essere visualizzati nei seguenti tipi di grafici:

  • A linee
  • Area
  • A dispersione
  • Sparkline
  • Valore singolo
  • A barre
  • Colonna
  • Tabella
  • Torta

Sono in fase di sviluppo altri tipi di grafici.

Per visualizzare le tabelle delle proprietà per ogni tipo di grafico, consulta la pagina della documentazione Visualization and Query property tables (Tabelle delle proprietà di visualizzazione e query).

Per visualizzare le opzioni di configurazione disponibili per ogni tipo di grafico, consulta il playground di visualizzazione.

Perché utilizzare i componenti di visualizzazione?

I componenti di visualizzazione migliorano e semplificano il processo di rendering di una visualizzazione da Looker all'interno di un'applicazione, liberano tempo dagli sviluppatori e offrono loro più opzioni per personalizzare ed estendere le visualizzazioni da Looker.

  • Incorporamento migliorato: i componenti di visualizzazione consentono agli sviluppatori di incorporare una visualizzazione di Looker in un'applicazione senza un iframe. In questo modo, puoi migliorare le prestazioni, il monitoraggio e la possibilità di personalizzazione.
  • Integrazione facile: i componenti di visualizzazione possono essere combinati con altri componenti di @looker/components per creare composizioni ed esperienze front-end completamente nuove.
  • Personalizzazione: è più facile personalizzare le visualizzazioni incorporate quando si utilizzano i componenti di visualizzazione rispetto all'utilizzo degli iframe. Inoltre, con i componenti di visualizzazione, gli sviluppatori possono creare applicazioni altamente personalizzate molto più velocemente, senza dover creare un livello di visualizzazione da zero.
  • Semplificazione: i componenti di visualizzazione migliorano la portabilità delle visualizzazioni di Looker e semplificano le interazioni con l'API Looker.

Installazione dei componenti di visualizzazione

Per iniziare, aggiungi il pacchetto NPM dei componenti di visualizzazione di Looker:

  • NPM: npm install @looker/visualizations
  • YARN: yarn add @looker/visualizations

Dovrai anche soddisfare alcune dipendenze peer: Looker/components, React e Styled Components:

  • NPM: npm install @looker/components react react-dom styled-components
  • YARN: yarn add @looker/components react react-dom styled-components

Le informazioni sull'installazione e sull'utilizzo del pacchetto dei componenti di visualizzazione sono disponibili nel documento README, disponibile su GitHub e NPM.

Passaggi successivi