4.9.16 Options de représentation type tab

Les options de représentation indiquées dans la structure de la famille ne sont pas prises en compte dans les interfaces HTML5.

Les options d'affichage générales des onglets sont fournies par les options de document.

Le widget de gestion des onglets est basé sur un widget Kendo tab Strip.

4.9.16.1 setTooltipLabel

Cette option d'afficher un tooltip au dessus de l'onglet lors du survol.

Si le label est particulièrement long et qu'il ne peut être affiché intégralement dans l'onglet, le tooltip permet de voir le libellé en entier.

Dcp\Ui\TabRenderOptions setTooltipLabel(string $label,
                                          bool $html=false)

4.9.16.1.1 Restrictions

Aucune

4.9.16.1.2 Paramètres

• L'argument $label indique le texte du tooltip.

  Il peut comporter les parties variables suivantes :

  • {{label}} : Le libellé de l'onglet
  • {{id}} : L'identifiant de l'onglet

• Si $html est à true, $label ne sera pas échappé. Si $html est à false, $label sera échappé.

4.9.16.1.3 Cas particuliers

Aucun

4.9.16.1.4 Exemples

$options->tab(My_family::my_informations)
    ->setTooltipLabel('Onglet informatif');

4.9.16.2 setDescription

Cette option est une option commune qui permet d'afficher une description pour un tableau.

Son usage est le même mais le positionnement de la description est propre au type "onglet".

4.9.16.2.1 Positionnement de la description d'un onglet

• Dcp\Ui\CommonRenderOptions::topValuePosition

• Dcp\Ui\CommonRenderOptions::topPosition : Texte affiché au dessus du premier cadre contenu dans l'onglet

  

  Figure 53. Placement "top"

• Dcp\Ui\CommonRenderOptions::bottomValuePosition :

• Dcp\Ui\CommonRenderOptions::bottomPosition : Texte affiché au dessous du dernier cadre contenu dans l'onglet

  

  Figure 54. Placement "bottom"

• Dcp\Ui\CommonRenderOptions::topLabelPosition :

• Dcp\Ui\CommonRenderOptions::bottomLabelPosition:
• Dcp\Ui\CommonRenderOptions::rightPosition :

• Dcp\Ui\CommonRenderOptions::leftPosition : Position non prise en compte. Ces positionnements ne sont pas possibles pour les onglets. Une erreur est affichée sur la console du navigateur dans ce cas. La description n'est pas affichée.

• Dcp\Ui\CommonRenderOptions::clickPosition : Affiche une ancre  à gauche du libellé de l'onglet. Cette ancre affiche la description lorsque l'utilisateur clique dessus.

  

  Figure 55. Placement "click"