yujunjun/playwright
1
0
Fork 0
mirror of https://github.com/microsoft/playwright.git synced 2025-06-26 21:40:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: update getByLabel docs to mention aria attributes (#21765)

Browse Source 
References #21624.
This commit is contained in:
Dmitry Gozman 2023-03-17 12:48:07 -07:00 committed by GitHub
parent 95e7d3aabc
commit f484b833ae
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 28 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/src/api/params.md
View File

@ -1430,34 +1430,40 @@ await page.GetByAltText("Playwright logo").ClickAsync();
## template-locator-get-by-label-text
Allows locating input elements by the text of the associated label.
Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
**Usage**
For example, this method will find the input by label text "Password" in the following DOM:
For example, this method will find inputs by label "Username" and "Password" in the following DOM:
```html
<input aria-label="Username">
<label for="password-input">Password:</label>
<input id="password-input">
```
```js
await page.getByLabel('Username').fill('john');
await page.getByLabel('Password').fill('secret');
```
```java
page.getByLabel("Username").fill("john");
page.getByLabel("Password").fill("secret");
```
```python async
await page.get_by_label("Username").fill("john")
await page.get_by_label("Password").fill("secret")
```
```python sync
page.get_by_label("Username").fill("john")
page.get_by_label("Password").fill("secret")
```
```csharp
await page.GetByLabel("Username").FillAsync("john");
await page.GetByLabel("Password").FillAsync("secret");
```

28
packages/playwright-core/types/types.d.ts vendored
View File

@ -2482,18 +2482,21 @@ export interface Page {
}): Locator;
/**
* Allows locating input elements by the text of the associated label.
* Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the
* `aria-label` attribute.
*
* **Usage**
*
* For example, this method will find the input by label text "Password" in the following DOM:
* For example, this method will find inputs by label "Username" and "Password" in the following DOM:
*
* ```html
* <input aria-label="Username">
* <label for="password-input">Password:</label>
* <input id="password-input">
* ```
*
* ```js
* await page.getByLabel('Username').fill('john');
* await page.getByLabel('Password').fill('secret');
* ```
*
@ -5900,18 +5903,21 @@ export interface Frame {
}): Locator;
/**
* Allows locating input elements by the text of the associated label.
* Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the
* `aria-label` attribute.
*
* **Usage**
*
* For example, this method will find the input by label text "Password" in the following DOM:
* For example, this method will find inputs by label "Username" and "Password" in the following DOM:
*
* ```html
* <input aria-label="Username">
* <label for="password-input">Password:</label>
* <input id="password-input">
* ```
*
* ```js
* await page.getByLabel('Username').fill('john');
* await page.getByLabel('Password').fill('secret');
* ```
*
@ -10855,18 +10861,21 @@ export interface Locator {
}): Locator;
/**
* Allows locating input elements by the text of the associated label.
* Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the
* `aria-label` attribute.
*
* **Usage**
*
* For example, this method will find the input by label text "Password" in the following DOM:
* For example, this method will find inputs by label "Username" and "Password" in the following DOM:
*
* ```html
* <input aria-label="Username">
* <label for="password-input">Password:</label>
* <input id="password-input">
* ```
*
* ```js
* await page.getByLabel('Username').fill('john');
* await page.getByLabel('Password').fill('secret');
* ```
*
@ -16692,18 +16701,21 @@ export interface FrameLocator {
}): Locator;
/**
* Allows locating input elements by the text of the associated label.
* Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the
* `aria-label` attribute.
*
* **Usage**
*
* For example, this method will find the input by label text "Password" in the following DOM:
* For example, this method will find inputs by label "Username" and "Password" in the following DOM:
*
* ```html
* <input aria-label="Username">
* <label for="password-input">Password:</label>
* <input id="password-input">
* ```
*
* ```js
* await page.getByLabel('Username').fill('john');
* await page.getByLabel('Password').fill('secret');
* ```
*