1 // widget_foreach.ysl2

     2 

     3 widget_desc("ForEach") {

     4 

     5     longdesc

     6     ||

     7     ForEach widget is used to span a small set of widget over a larger set of

     8     repeated HMI_NODEs. 

     9 

    10     Idea is somewhat similar to relative page, but it all happens inside the

    11     ForEach widget, no page involved.

    12 

    13     Together with relative Jump widgets it can be used to build a menu to reach

    14     relative pages covering many identical HMI_NODES siblings.

    15 

    16     ForEach widget takes a HMI_CLASS name as argument and a HMI_NODE path as

    17     variable.

    18 

    19     Direct sub-elements can be either groups of widget to be spanned, labeled

    20     "ClassName:offset", or buttons to control the spanning, labeled

    21     "ClassName:+/-number".

    22     ||

    23 

    24     shortdesc > span widgets over a set of repeated HMI_NODEs

    25 

    26     arg name="class_name" accepts="string" > HMI_CLASS name

    27 

    28     path name="root" accepts="HMI_NODE" >  where to find HMI_NODEs whose HMI_CLASS is class_name

    29 }