日日是Oracle APEX: APEX 26.1で追加されたボタンの属性「無効として表示」を確認する

2026年6月18日木曜日

APEX 26.1で追加されたボタンの属性「無効として表示」を確認する

Oracle APEX 26.1でボタンの属性として「無効として表示」が追加されました。オンラインヘルプの説明は以下です。

定義されたサーバー側の条件がFALSEと評価される場合に、ボタンまたはメニュー・エントリを非表示にするのではなく、無効としてレンダリングするかどうかを指定します。

今ひとつピンとこなかったので、動作について確認してみました。

以下のようにページを作成し、ページ・アイテムP1_ITEM1とP1_ITEM2の間にボタンBUTTONを配置します。

このとき、ボタンの外観の無効として表示がオフ（これが26.1以前の設定です）で、サーバー側の条件がfalseになるとき、ページは以下のように表示されます。ボタン要素は生成されず、ページにボタン要素が無いため、ページに表示されません。

このとき都合が悪いのは、ページのレイアウトが崩れることです。

APEX 26.1で新たに追加された無効として表示をオンにすると、サーバー側の条件がfalseのときに、ボタンは無効の状態で表示されます。ページのレイアウトは変わりません。

サーバー側の条件でボタンを除外するのは、単に無効にするだけではなく、ボタンに紐づけた動作の呼び出しをブラウザから直接実行されるのを防ぐ効果があります。ボタン要素がページ上に存在しないので、JavaScriptコンソールから直接呼び出してクリックすることはできません。

レイアウトを崩さないようにするため、サーバー側の条件の代わりにページ・ロード時にボタンを無効化する動的アクションを作成できます。

このようにした場合、以下のように表示上は同じであり、ボタンはクリックできなくなっています。

しかし、動的アクションの有効化を呼び出すか、それと等価な処理をブラウザ上で実行すると、ボタンを押せるようになります。

ボタンを押せるようになると、ブラウザのJavaScriptコンソールより以下のようなコードを実行することで、ボタンに紐づいたアクションを実行できます（ボタンにHTML DOM IDとしてmyButtonを割り当ててあります - 26.1から詳細の静的IDはHTML DOM IDという属性名に変わっています）。

document.getElementById("myButton").click();