Webエリア
4Dメソッドコールを許可
Webエリアで実行される JavaScript コードから 4Dメソッドおよびクラス関数を呼び出して、戻り値を取得することができます。 4Dメソッドを Webエリアから呼び出せるようにするには、プロパティリストの "4Dメソッドコールを許可" にチェックをする必要があります。
この機能は Webエリアが 埋め込みWebレンダリングエンジンを使用 している場合に限り、使用可能です。
このプロパティがチェックされている場合、特別な JavaScript オブジェクト $4d が Webエリア内にインスタンス化され、これを使用して4Dプロジェクトメソッドおよび関数の呼び出しを管理 できるようになります。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| methodsAccessibility | string | "none" (デフォルト), "all" |
対象オブジェクト
進捗状況変数
倍長整数型変数の名前です。 この変数には 0 から 100 までの値が格納され、この数値は Webエリアに表示されるページのロードされたパーセンテージを表します。 手動で変更することはできません。
4D v19 R5 以降、Windows上では、Web エリアが 埋め込みWebレンダリングエンジン を使用している場合にのみ、この変数が更新されます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| progressSource | string | 倍長整数型変数の名前 |
対象オブジェクト
URL
文字列型の変数で、Webエリアにロードされた URL またはロード中の URL が格納されます。 変数と Webエリア間の連携は双方向でおこなわれます。
- ユーザーが新しい URL を変数に割り当てると、その URL は自動で Webエリアにロードされます。
- Webエリアでブラウズされると、自動で変数の内容が更新されます。
このエリアは Webブラウザーのアドレスバーのように機能します。 Webエリアの上側にテキストエリアを置いて、内容を表示させることができます。
URL変数と WA OPEN URL コマンド
URL 変数はWA OPEN URL と同じ効果を生み出します。 しかしながら、以下の違いに注意してください。
- ドキュメントにアクセスする場合、この変数は RFC準拠 ("file://c:/My%20Doc") な URL のみを受け付け、システムパス名 ("c:\MyDoc") は受け付けません。
WA OPEN URLコマンドは両方の記法を受け入れます。 - URL変数が空の文字列の場合、Webエリアは URL をロードしません。
WA OPEN URLコマンドは、この場合にはエラーを生成します。 - URL変数がプロトコル (http, mailto, file など) を含まない場合、Webエリアは "http://" を付加しますが、
WA OPEN URLコマンドはこれを付加しません。 - Webエリアがフォーム上で表示されていない場合 (フォームの別ページに Webエリアがある場合等)、
WA OPEN URLコマンドを実行しても効果はありません。 一方、URL変数に値を代入すると、カレントURL が更新されます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| urlSource | string | URL |
対象オブジェクト
コマンド
WA GET PREFERENCE - WA SET PREFERENCE
埋め込みWebレンダリングエンジンを使用
このオプションを使用して、Webエリアで使用する描画エンジンを 2つのうちから選択することができます:
- チェックなし -
JSON値: system(デフォルト): この場合、4Dはシステムの最適なエンジンを使用します。 この結果、HTML5 や JavaScript の最新 Web描画エンジンを自動的に利用できることになります。 しかし、プラットフォーム間で若干描画に違いがでることがあります。 Windows では、4Dは Microsoft Edge WebView2 を使用します。 macOS では、カレントバージョンの WebKit (Safari) です。 この結果、HTML5 や JavaScript の最新 Web描画エンジンを自動的に利用できることになります。 しかし、プラットフォーム間で若干描画に違いがでることがあります。 Windows では、4Dは Microsoft Edge WebView2 を使用します。 macOS では、カレントバージョンの WebKit (Safari) です。
Windows で Microsoft Edge WebView2がインストールされていない場合、4D はシステムのレンダリングエンジンとして埋め込みエンジンを使用します。 システムにインストールされているかどうかを確認するには、アプリケーションパネルで "Microsoft Edge WebView2 Runtime" を検索してください。
- チェックあり -
JSON値: embedded: この場合、4D は Chromium Embedded Framework (CEF) を使用します。 埋め込みWebレンダリングエンジンを使用すると、Webエリアの描画とその動作が (ピクセル単位での若干の相違やネットワーク実装に関連する違いを除き) プラットフォームに関わらず同じになります。 このオプションが選択されると、OS によりおこなわれる自動更新などの利点を得ることができなくなります。 使用エンジンの新バージョンは 4D のリリースを通して定期的に提供されます。
CEFエンジンには以下のような制約があります:
- WA SET PAGE CONTENT: このコマンドを使用する場合、(
WA OPEN URLコマンドを呼び出すかあるいはエリアに割り当てられた URL変数への代入を通して) 少なくとも既に 1ページがエリア内に読み込まれている必要があります。 - WA SET PREFERENCE コマンドの
WA enable URL dropセレクターによって URLドロップが許可されている場合、最初のドロップをする前に少なくとも 1度は WA OPEN URL コマンドを呼び出すか、またはエリアに割り当てられている URL 変数に URL が渡されている必要があります。
ローカルで 4DCEFParameters.json 設定ファイル を作成することで、CEFエリアのパラメーターをカスタマイズできます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| webEngine | string | "embedded", "system" |