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 g =over

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.