Gestion des préférences de portlet sur le client

L'un des aspects les plus utiles du modèle de programmation côté client est la capacité de lire, de modifier et de sauvegarder des préférences de portlet sur le client.

Pourquoi et quand exécuter cette tâche

L'interface ibm.portal.portlet.PortletPreferences JavaScript reproduit le plus fidèlement possible son équivalent côté serveur javax.portlet.PortletPreferences. Pour une description complète des interfaces JavaScript, voir la documentation de l'API publique.

L'exemple de code suivant montre comment récupérer et lire les préférences de portlet sur le client :

<script>
    function <%=namespace%>_handleLoadPortletPreferences(portletWindow, status, portletPrefs) { 
        if (status==ibm.portal.portlet.PortletWindow.STATUS_OK) {
            portletWindow.setAttribute("preferences", portletPrefs);
            alert("Preferences.getValue()\n"+portletPrefs.getValue("test"));
            var prefs = portletPrefs.getMap();
            var mapStr = "Preferences.getMap()\number of preferences: "+prefs.length + "\n";
            for (var i=0; i<prefs.length; i++) {
                mapStr += i+" - "+prefs[i].name+" - "+prefs[i].values+" - "+prefs[i].readonly + "\n";
            }
            alert(mapStr);
        }
        else { alert("error loading feed"); }
    }
    <%=namespace%>_portletWindow = new ibm.portal.portlet.PortletWindow("<%=portletWindowID%>");
    <%=namespace%>_portletWindow.getPortletPreferences(<%=namespace%>_handleLoadPortletPreferences);
</script>
Pour une description complète des interfaces JavaScript, voir la documentation de l'API publique.