<uix:byteLength>タグ
ネームスペース:  http://xmlns.oracle.com/uix/ui
派生元:  <uix:clientValidater>タグ
タグの型:  ClientValidater

<byteLength>要素は、エンコーディングでの文字列のバイト長を制限するクライアント・バリデータを定義します。

構文
<uix:byteLength
      encoding="string"
      maximumBytes="nonNegativeInteger"
>
</uix:byteLength>

注意: 
  • このタグは派生元タグのすべての属性と子タグを持つことができます。

  • 説明

    <byteLength>要素は、エンコーディングでの文字列のバイト長を制限するクライアント・バリデータを定義します。textInputのmaximumLength属性と似ていますが、maximumLength属性ではユーザーの入力できる文字数を制限します。状況によっては、サーバーでも文字列の格納に必要なバイト数を制限する必要があります。これは、ユーザー・インタフェースの観点からは望ましくありません。日本語の2文字に対して英数字では6文字入力できる理由をユーザーが理解するのは難しいからです。ただし、バックエンドによりこれがエラーとして報告される場合には、データを送信する前に問題をレポートすることをお薦めします。

    <byteLength>要素により、開発者はバイト長の定義に使用するエンコーディングを指定できます。このエンコーディングは、Javaランタイムでサポートされているエンコーディングである必要があります。ただし、すべてのエンコーディングが、UIXのクライアント側の検証コードでサポートされているわけではありません。サポートされていないエンコーディング(EUC-TWなど)の場合、クライアントでの検証は実行されません。したがって、バイト長の検証をするためには、開発者はサーバーでJavaのByteLengthValidaterクラスまたは対応するコードを使用する必要があります。


    属性

    説明
    encoding 文字列に使用されるJavaのエンコーディング。 必須。
    string
    maximumBytes 文字列のエンコーディングで使用できる最大のバイト数。 必須。
    nonNegativeInteger