---
description: Le composant Label vous permet d'afficher du texte dans votre application.
---

# Label (Etiquette)

## Vue d'ensemble

* [Donner du style à l'étiquette](#style-the-label) (Label)
* [Modifier la taille de l'étiquette](#edit-the-label-size) (Label)
* [Ajouter un espacement](#add-spacing)
* [Blocs d'événements](#events)
* [Blocs de propriétés](#properties)

## Donner du style à l'étiquette (Label) <a href="#style-the-label" id="style-the-label"></a>

Vous pouvez personnaliser votre étiquette en utilisant les propriétés suivantes :

* **Text:** Texte qui figure sur l'étiquette
* **Font Size:** Taille du texte qui apparaît sur l'étiquette
* **Color:** Couleur du texte qui apparaît sur l'étiquette
* **Background Color:** Définit la couleur de fond de l'étiquette
* **Font Style**
  * **Normal:** Affichage du texte par défaut
  * **Italic:** Afficher le texte en italique
* **Font Weight:** Choisissez le degré de gras du texte sur l'étiquette
* **Text Align**
  * **Auto -** Aligne le texte automatiquement
  * **Left -** Affiche le texte à partir de la gauche de l'étiquette
  * **Right -** Affiche le texte à partir de la droite de l'étiquette
  * **Center -** Affiche le texte à partir du milieu de l'étiquette
  * **Justify -** Aligne de manière égale les côtés droit et gauche du texte
* **Visible:** Pour voir l'étiquette dans votre application, réglez le commutateur sur "True"
* **Border**
  * **Width:** Indiquez la largeur que vous souhaitez donner à la bordure de l'étiquette
  * **Color:** Choisissez une couleur pour le bord de l'étiquette
  * **Style:** Choisissez si vous voulez que le bord de l'étiquette soit une ligne pointillée, en pointillé ou en continu
  * **Radius:** Indiquez le tour que vous souhaitez donner aux bords de la bordure pour l'étiquette

## Modifier la taille du label <a href="#edit-the-label-size" id="edit-the-label-size"></a>

Vous pouvez définir la hauteur de l'étiquette en utilisant la propriété "**Height**" et la largeur de l'étiquette en utilisant la propriété "**Width**".

**Height**

* **Fill container -** L'étiquette remplit tout l'écran verticalement
* **Fit contents -** La hauteur de l'étiquette change en fonction de la taille du contenu qu'elle contient
* **Relative size -** L'étiquette remplit le pourcentage spécifié de l'écran
* **Absolute size -** Dimensionne l'étiquette à un nombre de pixels déterminé

**Width**

* **Fill container -** L'étiquette remplit tout l'écran horizontalement
* **Fit contents -** La largeur de l'étiquette change en fonction de la taille du contenu qu'elle contient
* **Relative size -** L'étiquette remplit le pourcentage spécifié de l'écran
* **Absolute -** Dimensionne l'étiquette à un nombre de pixels déterminé

_Note: Si le texte de votre étiquette comporte plus d'une ligne, nous vous recommandons de régler la hauteur sur_ _`Fit contents`_

## Ajouter un espacement <a href="#add-spacing" id="add-spacing"></a>

Vous modifiez l'espacement et le positionnement de l'étiquette avec les propriétés Margin (Marge) et Padding (Remplissage).

**Margin**

* Vous pouvez spécifier l'espace que vous souhaitez entre les bords de l'étiquette et l'écran en utilisant des valeurs en pixels ou en pourcentage.

**Padding**

* Vous pouvez spécifier l'espace que vous souhaitez entre la bordure et le contenu de l'étiquette en utilisant des valeurs en pixels ou en pourcentage.

## Événements <a href="#events" id="events"></a>

### Click <a href="#click" id="click"></a>

![Cet événement se déclenchera lorsque l'utilisateur cliquera sur l'étiquette.](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQmt2UXgQ_tfgkxjLdo%2F-MQmtMefeKp4pUPBJrgi%2Fevent_label.png?alt=media\&token=ded7874c-baea-4d9a-b403-422a0eb67247)

## Propriétés <a href="#properties" id="properties"></a>

### Background Color  <a href="#background-color" id="background-color"></a>

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQmtY1uz9NYsWkVJasc%2F-MQmuQiXAicNucq3hoUK%2Flabel1.png?alt=media\&token=abda7b55-5c0b-4051-bfd8-acdd83aacd74)

Les propriétés de couleur d'arrière-plan "Get" et "Set" fonctionnent avec la couleur de la vignette elle-même, c'est-à-dire la région située derrière le texte de l'étiquette. La meilleure pratique consiste à utiliser l'un des blocs de [Couleur ](../../untitled/untitled-1)pour définir cette valeur.

### Color  <a href="#color" id="color"></a>

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQmujPXW9QXANyTQ29t%2F-MQmurxnRmvXFdasUc0H%2Flabel2.png?alt=media\&token=7d2e227b-8407-4db1-ad8d-07dc71a674bd)

Les propriétés de couleur "get" et "set" de l'étiquette peuvent être utilisées pour travailler avec la couleur du texte qui est affiché dans l'étiquette. La meilleure pratique consiste à utiliser l'un des blocs de [Couleur ](../../untitled/untitled-1)pour définir cette valeur.

### Computed Dimensions  <a href="#computed-dimensions" id="computed-dimensions"></a>

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQmvLxU9UgiQL7dmouf%2F-MQmzB6KZfB7PbrPkeMz%2Flabel3.png?alt=media\&token=7545681a-b302-48da-b658-5420cc1b623d)

&#x20; &#x20;

Les blocs `Computed Height`  et `Computed Width` renvoient les dimensions de l'étiquette à l'écran, après que celle-ci ait été rendue à l'écran. La valeur renvoyée est un nombre entier, représentant la taille de l'étiquette en pixels.

### Font Size  <a href="#font-size" id="font-size"></a>

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQmvLxU9UgiQL7dmouf%2F-MQmz_bBDN7ldWzxgXq3%2Flabel4.png?alt=media\&token=1d6da475-579a-47a8-bf02-70d0c3cab645)

Les blocs `Get` et `Set` sont utilisés pour travailler avec la taille du texte qui est affiché dans l'étiquette. Cette valeur doit être un nombre.

### Font Style  <a href="#font-style" id="font-style"></a>

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQmzlJ81HiznIAg4qH4%2F-MQmzphTl_NfzGVy2cLs%2Flabel5.png?alt=media\&token=22faa5ec-ca76-4cd2-b470-971272f5ae36)

La propriété du style de police peut être soit "Normal" ou "_Italic"._

### Font Weight  <a href="#font-weight" id="font-weight"></a>

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQn-2kwiTdhoHRQiukm%2F-MQn-5F7Kh3w8utyaYuK%2Flabel6.png?alt=media\&token=e55353be-b27e-4a06-87c9-512b34a8ae51)

La valeur du corps de la police peut être soit : "Normal", "**Bold**" ou une valeur de 100 à 900.

### Height <a href="#height" id="height"></a>

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQn-MtVi8tX22kXIzA5%2F-MQn-RGGOsgRFN77VhoK%2Flabel7.png?alt=media\&token=ebdeffd2-001e-47e5-b230-e3de0a75ed7d)

Les blocs `Set` et `Get` fonctionnent avec la propriété "Height" du composant de l'étiquette. Les valeurs d'entrée acceptables sont .

* Number of Pixels (Nombre de pixels)
* Percentage Height (Pourcentage de Hauteur)
* "Fit Contents" (Contenu adapté)
* "Fill Container" (Remplir le conteneur)

### Number of Lines  <a href="#number-of-lines" id="number-of-lines"></a>

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQn03kmBDYeGipDH3We%2F-MQn08h6LryU96x-cjPc%2Flabel8.png?alt=media\&token=623fc8e7-db51-47c2-ae54-20b85562151b)

Les propriétés `Get` et `Set` du bloc "Number of Lines" est utilisée pour travailler avec le nombre maximum de lignes de texte qui doivent être affichées dans une étiquette avant que celle-ci ne commence à défiler.

### Text  <a href="#text" id="text"></a>

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQn0RC2W5mPXFo3Vwuf%2F-MQnd8gV_TVG9o9PJaqs%2Flabel9.png?alt=media\&token=a31d81fc-06b8-4109-9335-64cefbd03003)

Cette propriété correspond au texte qui est affiché dans le composant de l'étiquette.

### Text Align <a href="#text-align" id="text-align"></a>

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQn0RC2W5mPXFo3Vwuf%2F-MQndNplQI1I2BxwsRF2%2Flabel10.png?alt=media\&token=e9d9cd67-e9ab-4c92-924e-8356b20f9d88)

L'alignement du texte peut être l'une des valeurs suivantes :

* Auto
* Left (Gauche)
* Right (Droite)
* Center (Centre)
* Justify (Justifié)

### Visible <a href="#visible" id="visible"></a>

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQnd_CBqe6GZKheKpyh%2F-MQndxbL8dXhgSN8IvPQ%2Flabel11.png?alt=media\&token=1bbd6611-d641-4e22-8afd-299a8e848f05)

Les blocs `Set` et `Get` Visible sont utilisés pour afficher ou masquer l'ensemble de la composante de l'image. Les valeurs acceptables sont :

* True (Vrai)
* False (False)

### Width  <a href="#width" id="width"></a>

![](https://549775582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MQb_PhIRrBnThcbXLKN%2F-MQnd_CBqe6GZKheKpyh%2F-MQne2cv8kz621Ao3pmK%2Flabel12.png?alt=media\&token=865b0e95-c635-48db-9d7c-1902ccc52d1d)

Les blocs `Set` et `Get` Width fonctionnent avec la propriété Width du composant de l'étiquette. Les valeurs acceptables sont .

* Number of Pixels (Nombre de Pixels)
* Percentage Width (Pourcentage en Largeur)
* "Fit Contents" (Contenu adapté)
* "Fill Container" (Remplir le conteneur)
