javax.faces.component.visit.package.html Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of javax.faces-api Show documentation

This is the master POM file for Oracle's Implementation of the JSF 2.3 Specification.

There is a newer version: 2.3-pfd





Package Description for "javax.faces.component.visit"


APIs for
traversing a user interface component view.



The following example visits all nodes in the view.

UIViewRoot root = facesContext.getViewRoot();
root.visitTree(VisitContext.createVisitContext(context), 
               new VisitCallback() {
                   public VisitResult visit(VisitContext context, 
                                            UIComponent target) {
                       // take some action on target
                       return VisitResult.ACCEPT;
                   }
               }); 

The following example visits two subtrees within the component
view.

Set<String> toVisit = getSet("form1:optionsPanel", "form2:detailPanel");
UIViewRoot root = facesContext.getViewRoot();
root.visitTree(VisitContext.createVisitContext(context, toVisit, null), 
               new VisitCallback() {
                   public VisitResult visit(VisitContext context, 
                                            UIComponent target) {
                       // take some action on target
                       return VisitResult.ACCEPT;
                   }
               }); 

Note that every child node of those two subtrees is visited.