Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Platform 4.2+

...

が必要

データサービスプラグインが必要

DataService

...

のシンタックス

このドキュメントでは、com.nexaweb.data.DataService

...

インターフェイスを使用してデータを UI にバインドするための宣言型シンタックスについて説明します。com.nexaweb.data.

...

The following methods are exposed for binding data to the UI using the "DataService" system service.

...

DataService インターフェイスは、プラグインを通じて提供されるシステムサービスです。詳細については、データ サービス プラグイン API javadoc を参照してください。

"DataService" システムサービスを使用してデータを UI にバインドするために、以下のメソッドが公開されています。

重要: 以下のメソッドは、テキスト解決シンタックスで使用したり、メソッド呼び出しの引数として使用したりできる、汎用のオブジェクトを返します。

DataService.bind( 'bind-string' )

Bind using the specified bind-string.

...


指定された

...

bind-string:

...

where Parameter format: name/value pairs separated by equals (name=value).

The following table lists the supported parameters for the bind-string:

...

セミコロンで区切られたパラメータのリスト
パラメータのフォーマット: 等号で区切られた名前と値のペア (名前=)
次の表に、
defaultValue
パラメータ
説明
必須/省略可能
type
バインディング タイプ: ONE_TIME
or
または ONE_WAY
If not supplied, defaults to
指定しない場合は、デフォルトで ONE_TIME になります。
Optional
省略可能
dataSource

The ID of a data source, or in the context of an iteration loop, this may be the name of an ancestor iterator. If not supplied the select will be executed relative to the parent iterator.

Required

The value to be returned when the data is unavailable or null.

Optional
formatter the formatter to use to alter the data for presentation in the ui 

Example

...

データ ソースの ID です。反復ループのコンテキストでは、祖先反復子の名前になることがあります。指定しない場合、親反復子に対して相対的に選択が実行されます。
必須
defaultValue
データが使用不可であるか、Null である場合に返される値です。
省略可能
formatter
データを UI でのプレゼンテーション用に変更するために使用するフォーマッタです。
 

例:

<label text="{ bind('dataSource=myDataSource;

...

select=/customers/customer[0]@name;

...

type=ONE_WAY')

...

}"/>

...


登録されているショートカット

bind
bind=DataService.bind
 
DataService.bind( binding://binding-id )

...


ID binding-id

...

であるバインディング定義を使用してバインドします。

Example

...


例:

<label text="{

...

...

}

...

"/>

...


登録されているショートカット

bind
bind=DataService.bind

DataService.relativeBind( 'select' )

Bind using the specified select string. The binding executes against the data source for the closest iterator ancestor, supplying the current iteration data as the context for the select.

Example

...


指定された select 文字列を使用してバインドします。バインディングは、最も近い祖先反復子のデータソースに対して実行され、現在の反復データが選択のコンテキストとして指定されます。

例:
<data:iterator dataSource="myDataSource"

...

select="/customers"

...

...

<label

...

text="{

...

*('customer[0]@name')

...

}"/>

...

...

...

Registered Shortcut

*
*

...

DataService.relativeBind を表します

DataService.relativeBind( 'iteratorNameOrDataSourceId', 'select' )

Bind using the specified select string. The binding executes relative to the current iteration of the iterator ancestor named iteratorNameOrDataSourceId, or directly against the specified data source with id iteratorNameOrDataSourceId without context.

Example: 

...


指定された select 文字列を使用してバインドします。バインディングは、iteratorNameOrDataSourceIdという名前の祖先反復子の現在の反復に対して相対的に実行されるか、ID iteratorNameOrDataSourceId である指定されたデータソースに対してコンテキストを使用せずに直接実行されます。

例:  
 
<data:iterator name="topIterator"

...

dataSource="myDataSource"

...

select="/customers"

...

...

<label

...

text="{

...

*('topIterator',

...

'customer[0]@name')

...

}"/>

...

...

 

...


登録されているショートカット
*
*

...

DataService.relativeBind を表します

bind-stringでサポートされるパラメータを示します。 bind-string を使用してバインドします。