=====
Forms
=====

A Pancake form is enclosed in calls to the ``Pancake::start()`` and
``Pancake::end()`` methods:

.. code-block:: php
    
    <?php
    include_once 'Pancake/Pancake.php';
    $form = new \Pancake\Pancake;
    ?>
    
    <?= $form->start() ?>
        // Form contents...
    <?= $form->end() ?>

.. _form-attributes:

HTML attributes
===============

You can specify HTML attributes for the ``<form>`` tag by passing the
``Pancake::start()`` method an associative array wherein the key is the name of
the attribute:

.. code-block:: php
    
    <?= $form->start(array(
        'class' => 'application',
        'enctype' => 'multipart/form-data'
    )) ?>
        // Form contents...
    <?= $form->end() ?>

.. _form-identifiers:

Form identifiers
================

In order to allow multiple Pancake-powered forms on a single webpage, each form
utilises its :ref:`submit button <field-submit>` as a 'form identifier'.  If
the form identifier is present in the POST data, Pancake knows with which form
to associate the data.  This ability requires the submit buttons to be named
uniquely.  Again, you only need to worry about form identifiers if your page
contains more than one Pancake-powered form.