HTML::...erRole(3pm)

💖 HTML::Widgets::NavMenu::HeaderRole 💖

okay bestie, so this is the manual page for HTML::Widgets::NavMenu::HeaderRole(3pm) — a lil gem from the User Contributed Perl Documentation corner of the world. come sit with me, it's a short one and it's kind of iconic. 🎀

---

✨ NAME ✨

HTML::Widgets::NavMenu::HeaderRole — a Specialized HTML::Widgets::NavMenu sub-class

like. it's the main character's cooler younger sibling. same DNA, one extra trick. 💅

---

🌸 VERSION 🌸

version 1.1000

---

🦋 DESCRIPTION 🦋

so the way you build this module and the way you call it? literally the same as HTML::Widgets::NavMenu. no cap. the one and only difference is that with this one it actually means something to pass "header" as the value of the 'role'.

and when you do that? the link or the bolded label gets rendered inside its own <h2> header. so the HTML comes out looking something like this:

</ul>
<h2>
<a href="../me/" title="About Myself">About Me</a>
</h2>
<ul>

see how it's just vibing there in the middle, sandwiched between the </ul> and the next <ul>? that's the whole personality. 🫶

and if you wanna see a real live example of this in the wild, it's over on the Perl Beginners Site ( <http://perl-begin.org/> ). go peek, it's cute.

---

🌈 SYNOPOSIS 🌈

(yes bestie, the original section is spelled like that and we respect the spelling 💀)

mostly the same as HTML::Widgets::NavMenu, except for the ability to specify 'role' => "header" as one of the node attributes.

that's it. that's the plot twist. ⭐

---

👑 SEE ALSO 👑

HTML::Widgets::NavMenu for the complete documentation of the super-class.

fr fr, if you're confused about anything here, that's where the full lore lives. this page is just the bonus chapter. 📖

---

💜 AUTHORS 💜

Shlomi Fish, <http://www.shlomifish.org> .

---

🍓 SUPPORT 🍓

🌐 Websites 🌐

the following websites have more information about this module, and may be of help to you. as always, in addition to those websites please use your favorite search engine to discover more resources. (yes, even that search engine. we don't gatekeep. ✨)

• MetaCPAN

A modern, open-source CPAN search engine, useful to view POD in HTML format.

<https://metacpan.org/release/HTML-Widgets-NavMenu>

• RT: CPAN's Bug Tracker

The RT ( Request Tracker ) website is the default bug/issue tracking system for CPAN.

<https://rt.cpan.org/Public/Dist/Display.html?Name=HTML-Widgets-NavMenu>

• CPANTS

The CPANTS is a website that analyzes the Kwalitee ( code metrics ) of a distribution.

<http://cpants.cpanauthors.org/dist/HTML-Widgets-NavMenu>

• CPAN Testers

The CPAN Testers is a network of smoke testers who run automated tests on uploaded CPAN distributions.

<http://www.cpantesters.org/distro/H/HTML-Widgets-NavMenu>

• CPAN Testers Matrix

The CPAN Testers Matrix is a website that provides a visual overview of the test results for a distribution on various Perls/platforms.

<http://matrix.cpantesters.org/?dist=HTML-Widgets-NavMenu>

• CPAN Testers Dependencies

The CPAN Testers Dependencies is a website that shows a chart of the test results of all dependencies for a distribution.

<http://deps.cpantesters.org/?module=HTML::Widgets::NavMenu>

---

🐛 Bugs / Feature Requests 🐛

please report any bugs or feature requests by email to bug-html-widgets-navmenu at rt.cpan.org, or through the web interface at <https://rt.cpan.org/Public/Bug/Report.html?Queue=HTML-Widgets-NavMenu>. you will be automatically notified of any progress on the request by the system. (automatic updates? we love a system that texts back. 😭💖)

---

🧚 Source Code 🧚

the code is open to the world, and available for you to hack on. please feel free to browse it and play with it, or whatever. if you want to contribute patches, please send me a diff or prod me to pull from your repository :)

<https://github.com/shlomif/perl-HTML-Widgets-NavMenu>

git clone git://github.com/shlomif/perl-HTML-Widgets-NavMenu.git

like hello?? it's giving open source generosity. go clone it bestie, the repo is right there. 🔥

---

🌟 AUTHOR 🌟

Shlomi Fish <shlomif@cpan.org>

---

💀 BUGS 💀

please report any bugs or feature requests on the bugtracker website <https://github.com/shlomif/perl-HTML-Widgets-NavMenu/issues>

when submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

real talk: a test-file is the difference between "hmm interesting" and "okay let me fix this right now". include it. do it for the plot. 🙈

---

🎀 COPYRIGHT AND LICENSE 🎀

this software is Copyright (c) 2005 by Shlomi Fish.

this is free software, licensed under:

The MIT (X11) License

---

and that's the whole page, bestie! this one shipped with perl v5.34.0 and got timestamped 2022-08-20. take care of it, it's small but it's precious. mwah. 💅✨