UIZE JavaScript Framework

MODULES Uize.Widget.Collection

1. Introduction

The Uize.Widget.Collection class manages a collection of items, with support for managing selected state, and methods for manipulating the collection.

DEVELOPERS: Chris van Rensburg, Jan Borgersen, Guang-yu Xu, Vinson Chuong

1.1. In a Nutshell

The Uize.Widget.Collection class implements a widget for managing a collection of items, with support for managing selected state of items (including non-contiguous selection, range selection, and controls for selecting all, selecting none, and removing selected items), and methods by which application code can manipulate the collection.

1.1.1. Collection Item Widget Naming

Collection item widgets that are added to an instance of the Uize.Widget.Collection class as child widgets are named using one of two available schemes: explicit naming of collection item widgets, and automatic naming of collection item widgets.

1.1.1.1. Explicit Naming of Collection Item Widgets

When a collection item widget is added as a child widget of the collection, the element out of the items array that corresponds to the collection item being added is supplied as the value of the collection item widget's properties state property.

The itemPropertyForItemWidgetName property lets you specify a property out of the collection item properties object that should be used for the name of the collection item child widget. This is best illustrated with a simple example...

EXAMPLE

var myCollection = page.addChild (
  'collection',
  Uize.Widget.Collection,
  {
    itemWidgetClass:Uize.Widget.CollectionItem,
    itemPropertyForItemWidgetName:'widgetName',
    items:[
      {
        widgetName:'bravingTheOnslaught',
        title:'Braving the Onslaught',
        category:'The Winter Collection'
      },
      {
        widgetName:'flockOfClouds',
        title:'Flock of Clouds',
        category:'The Photographic Orphanage'
      }
    ]
  }
);

In the above example, the newly created collection widget will have two collection item child widgets: one named 'bravingTheOnslaught', and the other named 'flockOfClouds'. The items state property specifies the array of data for the items in the collection. The value of each element is passed to the corresponding collection item child widget, through its properties state property. But the widgetName property is treated specially in this example. That's because the itemPropertyForItemWidgetName state property calls out the widgetName property as the property that should determine the name of the collection item widgets.

1.1.1.2. Automatic Naming of Collection Item Widgets

When itemPropertyForItemWidgetName is set to the value null, undefined, or '' (empty string), or if the value of the item property specified by itemPropertyForItemWidgetName is null, undefined, or '' (empty string), then the name of the child widget for a collection item will be generated using the value of the itemWidgetNamePrefix state property as a prefix and appending an automatically incremented uniquifier.

EXAMPLE

var myCollection = page.addChild (
  'collection',
  Uize.Widget.Collection,
  {
    itemWidgetClass:Uize.Widget.CollectionItem,
    itemPropertyForItemWidgetName:null,
    itemWidgetNamePrefix:'photoItem',
    items:[
      {
        title:'Braving the Onslaught',
        category:'The Winter Collection'
      },
      {
        title:'Flock of Clouds',
        category:'The Photographic Orphanage'
      }
    ]
  }
);

In the above example, the newly created collection widget will have two collection item child widgets: one named 'photoItem0', and the other named 'photoItem1'. This is because the itemPropertyForItemWidgetName state property is set to null, thereby defeating the explicit naming of collection item widgets, and because the itemWidgetNamePrefix state property is set to 'photoItem'. The uniqifier value starts at 0, and is incremented for each item added to the collection. This results in the collection item widget names 'photoItem0' and 'photoItem1'.

1.2. Examples

There are no dedicated showcase example pages for the Uize.Widget.Collection module.

SEARCH FOR EXAMPLES

Use the link below to search for example pages on the UIZE Web site that reference the Uize.Widget.Collection module...

SEARCH

1.3. Implementation Info

The Uize.Widget.Collection module defines the Uize.Widget.Collection class, which is a subclass of Uize.Widget.

INHERITANCE CHAIN

Uize.Class −> Uize.Widget −> Uize.Widget.Collection

1.3.1. Features Introduced in This Module

1.3.2. Features Overridden in This Module

The features listed in this section have been overridden in this module.

The module that an overridden feature was initially introduced in will be noted in the IMPLEMENTATION INFO notes for the feature.

INSTANCE METHODS

addChild | updateUi | valueOf

STATIC PROPERTIES

Uize.Widget.Collection.moduleName | Uize.Widget.Collection.nonInheritableStatics | Uize.Widget.Collection.undefined

1.3.3. Features Inherited From Other Modules

The features listed in this section have been inherited from other modules.

The module that an inherited feature was initially introduced in will be noted in the IMPLEMENTATION INFO notes for the feature.

INSTANCE METHODS

addChildren | ajax | buildHtml | callInherited | childHtml | childId | confirm | displayNode | fire | flushNodeCache | get | getContainer | getHtml | getInherited | getNode | getNodeStyle | getNodeValue | getProvider | globalizeNode | inform | injectNodeHtml | insertOrWireUi | insertUi | is | isMet | kill | localize | met | nodeId | onChange | once | removeChild | removeNode | removeUi | set | setInherited | setNodeClipRect | setNodeInnerHtml | setNodeOpacity | setNodeProperties | setNodeStyle | setNodeValue | showNode | toggle | unmet | unwire | unwireNode | unwireNodeEventsByMatch | unwireUi | whenever | wire | wireNode | wireUi

INSTANCE PROPERTIES

showConfirm | showInform

STATE PROPERTIES

built | busy | busyInherited | busyParentTickle | children | container | enabled | enabledInherited | enabledParentTickle | html | idPrefix | idPrefixConstruction | insertionMode | localized | name | nodeMap | parent | wired

STATIC METHODS

Uize.Widget.Collection.alphastructor | Uize.Widget.Collection.declare | Uize.Widget.Collection.doMy | Uize.Widget.Collection.dualContextMethods | Uize.Widget.Collection.dualContextProperties | Uize.Widget.Collection.fire | Uize.Widget.Collection.get | Uize.Widget.Collection.getBlankImageUrl | Uize.Widget.Collection.instanceMethods | Uize.Widget.Collection.instanceProperties | Uize.Widget.Collection.mixins | Uize.Widget.Collection.omegastructor | Uize.Widget.Collection.set | Uize.Widget.Collection.singleton | Uize.Widget.Collection.spawn | Uize.Widget.Collection.stateProperties | Uize.Widget.Collection.staticMethods | Uize.Widget.Collection.staticProperties | Uize.Widget.Collection.subclass | Uize.Widget.Collection.toggle | Uize.Widget.Collection.treeInheritedStateProperties | Uize.Widget.Collection.unwire | Uize.Widget.Collection.wire

STATIC PROPERTIES

Uize.Widget.Collection.busyParentTickle | Uize.Widget.Collection.enabledParentTickle | Uize.Widget.Collection.isWired | Uize.Widget.Collection.pathToResources

1.3.4. Modules Directly Under This Namespace

1.3.5. Unit Tests

There is no dedicated unit tests module for the Uize.Widget.Collection module.

2. Instance Events

2.1. Item Selected

An instance event that is fired whenever an item becomes selected.

When this event is fired, the event object will contain an itemWidget property whose value will be a reference to the item widget for the item that has become selected.

2.2. Items Changed

An instance even that is fired whenever the items in the collection are modified.

2.3. Remove

An instance event that is fired when calling the remove instance method.

This event is fired immediately upon calling the remove instance method, and before calling the finishRemove hook method. When this event is fired, the event object will have the following contents...

EVENT OBJECT

{
  name         : 'Remove',                  // event name (standard event property)
  source       : collectionInstanceOBJ,     // event source (standard event property)
  itemWidgets  : itemWidgetsToRemoveARRAY,  // widgets for items being removed
  byUser       : byUserBOOL,                // whether or not user initiated remove
  finishRemove : finishRemoveCallbackFUNC   // callback, if you set handled to true
}

A handler that is wired for this event has the option of declaring that the remove request has been handled, by setting the handled property on the event object to true. If a handler does this, then the remove method will not call the finishRemove hook method after the event has been fired. Instead, it will be up to your even handler code to complete the removal of the items by calling the "finishRemove" function that is a property of the event object, when it is appropriate to do so, and supplying values for the itemWidgetsToRemoveARRAY and byUserBOOL parameters that this function accepts. Alternatively, the handler code could not call the "finishRemove" function and could, instead, remove the item widgets itself.

Among other things, this event mechanism allows specialized subclass or application code to insert an asynchronous interstitial step in the remove process, and it allows custom code to modify the list of items that will be removed.

NOTES

see the related remove instance method
see the related remove Child Widget

3. DOM Nodes

3.1. totalItems DOM Node

A node that will be used to display the total number of items in the collection.

Whenever the value of the totalItems state property changes, this node will be updated using the setNodeValue instance method of the Uize.Widget class. Because the setNodeValue method is used for displaying the value of the totalItems property, the totalItems DOM Node can be of any type supported by the setNodeValue method - it can be a div tag, a span tag, a p tag, a text input tag, a textarea tag, etc.

NOTES

see the related totalItems state property
the markup for this DOM node is optional, and a given implementation of a collection widget's HTML does not need to offer this node

4. Instance Properties

4.1. itemWidgets

A read-only array of collection item widget instances, where each collection item widget in the array corresponds to an element of the items array.

Elements of this array are typically instances of the Uize.Widget.CollectionItem class, or some subclass thereof. The contents of this array are modified as items are added to or removed from the collection, but the itemWidgets property should maintain a reference to the same array throughout the life of the collection instance. The value of this property should not be set explicitly, nor should the contents of the array be changed explicitly. Instead, methods such as the addItemWidget instance method should be used to manage the contents of the collection.

NOTES

this property is read-only
see the related items state property
the initial value is [] (empty array)

4.2. showConfirm

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

4.3. showInform

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

5. Child Widgets

5.1. remove Child Widget

An instance of Uize.Widget.Button, that is wired up so that clicking it will prompt the user to confirm that they wish to remove the selected items, and will then remove the selected items if the user agrees.

This button is disabled whenever the value of the someSelected state property is false. Put another way, this button is only enabled when the value of someSelected is true.

NOTES

the markup for this child widget is optional, and a given implementation of a collection widget's HTML does not need to offer this button
this child widget is added in the constructor
see the related remove instance method

5.2. selectAll Child Widget

An instance of Uize.Widget.Button, that is wired up to call the selectAll instance method when clicked.

This button is disabled whenever...

the value of the allSelected state property is true
the value of the isEmpty state property is true
the value of the selectionMode state property is 'single' and the value of the totalItems state property is not 1

NOTES

the markup for this child widget is optional, and a given implementation of a collection widget's HTML does not need to offer this button
see the companion selectNone Child Widget=
this child widget is added in the constructor

5.3. selectNone Child Widget

An instance of Uize.Widget.Button, that is wired up to call the selectAll instance method when clicked, with the value false specified for the selectAll method's selectedBOOL parameter.

This button is disabled whenever the value of the someSelected state property is false. Put another way, this button is only enabled when the value of someSelected is true.

NOTES

the markup for this child widget is optional, and a given implementation of a collection widget's HTML does not need to offer this button
see the companion selectAll Child Widget=
this child widget is added in the constructor

6. Instance Methods

6.1. addChild

IMPLEMENTATION INFO

this is an override of an inherited feature (implementation is in this module, first introduced in Uize.Widget)

6.2. addChildren

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.3. addControlButton

For advanced developers only, this is a subclassing hook that lets you add a button child widget with the specified name, with a specified click handler function, and whose enabled state is determined by a specified condition.

SYNTAX

buttonOBJ = myInstance.addControlButton (
  buttonNameSTR,               // name of button child widget
  clickHandlerFUNC,            // code to execute when button is clicked
  enabledWhenSTRorARRAYorFUNC  // condition under which button should be enabled
);

This method returns a reference to the button child widget created.

6.3.1. buttonNameSTR

A string, specifying the name of the button widget that will be added as a child widget of the collection widget instance.

6.3.2. clickHandlerFUNC

A function reference, specifying a function that should be executed when the button is clicked and in the enabled state.

6.3.3. enabledWhenSTRorARRAYorFUNC

A string, array, or function, specifying the condition under which the button should be enabled.

EXAMPLE

myCollection.addControlButton (
  'selectAll',
  function () {
    // code here to select all items
  },
  '!allSelected,!isEmpty'
);

In the above example, the "selectAll" button that is being added is to be enabled only when the values of both the allSelected and isEmpty state properties of the collection widget are false. There's no sense having the "selectAll" button be enabled when all the items are already selected. Similarly, there's no sense having the button be enabled when there are no items to select.

The value specified for the enabledWhenSTRorARRAYorFUNC parameter can be any valid condition expression, as supported by the condition system of the Uize.Class base class. For more information, consult the reference for that class and read the section on specifying conditions.

VARIATION 1

buttonOBJ = myInstance.addControlButton (buttonNameSTR,eventNameSTR,enabledWhenSTRorARRAYorFUNC);

When the eventNameSTR parameter is specified in place of the clickHandlerFUNC parameter, then an event of the name specified by the eventNameSTR parameter will be fired on the button child widget.

VARIATIONS 2 & 3

buttonOBJ = myInstance.addControlButton (buttonNameSTR,clickHandlerFUNC);
buttonOBJ = myInstance.addControlButton (buttonNameSTR,eventNameSTR);

When the enabledWhenSTRorARRAYorFUNC parameter is omitted, then no enabled state management will be performed and you will have to implement your own enabled state management, if desired.

NOTES

this is a hook method that can be used by a subclass

IMPLEMENTATION INFO

this feature was introduced in this module

6.4. addItemWidget

Lets you add an item widget to the collection, returning a reference to the item widget added.

SYNTAX

itemWidgetOBJ = myInstance.addItemWidget (itemWidgetNameSTR,itemWidgetPropertiesOBJ);

The value of the itemWidgetNameSTR parameter should be the widget name for the item widget that will be added as a child of the collection widget. The value of this parameter can be any string, so long as it doesn't collide with the names of existing child widgets of the collection widget, including the various button widgets of the class, and other existing item widgets. A value for this parameter can be generated using the makeItemWidgetName hook method.

The value of the itemWidgetPropertiesOBJ parameter should be an object containing the values for state properties of the item widget to be created. This object will be modified by the addItemWidget method, by copying in the properties of the object returned by the getItemWidgetProperties hook method.

NOTES

see the related makeItemWidgetName hook method
see the related wireItemWidget hook method

IMPLEMENTATION INFO

this feature was introduced in this module

6.5. ajax

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.6. buildHtml

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.7. callInherited

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.8. childHtml

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.9. childId

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.10. confirm

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.11. displayNode

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.12. finishRemove

A hook method, that is intended to be overrided in a subclass' implementation and that is called to complete a remove operation begun by calling the remove instance method.

SYNTAX

myInstance.finishRemove (itemWidgetsToRemoveARRAY,byUserBOOL);

A subclass' implementation for this method should expect the two parameters itemWidgetsToRemoveARRAY and byUserBOOL, where itemWidgetsToRemoveARRAY is an array of collection item widgets for the items to be removed, and where byUserBOOL is a boolean indicating whether or not the remove was initiated by the user (as opposed to programmatically).

NOTES

this is a hook method, intended to be overrided in a subclass
see the related remove instance method

IMPLEMENTATION INFO

this feature was introduced in this module

6.13. fire

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.14. flushNodeCache

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.15. forAll

Iterates through all the collection item widgets in the collection and performs the specified handler function for each item widget.

SYNTAX

myInstance.forAll (itemHandlerFUNC);

The function specified for the itemHandlerFUNC parameter should expect to receive two parameters: itemWidgetOBJ and itemNo, where itemWidgetOBJ is a reference to an item's collection item widget, and where itemNo is the item number / index for the item being processed. Your handler function can optionally omit the itemNo parameter from its definition if it doesn't need an item's index to perform its operation. If your handler function returns the special value false, then the iteration will be terminated.

EXAMPLE

var itemUserIsOver;
myCollection.forAll (
  function (itemWidget) {
    if (itemWidget.get ('over')) {
      itemUserIsOver = itemWidget;
      return false;
    }
  }
)

In the above example, the forAll method is being used to iterate through the item widgets in the collection to find the one (if any) that the user is currently mousing over. If the item handler function finds an item that the user is over, where the value of the item widget's over state property is true, then the handler sets the itemUserIsOver variable to this item widget and then returns the special value false, indicating to the forAll iterator that it should break out of the iteration (after all, the item handler function can't use the break statement to accomplish that in this case).

IMPLEMENTATION INFO

this feature was introduced in this module

6.16. get

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.17. getContainer

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.18. getHtml

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.19. getInherited

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.20. getItemWidgetProperties

For advanced developers only, this is a subclassing hook that lets you override the default use of the itemWidgetProperties state property in the addItemWidget instance method.

SYNTAX

itemWidgetPropertiesOBJ = myInstance.getItemWidgetProperties ();

The implementation of this method by this base class simply returns a reference to the itemWidgetProperties state property. By overriding this method in a subclass, you can provide your own logic for generating the item widget properties that will be used when adding item widgets in the addItemWidget instance method. One thing you can do with your own override of this method is to stitch in additional properties at the time of adding an item widget. You can look for an example of this in the implementation of the Uize.Widget.Collection.Dynamic class.

NOTES

this is a hook method, intended to be overrided in a subclass

IMPLEMENTATION INFO

this feature was introduced in this module

6.21. getNode

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.22. getNodeStyle

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.23. getNodeValue

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.24. getPropertyForItems

Returns an array, being the values of the specified properties "bucket" property for the specified items.

SYNTAX

propertyValuesARRAY = myInstance.getPropertyForItems (propertyNameSTR,itemWidgetsARRAY);

Items in the collection are represented by item widgets, and each item widget for an item should have a properties state property, which serves as a "bucket" for additional item data. The getPropertyForItems method lets you get an array of the values for a specific property in this properties "bucket" for all of the specified items, where the items are specified by an array containing item widgets that correspond to items in the collection.

6.24.1. For All Items

To get the value of a specific properties "bucket" property for all the items in the collection, supply the value of the itemWidgets instance property as the value of the itemWidgetsARRAY parameter, as in...

var productIds = myCollection.getPropertyForItems ('productId',myCollection.itemWidgets);

6.24.2. An Example

To better illustrate how the getPropertyForItems method behaves, let's consider an example...

EXAMPLE

var myCollection = page.addChild (
  'collection',
  Uize.Widget.Collection,
  {
    itemWidgetClass:Uize.Widget.CollectionItem,
    items:[
      {
        title:'A Lighted Spot',
        properties:{
          productId:'228277244419896914',
          category:'Trees Among Us'
        }
      },
      {
        title:'Braving the Onslaught',
        properties:{
          productId:'228109666540948246',
          category:'The Winter Collection'
        }
      },
      {
        title:'Companion to a Sunset',
        properties:{
          productId:'228745103279879745',
          category:'The Sunset Collection'
        }
      }
    ]
  }
);

var productIds = myCollection.getPropertyForItems ('productId',myCollection.itemWidgets);

In the above example, we're creating an instance of the Uize.Widget.Collection class, and we're setting it up with three items that represent different products. The properties bucket property for each of the items contains two extraneous item data properties: productId and category. Then we're using the getPropertyForItems instance method to get the value of the productId property for all items in the collection. After the above code has executed, the productIds variable will have the value...

['228277244419896914','228109666540948246','228745103279879745']

6.24.3. Getting All Properties

When the special value null or undefined is specified for the propertyNameSTR parameter, then the getPropertyForItems method will return an array containing the values of the properties state property for all of the specified items.

EXAMPLE

var productIds = myCollection.getPropertyForItems (null,myCollection.itemWidgets);

If we assume that the collection instance myCollection was set up just as in the example An Example, then the above statement would result in the productIds variable having the value...

[
  {
    productId:'228277244419896914',
    category:'Trees Among Us'
  },
  {
    productId:'228109666540948246',
    category:'The Winter Collection'
  },
  {
    productId:'228745103279879745',
    category:'The Sunset Collection'
  }
]

IMPORTANT

Note that the elements of the returned array will be the values of the properties state property for the specified items. Given that the properties state property for collection item widgets is an object, the elements array returned by the getPropertyForItems method will contain references to the same objects shared by the item widgets. Therefore, modifying the values of the objects in the returned array will have an affect on the item widgets. In cases where you wish to modify the returned data, you should probably use the Uize.clone static method to create your own clone of this data before modifying it.

NOTES

see the related getPropertyForSelected instance method

IMPLEMENTATION INFO

this feature was introduced in this module

6.25. getPropertyForSelected

Returns an array, being the values of the specified properties "bucket" property for the selected items.

SYNTAX

propertyValuesARRAY = myInstance.getPropertyForSelected (propertyNameSTR);

Using this method is equivalent to using the getPropertyForItems instance method and using the getSelected instance method to get an array of just the selected item widgets to specify for the getPropertyForItems method's itemWidgetsARRAY parameter. For example, the statement myCollection.getPropertyForSelected ('productId') would be equivalent to the statement myCollection.getPropertyForItems ('productId',myCollection.getSelected ()).

Because the getPropertyForSelected method uses the getPropertyForItems method for its implementation, you can consult the reference for the getPropertyForItems method for more detail on how the getPropertyForSelected method behaves.

VARIATION

propertyValuesARRAY = myInstance.getPropertyForSelected (propertyNameSTR,allIfNoneBOOL);

When the value true is specified for the optional allIfNoneBOOL parameter, then the getPropertyForSelected method will return an array of the values of the specified properties "bucket" property for all items in the collection when no items are selected.

NOTES

see the related getPropertyForItems instance method

IMPLEMENTATION INFO

this feature was introduced in this module

6.26. getProvider

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.27. getSelected

Returns an array of the selected collection items, where each element of the array is an object reference to a selected item's collection item widget.

SYNTAX

itemWidgetsARRAY = myInstance.getSelected ();

The elements of the returned selected items array are in the order of the items in itemWidgets array.

VARIATION

itemWidgetsARRAY = myInstance.getSelected (allIfNoneBOOL);

When the optional allIfNoneBOOL parameter is specified, you can control whether or not all the item widgets in the collection should be returned when none are selected. This may be useful for certain operations that should operate on all items when a selection has not been made.

NOTES

see the related getPropertyForSelected instance method

IMPLEMENTATION INFO

this feature was introduced in this module

6.28. globalizeNode

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.29. inform

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.30. injectNodeHtml

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.31. insertOrWireUi

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.32. insertUi

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.33. is

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.34. isCollectionItem

This is a hook method, overrideable by subclasses, which checks to see if the widget being added through widget adoption is a collection item

SYNTAX

bool = myInstance.isCollectionItem (itemWidget);

IMPLEMENTATION INFO

this feature was introduced in this module

6.35. isMet

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.36. kill

Inherited from Uize.Widget, but introduced in Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Class)

6.37. localize

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.38. makeItemWidgetName

For advanced developers only, this is a subclassing hook that lets you obtain a generated name for a new item widget that is to be added.

SYNTAX

itemWidgetNameSTR = myInstance.makeItemWidgetName (itemOBJ);

This method is not intended to be overrided by a subclass, but is intended instead to be used as part of the implementation of a subclass method that adds items to the collection. The method will be called first in order to generate a widget name for the item widget about to be added, and the generated name will then be used when adding the new item widget.

The itemOBJ parameter can be used to supply a reference to the properties "bucket" for additional item data. When an object is specified for the itemOBJ parameter, and when the itemPropertyForItemWidgetName state property is set to a non-empty string, and when the value of the property in the itemOBJ object specified by the itemPropertyForItemWidgetName property is a non-empty string, then that property will be returned as the item widget name. Otherwise, the item widget name will be generated by concatenating the value of the itemWidgetNamePrefix state property with a dynamically generated and automatically incremented uniquifier value.

VARIATION

itemWidgetNameSTR = myInstance.makeItemWidgetName ();

When the itemOBJ parameter is not specified, then the makeItemWidgetName method will behave as though the value null were specified for this parameter (see above).

NOTES

this is a hook method that can be used by a subclass
see the related itemPropertyForItemWidgetName and itemWidgetNamePrefix state properties

IMPLEMENTATION INFO

this feature was introduced in this module

6.39. met

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.40. nodeId

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.41. onChange

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.42. once

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.43. remove

Lets you initiate removal of the specified set of items from the collection.

SYNTAX

myInstance.remove (itemWidgetsToRemoveARRAY,byUserBOOL);

The items to be removed by this method should be specified in the itemWidgetsToRemoveARRAY parameter, where the value of this parameter should be an array of item widgets corresponding to the items to be removed. This method should be called with the value true specified for the byUserBOOL method when the remove operation is initiated by the user, such as when the user clicks on a remove button in the UI.

When this method is called, the method first fires the Remove instance event. If a handler is wired to handle this event and sets the handled property on the event object to true, then the remove method will do nothing after the event has been fired. If, on the other hand, the handled property of the event object is not set to true, then the remove method will call the finishRemove instance method after the event has been fired. The finishRemove method is a hook method that provides a subclass of Uize.Widget.Collection the ability to implement a custom items remover method.

VARIATION

myInstance.remove (itemWidgetsToRemoveARRAY);

When the byUserBOOL parameter is omitted, or its value is undefined or null, then its value is defaulted to false.

NOTES

for creating subclasses of Uize.Widget.Collection, see the finishRemove hook method
see the related Remove instance event
see the related remove Child Widget

IMPLEMENTATION INFO

this feature was introduced in this module

6.44. removeChild

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.45. removeNode

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.46. removeUi

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.47. removeWithConfirm

IMPLEMENTATION INFO

this feature was introduced in this module

6.48. selectAll

Selects all collection item widgets in the collection.

SYNTAX

myInstance.selectAll ();

Calling this method has the effect of setting the value of the selected state property of all collection item widgets to true. Calling this method will also result in the values of the allSelected, oneSelected, someSelected, and totalSelected state properties being updated, upon which some of these properties may change value.

VARIATION 1

myInstance.selectAll (selectedBOOL);

When the optional selectedBOOL parameter is specified, the desired selected state for all the collection items in the collection can be specified. Specifying the value true for the selectedBOOL parameter is equivalent to calling this method without specifying a parameter, and specifying the value false is equivalent to calling the selectNone instance method.

VARIATION 2

myInstance.selectAll (selectedBOOL,toExcludeItemWidgetOBJ);

When the optional toExcludeItemWidgetOBJ parameter is specified, then an object reference can be specified for a collection item widget whose selected state should not be modified by calling the selectAll method. This allows us to select all but or deselect all but a specific item in the collection.

NOTES

see the related selectNone and selectRange instance methods
see the related allSelected, oneSelected, someSelected, and totalSelected state properties

IMPLEMENTATION INFO

this feature was introduced in this module

6.49. selectNone

Deselects all collection item widgets in the collection.

SYNTAX

myInstance.selectNone ();

Calling this method has the effect of setting the value of the selected state property of all collection item widgets to false, and is equivalent to calling the selectAll instance method and specifying the value false for the selectedBOOL parameter. Calling this method will also result in the values of the allSelected, oneSelected, someSelected, and totalSelected state properties being updated, upon which some of these properties may change value.

NOTES

see the related selectAll and selectRange instance methods
see the related allSelected, oneSelected, someSelected, and totalSelected state properties

IMPLEMENTATION INFO

this feature was introduced in this module

6.50. selectRange

Selects all collection item widgets in the specified range - from the one specified item widget to the other specified item widget.

SYNTAX

myInstance.selectRange (itemWidgetAOBJ,itemWidgetBOBJ);

Calling this method has the effect of setting the value of the selected state property of all collection item widgets within the specified range to true, and all collection item widgets outside of the specified range to false. The range is specified by the itemWidgetAOBJ and itemWidgetBOBJ parameters, and is inclusive of the two item widgets that are specified by these parameters. The order of the range bounds is unimportant - the item specified by itemWidgetAOBJ can be before or after the item specified by itemWidgetBOBJ in the itemWidgets array.

Calling this method will result in the values of the allSelected, oneSelected, someSelected, and totalSelected state properties being updated, upon which some of these properties may change value. Calling this method will have no effect if the values of either - or both - of the itemWidgetAOBJ or itemWidgetBOBJ parameters is null or undefined, or if the value of the selectionMode state property is 'single' and the values of the itemWidgetAOBJ and itemWidgetBOBJ parameters are not identical (i.e. you can only select a range of one item when selectionMode is set to 'single', and trying to select a range of more than one item will result in no action).

NOTES

see the related selectAll and selectNone instance methods
see the related allSelected, oneSelected, someSelected, and totalSelected state properties

IMPLEMENTATION INFO

this feature was introduced in this module

6.51. set

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.52. setInherited

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.53. setNodeClipRect

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.54. setNodeInnerHtml

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.55. setNodeOpacity

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.56. setNodeProperties

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.57. setNodeStyle

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.58. setNodeValue

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.59. showNode

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.60. toggle

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.61. unmet

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.62. unwire

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.63. unwireNode

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.64. unwireNodeEventsByMatch

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.65. unwireUi

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.66. updateUi

IMPLEMENTATION INFO

this is an override of an inherited feature (implementation is in this module, first introduced in Uize.Widget)

6.67. valueOf

this is an override of an inherited feature (implementation is in this module, first introduced in Uize.Class)

IMPLEMENTATION INFO

6.68. whenever

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.69. wire

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)

6.70. wireItemWidget

A hook allowing subclasses to post-process new item widgets

SYNTAX

myInstance.wireItemWidget (itemWidgetOBJ);

IMPLEMENTATION INFO

this feature was introduced in this module

6.71. wireNode

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

6.72. wireUi

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

7. Localizable Strings

7.1. removeItemConfirmation

A localizable string, that will be displayed as the message in a confirmation dialog when the user chooses to remove a single item from the collection.

NOTES

see the companion removeItemsConfirmation localizable string
see the related removeItemConfirmationTitle and removeItemsConfirmationTitle localizable strings

7.2. removeItemsConfirmation

A localizable string, that will be displayed as the message in a confirmation dialog when the user chooses to remove multiple items from the collection.

NOTES

see the companion removeItemConfirmation localizable string
see the related removeItemConfirmationTitle and removeItemsConfirmationTitle localizable strings

7.3. removeItemConfirmationTitle

A localizable string, that will be displayed as the title of a confirmation dialog when the user chooses to remove a single item from the collection.

NOTES

see the companion removeItemsConfirmationTitle localizable string
see the related removeItemConfirmation and removeItemsConfirmation localizable strings

7.4. removeItemsConfirmationTitle

A localizable string, that will be displayed as the title of a confirmation dialog when the user chooses to remove multiple items from the collection.

NOTES

see the companion removeItemConfirmationTitle localizable string
see the related removeItemConfirmation and removeItemsConfirmation localizable strings

8. State Properties

8.1. allSelected

A read-only boolean, indicating whether or not all the items in the collection are selected.

Whenever the value of the totalSelected state property changes, the value of this property will be updated to be kept current and correct. Whenever the value of this property is true, the value of the someSelected state property will also be true.

The Changed.allSelected instance event can be wired in order to maintain enabled state of any UI elements whose enabled state is affected by whether or not all items are selected. For example, whenever this property is set to true, the selectAll child widget will be disabled. Conversely, whenever allSelected is set to false, the selectAll child widget will be enabled (provided that the isEmpty state property is not set to true).

NOTES

this property is read-only
see the related oneSelected, someSelected, and totalSelected state properties
the initial value is false

IMPLEMENTATION INFO

this feature was introduced in this module

8.2. built

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.3. busy

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.4. busyInherited

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.5. busyParentTickle

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.6. children

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.7. container

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.8. enabled

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.9. enabledInherited

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.10. enabledParentTickle

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.11. html

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.12. idPrefix

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.13. idPrefixConstruction

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.14. insertionMode

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.15. isEmpty

A read-only boolean, indicating whether or not the collection is empty (i.e. has no items).

Whenever the value of the totalItems state property changes, the value of the isEmpty state property will be updated to be kept current and correct. When the isEmpty property is set to true, then the selectAll Child Widget will be disabled.

NOTES

this property is read-only
the initial value is true

IMPLEMENTATION INFO

this feature was introduced in this module

8.16. itemPropertyForItemWidgetName

A string, specifying the name of a property in an item's properties object that should be used as the name of the item's widget in the collection.

For a detailed discussion, see the section Explicit Naming of Collection Item Widgets.

NOTES

see the related itemWidgetNamePrefix state property
the initial value is 'id'

IMPLEMENTATION INFO

this feature was introduced in this module

8.17. itemRemoveActsOnSelection

A boolean, specifying whether or not a Remove event fired by a selected collection item (as a result of the user clicking the item's remove button) should act on the rest of the selected items.

In certain applications, it might seem more appropriate for clicking the remove button of an individual collection item in a selection of collection items to remove all items in the current selection. In such cases, the itemRemoveActsOnSelection property can be set to true.

Even when this property is set to true, removing an individual collection item will not remove all selected items if the item being removed is not in the selection - if it is an unselected item, then only that item will be removed. So, essentially, when itemRemoveActsOnSelection is set to true, a single selected item becomes a proxy for the entire selection for a remove initiated on the item.

NOTES

the initial value is false

IMPLEMENTATION INFO

this feature was introduced in this module

8.18. itemWidgetClass

An object reference, specifying the Uize.Widget.CollectionItem subclass that should be used for creating item widget instances.

In some cases, the Uize.Widget.CollectionItem base class may be adequate. In other cases, however, one may wish the item widgets to have more than just the most basic functionality. In such cases, one can create one's own collection item widget class and then specify this class as the value of the itemWidgetClass property when creating the collection instance.

NOTES

the initial value is undefined

IMPLEMENTATION INFO

this feature was introduced in this module

8.19. itemWidgetNamePrefix

A string, specifying a prefix that should be used in collection item widget names when automatic widget naming is employed.

For a detailed discussion, see the section Automatic Naming of Collection Item Widgets.

NOTES

see the related itemPropertyForItemWidgetName state property
the initial value is 'item'

IMPLEMENTATION INFO

this feature was introduced in this module

8.20. itemWidgetProperties

An object reference, specifying the values for any state properties that are common for all collection item widgets that are created by this class.

The Uize.Widget.Collection class will use this property when creating new collection item widget instances as child widgets. Consider the following example...

EXAMPLE

var myCollection = page.addChild (
  'collection',
  Uize.Widget.Collection,
  {
    itemWidgetClass:Uize.Widget.CollectionItem,
    itemPropertyForItemWidgetName:'widgetName',
    itemWidgetProperties:{previewClickAction:'Select'},
    items:[
      {
        widgetName:'bravingTheOnslaught',
        title:'Braving the Onslaught',
        category:'The Winter Collection'
      },
      {
        widgetName:'flockOfClouds',
        title:'Flock of Clouds',
        category:'The Photographic Orphanage'
      }
    ]
  }
);

In the above example, we're setting the itemWidgetProperties state property to the value {previewClickAction:'Select'}. This means that the two collection item child widgets that are created will both have their previewClickAction state property set to the value 'Select', which means that clicking on them will change their selected state.

NOTES

the initial value is undefined

IMPLEMENTATION INFO

this feature was introduced in this module

8.21. items

An array of objects, representing the item data corresponding to the items in the collection.

Each element of the items array should be an object, which serves as a "bucket" for additional data for an item. When a collection item widget is created for an item in the items array, the element from the items array is used as the value of the item widget's properties state property.

Whenever the value of the items property is changed, the following actions will be taken...

collection item widgets will be added for all the elements of the items array
the Items Changed instance event will be fired.

NOTES

see the related itemWidgets instance property
see also the Items Changed instance event

IMPLEMENTATION INFO

this feature was introduced in this module

8.22. localized

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.23. name

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.24. nodeMap

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.25. oneSelected

A read-only boolean, indicating whether or not just one item is selected.

Whenever the value of the totalSelected state property changes, the value of this property will be updated to be kept current and correct. Whenever the value of this property is true, the value of the someSelected state property will also be true.

The Changed.oneSelected instance event can be wired in order to maintain enabled state of any UI elements that trigger action on a single item and that are, therefore, not applicable when more than one item or no items are selected, but where it is still desirable to permit multiple selection for the sake of other actions that can operate on more than one item.

NOTES

this property is read-only
see the related allSelected, someSelected, and totalSelected state properties
the initial value is false

IMPLEMENTATION INFO

this feature was introduced in this module

8.26. parent

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

8.27. selectionMode

A string, specifying the mode ('single' or 'multi') for selecting items in the collection.

'single' - In this selection mode, only one item can be selected at a time. Attempting to add to the selection using the ctrl or shift modifier keys will result in any currently selected item being deselected in favor of the new item being clicked on. In this mode it is possible, however, to use the ctrl modifier key to deselect the current item by ctrl-clicking on it. Also, when in this selection mode, the selectAll Child Widget will be disabled if there is more than one item in the collection.
'multi' - In this selection mode, multiple items may be selected at the same time. A user can add to the selection by using the ctrl or shift modifier keys, to do non-contiguous or range selection, respectively. In this mode, the selectAll Child Widget will be enabled unless all items in the collection are already selected, or the collection is empty.

NOTES

the initial value is 'multi'

IMPLEMENTATION INFO

this feature was introduced in this module

8.28. someSelected

A read-only boolean, indicating whether or not there are any items selected.

Whenever the value of the totalSelected state property changes, the value of this property will be updated to be kept current and correct. The value of this property will be true when the value of the oneSelected state property is true.

The Changed.someSelected instance event can be wired in order to maintain enabled state of any UI elements that trigger action on a selection and that are, therefore, not applicable when no items are selected. For example, whenever this property is set to true, the selectNone child widget will be enabled. Conversely, whenever someSelected is set to false, the selectNone child widget will be disabled.

NOTES

this property is read-only
see the related allSelected, oneSelected, and totalSelected state properties
the initial value is false

IMPLEMENTATION INFO

this feature was introduced in this module

8.29. totalItems

A read-only integer, indicating the total number of items in the collection.

Whenever the total number of items in the collection changes, either as a result of adding new items or removing items, the value of the isEmpty state property will be updated to be kept current and correct, and the totalItems DOM Node will be updated to reflect the new number of items in the collection.

NOTES

this property is read-only
see the related isEmpty state property
the initial value is 0

IMPLEMENTATION INFO

this feature was introduced in this module

8.30. totalSelected

An read-only integer, indicating the total number of items that are selected.

Whenever the selection is changed, either by the user or programmatically, the value of this property will be updated. Whenever its value changes, the values of the oneSelected, someSelected, and allSelected state properties will be updated to be kept current and correct.

NOTES

this property is read-only
see the related allSelected, oneSelected, and someSelected state properties
the initial value is 0

IMPLEMENTATION INFO

this feature was introduced in this module

8.31. wired

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)

9. Static Methods

9.1. Uize.Widget.Collection.alphastructor

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.2. Uize.Widget.Collection.declare

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.3. Uize.Widget.Collection.doMy

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.4. Uize.Widget.Collection.dualContextMethods

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.5. Uize.Widget.Collection.dualContextProperties

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.6. Uize.Widget.Collection.fire

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.7. Uize.Widget.Collection.get

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.8. Uize.Widget.Collection.getBlankImageUrl

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)
this static feature is inherited by subclasses

9.9. Uize.Widget.Collection.instanceMethods

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.10. Uize.Widget.Collection.instanceProperties

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.11. Uize.Widget.Collection.mixins

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.12. Uize.Widget.Collection.omegastructor

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.13. Uize.Widget.Collection.set

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.14. Uize.Widget.Collection.singleton

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.15. Uize.Widget.Collection.spawn

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)
this static feature is inherited by subclasses

9.16. Uize.Widget.Collection.stateProperties

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.17. Uize.Widget.Collection.staticMethods

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.18. Uize.Widget.Collection.staticProperties

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.19. Uize.Widget.Collection.subclass

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.20. Uize.Widget.Collection.toggle

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.21. Uize.Widget.Collection.treeInheritedStateProperties

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)
this static feature is inherited by subclasses

9.22. Uize.Widget.Collection.unwire

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

9.23. Uize.Widget.Collection.wire

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

10. Static Properties

10.1. Uize.Widget.Collection.busyParentTickle

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)
this static feature is inherited by subclasses

10.2. Uize.Widget.Collection.enabledParentTickle

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)
this static feature is inherited by subclasses

10.3. Uize.Widget.Collection.isWired

Inherited from Uize.Widget.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Widget, first introduced in Uize.Widget)
this static feature is inherited by subclasses

10.4. Uize.Widget.Collection.moduleName

IMPLEMENTATION INFO

this is an override of an inherited feature (implementation is in this module, first introduced in Uize.Class)
this static feature is inherited by subclasses

10.5. Uize.Widget.Collection.nonInheritableStatics

IMPLEMENTATION INFO

this is an override of an inherited feature (implementation is in this module, first introduced in Uize.Class)
this static feature is not inherited by subclasses

10.6. Uize.Widget.Collection.pathToResources

Inherited from Uize.Class.

IMPLEMENTATION INFO

this is an inherited feature (implementation is in Uize.Class, first introduced in Uize.Class)
this static feature is inherited by subclasses

10.7. Uize.Widget.Collection.undefined

IMPLEMENTATION INFO

this is an override of an inherited feature (implementation is in this module, first introduced in Uize.Widget)
this static feature is inherited by subclasses