コントロール記述リファレンス

値を入力するためのコントロールを作成する要素です。type属性に値を指定して、次のコントロールを作成できます。

• テキストフィールド
• チェックボックス
• 日付入力コントロール

日付入力コントロールで入力される日付の書式は、CCYY-MM-DDです。（CC：西暦の年の最初の２桁、YY：西暦の年の最後の２桁、MM：月、DD：日）

属性：

type

テキストフィールド以外のコントロールを作成したいときに、作成するコントロールの種類を記述する属性です。次の文字列で指定します。

boolean

チェックボックスが作成されます。

date

日付入力コントロールが作成されます。

省略された場合、テキストフィールドが作成されます。

style

コントロールに適用するスタイルシートを記述する属性です。スタイルシートはCSSで記述します。使用できるスタイルシートのプロパティについては、「コントロール記述のCSSサポート状況」の「ctrl:input要素」をご覧ください。

省略された場合、適用するスタイルシートはないものと見なされます。

ref

コントロールで設定された値を反映する変換元XML文書のノードを、XPath式で記述する属性です。

省略された場合、コントロールで設定された値を反映するノードは存在しないものと見なされます。

relevant

コントロールが有効か無効かを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが有効か無効かが判断されます。

評価結果がtrueの場合

コントロールは有効となります。

評価結果がfalseの場合

コントロールは無効となります。

省略された場合、true()が設定されたと見なされます。

readonly

コントロールが参照専用かそうでないかを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが参照専用かそうでないかが判断されます。

評価結果がtrueの場合

コントロールは参照専用となります。

評価結果がfalseの場合

コントロールは通常の動作をします。

省略された場合、false()が設定されたと見なされます。

design-mode

デザインモードを使用するかしないかを設定する属性です。真偽値で記述します。

true

デザインモードで使用します。

false

通常のモードで使用します。

省略された場合、falseが設定されたと見なされます。

maxlength

入力できる文字列の最大の長さを設定する属性です。１以上の整数値で記述します。type属性の指定でテキストフィールド以外のコントロールが作成された場合は、無効となります。

省略された場合、入力できる文字列の長さに制限はありません。

text-type

入力されるデータのデータ型を設定する属性です。「型制約に基づく補正入力機能リファレンス」の「2.1. 変数型」に記述されているデータ型をQNameで記述します。設定された値は、type属性が省略されたときに有効となります。

省略された場合、値は制約されません。

text-filler

表示する文字列データが存在しないときに、代わりに表示する文字列を設定する属性です。type属性の指定でテキストフィールド以外のコントロールが作成された場合は、無効となります。

省略された場合、空文字列が指定されたと見なされます。

inputmode

IMEの入力モードを設定する属性です。次の文字列で記述します。

hiragana

ひらがな入力モードにします。

katakana

全角カタカナ入力モードにします。

katakana halfWidth

半角カタカナ入力モードにします。

latin fullWidth

全角英数入力モードにします。

off

IMEをオフにします

type属性の指定でテキストフィールド以外のコントロールが作成された場合は、無効となります。IMEの入力モード設定については、「IME制御」をご覧ください。

省略された場合、IMEの制御は行われません。

dispatch-value-changed-event

ctrl:value-changedイベントを発行するタイミングを指定する属性です。次の文字列で記述します。

text-committed

コントロールがフォーカスを失ったとき、およびコントロール上でEnterキーが押されたときにイベントが発行されます。

text-edited

コントロール上で、文字列が編集されたときに発行されます。

type属性の指定でテキストフィールド以外のコントロールが作成された場合は、無効となります。

省略された場合、text-committedが設定されたと見なされます。

内容：

ctrl:input要素内には以下の要素を記述できます。

• ctrl:label要素
  type属性の値にbooleanを設定した場合は、必ず１つ記述します。
  それ以外の場合は、１つだけ記述できます。省略可能です。
• xvcd:action要素
  任意の数だけ記述できます。省略可能です。

入力された文字を*に置き換えて画面に表示する文字列入力コントロールを作成する要素です。パスワード入力など、入力された文字列が読み取られては困るような場合に使用します。

ctrl:secret要素のIMEの入力モード設定については、「IME制御」をご覧ください。

属性：

style

コントロールに適用するスタイルシートを記述する属性です。スタイルシートはCSSで記述します。使用できるスタイルシートのプロパティについては、「コントロール記述のCSSサポート状況」の「ctrl:secret要素」をご覧ください。

省略された場合、適用するスタイルシートはないものと見なされます。

ref

コントロールで設定された値を反映する変換元XML文書のノードを、XPath式で記述する属性です。

省略された場合、コントロールで設定された値を反映するノードは存在しないものと見なされます。

relevant

コントロールが有効か無効かを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが有効か無効かが判断されます。

評価結果がtrueの場合

コントロールは有効となります。

評価結果がfalseの場合

コントロールは無効となります。

省略された場合、true()が設定されたと見なされます。

readonly

コントロールが参照専用かそうでないかを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが参照専用かそうでないかが判断されます。

評価結果がtrueの場合

コントロールは参照専用となります。

評価結果がfalseの場合

コントロールは通常の動作をします。

省略された場合、false()が設定されたと見なされます。

design-mode

デザインモードを使用するかしないかを設定する属性です。真偽値で記述します。

true

デザインモードで使用します。

false

通常のモードで使用します。

省略された場合、falseが設定されたと見なされます。

maxlength

入力できる文字列の最大の長さを設定する属性です。１以上の整数値で記述します。

省略された場合、入力できる文字列の長さに制限はありません。

内容：

ctrl:secret要素内には以下の要素を記述できます。

• ctrl:label要素
  必要に応じて、１つだけ記述できます。省略可能です。
• xvcd:action要素
  任意の数だけ記述できます。省略可能です。

改行を入力できる、複数行の文字列入力コントロールを作成する要素です。

属性：

style

コントロールに適用するスタイルシートを記述する属性です。スタイルシートはCSSで記述します。使用できるスタイルシートのプロパティについては、「コントロール記述のCSSサポート状況」の「ctrl:textarea要素」をご覧ください。

省略された場合、適用するスタイルシートはないものと見なされます。

ref

コントロールで設定された値を反映する変換元XML文書のノードを、XPath式で記述する属性です。

省略された場合、コントロールで設定された値を反映するノードは存在しないものと見なされます。

relevant

コントロールが有効か無効かを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが有効か無効かが判断されます。

評価結果がtrueの場合

コントロールは有効となります。

評価結果がfalseの場合

コントロールは無効となります。

省略された場合、true()が設定されたと見なされます。

readonly

コントロールが参照専用かそうでないかを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが参照専用かそうでないかが判断されます。

評価結果がtrueの場合

コントロールは参照専用となります。

評価結果がfalseの場合

コントロールは通常の動作をします。

省略された場合、false()が設定されたと見なされます。

design-mode

デザインモードを使用するかしないかを設定する属性です。真偽値で記述します。

true

デザインモードで使用します。

false

通常のモードで使用します。

省略された場合、falseが設定されたと見なされます。

maxlength

入力できる文字列の最大の長さを設定する属性です。１以上の整数値で記述します。

省略された場合、入力できる文字列の長さに制限はありません。

inputmode

IMEの入力モードを設定する属性です。次の文字列で記述します。

hiragana

ひらがな入力モードにします。

katakana

全角カタカナ入力モードにします。

katakana halfWidth

半角カタカナ入力モードにします。

latin fullWidth

全角英数入力モードにします。

off

IMEをオフにします

type属性の指定でテキストフィールド以外のコントロールが作成された場合は、無効となります。IMEの入力モード設定については、「IME制御」をご覧ください。

省略された場合、IMEの制御は行われません。

dispatch-value-changed-event

ctrl:value-changedイベントを発行するタイミングを指定する属性です。次の文字列で記述します。

text-committed

コントロールがフォーカスを失ったときにイベントが発行されます。

text-edited

コントロール上で、文字列が編集されたときに発行されます。

省略された場合、text-committedが設定されたと見なされます。

内容：

ctrl:textarea要素内には以下の要素を記述できます。

• ctrl:label要素
  必要に応じて、１つだけ記述できます。省略可能です。
• xvcd:action要素
  任意の数だけ記述できます。省略可能です。

指定された範囲内の数値を入力するスピナーコントロールを作成する要素です。

属性：

start （必須）

入力可能な最小の値を設定する属性です。-9,223,372,036,854,775,808以上、9,223,372,036,854,775,807以下の整数値で設定します。step属性に小数値を指定した場合、値の範囲は-9,223,372,036,854,775,808に10の-（step属性の小数点以下の桁数）乗をかけた値以上、9,223,372,036,854,775,807に10の-（step属性の小数点以下の桁数）乗をかけた値以下となります。小数点以下の桁数がstep属性の小数点以下の桁数を超える場合は、超える部分は切り捨てられます。

［例］step属性に0.01が設定された場合

最小値	-92,233,720,368,547,758.08
最大値	92,233,720,368,547,758.07
123.45678が入力されたときに設定される値	123.45

設定する値を指数表現で記述することはできません。

end （必須）

入力可能な最大の値を設定する属性です。-9,223,372,036,854,775,808以上、9,223,372,036,854,775,807以下の整数値で設定します。step属性に小数値を指定した場合、値の範囲は-9,223,372,036,854,775,808に10の-（step属性の小数点以下の桁数）乗をかけた値以上、9,223,372,036,854,775,80710の-（step属性の小数点以下の桁数）乗をかけた値以下となります。小数点以下の桁数がstep属性の小数点以下の桁数を超える場合は、超える部分は切り捨てられます。

［例］step属性に0.01が設定された場合

最小値	-92,233,720,368,547,758.08
最大値	92,233,720,368,547,758.07
123.45678が入力されたときに設定される値	123.45

設定する値を指数表現で記述することはできません。

step

数値の増減幅を設定する属性です。小数値を指定した場合、その小数桁の値を入力できます。小数点以下の桁数は18桁まで設定できます。

省略した場合、1が指定されたと見なされます。

style

コントロールに適用するスタイルシートを記述する属性です。スタイルシートはCSSで記述します。使用できるスタイルシートのプロパティについては、「コントロール記述のCSSサポート状況」の「ctrl:range要素」をご覧ください。

省略された場合、適用するスタイルシートはないものと見なされます。

ref

コントロールで設定された値を反映する変換元XML文書のノードを、XPath式で記述する属性です。

省略された場合、コントロールで設定された値を反映するノードは存在しないものと見なされます。

relevant

コントロールが有効か無効かを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが有効か無効かが判断されます。

評価結果がtrueの場合

コントロールは有効となります。

評価結果がfalseの場合

コントロールは無効となります。

省略された場合、true()が設定されたと見なされます。

readonly

コントロールが参照専用かそうでないかを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが参照専用かそうでないかが判断されます。

評価結果がtrueの場合

コントロールは参照専用となります。

評価結果がfalseの場合

コントロールは通常の動作をします。

省略された場合、false()が設定されたと見なされます。

design-mode

デザインモードを使用するかしないかを設定する属性です。真偽値で記述します。

true

デザインモードで使用します。

false

通常のモードで使用します。

省略された場合、falseが設定されたと見なされます。

内容：

ctrl:range要素内には以下の要素を記述できます。

• ctrl:label要素
  必要に応じて、１つだけ記述できます。省略可能です。
• xvcd:action要素
  任意の数だけ記述できます。省略可能です。

複数の選択肢から１つを選ぶコントロールを作成する要素です。appearance属性に値を指定して、次のコントロールを作成できます。

• ラジオボタン
• リストボックス
• ドロップダウンリスト、またはコンボボックス

属性：

appearance

作成するコントロールの外見を設定する属性です。次の文字列で記述します。

full

ラジオボタン

compact

リストボックス

minimal

ドロップダウンリスト、またはコンボボックス

省略された場合、minimalが設定されたと見なされます。

selection

appearance属性の値にminimalが設定されているときに、任意の文字列を入力できるかできないかを設定する属性です。次の文字列で記述します。

open

任意の文字列を入力できます。コントロールはコンボボックスとなります。

closed

任意の文字列は入力できません。コントロールはドロップダウンリストとなります。

appearance属性の値がminimalでないときは、無視されます。

省略された場合、closedが指定されたと見なされます。

direction

appearance属性の値にfullが設定されているときに、ラジオボタンを横方向に並べるか縦方向に並べるかを設定する属性です。次の文字列で記述します。

vertical

ラジオボタンを縦方向に並べます。

horizontal

ラジオボタンを横方向に並べます。

appearance属性の値がfullでないときは、無視されます。

省略された場合、horizontalが指定されたと見なされます。

style

コントロールに適用するスタイルシートを記述する属性です。スタイルシートはCSSで記述します。使用できるスタイルシートのプロパティについては、「コントロール記述のCSSサポート状況」の「ctrl:select1要素」をご覧ください。

省略された場合、適用するスタイルシートはないものと見なされます。

ref

コントロールで設定された値を反映する変換元XML文書のノードを、XPath式で記述する属性です。

省略された場合、コントロールで設定された値を反映するノードは存在しないものと見なされます。

relevant

コントロールが有効か無効かを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが有効か無効かが判断されます。

評価結果がtrueの場合

コントロールは有効となります。

評価結果がfalseの場合

コントロールは無効となります。

省略された場合、true()が設定されたと見なされます。

readonly

コントロールが参照専用かそうでないかを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが参照専用かそうでないかが判断されます。

評価結果がtrueの場合

コントロールは参照専用となります。

評価結果がfalseの場合

コントロールは通常の動作をします。

省略された場合、false()が設定されたと見なされます。

design-mode

デザインモードを使用するかしないかを設定する属性です。真偽値で記述します。

true

デザインモードで使用します。

false

通常のモードで使用します。

省略された場合、falseが設定されたと見なされます。

alert-invalid-value

ref属性に設定されたノードで示される値がコントロールでは設定できない値のときに、警告を表示するかしないかを設定する属性です。真偽値で記述します。

true

ref属性に設定されたノードで示される値がコントロールでは設定できない値のときに、警告を表示します。

false

ref属性に設定されたノードで示される値がコントロールでは設定できない値でも警告は表示しません。

ref属性が指定されていない場合や、コントロールが無効となっている場合は、設定された値にかかわらず、警告は表示されません。appearance属性にfullが設定されたときに有効です。

省略された場合、trueが設定されたと見なされます。

maxlength

入力できる文字列の最大の長さを設定する属性です。１以上の整数値で記述します。

省略された場合、入力できる文字列の長さに制限はありません。

inputmode

IMEの入力モードを設定する属性です。次の文字列で記述します。

hiragana

ひらがな入力モードにします。

katakana

全角カタカナ入力モードにします。

katakana halfWidth

半角カタカナ入力モードにします。

latin fullWidth

全角英数入力モードにします。

off

IMEをオフにします

type属性の指定でテキストフィールド以外のコントロールが作成された場合は、無効となります。IMEの入力モード設定については、「IME制御」をご覧ください。

省略された場合、IMEの制御は行われません。

popup-height

ドロップダウンリストやコンボボックスのポップアップ部分に、スクロールバーを表示するときの高さを設定する属性です。CSSの長さの単位系px・em・exを使用して記述します。

省略された場合、200pxが指定されたと見なされます。

内容：

ctrl:select1要素内には以下の要素を記述できます。

• ctrl:label要素
  必要に応じて、１つだけ記述できます。省略可能です。
• ctrl:item要素
  任意の数だけ記述できます。 省略可能です。
• xvcd:action要素
  任意の数だけ記述できます。省略可能です。

複数の選択肢から複数の値を選択するリストボックスコントロールを作成する要素です。

設定する値については、「ctrl:select要素の項目の値を設定する場合」をご覧ください。

属性：

appearance

作成するコントロールの外見を設定する属性です。次の文字列で記述します。

compact

リストボックス

省略された場合、compactが指定されたと見なされます。

style

コントロールに適用するスタイルシートを記述する属性です。スタイルシートはCSSで記述します。使用できるスタイルシートのプロパティについては、「コントロール記述のCSSサポート状況」の「ctrl:select要素」をご覧ください。

省略された場合、適用するスタイルシートはないものと見なされます。

ref

コントロールで設定された値を反映する変換元XML文書のノードを、XPath式で記述する属性です。

省略された場合、コントロールで設定された値を反映するノードは存在しないものと見なされます。

relevant

コントロールが有効か無効かを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが有効か無効かが判断されます。

評価結果がtrueの場合

コントロールは有効となります。

評価結果がfalseの場合

コントロールは無効となります。

省略された場合、true()が設定されたと見なされます。

readonly

コントロールが参照専用かそうでないかを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが参照専用かそうでないかが判断されます。

評価結果がtrueの場合

コントロールは参照専用となります。

評価結果がfalseの場合

コントロールは通常の動作をします。

省略された場合、false()が設定されたと見なされます。

design-mode

デザインモードを使用するかしないかを設定する属性です。真偽値で記述します。

true

デザインモードで使用します。

false

通常のモードで使用します。

省略された場合、falseが設定されたと見なされます。

内容：

ctrl:select要素内には以下の要素を記述できます。

• ctrl:label要素
  必要に応じて、１つだけ記述できます。省略可能です。
• ctrl:item要素
  任意の数だけ記述できます。 省略可能です。
• xvcd:action要素
  任意の数だけ記述できます。省略可能です。

クリックされたときに ctrl:triggeredイベントを発行するボタンコントロールを作成する要素です。

属性：

style

コントロールに適用するスタイルシートを記述する属性です。スタイルシートはCSSで記述します。使用できるスタイルシートのプロパティについては、「コントロール記述のCSSサポート状況」の「ctrl:trigger要素」をご覧ください。

省略された場合、適用するスタイルシートはないものと見なされます。

relevant

コントロールが有効か無効かを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが有効か無効かが判断されます。

評価結果がtrueの場合

コントロールは有効となります。

評価結果がfalseの場合

コントロールは無効となります。

省略された場合、true()が設定されたと見なされます。

readonly

コントロールが参照専用かそうでないかを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが参照専用かそうでないかが判断されます。

評価結果がtrueの場合

コントロールは参照専用となります。

評価結果がfalseの場合

コントロールは通常の動作をします。

省略された場合、false()が設定されたと見なされます。

command

ctrl:triggeredイベントで発行されるコマンドを表す文字列を設定する属性です。QNameで記述します。ctrl:trigger要素内にxvcd:action要素で処理を記述した場合、command属性で指定されたコマンドは実行されません。

省略された場合、実行するコマンドは指定されていないと見なされます。

design-mode

デザインモードを使用するかしないかを設定する属性です。真偽値で記述します。

true

デザインモードで使用します。

false

通常のモードで使用します。

省略された場合、falseが設定されたと見なされます。

内容：

ctrl:trigger要素内には以下の要素を記述できます。

• ctrl:label要素
  必ず１つ記述します。
• xvcd:action要素
  任意の数だけ記述できます。省略可能です。

色選択コントロールを作成する要素です。

属性：

palette

色選択コントロールで使用するカラーパレットの種類を設定する属性です。次の文字列で記述します。

css-defined

CSSで色を示すキーワードが定義されている16色のパレットを使用します。

web-safe

Webセーフカラーとされる216色のパレットを使用します。

省略された場合、css-definedが設定されたと見なされます。

style

コントロールに適用するスタイルシートを記述する属性です。スタイルシートはCSSで記述します。使用できるスタイルシートのプロパティについては、「コントロール記述のCSSサポート状況」の「ctrl:select-color要素」をご覧ください。

省略された場合、適用するスタイルシートはないものと見なされます。

ref

コントロールで設定された値を反映する変換元XML文書のノードを、XPath式で記述する属性です。

省略された場合、コントロールで設定された値を反映するノードは存在しないものと見なされます。

relevant

コントロールが有効か無効かを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが有効か無効かが判断されます。

評価結果がtrueの場合

コントロールは有効となります。

評価結果がfalseの場合

コントロールは無効となります。

省略された場合、true()が設定されたと見なされます。

readonly

コントロールが参照専用かそうでないかを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが参照専用かそうでないかが判断されます。

評価結果がtrueの場合

コントロールは参照専用となります。

評価結果がfalseの場合

コントロールは通常の動作をします。

省略された場合、false()が設定されたと見なされます。

design-mode

デザインモードを使用するかしないかを設定する属性です。真偽値で記述します。

true

デザインモードで使用します。

false

通常のモードで使用します。

省略された場合、falseが設定されたと見なされます。

内容：

ctrl:select-color要素内には以下の要素を記述できます。

• ctrl:label要素
  必要に応じて、１つだけ記述できます。省略可能です。
• xvcd:action要素
  任意の数だけ記述できます。省略可能です。

コントロールをグループ化してタイトルを付けられるボーダーを作成する要素です。グループのタイトルは、要素の内容の ctrl:label要素で記述します。

属性：

style

コントロールに適用するスタイルシートを記述する属性です。スタイルシートはCSSで記述します。使用できるスタイルシートのプロパティについては、「コントロール記述のCSSサポート状況」の「ctrl:border要素」をご覧ください。

省略された場合、適用するスタイルシートはないものと見なされます。

relevant

コントロールが有効か無効かを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが有効か無効かが判断されます。

評価結果がtrueの場合

コントロールは有効となります。

評価結果がfalseの場合

コントロールは無効となります。

省略された場合、true()が設定されたと見なされます。

内容：

ctrl:border要素内には以下の要素を記述できます。

• ctrl:label要素
  必要に応じて、１つだけ記述できます。省略可能です。
• ctrl:input要素
  任意の数だけ記述できます。 省略可能です。
• ctrl:secret要素
  任意の数だけ記述できます。 省略可能です。
• ctrl:textarea要素
  任意の数だけ記述できます。 省略可能です。
• ctrl:range要素
  任意の数だけ記述できます。 省略可能です。
• ctrl:select1要素
  任意の数だけ記述できます。 省略可能です。
• ctrl:select要素
  任意の数だけ記述できます。 省略可能です。
• ctrl:trigger要素
  任意の数だけ記述できます。 省略可能です。
• ctrl:select-color要素
  任意の数だけ記述できます。 省略可能です。
• ctrl:border要素
  任意の数だけ記述できます。 省略可能です。
• ctrl:static-label要素
  任意の数だけ記述できます。 省略可能です。
• ほかのボキャブラリの頂点要素
  任意の数だけ記述できます。 省略可能です。

ラベルを表示する要素です。表示する文字列は、要素の内容の ctrl:label要素で記述します。

ctrl:label要素とは異なり、コントロール記述ボキャブラリの頂点要素として使用できます。

この要素で作成されたラベルへ入力フォーカスを移動することはできません。

属性：

style

コントロールに適用するスタイルシートを記述する属性です。スタイルシートはCSSで記述します。使用できるスタイルシートのプロパティについては、「コントロール記述のCSSサポート状況」の「ctrl:static-label要素・ctrl:label要素・ctrl:item要素」をご覧ください。

省略された場合、適用するスタイルシートはないものと見なされます。

relevant

コントロールが有効か無効かを設定する属性です。XPath式で記述します。記述されたXPath式を真偽値として評価した結果で、コントロールが有効か無効かが判断されます。

評価結果がtrueの場合

コントロールは有効となります。

評価結果がfalseの場合

コントロールは無効となります。

省略された場合、true()が設定されたと見なされます。

design-mode

デザインモードを使用するかしないかを設定する属性です。真偽値で記述します。

true

デザインモードで使用します。

false

通常のモードで使用します。

省略された場合、falseが設定されたと見なされます。

内容：

ctrl:static-label要素内には以下の要素を記述できます。

• ctrl:label要素
  必ず１つ記述します。

要素内にラベル文字列を記述する要素です。 ctrl:static-label要素とは異なり、ほかの要素で作成されるコントロールにラベル文字列を設定するために、その要素の内容に記述します。

コントロール記述ボキャブラリの頂点要素に使用することはできません。

属性：

style

コントロールに適用するスタイルシートを記述する属性です。スタイルシートはCSSで記述します。使用できるスタイルシートのプロパティについては、「コントロール記述のCSSサポート状況」の「ctrl:static-label要素・ctrl:label要素・ctrl:item要素」をご覧ください。

省略された場合、適用するスタイルシートはないものと見なされます。

内容：

ctrl:label要素内には、コントロールのラベル文字列をPCDATA文字列で記述します。

ctrl:select1要素や ctrl:select要素の選択肢となる項目１つを記述する要素です。項目の値は、要素の内容の ctrl:value要素で記述します。項目名は、要素の内容の ctrl:label要素で記述できます。ctrl:label要素を省略した場合は、ctrl:value要素の内容が項目名として使用されます。

ctrl:select要素内で使用するときに設定する値については、「ctrl:select要素の項目の値を設定する場合」をご覧ください。

コントロール記述ボキャブラリの頂点要素に使用することはできません。

属性：

style

コントロールに適用するスタイルシートを記述する属性です。スタイルシートはCSSで記述します。使用できるスタイルシートのプロパティについては、「コントロール記述のCSSサポート状況」の「ctrl:static-label要素・ctrl:label要素・ctrl:item要素」をご覧ください。

省略された場合、適用するスタイルシートはないものと見なされます。

内容：

要素内には以下の要素を記述できます。

• ctrl:label要素
  必要に応じて、１つだけ記述できます。省略可能です。
• ctrl:value要素
  必ず１つ記述します。

ctrl:select1要素や ctrl:select要素の選択肢となる項目１つの値を記述する要素です。

コントロール記述ボキャブラリの頂点要素に使用することはできません。

属性：

属性はありません。

内容：

ctrl:value要素内には、 ctrl:item要素で保持される値となる文字列をPCDATA文字列で記述します。

コントロールの値が変更されたときに発行されるイベントです。次の要素で発行されます。

• ctrl:input要素
• ctrl:secret要素
• ctrl:textarea要素
• ctrl:range要素
• ctrl:select1要素
• ctrl:select要素
• ctrl:select-color要素

属性：

value （必須）

イベントが発行されたときにコントロールに設定されている値が設定される属性です。設定される値の内容は、コントロールによって異なります。

ctrl:input要素

type属性の値によって異なります。

type属性に値が設定されていない場合

入力されている文字列が設定されます。

type属性にbooleanが設定されている場合

trueまたはfalseが設定されます。

type属性にdateが設定されている場合

日付を表すCCYY-MM-DD形式の文字列が設定されます。

ctrl:secret要素 、ctrl:textarea要素

入力されている文字列が設定されます。

ctrl:range要素

入力されている数値が設定されます。コントロールで設定可能な範囲外の数値が入力されている場合は、入力可能な範囲内の数値に変換した値が設定されます。

ctrl:select1要素

選択されている項目に対応する ctrl:item要素の内容に記述されている ctrl:value要素の内容が設定されます。

ctrl:select要素

選択されている項目に対応するctrl:item要素の内容に記述されているctrl:value要素の内容を、半角空白で区切ってつないだ文字列が設定されます。

ctrl:select-color要素

選択されている色のRGB値を、#RRGGBBの形式で表現した文字列が設定されます。

内容：

ctrl:value-changed要素は、空要素です。

コントロール内でキャレットが移動したときに発行されるイベントです。次の要素で発行されます。

• type属性が指定されていない ctrl:input要素
• ctrl:textarea要素

属性：

offset （必須）

コントロールに入力されている文字列の先頭からのオフセット位置が設定される属性です。オフセット位置は、文字列の先頭を0とした整数値で表されます。

内容：

ctrl:caret-moved要素は、空要素です。

ctrl:trigger要素で作成されたコントロールがクリックされたときに発行されるイベントです。

属性：

属性はありません。

内容：

ctrl:triggered要素は、空要素です。