mirrors/EWF
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Updated markdown syntax.

Browse Source
This commit is contained in:
Jocelyn FIAT
2017-02-14 19:43:54 +01:00
parent 5dc9d82df7
commit f216e98430
1 changed files with 11 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
doc/workbook/wui/readme.md
View File

@@ -23,7 +23,7 @@ In addition, the `WSF_FORM_..` is capable to analyze parameters from request `WS
A simple solution to return html content is to use the `WSF_HTML_PAGE_RESPONSE` for now. A simple solution to return html content is to use the `WSF_HTML_PAGE_RESPONSE` for now.
In a `WSF_EXECUTION` descendant, see how to implement the `execute` procedure. In a `WSF_EXECUTION` descendant, see how to implement the `execute` procedure.
```eiffel ```
execute execute
local local
mesg: WSF_HTML_PAGE_RESPONSE mesg: WSF_HTML_PAGE_RESPONSE
@@ -38,7 +38,7 @@ In a `WSF_EXECUTION` descendant, see how to implement the `execute` procedure.
In this case, the html is hardcoded, and written manually. In this case, the html is hardcoded, and written manually.
Now let's see how to use the WSF widgets on a more advanced usecase, a simple sign-in web form with 2 input fields `username`, `password` and `submit` button. Now let's see how to use the WSF widgets on a more advanced usecase, a simple sign-in web form with 2 input fields `username`, `password` and `submit` button.
```eiffel ```
execute execute
do do
@@ -116,8 +116,10 @@ See [Handling requests section](../handling_request/form.md)
The `wsf_html` library, thanks to the `WSF_FORM`, provides a more powerful solution. The `wsf_html` library, thanks to the `WSF_FORM`, provides a more powerful solution.
Indeed `WSF_HTML.process (request, .., ..)` analyze the request, fill the form fields, and process various validations, and submissions automatically. Indeed `WSF_HTML.process (request, .., ..)` analyze the request, fill the form fields, and process various validations, and submissions automatically.
see
```eiffel See
```
process (req: WSF_REQUEST; a_before_callback, a_after_callback: detachable PROCEDURE [WSF_FORM_DATA]) process (req: WSF_REQUEST; a_before_callback, a_after_callback: detachable PROCEDURE [WSF_FORM_DATA])
-- Process Current form with request `req`, -- Process Current form with request `req`,
-- and build `last_data: WSF_FORM_DATA` object containing the field values. -- and build `last_data: WSF_FORM_DATA` object containing the field values.
@@ -126,7 +128,8 @@ see
``` ```
In our previous sample code, `execute_web_form_submission` could be: In our previous sample code, `execute_web_form_submission` could be:
```eiffel
```
execute_web_form_submission execute_web_form_submission
local local
mesg: WSF_HTML_PAGE_RESPONSE mesg: WSF_HTML_PAGE_RESPONSE
@@ -181,7 +184,8 @@ If those validations reports error, then the `form_data.has_error` will be True.
To set validation, To set validation,
For instance, in previous sample, accepts only alpha-numeric characters: For instance, in previous sample, accepts only alpha-numeric characters:
```eiffel
```
f_username.set_description ("Only alpha-numeric character are accepted.") f_username.set_description ("Only alpha-numeric character are accepted.")
f_username.set_validation_action (agent (fd: WSF_FORM_DATA) f_username.set_validation_action (agent (fd: WSF_FORM_DATA)
do do
@@ -196,6 +200,7 @@ For instance, in previous sample, accepts only alpha-numeric characters:
end end
end) end)
``` ```
Notes: Notes:
* If the validation is not satisfied, the form data will report `has_error` as True, and the associated form will be updated with submitted values, and with `class="error"` set to the related html code. * If the validation is not satisfied, the form data will report `has_error` as True, and the associated form will be updated with submitted values, and with `class="error"` set to the related html code.
The errors are also available via the `form_data.errors` feature. The errors are also available via the `form_data.errors` feature.