Aller au contenu
x4x4x4js2.3.29

Contrôles standard

Ce chapitre est court : il s’agit de vous donner une idée de tous les contrôles et outils qui existent dans x4js, et de ce à quoi ils servent.

Les propriétés et les méthodes exactes de chacun sont dans la référence de l’API.

Pour les voir fonctionner, la galerie a une page par composant, avec sa description et le code de l’exemple.

Contrôle Description
Box, HBox, VBox Conteneur générique, horizontal, vertical.
HSplitBox, VSplitBox Panneaux côte à côte ou empilés, redimensionnables par l’utilisateur.
HSizer, VSizer Poignées de redimensionnement posées à la main, quand un HSplitBox ou un VSplitBox ne convient pas.
DockingView Panneaux que l’utilisateur dispose en les tirant par leur titre, comme dans un IDE.
StackBox Pile de pages dont une seule est visible.
AssistBox Pile de pages parcourue dans l’ordre, pour un assistant.
Carousel Diapositives qui défilent : flèches, points, glissement du doigt, lecture automatique.
GridBox Grille de lignes et de colonnes.
MasonryBox Disposition en mosaïque.
Tabs Pages accessibles par des onglets.
Panel Conteneur avec un titre.
Form Formulaire : lit et écrit les valeurs des champs qui ont un name. Voir Formulaires et dialogues.
SettingsView, SettingItem Page de réglages, comme celle de VS Code : sommaire, sections, recherche.
ScrollView Zone défilante.
Flex, Space Éléments vides : l’un prend la place restante, l’autre a une taille fixe.
Contrôle Description
Label Texte, avec une icône optionnelle.
SimpleText Texte seul.
Icon Icône (SVG, variable CSS ou image).
Image Image, qui peut aussi accepter le dépôt d’un fichier.
Link Lien.
Tag Étiquette courte, avec une icône optionnelle.
Progress Barre de progression.
Gauge Jauge à aiguille.
Bargraph Indicateur de niveau en segments, comme un vumètre.
Rating Note (étoiles…).
Timeline Événements sur une ligne, chacun avec son icône et sa date.
TickLine Mini-graphique d’une série de valeurs, en barres ou en ligne.
Chart Graphique simple : lignes, aires, barres, camembert, anneau, radar.
Canvas Zone de dessin libre.
SvgComponent Composant SVG, base des contrôles dessinés.
Video Lecteur vidéo.
Breadcrumbs Fil d’Ariane.
Contrôle Description
Button Bouton, avec texte et/ou icône, et un menu optionnel.
BtnGroup Groupe de boutons, avec des boutons prédéfinis (ok, cancel…).
Input Champ de saisie natif : texte, nombre, date, heure, fichier…
TextEdit Champ de saisie avec son libellé.
TextArea, SimpleTextArea Zone de saisie multiligne, avec ou sans libellé.
Checkbox, Radio, Switch Case à cocher, bouton radio, interrupteur.
Slider Curseur.
Knob Bouton rotatif, sur une plage ou sans fin.
Select Liste de choix native.
Combobox Liste déroulante sur une liste connue.
AutoComplete Champ avec des suggestions obtenues à la demande.
ColorInput, ColorPicker Saisie et choix d’une couleur.
Calendar, PopupCalendar Calendrier, dans la page ou en popup.
FileDrop, FileDialog Zone de dépôt de fichiers, sélecteur de fichiers du système.
Keyboard Clavier virtuel.
Contrôle Description
Listbox Liste simple, avec colonnes optionnelles.
Header En-tête de colonnes redimensionnables, pour un Listbox.
Treeview Liste arborescente.
Gridview Affichage tabulaire d’un DataStore.
Spreadsheet Tableau de type tableur, éditable en ligne.
PropertyGrid Éditeur de propriétés.
Contrôle Description
Popup Base de tout ce qui s’affiche par-dessus la page.
Dialog Base des boîtes de dialogue.
MessageBox, InputBox, PromptBox Message, saisie d’une valeur, saisie avec un éditeur au choix.
ProgressionBox Suivi d’une opération longue, avec textes et erreurs.
Menu Menu contextuel ou déroulant.
Notification Notification à l’utilisateur.

Les info-bulles s’obtiennent avec la propriété tooltip, commune à tous les composants, après un appel à initTooltips( ) au démarrage.

Ces composants sont gros, ou peu utilisés : ils ne sont pas dans x4js, mais chacun a son propre import. Une application qui ne s’en sert pas n’emporte ni leur code ni leur CSS.

Contrôle Import Description
Gantt x4js/gantt Tâches sur un calendrier : barres, dépendances, groupes, jalons.
Planner x4js/planner Agenda : événements par jour, par semaine ou par mois.
MapView x4js/mapview Carte en tuiles (OpenStreetMap par défaut), avec marqueurs et zones.
MonacoEditor x4js/monaco Éditeur de code. Ses fichiers sont à copier dans le dossier monaco de la sortie.
import { Gantt } from "x4js/gantt";
Outil Description
Application Singleton qui définit l’application.
makeState État observable de l’application.
DataModel, DataStore, DataView Enregistrements, stockage et vues filtrées ou triées.
Store Stockage par cellule, pour Spreadsheet.
Router Routage par adresse.
_tr, addTranslation… Système de traduction.
formatNumber, formatMoney, formatDate… Nombres, montants, pourcentages et dates au format de la langue courante.
addShortcut( ), shortcutText Raccourcis clavier, d’un composant ou de toute l’application.
setClipboard, getClipboard Presse-papiers du système : texte, image, fichiers.
Color, Rect, Point, Size Couleurs et géométrie.
dragManager Glisser-déposer.
setStyleVariable( ), getComputedStyle( ) Changer une variable CSS d’un composant, lire son style calculé.
SvgBuilder Construction de dessins SVG.
X4PDFBuilder, renderBarcodeImage Génération de PDF, codes-barres (Data Matrix, Code 128).
x4_react Fabrique JSX, pour écrire un arbre de composants dans un fichier .tsx.

À cela s’ajoutent bon nombre de fonctions pratiques pour manipuler les dates, les chaînes ou le DOM. Vous pouvez jeter un œil à core_tools dans les sources pour en avoir une idée.