Widget Text (Texte)

Le widget Text (Texte) permet d’ajouter du texte statique ou dynamique à votre application.

Exemples

Utilisez ce widget pour prendre en charge les exigences de conception d’application, telles que les suivantes :

• Vous souhaitez afficher dans l’application du texte qui prenne en charge les autres contenus, tels que les détails des données et les légendes des images.
• Vous souhaitez afficher une expression ou un champ dynamique à partir d’une source de données. Vous pouvez combiner un widget Text (Texte) et un widget List (Liste) de sorte que les utilisateurs finaux puissent cliquer sur un élément de la liste pour afficher les détails de l’entité correspondante, tels que les valeurs attributaires.

Remarques sur l’utilisation

Le widget Text (Texte) inclut un éditeur de texte enrichi dans lequel vous pouvez modifier, entre autres, le type, la taille ou la couleur de police. Pour un texte dynamique, vous pouvez définir la source de données pour utiliser les attributs de plusieurs couches d'entités ou en obtenir les statistiques. Les options courantes de mise en forme de texte sont disponibles sur une barre d’outils qui apparaît lorsque vous effectuez des mises à jour dans le widget Text (Texte). Vous pouvez accéder à toutes les options de mise en forme dans le panneau de configuration du widget. Pour mettre à jour le texte d’un hyperlien, cliquez dessus, cliquez sur le bouton Link (Lier) de l’onglet Content (Contenu), mettez à jour le lien configuré, puis fermez le panneau Set link (Définir un lien).

Conseil :

Lorsque vous saisissez du texte dans l’éditeur de texte, utilisez des raccourcis clavier pour annuler ou rétablir les mises à jour de texte (Ctrl+Z pour annuler et Ctrl+Y pour rétablir). Les boutons Undo (Annuler) et Redo (Rétablir) de la barre d’outils du générateur dépendent des actions effectuées dans le générateur, telles que la connexion de données ou l’ajout du widget Text (Texte).

Lorsque le texte occupe un espace supérieur à la taille du widget, les utilisateurs peuvent faire défiler le texte dans le widget. Un effet de fondu est alors appliqué en bas du widget avec une icône en forme de flèche dans l’angle pour indiquer qu’il existe davantage de texte à lire.

Paramètres

Le widget Text (Texte) inclut les paramètres suivants :

• Connect to data (Connexion aux données) : connectez éventuellement le widget à des données spécifiques. (Aucune source de données n’est requise pour un widget Text (Texte).)
  • Select data (Sélectionner des données) : sélectionnez les données qui doivent alimenter le contenu du widget. Vous pouvez sélectionner plusieurs couches d’entités pour un même widget Texte, et ajouter plusieurs visualisations de données pour chaque couche d’entités. Vous pouvez combiner du texte statique à du contenu dynamique. Par exemple, vous pouvez saisir une phrase et choisir un ou plusieurs champs pour alimenter des valeurs à partir d’entités sélectionnées des données connectées.
  • Une fois que vous avez connecté les données, le bouton Dynamic content (Contenu dynamique) devient actif sur la barre d’outils du widget pour que vous puissiez continuer de configurer la connexion aux données.
• Wrap (Délimiter) : activez ou désactivez le retour du texte à la ligne.
• Tooltip (Info-bulle) : saisissez un texte de survol pour décrire le contenu textuel. Si vous connectez le widget Texte à des données, vous pouvez utiliser du contenu dynamique. Pour cela, sélectionnez Attribute (Attribut), Statistics (Statistiques) ou Expression.
• Placeholder (Espace réservé) (disponible dans les modèles) : lorsque vous utilisez le widget Text (Texte) dans un modèle d’expérience web, indiquez le texte de l’espace réservé pour personnaliser le contenu et le style.
• Text format (Format de texte) : utilisez les options de mise en forme courantes suivantes :
  • Police : modifiez le type et la taille de police par unité en pixels (px), rem ou largeur de vue (vw).
  • Basic font settings (Paramètres de police de base) : appliquez une mise en forme gras, italique, barré ou souligné et choisissez une couleur de mise en surbrillance et une couleur de police.
  • Lien : mettez en forme le texte comme hyperlien pour accéder à d’autres contenus, par exemple une page, une fenêtre, une vue de section ou une adresse Web. Dans les pages avec défilement, vous pouvez définir un lien de façon à accéder directement à un bloc déterminé de la page ou à revenir en haut de la page.
  • Paragraph layout (Mise en page des paragraphes) : ajustez l’alignement des paragraphes (gauche, centre, droit ou justifié), utilisez une mise en forme de type liste à puces ou liste numérotée et augmentez ou réduisez le retrait.
  • Espacement des caractères : ajustez l’espace entre les caractères par unité en pixels (px), rem ou largeur de vue (vw).
  • Line spacing (Espacement des lignes) : ajustez l’espacement des lignes et des paragraphes. La valeur par défaut est de 1,5 lignes.
  • Character effect (Effet typographique) : donnez du style aux caractères du texte en leur appliquant une ombre.
• Clear all formatting (Effacer toute la mise en forme) : sélectionnez le texte mis en forme et cliquez sur ce bouton pour effacer la mise en forme existante.

  Attention :

  Si une phrase variable du contenu dynamique est incluse dans le texte sélectionné, ce bouton en supprime le contenu car il est traité comme une mise en forme de texte.

Volet de contenu dynamique

Lorsque vous connectez le widget Texte aux données, le bouton Dynamic content (Contenu dynamique) devient actif sur la barre d’outils qui s’affiche en mode de mise à jour intégrée du widget. Ce bouton permet d’ouvrir un volet qui regroupe les options ci-après pour extraire le contenu dynamique de la source de données sélectionnée.

• Attribute (Attribut) : choisissez le champ dans les données sélectionnées pour lesquelles vous souhaitez afficher les valeurs attributaires dans le widget Text (Texte). Une fois que vous avez choisi un champ, ce dernier est ajouté à la zone de texte modifiable sous forme de variable de nom de champ (nom du champ entre accolades). Cette variable est alimentée avec les valeurs attributaires d’entité en fonction des connexions que vous configurez, notamment l’utilisation d’un widget Texte pour afficher des noms de lieux dans une liste connectée aux mêmes données.
• Statistics (Statistiques) : obtenez les résultats de fonctions statistiques pour un champ sélectionné ou le nombre de données de la source de données correspondante à insérer dans le widget Text (Texte).
• Expression : créez une expression plus complexe avec les opérateurs de fonction et les champs de données à insérer dans le widget Text (Texte).

  Conseil :

  Pour personnaliser le message qui s’affiche lorsqu’aucun enregistrement n’est sélectionné, changez le titre de l’expression. Le titre de l’expression s’affiche comme message d’absence de données pour le texte dynamique. Vous pouvez aussi créer une vue en cas de sélection vide dans la fenêtre Data (Données).

Vous pouvez utiliser les opérateurs de fonction suivants sur les onglets Statistics (Statistiques) et Expression :

Opérateur	Syntaxe de l’expression	Description
MOYENNE	AVERAGE({field})	Moyenne de toutes les valeurs dans le champ spécifié.
TOTAL	COUNT({field})	Nombre total des valeurs dans le champ spécifié.
SOMME	SUM({field})	Somme de toutes les valeurs dans le champ spécifié.
MAX	MAX({field})	Valeur maximale dans le champ spécifié.
MIN	MIN({field})	Valeur minimale dans le champ spécifié.
ÉCART_TYPE	STANDARD_DEVIATION({field})	L’écart type montre l’écart séparant une valeur de la moyenne.
CENTILE_DISCRET	PERCENTILE_DISCRETE({field},percentile value, order)	Une valeur de centile est une valeur sur une échelle de 0 à 100. Un centile discret signifie que la valeur renvoyée est extraite du champ en entrée.
CENTILE_CONTINU	PERCENTILE_CONTINUOUS({field},percentile value, order)	Un centile continu signifie que la valeur renvoyée est interpolée à partir des données du champ en entrée.

Pour PERCENTILE_DISCRETE (CENTILE_DISCRET) et PERCENTILE_CONTINUOUS (CENTILE_CONTINU), vous pouvez calculer les centiles par ordre croissant (ASC) ou décroissant (DESC). L’ordre croissant signifie qu’une valeur dans le n^ème centile d’un jeu de données est supérieure à n % des valeurs du jeu de données. L’ordre décroissant signifie qu’une valeur dans le n^ème centile d’un jeu de données est inférieure à n % des valeurs du jeu de données.

Pour plus d’informations sur l’utilisation de contenu dynamique, reportez-vous à la rubrique Sélectionner des données.