18.2. Controlling Whether Text Fields can be Left Empty (-wap-input-required Property)

The -wap-input-required property helps you control whether a text field can be empty. This WCSS property should be applied to text fields, password fields or text area fields. There will be no effect if it is applied to other form controls. The -wap-input-required property either takes a true or false as the value. Here are two WAP CSS examples that demonstrate the usage of the -wap-input-required property:

-wap-input-required: true

Meaning: A user must enter some text in a text field with this WAP CSS style rule applied.

-wap-input-required: false

Meaning: A text field with this WAP CSS style rule applied accepts empty input.

Note that if both the -wap-input-required property and -wap-input-format property are specified to the same XHTML MP element and conflict occurs between the two styles, the -wap-input-required property takes precedence. For example, suppose some WCSS style rules are applied to a text field like this:

<input type="text" style='-wap-input-format: "N"; -wap-input-required: false'/>

The two WCSS styles in the above markup conflict with each other. The "-wap-input-format: "N"" WCSS style specifies that a single numeric character must be entered, but the "-wap-input-required: false" WCSS style states that the text field can be empty. In this case, the "-wap-input-required: false" WCSS style takes precedence. So, the text field can either be left empty or contain a single numeric character.

Here is another WAP CSS example:

<input type="text" style='-wap-input-format: "*M"; -wap-input-required: true'/>

The "-wap-input-format: "*M"" WCSS style states that the text field can contain any number of characters (i.e. having no character is valid). However, as the "-wap-input-required: true" WCSS style takes precedence, the text field must contain at least one character.

Previous Page Page 28 of 39 Next Page

Feedback Form (ExpandCollapse)

What do you think about this web page?

(Optional) Please provide us more details. For example, suppose you select option 2 above, can you tell us specifically what information is missing? You can also suggest anything that can help us improve this web page.

(Optional) Your name:

(Optional) Your email address:

Please enter again to confirm:

Due to the amount of messages we received, we may not be able to reply to all messages.

A button for going back to the top of this page