Version: 6.5

Gestion des headers

Afin de faciliter la surcharge avec l’ajout ou la modification des actions disponibles en haut à droite de l’écran, les headers sont gérés avec un système de clé. Il faut venir enregistrer, via un provider disponible dans le package core, pour chaque écran les actions qui doivent être affichées.

Ces enregistrements sont réalisés par des hook permettant ainsi d’accéder à différents outils mis à disposition dans les packages (traductions, thèmes, store,…) mais également d’avoir une mise à jour des headers lorsque c’est nécessaire.

Chaque module doit donc fournir son hook permettant d’enregistrer les actions du header pour ses écrans.

const useCustomerDeliveryDetailsActions = () => {
  const { mobileSettings } = useSelector((state) => state.config);
  const { customerDelivery } = useSelector((state) => state.customerDelivery);

  useEffect(() => {
    headerActionsProvider.registerModel("stock_customerDelivery_details", {
      model: "com.axelor.apps.stock.db.StockMove",
      modelId: customerDelivery?.id,
      disableMailMessages: !mobileSettings?.isTrackerMessageOnStockApp,
    });
  }, [mobileSettings, customerDelivery]);
};

Il faut donc utiliser l’outil headerActionsProvider pour associer une clé à un objet contenant l’ensemble des informations nécessaires aux différentes actions du header.

Un nomenclature a été mise en place pour aider à la compréhension de l’origine d’une clé : <Module>_<Object>_<Type d’écran>.

Les actions sont donc définies à travers une structure nommée HeaderOptions :

export interface HeaderActions {
  [key: string]: HeaderOptions;
}

export interface HeaderOptions {
  model?: string;
  modelId?: number;
  disableMailMessages?: boolean;
  attachedFileScreenTitle?: string;
  actions?: ActionType[];
}

Le package core fournit par défaut deux actions pour le header qui sont les messages de suivi sur chaque objet ainsi que les fichiers joints. Elles sont paramétrables via les props suivantes :

  model?: string; // nom complet du modèle sur l'ERP
  modelId?: number; // Id de l'objet
  disableMailMessages?: boolean; // Condition pour l'affichage ou non des messages de suivi sur l'objet
  attachedFileScreenTitle?: string; // Nom de l'écran pour les fichiers joints

Les fichiers joints s’affichent uniquement si l’objet actuel en possède avec un indicateur sur leur nombre. Les messages de suivi eux n’affichent lorsque model et modelId sont renseignés et qu’il ne sont pas désactivés par l’attribut disableMailMessages.

Il est ensuite possible d’ajouter des actions supplémentaires avec l’attribut actions. Chaque action possède alors la structure suivante :

export interface ActionType {
  key: string;
  order: number;
  title: string;
  iconName: string;
  iconColor?: string;
  FontAwesome5?: boolean;
  indicator?: number;
  hideIf?: boolean;
  onPress: () => void;
  showInHeader?: boolean;
}

Les différents attributs mis à disposition sont donc :

key : [Required] permet de donner un identifiant à l’action afin de permettre la modification à travers une surcharge.
order : [Required] permet d’ordonner l’affichage des actions
title : [Required] titre de l’action lorsque celle-ci est réduite dans le DropdownMenu
iconName : [Required] nom de l’icone associé à cette action
iconColor : couleur de l’icone, par défaut celle-ci est fixée à secondaryColor_dark.background
FontAwesome5 : booléen pour savoir si l’icone appartient à la base de FontAwesome4 ou FontAwesome5. Par défaut cette valeur est fixée à true ce qui correspond donc à FontAwesome5.
indicator : chiffre à afficher en petit en haut de l’icone de l’action (ex: nombre de fichiers joints ou de messages en attente)
hideIf : condition d’affichage de l’action
onPress : [Required] action à exécuter lorsque l’utilisateur clique sur l’icone
showInHeader : condition pour savoir si l’action peut s’afficher directement dans le header ou si elle doit toujours être présente dans les actions déroulantes. Par défaut, les actions sont paramétrées pour s’afficher dans la liste déroulante.

D’un point de vue fonctionnel, l’ensemble des actions est transmis au composant HeaderOptionsMenu qui va ensuite réaliser les étapes suivantes:

récuprérer les deux actions par défaut paramétrées avec les informations renseignées
retirer de la liste les actions cachées
trier la liste par order croissant
afficher les deux premières actions avec l’attribut showInHeader à true directement dans le header
afficher le reste des actions dans le DropdownMenu

Pour les petits écrans, toutes les actions sont affichées dans la liste déroulante.