#
# YUI::MenuBar::Markup
#
# Author(s): Pablo Fischer (pfischer@cpan.org)
# Created: 01/19/2010 10:05:38 PST 10:05:38
=head1 NAME
YUI::MenuBar::Markup - Generate YUI markup menus
=head1 DESCRIPTION
YUI::MenuBar::Markup will help you create your YUI menus by using markup (html).
It offers a very light interface to create your modules from any kind of data,
like I<perl raw> (hashes) to even L<YAML>.
There are no plans in giving support for creating YUI menus by javascript data.
Even, the html genearated doesn't allow modifications such as changing the CSS
class name of the items.
Please note that the string returned by L<generated()> is the pure javascript
to start the menubar and the HTML of the menubar. It's your B<responsibility>
to include the CSS and JS files. You can use L<YUI::Loader> for this.
=head1 SYNOPSYS
use strict;
use warnings;
use YUI::MenuBar::Markup;
use YUI::MenuBar::Markup::YAML;
my $markup_yaml = YUI::MenuBar::Markup::YAML->new(
filename => 'examples/menu_yaml.yaml');
my $markup = YUI::MenuBar::Markup->new(
source_ref => $markup_yaml);
print $markup->generate();
=cut
use Mouse;
our $VERSION = '0.02';
=head1 Attributes
=over 4
=item B<source_class>
If you have your own class (or module) for getting the data of the menu please
use this attribute. It should be the module name (I<Foo::Bar>) and have the
module should have a I<new()> method.
If your module doesn't have anything of the above please take a look to
L<source_ref>.
=cut
has 'source_class' => (
is => 'rw',
isa => 'Str');
=item B<source_ref>
Similar to L<source_class> but it should be the reference (eg, the object) to
the source.
The class contained in this refernece should have a method named L<get_source>
and should return an array of hashes to be used for building the menu.
=cut
has 'source_ref' => (
is => 'rw',
isa => 'Ref');
=item B<data>
The data that will be used for building the menu, should be an array of hashes
where
=cut
has 'data' => (
is => 'rw',
isa => 'ArrayRef');
=item B<top_id>
The menubar is made of lists (ul, li) and all these lists are contained in a
div element. By default the div element ID is automatically generated (with a
random number). In case you want to use a different ID just set the value of
this attribute to I<that>.
=cut
has 'top_id' => (
is => 'rw',
isa => 'Str');
=item B<autosubmenu>
When the cursor is over a menu that has a submenu, then the submenu will be
displayed automatically without clicking on it.
This is turned on by default.
=cut
has 'autosubmenu' => (
is => 'rw',
isa => 'Bool',
default => 1);
=item B<delay>
Indicates the time (milliseconds) that should expire before a menu is hidden.
In YUI this is known as the I<hidedelay>.
=cut
has 'delay' => (
is => 'rw',
isa => 'Int',
default => 750);
=item B<lazy>
Modifies the lazyload parameter of the YUI menubar to improve the performance
of the menubar by deferring the initialization and rendering of submenus until
the first time they are made visible.
=back
=cut
has 'lazy' => (
is => 'rw',
isa => 'Bool',
default => 1);
=head1 Methods
=head2 B<generate()>
Builds the HTML and javascript caller for the menu and returns it as a string
=cut
sub generate {
my ($self) = @_;
if (defined $self->{'source'}) {
my $sref = "$self->{'source'}"->new();
if ($sref->can('get_data')) {
$self->{'data'} = $sref->get_data();
} else {
warn "$self->{'source'} does not have a get_data() method";
}
} elsif (defined $self->{'source_ref'}) {
if ($self->{'source_ref'}->can('get_data')) {
$self->{'data'} = $self->{'source_ref'}->get_data();
}
}
if ($self->{'data'}) {
# The YUI loader
my $html = '';
my $menu_id = $self->_get_id();
$html .= "<script type=\"text/javascript\">\n";
$html .= $self->_generate_javascript($menu_id);
$html .= "</script>\n";
$html .= "<div id=\"" . $menu_id . "\" class=\"yuimenubar yuimenubarnav\">\n";
$html .= "<div class=\"bd\">\n";
$html .= $self->_generate_child_menu(
$self->{'data'},
1);
$html .= "</div>\n";
$html .= "</div>\n";
return $html;
}
}
############################## PRIVATE METHODS #################################
# Builds the <ul>, <li> and <div> for the menus and submenus
sub _generate_child_menu {
my ($self, $menu, $level) = @_;
my $tab = "\t" x $level;
my $html = "";
$html .= "$tab<ul class=\"first-of-type\">\n";
my $is_first = 1;
foreach my $item (@{$menu}) {
if (defined $item->{'name'}) {
my $extra_class = '';
if (defined $item->{'classes'}) {
$extra_class = $item->{'classes'};
}
if ($is_first) {
if ($extra_class) {
$extra_class = "$extra_class first-of-type";
} else {
$extra_class = "first-of-type";
}
$is_first = 0;
}
my $link = '#';
if (defined $item->{'link'}) {
$link = $item->{'link'};
}
my $menuitemclass = 'menubaritem';
if ($level gt 1) {
$menuitemclass = 'menuitem';
}
if ($extra_class) {
$html .= "$tab<li class=\"$menuitemclass $extra_class\">";
} else {
$html .= "$tab<li class=\"$menuitemclass\">";
}
$html .= "<a class=\"" . $menuitemclass . "label\" href=\"$link\">";
$html .= $item->{'name'} . "</a>";
if (defined $item->{'menu'}) {
$html .= "\n";
my $id = (defined $item->{'id'}) ?
$item->{'id'} :
$self->_generate_random_id();
$html .= "$tab<div id=\"$id\">\n";
$html .= "$tab<div class=\"bd\">\n";
$html .= $self->_generate_child_menu(
$item->{'menu'},
$level+1);
$html .= "$tab</div>\n";
$html .= "$tab</div>\n";
$html .= "$tab</li>\n";
} else {
$html .= "</li>\n";
}
}
}
$html .= "$tab</ul>\n";
return $html;
}
# Generates the javascript section
sub _generate_javascript {
my ($self, $id) = @_;
my $autosubmenu = ($self->{'autosubmenu'}) ? 'true' : 'false';
my $lazy = ($self->{'lazy'}) ? 'true' : 'false';
my $js_menu = <<JS;
YAHOO.util.Event.onContentReady("$id", function () {
var oMenuBar = new YAHOO.widget.MenuBar("$id", {
autosubmenudisplay: $autosubmenu,
hidedelay: $self->{'delay'},
lazyload: $lazy });
oMenuBar.render();
});
JS
return $js_menu;
}
# Generates a random ID
sub _generate_random_id {
my ($self) = @_;
return 'rand_yui_menu_markup_id' . int(rand(100));
}
# Gets the ID of the complete menu, the top ID. If no ID is set then a random
# ID is returned
sub _get_id {
my ($self) = @_;
if ($self->{'top_id'}) {
return $self->{'top_id'};
}
return $self->_generate_random_id();
}
=head1 SEE ALSO
=over 4
=item * YUI Menu documentation: http://developer.yahoo.com/yui/menu
=item * L<YUI::Loader>
=back
=head1 AUTHOR
Pablo Fischer (pablo@pablo.com.mx).
=head1 COPYRIGHT
Copyright (C) 2010 by Pablo Fischer.
This library is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.
=cut
1;