# Legend

## Description

Display a legend of color and value pairs

{% tabs %}
{% tab title="Preview" %}
![](https://97674526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOQQ5Dv56AckPkeQ6O9Rf%2Fuploads%2FvNCjGtI8fDaAxsRZOzRN%2FLegend.png?alt=media\&token=8fcb4de0-0409-48e1-8086-9fee453925d4)
{% endtab %}

{% tab title="Location" %}
**Name** | Ui Legend

**Nickname** | Legend

**Tab** | Ui

**Panel** | Display

**Division** | 4
{% endtab %}

{% tab title="Inputs" %}
**\*E** | **Element** (*Ui+ Element*) | An optional input for an Element. 

> If an Element is input it will be updated, if empty a new Element will be created.
>
> The input control must be of the same type as the component

**V** | **Label** (*Text*) | The controls legend values

**C** | **Colors** (*Colour*) | The controls legend colors

**H** | **Horizontal** (*Bool*) | Is legend orientation horizontal

**I** | **Icon** (*Integer*) | The legend icon
{% endtab %}

{% tab title="Ouputs" %}
**E** | **Element** (*Ui+ Element*) | Ui Element Control. 
{% endtab %}

{% tab title="Mode" %}
*none*
{% endtab %}
{% endtabs %}

## Usage

![Box](https://97674526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOQQ5Dv56AckPkeQ6O9Rf%2Fuploads%2F2xqvMrgWrG3zHrjSJRQP%2Fimage.png?alt=media\&token=cb84e4e8-fdda-4c56-a10e-64f442d38633)

![Dot](https://97674526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOQQ5Dv56AckPkeQ6O9Rf%2Fuploads%2Fh3ViI4vgBWlyqogsAR3q%2Fimage.png?alt=media\&token=4686eee7-c8ac-44dc-93c7-712fd80edcda)

![Bar](https://97674526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOQQ5Dv56AckPkeQ6O9Rf%2Fuploads%2FTxvo1RITbzP6oUkgRPBB%2Fimage.png?alt=media\&token=0aa08fd5-aeda-42d5-b99a-cec2b89af434)

![Fill](https://97674526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOQQ5Dv56AckPkeQ6O9Rf%2Fuploads%2FIqZNx4f4kEkK5KiXFUgS%2Fimage.png?alt=media\&token=0eadb97d-c8c4-4212-abbe-64f0c1b50005)

![Underline](https://97674526-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOQQ5Dv56AckPkeQ6O9Rf%2Fuploads%2FrbCnMCSoMj5u00zcZAbT%2Fimage.png?alt=media\&token=a1832825-9634-46ed-b937-eeea2c70c2ed)