Files
grafana/docs/sources/packages_api/data/dataframeview.md

165 lines
4.7 KiB
Markdown
Raw Normal View History

Docs: adding first version of the auto-generated packages API docs. (#22107) * trying out api-extractor. * works with our setup of build. * wip. * changed the packages so it works better with the api-extractor. * Changes to make the api-extractor to work. * cleaned up the api-extractor config files. * added some more documentation. * added tsdoc-metadata to gitignore. * removed the generated docs (will do that in another PR). * added execute permission to script for generating dosc. * added so we will push generated docs to branch. * will clean packages_api on abort. * Fixed failing tests. * fixed formatting issue with typedoc comment. * temporarily disabled tslint rules about namespace until https://github.com/microsoft/rushstack/issues/1029 is resolved * temporary enabled bable namespaces. * updated build script. * updated script. * updated script with some colors. * changed to camelCase. * removed spacing. * Starting to add documentation guidelines. * added examples headline. * added menu options. * added parameters and return values. * Fixed merge error. * Added first version of auto-generated docs. * changed so we use the eslint ignore syntax. * changed to correct eslint ingnore comment. * fixed some spelling errors reported by codespell. * added script to generate docs in current folder. * updated api docs. * lerna bootstrap. * added eror to the ingore words list. * removed file that should be ignored. * updated locKFILE. * referenced the code comments guidelines. * updated packages. * updated deps. * updated the autogenerated dosc. * adding missing new line.
2020-02-26 10:03:53 +01:00
+++
# -----------------------------------------------------------------------
# Do not edit this file. It is automatically generated by API Documenter.
# -----------------------------------------------------------------------
title = "DataFrameView"
keywords = ["grafana","documentation","sdk","@grafana/data"]
type = "docs"
+++
## DataFrameView class
> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
>
This abstraction will present the contents of a DataFrame as if it were a well typed javascript object Vector.
<b>Signature</b>
```typescript
export declare class DataFrameView<T = any> extends FunctionalVector<T>
Docs: adding first version of the auto-generated packages API docs. (#22107) * trying out api-extractor. * works with our setup of build. * wip. * changed the packages so it works better with the api-extractor. * Changes to make the api-extractor to work. * cleaned up the api-extractor config files. * added some more documentation. * added tsdoc-metadata to gitignore. * removed the generated docs (will do that in another PR). * added execute permission to script for generating dosc. * added so we will push generated docs to branch. * will clean packages_api on abort. * Fixed failing tests. * fixed formatting issue with typedoc comment. * temporarily disabled tslint rules about namespace until https://github.com/microsoft/rushstack/issues/1029 is resolved * temporary enabled bable namespaces. * updated build script. * updated script. * updated script with some colors. * changed to camelCase. * removed spacing. * Starting to add documentation guidelines. * added examples headline. * added menu options. * added parameters and return values. * Fixed merge error. * Added first version of auto-generated docs. * changed so we use the eslint ignore syntax. * changed to correct eslint ingnore comment. * fixed some spelling errors reported by codespell. * added script to generate docs in current folder. * updated api docs. * lerna bootstrap. * added eror to the ingore words list. * removed file that should be ignored. * updated locKFILE. * referenced the code comments guidelines. * updated packages. * updated deps. * updated the autogenerated dosc. * adding missing new line.
2020-02-26 10:03:53 +01:00
```
<b>Import</b>
```typescript
import { DataFrameView } from '@grafana/data';
```
## Remarks
The [DataFrameView.get()](./data/dataframeview/get.md) is optimized for use in a loop and will return same object. See function for more details.
<b>Constructors</b>
| Constructor | Modifiers | Description |
| --- | --- | --- |
| [constructor(data)](#constructor-data) | | <b><i>(BETA)</i></b> Constructs a new instance of the <code>DataFrameView</code> class |
<b>Properties</b>
| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [dataFrame](#dataframe-property) | | <code>DataFrame</code> | <b><i>(BETA)</i></b> |
| [length](#length-property) | | <code>number</code> | <b><i>(BETA)</i></b> |
<b>Methods</b>
| Method | Modifiers | Description |
| --- | --- | --- |
| [get(idx)](#get-method) | | <b><i>(BETA)</i></b> The contents of the object returned from this function are optimized for use in a loop. All calls return the same object but the index has changed. |
| [getFieldDisplayProcessor(colIndex)](#getfielddisplayprocessor-method) | | <b><i>(BETA)</i></b> Helper function to return the [DisplayProcessor](./data/displayprocessor.md) for a given field column. |
| [toArray()](#toarray-method) | | <b><i>(BETA)</i></b> |
> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
>
### constructor(data)
Constructs a new instance of the `DataFrameView` class
<b>Signature</b>
```typescript
constructor(data: DataFrame);
```
<b>Parameters</b>
| Parameter | Type | Description |
| --- | --- | --- |
| data | <code>DataFrame</code> | |
> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
>
### dataFrame property
<b>Signature</b>
```typescript
get dataFrame(): DataFrame;
```
> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
>
### length property
<b>Signature</b>
```typescript
get length(): number;
```
> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
>
### get method
The contents of the object returned from this function are optimized for use in a loop. All calls return the same object but the index has changed.
<b>Signature</b>
```typescript
get(idx: number): T;
```
<b>Parameters</b>
| Parameter | Type | Description |
| --- | --- | --- |
| idx | <code>number</code> | The index of the object you currently are inspecting |
<b>Returns:</b>
`T`
## Example
```typescript
// `first`, `second` and `third` will all point to the same contents at index 2:
const first = view.get(0);
const second = view.get(1);
const third = view.get(2);
// If you need three different objects, consider something like:
const first = { ...view.get(0) };
const second = { ...view.get(1) };
const third = { ...view.get(2) };
```
> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
>
### getFieldDisplayProcessor method
Helper function to return the [DisplayProcessor](./data/displayprocessor.md) for a given field column.
<b>Signature</b>
```typescript
getFieldDisplayProcessor(colIndex: number): DisplayProcessor | null;
```
<b>Parameters</b>
| Parameter | Type | Description |
| --- | --- | --- |
| colIndex | <code>number</code> | the field column index for the data frame. |
<b>Returns:</b>
`DisplayProcessor | null`
> This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
>
### toArray method
<b>Signature</b>
```typescript
toArray(): T[];
```
<b>Returns:</b>
`T[]`