---
name: "Weasel::WidgetHandlers"
section: "3pm"
platform: "linux"
package: "libweasel-perl"
version: "0.32-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Weasel::WidgetHandlers"
---

# Weasel::WidgetHandlers(3pm)

Mapping elements to widget handlers

## NAME

Weasel::WidgetHandlers - Mapping elements to widget handlers

## VERSION

version 0.32

## 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',
       ...
    });
```

## DESCRIPTION

Widget handlers map HTML elements to Perl class instances based on the HTML tag and its attributes.  The Perl class can be used to encapsulate interaction with the HTML element and its children, abstracting HTML DOM interactions into functional behaviours.

A widget may itself be composed of one or more child-widget. Eg, a form could be composed of several input fields and a button, all mapped to widgets to handle the interactions with the specific element type.

Classes can be developed and handlers registered for widgets which perform the same behaviours as basic HTML widgets, like the `"select"` tag; eg., a Dojo Toolkit, Vue or React widgets could be mapped to specific classes which encapsulate the DOM interactions required to make these widgets transparent to the Perl code which is interacting with them. An example of a widget mimicing to be a `"select"` tag is Weasel::Widgets::Dojo::Select.

## DEPENDENCIES

## SUBROUTINES/METHODS

- 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.

## AUTHOR

Erik Huelsmann

## CONTRIBUTORS

Erik Huelsmann Yves Lavoie

## MAINTAINERS

Erik Huelsmann

## BUGS AND LIMITATIONS

Bugs can be filed in the GitHub issue tracker for the Weasel project:\
  https://github.com/perl-weasel/weasel/issues

## SOURCE

The source code repository for Weasel is at\
  https://github.com/perl-weasel/weasel

## SUPPORT

Community support is available through perl-weasel@googlegroups.com \<mailto:perl-weasel@googlegroups.com\>.

## LICENSE AND COPYRIGHT

```
 (C) 2016-2023  Erik Huelsmann
```

Licensed under the same terms as Perl.