Skip to content

Commit

Permalink
revert changes to files in other PRs
Browse files Browse the repository at this point in the history
  • Loading branch information
dipikabh committed Sep 17, 2024
1 parent 4efa5f0 commit 2b6d13b
Show file tree
Hide file tree
Showing 5 changed files with 55 additions and 41 deletions.
9 changes: 9 additions & 0 deletions files/en-us/web/manifest/name/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,15 @@ browser-compat: html.manifest.name

{{QuickLinksWithSubpages("/en-US/docs/Web/Manifest")}}

<table class="properties">
<tbody>
<tr>
<th scope="row">Type</th>
<td><code>String</code></td>
</tr>
</tbody>
</table>

The `name` member is a string that represents the name of the web application as it is usually displayed to the user (e.g., amongst a list of other applications, or as a label for an icon). `name` is directionality-capable, which means it can be displayed left-to-right or right-to-left based on the values of the [`dir`](/en-US/docs/Web/Manifest) and [`lang`](/en-US/docs/Web/Manifest) manifest members.

## Examples
Expand Down
15 changes: 9 additions & 6 deletions files/en-us/web/manifest/prefer_related_applications/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,16 +9,19 @@ browser-compat: html.manifest.prefer_related_applications

{{QuickLinksWithSubpages("/en-US/docs/Web/Manifest")}}{{SeeCompatTable}}

<table class="properties">
<tbody>
<tr>
<th scope="row">Type</th>
<td><code>Boolean</code></td>
</tr>
</tbody>
</table>

The `prefer_related_applications` member is a boolean value that specifies that applications listed in [`related_applications`](/en-US/docs/Web/Manifest/related_applications) should be preferred over the web application. If the `prefer_related_applications` member is set to `true`, the user agent might suggest installing one of the related applications instead of this web app.

If omitted, `prefer_related_applications` defaults to `false`.

## Syntax

```json
"prefer_related_applications": true
```

## Examples

```json
Expand Down
42 changes: 19 additions & 23 deletions files/en-us/web/manifest/related_applications/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,34 +9,20 @@ browser-compat: html.manifest.related_applications

{{QuickLinksWithSubpages("/en-US/docs/Web/Manifest")}}{{SeeCompatTable}}

<table class="properties">
<tbody>
<tr>
<th scope="row">Type</th>
<td><code>Array</code></td>
</tr>
</tbody>
</table>

The `related_applications` field is an array of objects specifying native applications that are installable by, or accessible to, the underlying platform — for example, a native Android application obtainable through the Google Play Store. Such applications are intended to be alternatives to the manifest's website that provides similar/equivalent functionality — like the native app equivalent.

> [!NOTE]
> Developer can specify that the native applications are preferred over the web application by setting `prefer_related_applications` to `true`.
## Syntax

```json
"related_applications": [
{
"platform": "<platform-keyword>",
"url": "<app-url>",
"id": "<app-id>"
}
]
```

### Values

Application objects may contain the following properties:

- `platform`
- : The platform on which the application can be found. [List of available values](https://github.com/w3c/manifest/wiki/Platforms)
- `url`
- : The URL at which the application can be found.
- `id`
- : The ID used to represent the application on the specified platform.

## Examples

```json
Expand All @@ -55,6 +41,16 @@ Application objects may contain the following properties:
]
```

## Related application properties

Application objects may contain the following properties:

| Member | Description |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `platform` | The platform on which the application can be found. [List of available values](https://github.com/w3c/manifest/wiki/Platforms) |
| `url` | The URL at which the application can be found. |
| `id` | The ID used to represent the application on the specified platform. |

## Specifications

{{Specifications}}
Expand Down
15 changes: 9 additions & 6 deletions files/en-us/web/manifest/short_name/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,16 @@ browser-compat: html.manifest.short_name

{{QuickLinksWithSubpages("/en-US/docs/Web/Manifest")}}

The `short_name` member is a string that represents the name of the web application displayed to the user if there is not enough space to display [`name`](/en-US/docs/Web/Manifest/name) (e.g., as a label for an icon on the phone home screen). `short_name` is directionality-capable, which means it can be displayed left-to-right or right-to-left based on the value of the [`dir`](/en-US/docs/Web/Manifest) and [`lang`](/en-US/docs/Web/Manifest) manifest members.

## Syntax
<table class="properties">
<tbody>
<tr>
<th scope="row">Type</th>
<td><code>String</code></td>
</tr>
</tbody>
</table>

```json
"name": "<short-app-name>"
```
The `short_name` member is a string that represents the name of the web application displayed to the user if there is not enough space to display [`name`](/en-US/docs/Web/Manifest/name) (e.g., as a label for an icon on the phone home screen). `short_name` is directionality-capable, which means it can be displayed left-to-right or right-to-left based on the value of the [`dir`](/en-US/docs/Web/Manifest) and [`lang`](/en-US/docs/Web/Manifest) manifest members.

## Examples

Expand Down
15 changes: 9 additions & 6 deletions files/en-us/web/manifest/start_url/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,19 +7,22 @@ browser-compat: html.manifest.start_url

{{QuickLinksWithSubpages("/en-US/docs/Web/Manifest")}}

<table class="properties">
<tbody>
<tr>
<th scope="row">Type</th>
<td><code>String</code></td>
</tr>
</tbody>
</table>

The `start_url` member is a string that represents the _start URL of the web application_ — the preferred URL that should be loaded when the user launches the web application (e.g., when the user taps on the web application's icon from a device's application menu or homescreen).

A valid `start_url` needs to be same-origin with the document that references the manifest. If `start_url` is unspecified or invalid in any way (such as not a string, not a valid URL, or not a same-origin with the document), the document URL is used.

> [!NOTE]
> The `start_url` member is purely advisory, and a user agent may ignore it or allow the user to alter it at install time or afterwards.
## Syntax

```json
"start_url": "<url>"
```

## Examples

### Absolute URL
Expand Down

0 comments on commit 2b6d13b

Please sign in to comment.