Examples of org.zkoss.zul.Listbox

org.zkoss.zul.Listbox
A listbox.
Event:
1. {@link org.zkoss.zk.ui.event.SelectEvent} is sent when user changes theselection.
2. onAfterRender is sent when the model's data has been rendered.(since 5.0.4)
See Specification.

Besides creating {@link Listitem} programmingly, you could assign a datamodel (a {@link ListModel} or {@link GroupsModel} instance) to a listbox via{@link #setModel(ListModel)} or {@link #setModel(GroupsModel)} and then thelistbox will retrieve data via {@link ListModel#getElementAt} when necessary.
Besides assign a list model, you could assign a renderer (a {@link ListitemRenderer} instance) to a listbox, such that the listbox willuse this renderer to render the data returned by {@link ListModel#getElementAt}. If not assigned, the default renderer, which assumes a label per list item, is used. In other words, the default renderer adds a label to a Listitem by calling toString against the object returned by {@link ListModel#getElementAt}[Since 5.0.4]
To retrieve what are selected in Listbox with a {@link Selectable} {@link ListModel}, you shall use {@link Selectable#getSelection} to get what is currently selected object in {@link ListModel} rather than using {@link Listbox#getSelectedItems}. That is, you shall operate on the item of the {@link ListModel} rather than on the {@link Listitem} of the {@link Listbox} if you use the {@link Selectable} {@link ListModel}.
```
 Set selection = ((Selectable)getModel()).getSelection(); 
```
There are two ways to handle long content: scrolling and paging. If {@link #getMold} is "default", scrolling is used if {@link #setHeight} iscalled and too much content to display. If {@link #getMold} is "paging",paging is used if two or more pages are required. To control the number of items to display in a page, use {@link #setPageSize}.
If paging is used, the page controller is either created automatically or assigned explicitly by {@link #setPaginal}. The paging controller specified explicitly by {@link #setPaginal} is called the external page controller. Itis useful if you want to put the paging controller at different location (other than as a child component), or you want to use the same controller to control multiple listboxes.
Default {@link #getZclass}: z-listbox.(since 3.5.0)
To have a list box without stripping, you can specify a non-existent style class to {@link #setOddRowSclass}.
Clustering and Serialization

When used in a clustering environment, you have to make {@link ListitemRenderer} ({@link #setItemRenderer}) and {@link ListModel} ({@link #setModel}) either serializable or re-assign them when {@link #sessionDidActivate} is called.
Render on Demand (rod)
[ZK EE] [Since 5.0.0]
For huge data, you can turn on Listbox's ROD to request ZK engine to load from {@link ListModel} only the required data chunk and create only the required{@link Listitem}s in memory and render only the required DOM elements in browser. So it saves both the memory and the processing time in both server and browser for huge data. If you don't use the {@link ListModel} with the Listbox, turn on the ROD will still have ZK engine to render only a chunk of DOM elements in browser so it at least saves the memory and processing time in browser. Note that ROD works only if the Listbox is configured to has a limited "view port" height. That is, either the Listbox is in the "paging" mold or you have to {@link #setHeight(String)}, {@link #setVflex(String)}, or {@link #setRows(int)} of the Listbox to make ROD works.
You can turn on/off ROD for all Listboxes in the application or only for a specific Listbox. To turn on ROD for all Listboxes in the application, you have to specify the Library Property "org.zkoss.zul.listbox.rod" to "true" in WEB-INF/zk.xml. If you did not specify the Library Property, default is false.
```
  org.zkoss.zul.listbox.rod true  
```
To turn on ROD for a specific Listbox, you have to specify the Listbox's attribute map with key "org.zkoss.zul.listbox.rod" to true. That is, for example, if in a zul file, you shall specify <custom-attributes> of the Listbox like this:
```
    
```
You can mix the Library Property and <custom-attributes> ways together. The <custom-attributes> way always takes higher priority. So you can turn OFF ROD in general and turn ON only some specific Listbox component. Or you can turn ON ROD in general and turn OFF only some specific Listbox component.

Since only partial {@link Listitem}s are created and rendered in the Listbox if you turn the ROD on, there will be some limitations on accessing {@link Listitem}s. For example, if you call
```
 Listitem itemAt100 = (Listitem) getItemAtIndex(100); 
```
The {@link Listitem} in index 100 is not necessary created yet if it is not in the current "view port" and you will get "null" instead.

And it is generally a bad idea to "cache" the created {@link Listitem} in your application if you turn the ROD on because Listitems might be removed later. Basically, you shall operate on the item of the {@link ListModel} rather than on the {@link Listitem} of the {@link Listbox} if you use the {@link ListModel} and ROD.
@author tomyeh @see ListModel @see ListitemRenderer @see ListitemRendererExt

  private void dropPerformed(DropEvent dropEvent) {
    Component target = dropEvent.getTarget();
    Component dragged = dropEvent.getDragged();
    Node[] draggedNodes = null;
    if (dragged instanceof Listitem) {
      Listbox listbox = ((Listitem) dragged).getListbox();
      Set<Listitem> itemSet = new HashSet(listbox.getSelectedItems());
      itemSet.add((Listitem) dragged);
      List<Node> nodes = new ArrayList();
      for (Object item : listbox.getItems()) {
        if (itemSet.contains(item)) {
          if (((Listitem) item).getValue() instanceof Node) {
            nodes.add((Node) ((Listitem) item).getValue());
          }
        }
      }
      listbox.clearSelection();
      draggedNodes = nodes.toArray(new Node[] {});
    }
    if (dragged instanceof Treerow) {
      draggedNodes = new Node[] { (Node) ((Treeitem) ((Treerow) dragged)
          .getParent()).getValue() };

View Full Code Here

  public void service(HttpServletRequest request, HttpServletResponse response)
  throws javax.servlet.ServletException, java.io.IOException {
    final Desktop desktop = getDesktop(request);
    Bridge bridge = Bridge.start(getServletContext(), request, response, desktop);
    try {
      final Listbox listbox = (Listbox) ((Page)desktop.getPages().iterator().next()).getRoots().iterator().next();
      listbox.appendChild(new Listitem("Ajax " + ++cnt));
      response.getWriter().write(bridge.getResult());
    } finally {
      bridge.close();
    }
  }

View Full Code Here

    }
  }


  public ListModel getModelByOwner(Component comp) {
    if (comp instanceof Listbox) {
      final Listbox listbox = (Listbox) comp;
      return listbox.getModel();
    } else {
      throw new UiException(
          "Unsupported type for ListitemCollectionItem: " + comp);
    }
  }

View Full Code Here

    }
  }


  public Component getComponentAtIndexByOwner(Component comp, int index) {
    if (comp instanceof Listbox) {
      final Listbox listbox = (Listbox) comp;
      return listbox.getItemAtIndex(index);
    } else {
      throw new UiException(
          "Unsupported type for ListitemCollectionItem: " + comp);
    }
  }

View Full Code Here

  }


  public void setupBindingRenderer(Component comp, DataBinder binder) {
    if (comp instanceof Listitem) {
      final Listitem li = (Listitem) comp;
      final Listbox lbx = li.getListbox();
      if (lbx.getItemRenderer() == null) {
        lbx.setItemRenderer(new BindingListitemRenderer(li, binder));
      }
    }
  }

View Full Code Here

    }
  }


  public List getItems(Component comp) {
    if (comp instanceof Listbox) {
      final Listbox listbox = (Listbox) comp;
      return listbox.getItems();
    } else {
      throw new UiException(
          "Unsupported type for ListitemCollectionItem: " + comp);
    }
  }

View Full Code Here

 */
public class SelectedItemConverter implements TypeConverter, java.io.Serializable {
  private static final long serialVersionUID = 200808191439L;
  
  public Object coerceToUi(Object val, Component comp) { //load
    Listbox lbx = (Listbox) comp;
      if (val != null) {
        final ListModel xmodel = lbx.getModel();
        if (xmodel instanceof BindingListModel) {
          final BindingListModel model = (BindingListModel) xmodel;
          int index = model.indexOf(val);
          if (index >= 0) {
            final Listitem item = (Listitem) lbx.getItemAtIndex(index);
            //Bug #2728704: Listbox with databinding generates onSelect w/o user action
            //Shall not fire event by spec. For backward compatibility(still want to
            //fire onSelect event as usual), user can specifies in zk.xml
            //<library-property>
            //  <name>org.zkoss.zkplus.databind.onSelectWhenLoad</name>
            //  <value>true</value>
            //</library-property>
            //then data binder will still fire the onSelect event as usual.
            if (SelectedItemConverter.isOnSelectWhenLoad()) {
              final int selIndex = lbx.getSelectedIndex();
              
            //We need this to support load-when:onSelect when first load 
            //the page in (so it is called only once).
              if (item != null && selIndex != index) { // bug 1647817, avoid endless-loop
                Set items = new HashSet();
                items.add(item);
                //bug #2140491
                Executions.getCurrent().setAttribute("zkoss.zkplus.databind.ON_SELECT"+lbx.getUuid(), Boolean.TRUE);
                Events.postEvent(new SelectEvent("onSelect", lbx, items, item));
              }
            }
            return item;
          }
        } else if (xmodel == null) { //no model case, assume Listitem.value to be used with selectedItem
          //iterate to find the selected item assume the value (select mold)
          for (final Iterator it = lbx.getItems().iterator(); it.hasNext();) {
            final Listitem li = (Listitem) it.next();
            if (val.equals(li.getValue())) {
              return li;
            }
          }

View Full Code Here

      _onSelectWhenLoad = Boolean.valueOf("true".equals(str));
    }
    return _onSelectWhenLoad.booleanValue();
  }
  public Object coerceToBean(Object val, Component comp) { //save
      final Listbox lbx = (Listbox) comp;
    if (Executions.getCurrent().getAttribute("zkoss.zkplus.databind.ON_SELECT"+lbx.getUuid()) != null) {
      //bug #2140491
      //triggered by coerceToUi(), ignore this
      Executions.getCurrent().removeAttribute("zkoss.zkplus.databind.ON_SELECT"+lbx.getUuid());
      return TypeConverter.IGNORE;
    }
      if (val != null) {
        final ListModel model = lbx.getModel();
        //no model case, assume Listitem.value to be used with selectedItem
         return model != null ? model.getElementAt(((Listitem) val).getIndex()) : ((Listitem) val).getValue();
      }
     return null;
  }

View Full Code Here

        SqlSession sess = IBatisFactory.getInstance().getSqlSession();
        List buildingList = sess.selectList("Building.getAll");
        sess = null;


        // show to the building listbox
        Listbox buildingListbox = (Listbox) getFellow("buildingListbox");
        ListModelList buildingListModel = new ListModelList(buildingList, true);
        buildingListbox.setModel(buildingListModel);
        buildingListbox.setItemRenderer(buildingListRenderer);
    }

View Full Code Here

        System.out.println("--------->>> "+form.getObjectId());
          
    }
    
    public void selectBomByBuilding() {
        Listbox buildingListboxLB = (Listbox) getFellow("buildingListbox");
        Building building = (Building) buildingListboxLB.getSelectedItem().getValue();
        Map para = new HashMap();
        para.put("buildingId", building.getBuildingId());


        refreshObjEntities(para);

View Full Code Here

0 1 2 3 4 5

TOP

Related Classes of org.zkoss.zul.Listbox

com.pre.web.base.details.ItemDetailsWindow

de.forsthaus.example.TestCtrl

de.forsthaus.webui.customer.CustomerSearchCtrl

de.forsthaus.webui.dashboard.module.DashboardApplicationNewsListCtrl

de.forsthaus.webui.dashboard.module.DashboardYoutubeVideoCtrl$YoutubeLinkSelectListBox

de.forsthaus.webui.logging.loginlog.SecLoginlogStatisticCtrl

de.forsthaus.webui.order.OrderPositionDialogCtrl

de.forsthaus.webui.util.searchdialogs.BranchAdvancedSearchListBox

de.forsthaus.webui.util.searchdialogs.BranchExtendedSearchListBox

de.forsthaus.webui.util.searchdialogs.BranchSimpleSearchListBox

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.

Examples of org.zkoss.zul.Listbox

Clustering and Serialization

Render on Demand (rod)

Related Classes of org.zkoss.zul.Listbox