Webエリア

ホーム

4D v20.2

デザインリファレンス

アクティブオブジェクトを使用する

Webエリア

Webエリアはフォーム中で静的および動的なHTMLページ、ファイル、ピクチャー、JavaScript などの様々なWeb用ファイルを表示することのできるオブジェクトです。

(*) WebプラグインとJavaアップレットの使用は推奨されていません。何故なら、特にイベント管理レベルにおいて4Dの動作を不安定にさせる可能性があるからです。

Webエリアの描画エンジンはアプリケーションの実行プラットフォームおよび埋め込みWebレンダリングエンジンを使用オプションの設定状態により異なります (次の章 "特別なプロパティ" 参照)。

同じフォーム内に複数のWebエリアを配置できます。しかしながら、Webエリアの挿入にはいくつかの制約がつく事に注意して下さい(以下の"位置はサポートされません"を参照して下さい)。

いくつかの標準アクション、ランゲージコマンド、そして汎用および専用のフォームイベントを使用して、開発者はWebエリアの動作を制御できます。特別な変数を使用してエリアと4D環境間で情報を交換できます。

この節ではフォームエディターにおけるWebエリアの利用や設定に関連する原則を説明します。このオブジェクトをプログラムで管理することに関する情報は、4DランゲージリファレンスマニュアルのWebエリアを参照してください。

またWebエリアを使用する際にはいくつか特別なルールに従わなくてはならない点に留意してください。この点についてはWebエリアの利用に際する注意点で説明しています。

特別なプロパティ

フォームエディターでWebエリアを選択すると、プロパティリストには専用のプロパティが表示されます:

コンテキストメニュー

Webエリアでコンテキストメニュープロパティ("入力"テーマ内)を設定すると、フォーム実行時にユーザーは標準のコンテキストメニューにアクセスできます。

メニューの内容はプラットフォームの描画エンジンにより設定されます。

注: WA SET PREFERENCEコマンドを使用してコンテキストメニューへのアクセスを制御できます。

割り当てられる変数

Webエリアには2つの特別な変数“URL”と“進捗状況”が自動で割り当てられます。これらの変数はそれぞれWebエリアに表示されているURL やロード中のページのパーセンテージを知るために使用できます。デフォルトでこれらの変数はそれぞれWebエリア_urlとWebエリア _progressという名前です。必要に応じてこの名称を変更できます。

これらの変数はWebエリアを選択した状態でプロパティリストで設定できます。

これらの変数の動作に関する詳細は4Dランゲージリファレンスマニュアルの Webエリアのプログラムによる管理を参照してください。

埋め込みWebレンダリングエンジンを使用する

このオプションを使用して、Webエリアで使用する描画エンジンを2つのうちから選択することができます:

"埋め込みWebレンダリングエンジンを使用する" がチェックされていない場合 (デフォルト): この場合4Dはシステムの最適なエンジンを使用します。
Windows では、4Dはマシンにインストールされた最新のブラウザ(IE11、MS Edge、等)を自動的に使用します。
MacではカレントバージョンのWebKit(Safari)です。
この結果自動的にHTMLファイルやJavaScriptの最新Web描画エンジンを利用できることになります。しかしInternet Explorer/EdgeとWeb Kit間で若干描画に違いがでることがあります。

"埋め込みWebレンダリングエンジンを使用する" がチェックされている場合: この場合、4DはGoogle のBlink を使用します。
埋め込みWebレンダリングエンジンを使用すると、Web エリアの描画とその動作が (ピクセル単位での若干の相違やネットワーク実装に関連する違いを除きプラットフォームに関わらず同じになります。
このオプションが選択されると、OS により行われる自動更新などの利点を得ることができなくなります。使用される WebKit の新バージョンは4D のリリースを通して提供されます。
ただし、Blink エンジンには以下のような制約があることに注意してください:
- WA SET PAGE CONTENT: このコマンドを使用する場合、(WA OPEN URL コマンドを呼び出すかあるいはエリアに割り当てられたURL 変数への代入を通して)少なくとも既に1ページがエリア内に読み込まれている必要があります。
- Blink でのWeb エリアにおいては、Java applet、JavaScript、およびプラグインの実行は常に許可されており、無効化することはできません。WA SET PREFERENCE および WA GET PREFERENCE コマンドでの以下のセレクターは無視されます:
  - WA enable Java applets
  - WA enable JavaScript
  - WA enable plugins
- WA SET PREFERENCE コマンドのWA enable URL drop セレクターによってURL ドロップが許可されている場合、最初のドロップをする前に少なくとも1度はWA OPEN URL コマンドを呼び出すかまたはエリアに割り当てられているURL 変数にURLが渡されている必要があります。

注意: Web エリアがインターネットに接続されている場合にはシステムのレンダリングエンジンを使用することが推奨されています。それであれば常に最新のセキュリティアップデートが利用できるからです。

4Dメソッドへのアクセス

このプロパティがチェックされている場合、特別なJavaScriptオブジェクト($4d)がWebエリア内に表示され、これを使用して4Dプロジェクトメソッドの呼び出しを管理することが出来るようになります。このオプションについての詳細な情報に関しては、 4D Language Reference マニュアルの Webエリアのプログラムによる管理セクションを参照して下さい。

注意:

このオプションは、埋め込みWebレンダリングエンジンを使用のオプションにチェックをしている場合のみ有効です。
4D コードを実行するという観点から、セキュリティ上の理由のため、このオプションは信頼できるページに対してのみ有効化するべきです(例えばアプリケーションで生成されたページなど)。

Webエリアは"スクロール可能"なサブフォームにおいてはサポートされません(スクロールしても期待される動作はしません)。
Webエリアのサイズは、それを内包するサブフォームのサイズを超えてはいけません(Webエリア全体が見えなければなりません)。
Webエリアを他のフォームオブジェクトの上に被せたり、または下にくぐらせることはサポートされていません。