メインコンテンツまでスキップ
バージョン: 20 R5 BETA

Webエリア

4Dメソッドコールを許可​

Webエリアで実行される JavaScripe コードから 4Dメソッドを呼び出して、戻り値を取得することができます。 4Dメソッドを Webエリアから呼び出せるようにするには、プロパティリストの "4Dメソッドコールを許可" にチェックをする必要があります。

この機能は Webエリアが 埋め込みWebレンダリングエンジンを使用 している場合に限り、使用可能です。

このプロパティがチェックされている場合、特別な JavaScript オブジェクト $4d が Webエリア内にインスタンス化され、これを使用して4Dプロジェクトメソッドの呼び出しを管理 できるようになります。

JSON 文法​

名称データタイプとりうる値
methodsAccessibilitystring"none" (デフォルト), "all"

対象オブジェクト​

Web Area

進捗状況変数​

倍長整数型変数の名前です。 この変数には 0 から 100 までの値が格納され、この数値は Webエリアに表示されるページのロードされたパーセンテージを表します。 この変数は 4D が自動で更新します。手動で変更することはできません。

4D v19 R5 以降、Windows上では、Web エリアが 埋め込みWebレンダリングエンジン を使用している場合にのみ、この変数が更新されます。

JSON 文法​

名称データタイプとりうる値
progressSourcestring倍長整数型変数の名前

対象オブジェクト​

Web Area

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 コマンドはこれを付加しません。
  • When the Web area is not displayed in the form (when it is located on another page of the form), executing the WA OPEN URL command has no effect, whereas assigning a value to the URL variable can be used to update the current URL.

JSON 文法​

名称データタイプとりうる値
urlSourcestringURL

対象オブジェクト​

Web Area

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

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

  • チェックなし - JSON値: system (デフォルト): この場合、4Dはシステムの最適なエンジンを使用します。 この結果、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: using this command requires that at least one page is already loaded in the area (through a call to WA OPEN URL or an assignment to the URL variable associated to the area).
  • When URL drops are enabled by the WA enable URL drop selector of the WA SET PREFERENCE command, the first drop must be preceded by at least one call to WA OPEN URL or one assignment to the URL variable associated to the area.

JSON 文法​

名称データタイプとりうる値
webEnginestring"embedded", "system"

対象オブジェクト​

Web Area