NAME

Yancy::Plugin::Form::Bootstrap4 - Generate forms using Bootstrap 4

VERSION

version 1.034

SYNOPSIS

    use Mojolicious::Lite;
    plugin Yancy => {
        backend => 'pg://localhost/mysite',
        read_schema => 1,
    };
    app->yancy->plugin( 'Form::Bootstrap4' );
    # See Yancy::Controller::Yancy for routing
    app->routes->get( '/people/:id/edit' )->to(
        'yancy#set',
        schema => 'people',
        template => 'edit_people',
    );
    app->start;
    __DATA__
    @@ edit_people.html.ep
    %= $c->yancy->form->form_for( 'people' );

DESCRIPTION

This plugin generates forms using the Bootstrap 4.0.

For details on the helpers added by this plugin, see Yancy::Plugin::Form.

TEMPLATES

These templates can be overridden by providing your own template with the same path.

yancy/form/bootstrap4/form.html.ep

This template surrounds the form to create the <form> element, list all the fields, and add a submit button. Also includes a CSRF token.

yancy/form/bootstrap4/field.html.ep

This template surrounds a single form field to add a <label> element, the appropriate input element(s), and the optional description.

yancy/form/bootstrap4/input.html.ep

This template is for single <input> elements and the attributes they need. This is used by field types string, number, integer, and string fields with formats email and date-time.

yancy/form/bootstrap4/textarea.html.ep

This template is for single <textarea> elements and the attributes they need. This is used by fields with type string and format textarea.

yancy/form/bootstrap4/select.html.ep

This template is for single <select> elements and the attributes they need. This is used by fields with an enum property.

yancy/form/bootstrap4/yesno.html.ep

This template displays a yes/no toggle used for fields of type boolean.

yancy/form/bootstrap4/readonly.html.ep

This template displays all read-only fields. This template must not include any kind of <input>, <select>, or other form fields.

SEE ALSO

Yancy::Plugin::Form, Yancy

AUTHOR

Doug Bell <preaction@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2019 by Doug Bell.

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