SiB-Form.rst

solid-form
==========

Receives the URL of a ressource via its ``data-src`` attribute, and
displays a form to edit the resource. If given the URL of a container of
ressources, and displays a creation form to add a resource to the
container.

.. code:: html

   <solid-form data-src="http://localhost:8000/todos/"></solid-form>

Attributes
----------

``label-xyz``
~~~~~~~~~~~~~
   When displaying a form, the default labels are the fields names of the model.
   If you want something fancier, you can set this attribute.
   i.e. ``label-username="Your name"``

``naked``
~~~~~~~~~
   When the attribute is set, the submit button will be
   removed. It’s particularly useful to prevent the nested forms to
   display their own submit button.

``upload-url-xyz``
~~~~~~~~~~~~~~~~~~
   URL to upload file for field ``xyz``, it
   automatically set ``widget-xyz`` to ``solid-form-file`` if net defined.
   It’s particularly useful with a dropdown field.

``submit-button``
~~~~~~~~~~~~~~~~~
   Text of the submit button of the form.

``range-xyz``
~~~~~~~~~~~~~
   URL of a container which list the accepted values
   for the field ``xyz``. It’s particularly useful with a dropdown
   field.

``partial``
~~~~~~~~~~~
   Add this attribute when the form does not include
   all the fields of the resource to update.