Documentation for <p:inputMask> - comments.

UI Components for JSF
Post Reply
burferd
Posts: 234
Joined: 01 May 2010, 16:15

03 Apr 2011, 07:57

There appears to be an error in the PF2.2 documentation for the p:inputMask component.

The "mask" attribute type is listed as an Integer, where it should be a String (according to the examples).
That should be clarified in the next document release.

It would also be nice to have a bit more explanation of the formats.
Here are some observations:
1) The masking is fairly obvious, and it appears the the "9" and "a" placeholders provide for single Numeric and Non-numeric values, respectively - you might want to actually point that out.
2) It looks like you can have "optional" information after a "?" (phone with ext example), but that is not explained.
3) For the Product Key example, there is an asterisk (^). Appaently that means you can have either Numeric or Non-numeric data, but that is not explained.

A couple additional paragraphs to better explain the formats would be appreciated in the next set of documentation.

It would REALLY be nice to have an email specific mask where you can specify the "@" and "." characters with arbitrary length alphanumeric in between - maybe something like "x@x.x", where the x can be arbitrary length alphanumeric values.

This would require a new format token "x" to represent arbitrary length alphanumeric data.
Maybe there could also be additional format tokens to represent arbitrary length numeric and non-numeric values as well?
These would make this component VERY useful.

Another observation from an asthetic point of view - it would be nice if the component actually had the same default look as an h:inputText field.
Right now, the two components look a bit different and makes a form combining both look a bid odd.

Thanks.
Using PrimeFaces 3.4, Mojarra 2.1.6, Glassfish 3.1.2, NetBerans 7.2, Hibernate 3.2.5 (sometimes)
Windows 7.

cagatay.civici
Prime
Posts: 18616
Joined: 05 Jan 2009, 00:21
Location: Cybertron
Contact:

03 Apr 2011, 11:32

Hi,

Please add your errata comments at;

http://primefaces.prime.com.tr/forum/vi ... f=3&t=7788

Post Reply

Return to “PrimeFaces”

  • Information
  • Who is online

    Users browsing this forum: No registered users and 35 guests