特定のフォームの中にあるボタンをクリックするステップです。
「ボタン名」ボタンをクリックするとは異なり、このステップは
1つのページに複数のフォームがあり、それぞれのフォームに同じ名前のボタンがある場合に、ボタンをひとつに絞り込むことができます。
パラメータ
| パラメータ名 |
説明 |
フォーム名 |
<form>タグのid属性、または、<form>タグに含まれるテキストが利用可能。
|
ボタン名 |
id属性・name属性・value属性・title属性などが利用可能。
|
探索対象のフォーム
このステップが見つけることができる<form>は次の2種類のHTMLです。
<!-- 1. id属性が付いている -->
<form id="フォーム名">...</form>
<!-- 2. フォームの見出しテキストを含む -->
<form>...フォーム名...</form>
例えば、下記のように複数フォームがあるページで、「first_form」フォームの「field」フィールドの値が「value1」であることを実行すると、1つ目のフォームのフィールドの値をチェックします。
1つ目のフォームのid属性がfirst_formなので、これを手がかりにフォームを見つけるわけです。
一方、「2つ目のフォーム」フォームの「field」フィールドの値が「value2」であることという書き方では、2つ目のフォームのフィールドの値をチェックするようになります。
2つ目のフォームが「2つ目のフォーム」というテキストを含んでいるため、これがフォームを見つける手がかりになります。
テスト対象サイトの実装によっては、フォームが見出しテキストを持っています。
テキストは画面に見えるので、テキストでフォームを探す書き方のほうがステップが読みやすくなるメリットがあります。
<form id="first_form">
<div>1つ目のフォーム</div>
入力欄:<input type="text" name="field" value="value1">
</form>
<form id="second_form">
<div>2つ目のフォーム</div>
入力欄:<input type="text" name="field" value="value2">
</form>
探索対象のボタン
このステップは下記の順番でマッチする要素を探していきます。
<input type="submit" id="ボタン名"/>
<input type="submit" name="ボタン名"/>
<input type="submit" value="ボタン名"/>
<input type="submit" title="ボタン名"/>
<input type="image" id="ボタン名"/>
<input type="image" name="ボタン名"/>
<input type="image" value="ボタン名"/>
<input type="image" title="ボタン名"/>
<input type="image" alt="ボタン名"/>
<input type="button" id="ボタン名"/>
<input type="button" name="ボタン名"/>
<input type="button" value="ボタン名"/>
<input type="button" title="ボタン名"/>
<button id="ボタン名">...</button>
<button name="ボタン名"/>...</button>
<button value="ボタン名"/>...</button>
<button title="ボタン名"/>...</button>
<button>ボタン名</button>
<* role="button" id="ボタン名">...</*>
<* role="button" name="ボタン名">...</*>
<* role="button" value="ボタン名">...</*>
<* role="button" title="ボタン名">...</*>
<* role="button">ボタン名</*>
上記の*はタグ名を限定しないという意味です。
2つ目のボタンをクリックする例
同じページに、メディアユーザ・広告主ユーザそれぞれにログインフォームがあるページのサンプルです。
「http://docs.shouldbee.at/steps/PressButtonInForm/」に移動する
「広告主様ログイン」フォームの「メールアドレス」フィールドに「yamada@example.com」と入力する
「広告主様ログイン」フォームの「パスワード」フィールドに「p@ssW0rd」と入力する
「広告主様ログイン」フォームの「ログイン」ボタンをクリックする
アラートに「広告主としてログインしました。」と表示されていること
アラートを閉じる