# source

the tabular dataset the series read through `encode` (a Dataset, a source, or rows); it wins over `values` / `series`. Named `source` because `dataset` is the element's own data-* map.

Canonical: https://chart.syidax.com/docs/options/source/

<a id="definition"></a>

## Definition

| Item | Value |
| --- | --- |
| JavaScript property | `source` |
| HTML attribute | Pass objects, arrays, and callbacks as JavaScript properties |
| Type | `Dataset \| DatasetSourceInput \| ReadonlyArray<DatasetRow> \| null` |
| Default | `undefined` |

undefined means this property was not explicitly set. The effective value may depend on the chart type and other settings.

- [Dataset](https://chart.syidax.com/docs/types/Dataset.md) — Type definition
- [DatasetSourceInput](https://chart.syidax.com/docs/types/DatasetSourceInput.md) — Type definition
- [DatasetRow](https://chart.syidax.com/docs/types/DatasetRow.md) — Type definition

<a id="related"></a>

## Related documentation

A property with the same name may have different types and defaults across charts. When using a direct tag, follow that chart's documentation below.

- [Shared facade and direct tags](https://chart.syidax.com/docs/concepts.md)
