プライマリ・コンテンツに移動

Oracle® Application Express APIリファレンス リリース5.1 E85937-02 |
| 目次 | 索引

前 | 次 |

# 14.11 ADD_VALUEファンクションのシグネチャ1

このファンクションは、二重引用符で囲まれたエスケープされたテキストを戻します。たとえば、`"That\'s a test"`のような文字列が戻されます。

注意:

このファンクションは、HTMLタグはエスケープしません。HTMLタグがJavaScriptオブジェクトの属性の割当てに悪影響を与えないようにするだけです。XSS(クロスサイト・スクリプティング)攻撃を防ぐには、`SYS.HTF.ESCAPE_SC`をコールして、HTMLページに文字列を差し込む際に、埋め込まれたJavaScriptコードが実行されるのを防ぐ必要もあります。

構文

    APEX_JAVASCRIPT.ADD_VALUE (
        p_value          IN VARCHAR2,
        p_add_comma      IN BOOLEAN :=TRUE)
    RETURN VARCHAR2;

パラメータ

表14-10 ADD_VALUEのシグネチャ1のパラメータ

パラメータ | 説明
--- | ---
`p_value` | エスケープされ、二重引用符で囲まれるテキスト。
`p_add_comma` | `p_add_comma`がTRUEの場合、後続のカンマが追加されます。

例

次の例では、onloadバッファにいくつかのJavaScriptコードを追加します。`p_item.attribute_01`の値を、まず、XSS攻撃を防ぐために`htf.escape_sc`でエスケープし、`apex_javascript.add_value`をコールしてJavaScript変数`lTest`に割り当てます。`Add_value`は、値を適切にエスケープし、二重引用符で囲みます。カンマは不要なため、`p_add_comma`はFALSEに設定します。

    apex_javascript.add_onload_code (
        'var lTest = '||apex_javascript.add_value(sys.htf.escape_sc(p_item.attribute_01), FALSE)||';'||chr(10)||
        'showMessage(lTest);' );