Les bandeaux d'actions
Un bandeau d’action permet d’afficher un ensemble de boutons regroupés dans une zone dédiée, généralement positionnés côte à côte. Chaque bouton représente une action utilisateur (par exemple : ajout aux favoris, export PDF, notification...).
La configuration des actions du bandeau est entièrement personnalisable :
- Une action peut être désactivée via une propriété dans le projet.
- L’ordre d’affichage des actions est configurable.
- De nouvelles actions peuvent être ajoutées directement depuis le projet, sans modifier le code de l’extension d’origine.
Définition du bandeau
Voici un exemple de définition de bandeau :
<bean id="defaultActionsBandeauFicheViewPreparer" class="com.kosmos.actionsbandeau.bandeau.ActionsBandeauFicheViewPreparer">
<property name="type" value="bandeau-action-fiche" />
<property name="view" value="/WEB-INF/jsp/actionsbandeau/actionsBandeau.jsp" />
<property name="expectedViewTypes">
<list>
<value>action-fiche</value>
</list>
</property>
</bean>
Tout bandeau doit étendre AbstractActionsBandeauViewPreparer. Pour utiliser ce bandeau au sein d'une fiche, il est nécessaire, dans la page en question de rajouter le type du preparer dans les expectedViewTypes.
Le bandeau prépare ici des actions de type "action-fiche".
Actions de bandeau
Voici un exemple d'action, ici un bouton d'ajout/retrait des favoris, qui sera ajouté au bandeau si son preparer l'accepte et que l'action est active (non désactivé).
<bean id="favorisActionFicheViewPreparer" class="com.kosmos.panier.actionsbandeau.preparer.FavorisActionFicheViewPreparer">
<property name="type" value="action-fiche" />
<property name="view" value="/extensions/panier/WEB-INF/jsp/buttonContentPanier.jsp" />
<property name="actionActive" value="${front.actionbandeaufiche.favoris.active:true}" />
<property name="actionPosition" value="${front.actionbandeaufiche.favoris.order:3}" />
<property name="typeFicheAutorise" value="${panier.FAVORIS.included.contents:}"/>
<property name="typeFicheExclu" value="${panier.FAVORIS.excluded.contents:}"/>
</bean>
Tout préparer d'action de bandeau doit étendre AbstractActionViewPreparer.