rougail/doc/family/simple.md
2023-11-14 15:31:58 +01:00

2.9 KiB

Table of Contents

Une famille

Synopsis

Une famille est un conteneur de variables et de sous-famille.

⚠️ Une famille sans sous-famille ni sous-variable sera automatiquement supprimée.

Exemple

---
version: '1.0'
my_family:
  type: family
  description: This is a great family
  help: This is the help of a great family
  mode: expert

Paramètres

Paramètre Commentaires
name
string
mandatory
Nom de la famille.
C'est avec ce nom qu'on va pouvoir interagir avec la famille.
Il est préférable de suivre la convention sur les noms de variable.
type, _type
string
Type de la famille.
Le type n'est pas obligatoire même si parfois c'est nécessaire de le faire pour aider le moteur.
Valeurs possible :
- family ← par defaut
- leadership
- dynamic
📝 Si une sous-famille ou une sous-variable a déjà le nom "type" il est possible d'utiliser l'attribut "_type".
description, _description
string
La description de la famille.
Information utilisateur permettant de comprendre l'utilité de la famille.
📝 Si une sous-famille ou une sous-variable a déjà le nom "description" il est possible d'utiliser l'attribut "_description".
help, _help
string
Aide complémentaire associée à la famille.
📝 Si une sous-famille ou une sous-variable a déjà le nom "help" il est possible d'utiliser l'attribut "_help".
mode, _mode
string
Mode de la famille
Le mode par défaut d'une famille est le mode le plus petit des familles parentes, les variables enfants ou des familles enfants qui sont contenus dans cette famille.
Ce mode permet aussi de définir le mode par défaut des variables ou des familes inclusent dans cette famille.
Values:
- basic
- normal ← default
- expert
📝 Si une sous-famille ou une sous-variable a déjà le nom "mode" il est possible l'attribut "_mode".
hidden, _hidden
boolean ou calculation
Famille invisible.
Permet de cacher une famille ainsi que les variables ou les familles inclusent dans cette famille.
Cela signifie que la famille ne sera plus visible pour l'utilisateur mais sera visible pour un calcul.
📝 Si une sous-famille ou une sous-variable a déjà le nom "hidden" il est possible l'attribut "_hidden".
disabled, _disabled
boolean ou calculation
Famille désactivée.
Permet de désactiver une famille ainsi que les variables ou les familles inclusent dans cette famille.
Cela signifie que la famille ne sera plus visible pour l'utilisateur mais également pour un calcul.
📝 Si une sous-famille ou une sous-variable a déjà le nom "disabled" il est possible l'attribut "_disabled".