1 package Reaction::UI::Widget;
4 use aliased 'Reaction::UI::ViewPort';
5 use aliased 'Reaction::UI::View';
6 use aliased 'Reaction::UI::LayoutSet';
8 use namespace::clean -except => [ qw(meta) ];
11 sub DEBUG_FRAGMENTS () { $ENV{REACTION_UI_WIDGET_DEBUG_FRAGMENTS} }
12 sub DEBUG_LAYOUTS () { $ENV{REACTION_UI_WIDGET_DEBUG_LAYOUTS} }
14 has 'view' => (isa => View, is => 'ro', required => 1);
15 has 'layout_set' => (isa => LayoutSet, is => 'ro', required => 1);
16 has 'fragment_names' => (is => 'ro', lazy_build => 1);
17 has 'basic_layout_args' => (is => 'ro', lazy_build => 1);
18 sub _build_fragment_names {
21 map { /^_fragment_(.*)/; $1; }
22 grep { /^_fragment_/ }
24 $self->meta->compute_all_applicable_methods
28 my ($self, $fragment_name, $rctx, $passed_args) = @_;
29 confess "\$passed_args not hashref" unless ref($passed_args) eq 'HASH';
30 if (DEBUG_FRAGMENTS) {
31 my $vp = $passed_args->{viewport};
32 $self->view->app->log->debug(
33 "Rendering fragment ${fragment_name} for ".ref($self)
34 ." for VP ${vp} at ".$vp->location
37 my $args = { self => $self, %$passed_args };
38 my $new_args = { %$args };
39 my $render_tree = $self->_render_dispatch_order(
40 $fragment_name, $args, $new_args
42 $rctx->dispatch($render_tree, $new_args);
44 sub _method_for_fragment_name {
45 my ($self, $fragment_name) = @_;
46 return $self->can("_fragment_${fragment_name}");
48 sub _render_dispatch_order {
49 my ($self, $fragment_name, $args, $new_args) = @_;
51 my @render_stack = (my $render_deep = (my $render_curr = []));
52 my @layout_order = $self->layout_set->widget_order_for($fragment_name);
54 if (my $f_meth = $self->_method_for_fragment_name($fragment_name)) {
59 while ($package eq $layout_order[0][0]
60 || $layout_order[0][0]->isa($package)) {
62 my @l = @{shift(@layout_order)};
64 $self->view->app->log->debug(
65 "Layout ${fragment_name} in ${\$l[1]->name} from ${\$l[1]->source_file}"
68 push(@$render_curr, [ -layout, $l[1], $fragment_name, $new_curr ]);
69 push(@render_stack, $new_curr);
70 push(@wclass_stack, $l[0]);
71 $render_deep = $render_curr = $new_curr;
72 last unless @layout_order;
76 while ($package ne $wclass_stack[-1]
77 && $package->isa($wclass_stack[-1])) {
79 $render_curr = pop(@render_stack);
82 push(@{$render_curr}, [ '-render', @_ ]);
84 $self->$f_meth($do_render, $args, $new_args);
86 # if we had no fragment method or if we still have layouts left
88 while (my $l = shift(@layout_order)) {
90 $self->view->app->log->debug(
91 "Layout ${fragment_name} in ${\$l->[1]->name} from ${\$l->[1]->source_file}"
95 -layout => $l->[1], $fragment_name, ($render_deep = [])
100 return $render_stack[0];
102 sub _build_basic_layout_args {
105 foreach my $name (@{$self->fragment_names},
106 @{$self->layout_set->layout_names}) {
107 $args->{$name} ||= sub { $self->render($name, @_); };
111 sub _fragment_viewport {
112 my ($self, $do_render, $args, $new_args) = @_;
113 my $vp = $args->{'_'};
114 my ($widget, $merge_args) = $self->view->render_viewport_args($vp);
115 $merge_args->{outer} = { %$new_args };
116 delete @{$new_args}{keys %$new_args}; # fresh start
117 @{$new_args}{keys %$merge_args} = values %$merge_args;
118 $do_render->(Widget, $widget, 'widget');
120 sub _fragment_widget {
121 my ($self, $do_render, $args, $new_args) = @_;
122 my $merge = $self->basic_layout_args;
123 #warn "Merge: ".join(', ', keys %$merge)." into: ".join(', ', keys %$new_args);
124 delete @{$merge}{keys %$new_args}; # nuke 'self' and 'viewport'
125 @{$new_args}{keys %$merge} = values %$merge;
128 __PACKAGE__->meta->make_immutable;
141 See L<Reaction::Class> for authors.
145 See L<Reaction::Class> for the license.