++ed by:

1 PAUSE user
2 non-PAUSE users.

Author image Matt S Trout
and 1 contributors


HTML::String::TT::Directive - Template::Directive overrides to forcibly escape HTML strings


This is not user serviceable, and is documented only for your edification.

Please use HTML::String::TT as this module could change, be renamed, or if I figure out a better way of implementing the functionality disappear entirely at any moment.



We override this top-level method in order to pretend two things to the perl subroutine definition that TT has generated - firstly,

  package HTML::String::TT::_TMPL;

to ensure that no packages marked to be ignored are the current one when the template code is executed. Secondly,

  use HTML::String::Overload { ignore => { ... } };

where the ... contains a list of TT internal packages to ignore so that things actually work. This list is not duplicated here since it may also change without warning.

Additionally, the hashref option to HTML::String::Overload is not documented there since I'm not yet convinced that's a public API either.


Due to a perl bug (https://rt.perl.org/rt3/Ticket/Display.html?id=49594) we overload this method to change




since any string containing a backslash escape doesn't get marked as HTML. Since we don't want to escape things that backslash escapes are normally used for, this isn't really a problem for us.


For no reason I can comprehend at all, Template::Directive's textblock method calls &text instead of using a method call so we have to override this as well.


See HTML::String for authors.


See HTML::String for the copyright and license.