Package org.zkoss.zk.ui.select

Class Selectors

java.lang.Object
org.zkoss.zk.ui.select.Selectors
public class Selectors extends Object
A collection of selector related utilities.
Since:
6.0.0
Author:
simonpai

  • Constructor Details

    • Selectors

      public Selectors()

  • Method Details

    • iterable

      public static Iterable<Component> iterable(Page page, String selector)
      Returns an Iterable that iterates through all Components matched by the selector.
      Parameters:
      page - the reference page for selector
      selector - the selector string
      Returns:
      an Iterable of Component

    • iterable

      public static Iterable<Component> iterable(Component root, String selector)
      Returns an Iterable that iterates through all Components matched by the selector.
      Parameters:
      root - the reference component for selector
      selector - the selector string
      Returns:
      an Iterable of Component

    • find

      public static List<Component> find(Page page, String selector)
      Returns a list of Components that match the selector.
      Parameters:
      page - the reference page for selector
      selector - the selector string
      Returns:
      a List of Component

    • find

      public static List<Component> find(Component root, String selector)
      Returns a list of Components that match the selector.
      Parameters:
      root - the reference component for selector
      selector - the selector string
      Returns:
      a List of Component

    • find

      public static List<Component> find(String selector)
      Returns a list of Components that match the selector (from the first page of current Desktop).
      Parameters:
      selector - the selector string
      Returns:
      a List of Component
      Since:
      9.5.0

    • wireVariables

      public static void wireVariables(Component component, Object controller, List<org.zkoss.xel.VariableResolver> extraResolvers)
      Wire variables to controller, including XEL variables, implicit variables.
      Parameters:
      component - the reference component
      controller - the controller object to be injected with variables

    • wireVariables

      public static void wireVariables(Page page, Object controller, List<org.zkoss.xel.VariableResolver> extraResolvers)
      Wire variables to controller, including XEL variables, implicit variables.
      Parameters:
      page - the reference page
      controller - the controller object to be injected with variables

    • wireComponents

      public static void wireComponents(Component component, Object controller, boolean ignoreNonNull)
      Wire components to controller.
      Parameters:
      component - the reference component for selector
      controller - the controller object to be injected with variables
      ignoreNonNull - ignore wiring when the value of the field is a Component (non-null) or a non-empty Collection.

    • wireComponents

      public static void wireComponents(Page page, Object controller, boolean ignoreNonNull)
      Wire components to controller.
      Parameters:
      page - the reference page for selector
      controller - the controller object to be injected with variables
      ignoreNonNull - ignore wiring when the value of the field is a Component (non-null) or a non-empty Collection.

    • rewireVariablesOnActivate

      public static void rewireVariablesOnActivate(Component component, Object controller, List<org.zkoss.xel.VariableResolver> extraResolvers)
      Rewire the variables on session activation
      Since:
      7.0.7

    • rewireComponentsOnActivate

      public static void rewireComponentsOnActivate(Component component, Object controller)
      Rewire the components on session activation
      Since:
      7.0.7

    • wireEventListeners

      public static void wireEventListeners(Component component, Object controller)
      Add event listeners to components based on the controller.
      Parameters:
      component - the reference component for selector
      controller - the controller of event listening methods

    • newVariableResolvers

      public static List<org.zkoss.xel.VariableResolver> newVariableResolvers(Class<?> cls, Class<?> untilClass)
      Creates a list of instances of VariableResolver based on the annotation of the given class. If no such annotation is found, an empty list is returned.
      Parameters:
      cls - the class to look for the annotation.
      untilClass - the class to stop the searching. By default, it will look for the annotation of the super class if not found. Ignored if null.