Provides a mask edit HTML <input type="text"> form element.
Mask edit field validates the text the user enters against a mask that encodes the
valid forms the text can take. The mask can also format text that is displayed to
the user.
| Mask character | Meaning in mask |
|---|---|
| l | Mixed case letter character [a..z, A..Z] |
| L | Upper case letter character [A..Z] |
| a | Mixed case alpha numeric character [a..z, A..Z, 0..1] |
| A | Upper case alpha numeric character [A..Z, 0..9] |
| # | Numeric character [0..9] |
| _ | Reserved character for display, do not use. |
| others | Non editable character for display. |
This component requires JavaScript to be enabled in the client browser.
See also: Form
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| mask | string | yes | See above. | |
| value | string | yes | The value to be editted, which is is usually a string. | |
| disabled | boolean | no | false |
If true, then a disabled attribute will be rendered as part of the
<input> tag, and the component will not update its value parameter
when the form is submitted.
|
Body: removed
Informal parameters: forbidden
Reserved parameters: none
Example of a masked US phone number input field:
<label for="phone" accessKey="p">Phone</label>
<input jwcid="phone@contrib:MaskEdit" value="ognl:phoneInput"
mask="literal:(###) ###-####" />