NAME

       Weasel::WidgetHandlers - Mapping elements to widget handlers

VERSION

       0.01

SYNOPSIS

         use Weasel::WidgetHandlers qw( register_widget_handler );

         register_widget_handler(
           'Weasel::Widgets::HTML::Radio', # Perl class handler
           'HTML',                         # Widget group
           tag_name => 'input',
           attributes => {
              type => 'radio',
           });

         register_widget_handler(
           'Weasel::Widgets::Dojo::FilteringSelect',
           'Dojo',
           tag_name => 'span',
           classes => ['dijitFilteringSelect'],
           attributes => {
              role => 'presentation',
              ...
           });

FUNCTIONS

       register_widget_handler($handler_class_name, $group_name, %conditions)
           Registers $handler_class_name to be the instantiated widget returned for an element matching
           %conditions into $group_name.

           "Weasel::Session" can select a subset of widgets to be applicable to that session by adding a subset
           of available groups to that session.

       best_match_handler_class($driver, $_id, $groups)
           Returns the best matching handler's class name, within the groups listed in the arrayref $groups, or
           "undef" in case of no match.

           When $groups is undef, all registered handlers will be searched.

           When multiple handlers are considered "best match", the one last added to the group last mentioned in
           $groups is selected.