URLのオープン

URLを開くアクションは、外部URLに移動するために使用されます。 webアプリケーションでは、このアクションによって、現在のウィンドウまたはwindow.open() APIを使用した新規ウィンドウで、指定したURLが開きます。ネイティブ・モバイル・アプリケーションでは、このアクションによってローカル・ファイル添付およびリモート・リソースを開くことができます。

ネイティブ・モバイル・アプリケーションでは、このアクションはローカル・ファイル添付のオープンおよびリモート・リソースをサポートしています。 urlパラメータに許可されるファイル・タイプは:

.pdf
.doc
.txt
.text
.ppt
.rtf
.xls
.mp3
.mp4
.csv

初めて、ユーザーは特定のファイル・タイプを開くために使用するアプリケーションを選択するオプションを取得します。そのようなファイルを開くことができるアプリケーションがない場合、このアクションは適切なエラーで失敗します。ファイルを最初に開くと、デバイスにインストールされているすべてのVisual Builderアプリケーション全体で、常に同じアプリケーションで開かれます。

指定されたファイルがローカルでない場合、またはファイル拡張子が認識されない場合、このアクションではCordovaプラグインcordova-plugin-inappbrowserが使用され、指定されたURLが開きます。

次の表では、URLを開くアクションのパラメータについて説明します:

パラメータ名	説明
url	移動先のURL。
params	URLへの問合せパラメータとして使用されるキー/バリューのペア・マップ
hash	URLに追加するハッシュ・エントリ。
history	ブラウザの履歴への影響を定義します。許可されている値は'replace'または'push'です。値がreplaceの場合、現在のブラウザ履歴エントリが置き換えられ、つまり戻るボタンは戻りません。デフォルトはプッシュです。
windowName	`window.open()` APIで定義されているウィンドウを識別する名前(オプション)。定義していない場合、URLは現在のウィンドウで開きます。それ以外の場合は、`window.open()` APIのドキュメントを参照してください。モバイル・アプリケーションでは、3の使用可能な値があります: `_self`、`_blank`、または`_system`。デフォルトは`_self`です。 `cordova-plugin-inappbrowser`のドキュメントを参照してください。ローカル・ファイル・タイプの場合、このパラメータは無視されます。

現在のウィンドウでURLを開くwindowNameパラメータの値を指定した場合、URLのロケーションにブラウザの戻るボタンが最後のページを再入力します。ページ入力パラメータは、タイプが'fromCaller'の場合でも記憶されます。

次に、1つのパラメータが渡されるOpen URLアクションのコールの例を示します:

    await Actions.openUrl(context, {
        url: $variables.urlToOpen_pv,
        params: {
          inParam: $variables.itemID,
        },
        hash: $variables.hashPart_pv,
        history: 'push',
        windowName: '_self',
    });