Skip to content

Commit

Permalink
update
Browse files Browse the repository at this point in the history
  • Loading branch information
skyclouds2001 authored Sep 19, 2024
1 parent af9727e commit 7865629
Show file tree
Hide file tree
Showing 2 changed files with 27 additions and 30 deletions.
23 changes: 6 additions & 17 deletions files/zh-cn/web/api/notification/notification/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,42 +28,31 @@ new Notification(title, options)
- : 一个包含要应用于通知的任何自定义设置的选项对象。可能的选项有:

- `actions` {{optional_inline}}

- : 要在通知中显示的一系列操作的数组,默认为一个空数组。数组中的每个元素都是一个具有以下成员的对象:

- `action`
- : 一个标识要在通知上显示的用户操作的字符串。
- `title`
- : 一个包含要向用户显示的操作文本的字符串。
- `icon` {{optional_inline}}
- : 一个包含与操作一起显示的图标 URL 的字符串。

使用 {{domxref("ServiceWorkerGlobalScope.notificationclick_event", "notificationclick")}} 事件中的 `event.action` 构建适当的响应。

- : 必须未指定或为空数组。`actions` 仅支持使用 {{domxref("ServiceWorkerRegistration.showNotification()")}} 从 service worker 触发的持久通知。
- `badge` {{optional_inline}}
- : 一个包含图像 URL 的字符串,用于在没有足够空间显示通知本身时表示通知。
- : 一个包含图像 URL 的字符串,用于在没有足够空间显示通知本身时表示通知;例如,Android 通知栏。在 Android 设备上,徽章应适应高达 4 倍分辨率的设备,大约 96x96px,并且图像将被自动遮罩
- `body` {{optional_inline}}
- : 一个表示通知正文的字符串,显示在标题下方,默认值是一个空字符串。
- `data` {{optional_inline}}
- : 任意你想要与通知关联的数据。它可以是任何数据类型。默认值为 `null`
- : 任意你想要与通知关联的数据。它可以是任何[可结构化克隆](/zh-CN/docs/Web/API/Web_Workers_API/Structured_clone_algorithm#支持的类型)的数据类型。默认值为 `null`
- `dir` {{optional_inline}}
- : 显示通知的方向。它默认为 `auto`,即只采用浏览器的语言设置行为,但你可以通过设置 `ltr``rtl` 的值来覆盖该行为(尽管大多数浏览器似乎忽略这些设置)。
- `icon` {{optional_inline}}
- : 一个包含要在通知中显示的图标的 URL 的字符串。
- `image` {{optional_inline}}
- : 一个包含要在通知中显示的图像的 URL 的字符串。
- `lang` {{optional_inline}}
- : 指定通知的语言,根据 {{RFC(5646, "识别语言的标签(也被称为 BCP47)")}}使用表示语言标签的字符串指定。请参阅 Sitepoint [ISO 2 字母语言代码](https://www.sitepoint.com/iso-2-letter-language-codes/)页面以获取简单参考。
- : 指定通知的语言,根据 {{RFC(5646, "识别语言的标签(也被称为 BCP47)")}}使用表示语言标签的字符串指定。请参阅 Sitepoint [ISO 2 字母语言代码](https://www.sitepoint.com/iso-2-letter-language-codes/)页面以获取简单参考。默认值为空字符串。
- `renotify` {{optional_inline}}
- : 一个布尔值,指定在新通知替换旧通知后是否应通知用户。默认值为 `false`这意味着他们不会收到通知。如果该值被指定为 `true`,那么必须同时设置 `tag` 参数。
- : 一个布尔值,指定在新通知替换旧通知后是否应通知用户。默认值为 `false`这意味着用户不会收到通知。如果该值被指定为 `true`,那么必须同时设置 `tag` 参数。
- `requireInteraction` {{optional_inline}}
- : 指示通知应保持活动状态,直到用户单击或关闭它,而不是自动关闭。默认值为 `false`
- `silent` {{optional_inline}}
- : 一个布尔值,指定通知是否静音(不发出声音或振动),无论设备设置如何。默认值 `null` 表示使用设备默认值。如果被设置为 `true`,那么不能同时存在 `vibrate` 参数。
- `tag` {{optional_inline}}
- : 一个表示通知的识别标签的字符串,默认值是一个空字符串。
- `timestamp` {{optional_inline}}
- : 一个表示通知创建或适用的时间(过去、现在或将来)的数字
- : 一个以毫秒为单位表示为 {{glossary("Unix time", "Unix 时间")}}的时间戳,表示与通知相关的时间。当通知用于发送由于设备离线而无法立即发送的消息时,该时间戳可能是过去的时间,或者用于即将开始的会议的未来时间
- `vibrate` {{optional_inline}}
- : 设备振动硬件随通知一起发出的[振动模式](/zh-CN/docs/Web/API/Vibration_API#振动模式)。当该值被指定时,`silent` 参数不得设置为 `true`

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,14 +19,14 @@ showNotification(title, options)
### 参数

- `title`
- : 通知中必须显示的标题
- : 定义通知的标题,显示在通知窗口的顶部
- `options` {{optional_inline}}

- : 允许配置通知的对象。它可以具有以下属性:

- `actions` {{optional_inline}} {{experimental_inline}}

- : 要在通知中显示的一系列操作的数组。数组中的每个元素都是一个具有以下成员的对象:
- : 要在通知中显示的一系列操作的数组,默认值为空数组。数组中的每个元素都是一个具有以下成员的对象:

- `action`
- : 一个标识要在通知上显示的用户操作的字符串。
Expand All @@ -38,31 +38,31 @@ showNotification(title, options)
使用 {{domxref("ServiceWorkerGlobalScope.notificationclick_event", "notificationclick")}} 事件中的 `event.action` 构建适当的响应。

- `badge` {{optional_inline}} {{experimental_inline}}
- : 一个当没有足够的空间来显示通知本身(例如 Android 通知栏)时来表示通知的图像 URL 的字符串。在 Android 设备上,徽章应适应高达 4 倍分辨率(约 96 x 96 像素)的设备,并且图像将自动屏蔽
- : 一个当没有足够的空间来显示通知本身(例如 Android 通知栏)时来表示通知的图像 URL 的字符串。在 Android 设备上,徽章应适应高达 4 倍分辨率(约 96 x 96 像素)的设备,并且图像将被自动遮罩
- `body` {{optional_inline}}
- : 表示要在通知中显示的额外内容的字符串
- : 一个表示通知正文的字符串,显示在标题下方,默认值是一个空字符串
- `data` {{optional_inline}} {{experimental_inline}}
- : 你想要与通知关联的任意数据。这可以是任何数据类型
- : 你想要与通知关联的任意数据。它可以是任何[可结构化克隆](/zh-CN/docs/Web/API/Web_Workers_API/Structured_clone_algorithm#支持的类型)的数据类型。默认值为 `null`
- `dir` {{optional_inline}}
- : 表示通知的方向;它可以是 `auto``ltr` `rtl`
- : 表示通知的方向。默认为 `auto`,即采用浏览器的语言设置行为,但你可以通过设置 `ltr` `rtl` 的值来覆盖该行为(尽管大多数浏览器似乎会忽略这些设置)
- `icon` {{optional_inline}}
- : 一个包含要在通知中显示的图标的 URL 的字符串。
- `image` {{optional_inline}} {{experimental_inline}}
- : 一个包含要在通知中显示的图像的 URL 的字符串。
- `lang` {{optional_inline}}
- : 指定通知中使用的语言。根据 {{RFC(5646, "识别语言的标签(也被称为 BCP47)")}},此字符串必须是有效的语言标签
- : 指定通知的语言,根据 {{RFC(5646, "识别语言的标签(也被称为 BCP47)")}}使用表示语言标签的字符串指定。请参阅 Sitepoint [ISO 2 字母语言代码](https://www.sitepoint.com/iso-2-letter-language-codes/)页面以获取简单参考。默认值为空字符串
- `renotify` {{optional_inline}} {{experimental_inline}}
- : 一个布尔值,指示重复使用 `tag` 值时是否阻止振动和声音提醒。如果 _options_ 参数的 `renotify` 属性为 `true` 并且 _options_ 参数的 `tag` 属性是空字符串,则会抛出 `TypeError`。默认为 `false`
- : 一个布尔值,指示重复使用 `tag` 值时是否阻止振动和声音提醒。默认为 `false`,表示不会通知。如果为 `true`,则还必须设置 `tag` 参数
- `requireInteraction` {{optional_inline}} {{experimental_inline}}
- : 指示在屏幕足够大的设备上,通知应保持活动状态,直到用户单击或关闭它。如果此值不存在或为 `false`,桌面版 Chrome 将在大约二十秒后自动最小化通知。默认值为 `false`
- : 表示通知应保持活动状态直到用户点击或关闭它,而不是自动关闭。默认值为 `false`
- `silent` {{optional_inline}}
- : 设置后表示不应发出声音或振动。如果 _options_ 参数的 `silent` 属性为 `true` 并且 _options_ 参数的 `vibrate` 属性存在,则会抛出 `TypeError` 异常。默认值为 `null`,表示使用设备默认值
- : 一个布尔值,用于指定通知是否静音(不发出声音或振动),无论设备设置如何。默认值为 `null`,表示遵循设备默认值。如果为 `true`,则 `vibrate` 参数不得指定
- `tag` {{optional_inline}}
- : 给定通知的 ID,允许你在必要时使用脚本查找、替换或删除通知
- : 表示通知的标签的字符串。默认值为空字符串
- `timestamp` {{optional_inline}}
- : 一个时间戳,以毫秒为单位的 {{glossary("Unix time")}},表示与通知关联的时间。这可能是在过去,当通知用于因设备离线而无法立即发送的消息时,或者在将来,当通知用于即将开始的会议时。
- : 一个时间戳,以毫秒为单位的 {{glossary("Unix time", "Unix 时间")}},表示与通知关联的时间。这可能是在过去,当通知用于因设备离线而无法立即发送的消息时,或者在将来,当通知用于即将开始的会议时。
- `vibrate` {{optional_inline}} {{experimental_inline}}
- : 一个与通知显示一起运行的振动模式。振动模式可以是只有一个成员的阵列。这些值是以毫秒为单位的时间,其中偶数索引(0、2、4 等)表示振动多长时间,奇数索引表示暂停多长时间。例如,`[300, 100, 400]` 会振动 300 毫秒,暂停 100 毫秒,然后振动 400 毫秒
- : 设备振动硬件随通知一起发出的[振动模式](/zh-CN/docs/Web/API/Vibration_API#振动模式)。当该值被指定时,`silent` 参数不得设置为 `true`

### 返回值

Expand All @@ -72,6 +72,14 @@ showNotification(title, options)

- `TypeError`
- : 如果当前 Service Worker 的状态不是 `activating``activated`,或者用户明确拒绝了浏览器使用 API 的权限请求,则抛出该异常。
- {{jsxref("TypeError")}}
- : 如果满足以下条件之一,则抛出该异常:
- 当前 service worker 的状态不是 `activating``activated`
- 用户已明确拒绝浏览器使用该 API 的权限请求。
- `silent` 选项是 `true``vibrate` 选项被同时指定。
- `renotify` 选项是 `true` 但是 `tag` 选项为空值。
- `DataCloneError` {{domxref("DOMException")}}
- : 若由于某种原因序列化 `data` 选项失败,则抛出该异常。

## 示例

Expand Down

0 comments on commit 7865629

Please sign in to comment.