fonction obsolète : Balise : declareRefreshController

La balise wcf:declareRefreshController déclare un contrôleur de zone d'actualisation. Le contrôleur de zone d'actualisation fournit la logique JavaScript à l'écoute des modifications dans le contexte du rendu et le modèle. Il actualise les zones d'actualisation inscrites auprès de lui. Les zones d'actualisation sont déclarées à l'aide du widget wc.widget.RefreshArea et en spécifiant l'ID d'un contrôleur d'actualisation déclaré pour l'attribut controllerId.

Au lieu d'utiliser la balise wcf:declareRefreshController, écrivez du code JavaScript.

Informations sur la balise

Informations sur la balise
Contenu de l'élément 'Body' empty
Nom d'affichage Declare refresh controller
Balise filepath /META-INF/tags/wcf/DeclareRefreshController.tag

Attributs

Attributs

Nom Obligatoire Type Description
id true Chaîne ID du contrôleur d'actualisation.
renderContextId false Chaîne ID du contexte de rendu. Si l'ID du contexte de rendu n'est pas spécifié, la valeur default est utilisée.
url false Chaîne URL appelée pour extraire les données d'actualisation.
modelChangedScript false Fragment JSP JavaScript qui doit être exécuté lorsqu'un changement de modèle se produit. Le script peut utiliser plusieurs variables locales :
  • controller- Le contrôleur d'actualisation
  • message - le message d'événement de changement de modèle
  • widget - le widget de zone d'actualisation
  • renderContext- le contexte de rendu
renderContextChangedScript false Fragment JSP JavaScript qui est exécuté lorsqu'un changement de contexte de rendu se produit. Le script peut utiliser plusieurs variables locales :
  • controller- Le contrôleur d'actualisation
  • message - le message d'événement de changement de modèle
  • widget - le widget de zone d'actualisation
  • renderContext- le contexte de rendu
json false Chaîne Cet attribut doit être défini sur true si le type de réponse attendu de l'URL d'actualisation est JSON. Cette case est cochée par défaut.
refreshScript false Fragment JSP JavaScript qui est exécuté pour effectuer l'actualisation. Le script peut utiliser les variables locales suivantes :
  • controller- Le contrôleur d'actualisation
  • widget - le widget de zone d'actualisation
  • data - les données de réponse de la demande d'actualisation
  • renderContext- le contexte de rendu
Si cet attribut n'est pas spécifié, le comportement par défaut est d'appeler widget.setInnerHtml(data).
postRefreshScript false Fragment JSP JavaScript qui s'exécute une fois l'actualisation terminée. Le script peut utiliser plusieurs variables locales :
  • controller- Le contrôleur d'actualisation
  • widget - le widget de zone d'actualisation
  • renderContext- le contexte de rendu

Variables

Aucune variable n'est définie pour la balise wcf:declareRefreshController.

Exemple

L'exemple suivant indique un objet de contrôleur d'actualisation qui met à jour une zone d'actualisation avec les informations de commande en cours.

<wcf:declareRefreshController 
 id="currentOrderTotalsAreaController" 
 url="${AjaxCurrentOrderInformationViewURL}"
 renderContextId="currentOrderTotals_Context">
  <jsp:attribute name="modelChangedScript">
   if (message.actionId in order_updated) {
     widget.refresh();
   } 
  </jsp:attribute>
</wcf:declareRefreshController>