command 要素

command 要素は、ユーザーが呼び出すことができるコマンドを表します。この要素単体では何も行いません。onclick 属性などと組み合わせてスクリプトを実行するコマンドとなります。

menu 要素内で使用して、コンテクストメニューやツールバーの項目としたり、accesskey 属性と組み合わせることで、キーボードによる任意の操作を可能にするといったことが可能です。

command 要素は、HTML5 仕様書 (HTML5 W3C Recommendation 28 October 2014) には含まれていません。HTML 5.1 Nightly で策定が行われています。

さらに詳細な説明を見る

サンプルソースを見る

command 要素の仕様

カテゴリ
コンテンツモデル
この要素を使用できる文脈

メタデータ・コンテンツ、またはフレージング・コンテンツが期待される場所

この要素で使用できる属性

この要素に対して使用される title 属性は、特別な意味をもちます。

DOM インタフェース
interface HTMLCommandElement : HTMLElement {
           attribute DOMString type;
           attribute DOMString label;
           attribute DOMString icon;
           attribute boolean disabled;
           attribute boolean checked;
           attribute DOMString radiogroup;
  readonly attribute HTMLElement? command;
};

詳細説明

command 要素に指定できる属性は下記の通りです。

属性値 概要
label 属性 必須属性です。閲覧者に表示するコマンドのラベルを指定します。値は空でない文字列ある必要があります。
type 属性値 コマンドの種別を指定します。
icon 属性 閲覧者に表示するコマンドのアイコンを、画像ファイルの URI で指定します。
disabled 属性 この属性が指定された command 要素のコマンドを無効にします。
checked 属性 type 属性値が、checkbox または、radio の場合に、選択済みにします。
radiogroup 属性 type 属性値が、radio の場合に、グループ名を指定します。同一グループからは、1つしか選択できません。
command 属性 command 属性値に、文書内の他の場所に記述した command 要素の id 属性値を指定することで、別の場所で定義したコマンドを実行することができます。command 属性が付与された command 要素をスレーブコマンド。command 属性によって指定された id 属性を持つ command 要素をがマスターコマンドとなります。command 属性が付与された場合、type、label、icon、disabled、checked、radiogroup 属性は省略しなければなりません。

type 属性

type 属性で指定できるコマンドの種別は下記の通りです。

属性値 概要
command 通常のコマンド。(初期値)
checkbox チェックボックス。複数の選択が可能
radio ラジオボタン。同じグループから 1つだけ選択可能

title 属性

この要素におけるグローバル属性の title 属性は、コマンドに関するヒントを表す、特別な意味を持ちます。

command 要素のサンプルソース

<menu type="context">
 <command type="command" label="戻る" onclick="history.back(); " />
</menu>
<menu type="toolbar">
 <command type="radio" radiogroup="alignment" checked="checked" label="右寄せ" icon="icons/alL.png" onclick="setAlign('left')" />
 <command type="radio" radiogroup="alignment" label="中央寄せ" icon="icons/alC.png" onclick="setAlign('center')" />
 <command type="radio" radiogroup="alignment" label="右寄せ" icon="icons/alR.png" onclick="setAlign('right')" />
 <hr />
 <command type="command" disabled="disabled" label="出力" icon="icons/pub.png" onclick="publish()" />
</menu>

W3C HTML5 仕様書

4.11.3 The command element