diff --git a/source/import_documentation/Components/Solid-Delete.rst b/source/import_documentation/Components/Solid-Delete.rst index 0470de6ba9958491bad5cd0cd95feb493dd96197..44c8733b8bf8ff28f29182c91b37b23355f0e901 100644 --- a/source/import_documentation/Components/Solid-Delete.rst +++ b/source/import_documentation/Components/Solid-Delete.rst @@ -16,6 +16,7 @@ Mixins This component uses the following mixin: * :ref:`next-mixin <next-mixin>` + * :ref:`validation-mixin <validation-mixin>` Please check their documentation to know more about its capabilities. @@ -33,7 +34,10 @@ Attributes ``confirmation-message`` ~~~~~~~~~~~~~~~~~~~~~~~~~ - Add this attribute to create a dialog box linked with the submit button of the solid-form. + *Available from version 0.13* + **Migrated to the validation mixin page in version 0.16** + + Add this attribute to create a dialog box linked with the button of the solid-delete. Its value matches the message displayed in the dialog box. diff --git a/source/import_documentation/Components/Solid-Form.rst b/source/import_documentation/Components/Solid-Form.rst index 7414c91834d73c255b0709b9d7bd6eef216f8fd7..b440ca98102ebb980ef31b60228d0bd0cc3439d1 100644 --- a/source/import_documentation/Components/Solid-Form.rst +++ b/source/import_documentation/Components/Solid-Form.rst @@ -17,6 +17,7 @@ Mixins This component uses the following mixins: * :ref:`next-mixin <next-mixin>` * :ref:`store-mixin <store-mixin>` + * :ref:`validation-mixin <validation-mixin>` * :ref:`widget-mixin <widget-mixin>` Please check their documentation to know more about their capabilities. @@ -29,7 +30,7 @@ Attributes List of the fields used to create the form (by default, all of them are used). ``label-[field]`` -~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~ 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"`` @@ -41,7 +42,7 @@ Attributes display their own submit button. ``upload-url-[field]`` -~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~ URL to upload file for field ``[field]``, it automatically set ``widget-[field]`` to ``solid-form-file`` if net defined. It’s particularly useful with a dropdown field. @@ -51,13 +52,13 @@ Attributes Text of the submit button of the form. ``range-[field]`` -~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~ URL of a container which list the accepted values for the field ``[field]``. It’s particularly useful with a dropdown field. ``enum-[field]`` -~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~ *Available from version 0.13* List of values of your choice for the field ``[field]``. @@ -72,7 +73,7 @@ Attributes and "a", "b", "c" will be loaded in value attribute. ``order-asc-[field]`` or ``order-desc-[field]`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Name of the field used to order the range list ``[field]``. ``partial`` @@ -81,14 +82,14 @@ Attributes all the fields of the resource to update. ``min-[field]`` -~~~~~~~~~~~ +~~~~~~~~~~~~~~~ Add this attribute for the field ``[field]`` to define its minimum value. - It works only with a ``solid-form-number`` widget. + It works only with ``solid-form-number`` and ``solid-form-time`` widgets. ``max-[field]`` -~~~~~~~~~~~ +~~~~~~~~~~~~~~~ Add this attribute for the field ``[field]`` to define its maximum value. - It works only with a ``solid-form-number`` widget. + It works only with ``solid-form-number`` and ``solid-form-time`` widgets. ``pattern-[field]`` ~~~~~~~~~~~~~~~ @@ -98,15 +99,16 @@ Attributes It works only with a ``solid-form-text`` widget. ``title-[field]`` -~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~ *Available from version 0.13* Add this attribute for the field ``[field]`` to precise extra information about an element. It works only with a ``solid-form-text`` widget. ``confirmation-message`` -~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~~~~~~~~~~ *Available from version 0.13* + **Migrated to the validation mixin page in version 0.16** Add this attribute to create a dialog box linked with the submit button of the solid-form. Its value matches the message displayed in the dialog box. @@ -125,6 +127,31 @@ Attributes If the attribute is defined, each change in an input will trigger a request to update the resource. This attribute works only when editing resources, not creating them. + +``maxlength-[field]`` +~~~~~~~~~~~~~~~~~~~~~ + *Available from version 0.16* + + Add this attribute for the field ``[field]`` to define the maximum number of characters that can be typed. + It works only with ``solid-form-text``, ``solid-form-email`` or ``solid-form-password`` and ``solid-form-textarea`` widgets. + +``minlength-[field]`` +~~~~~~~~~~~~~~~~~~~~~ + *Available from version 0.16* + + Add this attribute for the field ``[field]`` to define the minimum number of characters that can be typed. + It works only with ``solid-form-text``, ``solid-form-email`` or ``solid-form-password`` and ``solid-form-textarea`` widgets. + + +``step-[field]`` +~~~~~~~~~~~~~~~~ + *Available from version 0.16* + + Add this attribute for the field ``[field]`` to define the stepping interval number to use as constraint validation. Its based on the ``min-[field]`` value. + It works with : + - ``solid-form-time`` widget : Its value is given in seconds (default value is 60). + - ``solid-form-number`` widget : Its default value is 1. + Widgets ------- By default, the widget used is ``<solid-form-label-text>``. Cf the diff --git a/source/import_documentation/Mixins/validation-mixin.rst b/source/import_documentation/Mixins/validation-mixin.rst new file mode 100644 index 0000000000000000000000000000000000000000..e14d13b9601161b26a426ae78d6ca334ff9a1d28 --- /dev/null +++ b/source/import_documentation/Mixins/validation-mixin.rst @@ -0,0 +1,66 @@ +.. _validation-mixin: +validation-mixin +================ +*Available from version 0.16* + +The validation mixin creates a modal dialog before deleting or submitting data. + +Used by: +-------- + + * :ref:`solid-delete <solid-delete>` + * :ref:`solid-form <solid-form>` + +Attributes +---------- + +``confirmation-type`` +~~~~~~~~~~~~~~~~~~~~~ + It is a prerequisite and can take two options : + + - ``confirm``: to access to a basic modal dialog. + - ``dialog``: to get a ``<dialog>`` more customizable. + +``confirmation-message`` +~~~~~~~~~~~~~~~~~~~~~~~~ + Message displayed in the modal dialog (``confirm`` or ``dialog`` type). + The message by default is "Please, confirm your choice". + + +**The attributes below only concern ``dialog`` type.** + +``confirmation-submit-text`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + Text displayed on the submit button ("Ok" by default). + +``confirmation-cancel-text`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + Text displayed on the cancel button ("Cancel" by default). + +``confirmation-submit-class`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + Submit button class name (undefined by default). + +``confirmation-cancel-class`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + Cancel button class name (undefined by default). + + + Some examples of the use of validation mixin attributes : + + .. code:: html + + <solid-delete + data-src="http://server/user/" + confirmation-type="confirm" + confirmation-message="Thank you to confirm the data deletion." + ></solid-delete> + + <solid-form + data-src="../data/list/events.jsonld" + confirmation-type="dialog" + confirmation-message="Are you sure you want to create this event ?" + confirmation-submit-text="Yes, I am" + confirmation-submit-class="submit-button" + confirmation-cancel-class="cancel-button" + ></solid-form> \ No newline at end of file diff --git a/source/import_documentation/Mixins/widget-mixin.rst b/source/import_documentation/Mixins/widget-mixin.rst index 06afbdd78853c5c99b0ec9e4d6adf79e8d0ff4db..083585f532b948ce8d91e8a586bf8094267c0a71 100644 --- a/source/import_documentation/Mixins/widget-mixin.rst +++ b/source/import_documentation/Mixins/widget-mixin.rst @@ -85,6 +85,10 @@ Attributes ~~~~~~~~~~~~~~~~~~ The widget to use for all the fields, except if a specific one is defined for a field. +``default-widget-[field]`` +~~~~~~~~~~~~~~~~~~~~~~~~~~ + The widget displayed by default if the ``[field]`` is empty. + ``action-[field]`` ~~~~~~~~~~~~~~~~~~ Displays a link with a ``<solid-link>`` tag with the current resource as ``data-src`` and the value of the attribute as ``next``. diff --git a/source/import_documentation/Widgets/Reference.rst b/source/import_documentation/Widgets/Reference.rst index 537daabd2d4156226ace5cf72e0da8f3b696a9a3..43f6fb80f356a705d230ea9c6fa1699513390969 100644 --- a/source/import_documentation/Widgets/Reference.rst +++ b/source/import_documentation/Widgets/Reference.rst @@ -58,6 +58,7 @@ Name of the template to use. Available templates: - ``image``: Works like ``file`` but allow only images in the input, and create a preview of the image when selected by the user. - ``color``: set ``value`` in an ``<input>`` of type ``color``. - ``password``: set ``value`` in an ``<input>`` of type ``password``. + - ``time``: set ``value`` in an ``<input>`` of type ``time``. The format value is ``hh:mm``. - ``set`` diff --git a/source/import_documentation/attributes-list.rst b/source/import_documentation/attributes-list.rst index 5da3c35e8e8ec843e89d10f28e82228646959fd4..3ac73e427455ef93aa049a261773ee395b07b422 100644 --- a/source/import_documentation/attributes-list.rst +++ b/source/import_documentation/attributes-list.rst @@ -30,10 +30,29 @@ List of attributes (core framework) ~~~~~~~~~~~~~~ * :ref:`solid-map <solid-map>` +``confirmation-cancel-text`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + * :ref:`validation-mixin <validation-mixin>` + +``confirmation-cancel-class`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + * :ref:`validation-mixin <validation-mixin>` + ``confirmation-message`` ~~~~~~~~~~~~~~~~~~~~~~~~ - * :ref:`solid-form <solid-form>` - * :ref:`solid-delete <solid-delete>` + * :ref:`validation-mixin <validation-mixin>` + +``confirmation-type`` +~~~~~~~~~~~~~~~~~~~~~ + * :ref:`validation-mixin <validation-mixin>` + +``confirmation-submit-class`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + * :ref:`validation-mixin <validation-mixin>` + +``confirmation-submit-text`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + * :ref:`validation-mixin <validation-mixin>` ``counter-template`` ~~~~~~~~~~~~~~~~~~~~ @@ -56,6 +75,10 @@ List of attributes (core framework) ~~~~~~~~~~~~~~~~~~ * :ref:`widget-mixin <widget-mixin>` +``default-widget-[field]`` +~~~~~~~~~~~~~~~~~~~~~~~~~~ + * :ref:`widget-mixin <widget-mixin>` + ``editable-[field]`` ~~~~~~~~~~~~~~~~~~~~ * :ref:`widget-mixin <widget-mixin>` @@ -122,11 +145,19 @@ List of attributes (core framework) ``max-[field]`` ~~~~~~~~~~~~~~~ * :ref:`solid-form <solid-form>` + +``maxlength-[field]`` +~~~~~~~~~~~~~~~~~~~~~ + * :ref:`solid-form <solid-form>` ``min-[field]`` ~~~~~~~~~~~~~~~ * :ref:`solid-form <solid-form>` +``minlength-[field]`` +~~~~~~~~~~~~~~~~~~~~~ + * :ref:`solid-form <solid-form>` + ``multiple-[field]`` ~~~~~~~~~~~~~~~~~~~~ * :ref:`widget-mixin <widget-mixin>` @@ -212,6 +243,10 @@ List of attributes (core framework) ~~~~~~~~~~~~~~~~~~~~~~~ * :ref:`solid-form-search <solid-form-search>` +``step-[field]`` +~~~~~~~~~~~~~~~~ + * :ref:`solid-form <solid-form>` + ``(search-fields)`` deprecated ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * :ref:`filter-mixin <filter-mixin>`