/ 
HTML-FormHandler-0.35005
River stage two • 21 direct dependents • 31 total dependents
/ HTML::FormHandler::TraitFor::I18N

NAME

HTML::FormHandler::TraitFor::I18N - localization

VERSION

version 0.35005

language_handle, _build_language_handle

Holds a Locale::Maketext (or other duck_type class with a 'maketext' method) language handle

The builder for this attribute gets the Locale::Maketext language handle from the environment variable $ENV{LANGUAGE_HANDLE}, or creates a default language handler using HTML::FormHandler::I18N. The language handle is used in the field's add_error method to allow localizing.

You can pass in an existing Locale::MakeText subclass instance or create one in a builder.

In a form class:

sub _build_language_handle { MyApp::I18N::abc_de->new }

Passed into new or process:

my $lh = MyApp::I18N::abc_de->new;
my $form = MyApp::Form->new( language_handle => $lh );

If you do not set the language_handle, then Locale::Maketext and/or I18N::LangTags may guess, with unexpected results.

You can use non-Locale::Maketext language handles, such as Data::Localize. There's an example of building a Data::Localize language handle in t/xt/locale_data_localize.t in the distribution.

If you don't want a particular error message to go through localization, you can use 'push_errors' and 'push_form_errors' instead of 'add_error' and 'add_form_errors'.

AUTHOR

FormHandler Contributors - see HTML::FormHandler

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Gerda Shank.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.