From ee67ebe0ded4f76aba76850e2448ff71b9a0074a Mon Sep 17 00:00:00 2001 From: hoarfroster Date: Fri, 13 Sep 2024 21:22:15 +0800 Subject: [PATCH 1/4] feat: update translation --- .../api/extensiontypes/imagedetails/index.md | 71 +++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md new file mode 100644 index 00000000000000..eb9af7156c4c05 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md @@ -0,0 +1,71 @@ +--- +title: extensionTypes.ImageDetails +slug: Mozilla/Add-ons/WebExtensions/API/extensionTypes/ImageDetails +l10n: + sourceCommit: a16fecbf75f71fc11e03ef6cd0b0c34ad6f3d480 +--- + +{{AddonSidebar}} + +有关图片格式、质量、区域和缩放的详细信息。 + +## 类型 + +该类型的取值是对象，包含下列属性： + +- `format` {{optional_inline}} + - : {{WebExtAPIRef('extensionTypes.ImageFormat')}}。结果图片的格式，默认为 `"png"`。 +- `quality` {{optional_inline}} + - : `integer`。当格式是 `"jpeg"` 时，这将决定结果图片的质量。这应是 0—100 之间的数字并将转为 0—1 之间的值，传递为 [`HTMLCanvasElement.toDataURL()`](/zh-CN/docs/Web/API/HTMLCanvasElement/toDataURL) 方法的 `encoderOptions` 参数。若省略该属性则将使用 92 作为取值。随着质量的降低，结果图片将有更多视觉伪影，存储所需的字节数将减少。对于 PNG 图片，该值将被忽略。 +- `rect` {{optional_inline}} + + - : `object`，指定要捕获的文档区域，单位为 CSS 像素，相对于页面。所有属性默认为 `0`。这些属性是： + + - `x`：矩形左侧的坐标。 + - `y`：矩形顶部的坐标。 + - `width`：矩形的宽度。 + - `height`：矩形的高度。 + + 该选项在 Firefox 82 中引入。若省略，则捕获当前可见视口。 + +- `scale` {{optional_inline}} + - : `number`，渲染的比例，默认为 [`devicePixelRatio`](/zh-CN/docs/Web/API/Window/devicePixelRatio)。该选项在 Firefox 82 中引入。 + +## 浏览器兼容性 + +{{Compat}} + +{{WebExtExamples}} + +> [!NOTE] +> 此 API 基于 Chromium 的 [`chrome.extensionTypes`](https://developer.chrome.com/docs/extensions/reference/extensionTypes/#type-ImageDetails) API。该文档衍生自 Chromium 代码中的 [`extension_types.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/extension_types.json)。 + + From a9c0ed879d98c9fe8d103506ac46a699904d072b Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Fri, 13 Sep 2024 21:35:18 +0800 Subject: [PATCH 2/4] feat: improvements --- .../webextensions/api/extensiontypes/imagedetails/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md index eb9af7156c4c05..885f8035698c90 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md @@ -2,7 +2,7 @@ title: extensionTypes.ImageDetails slug: Mozilla/Add-ons/WebExtensions/API/extensionTypes/ImageDetails l10n: - sourceCommit: a16fecbf75f71fc11e03ef6cd0b0c34ad6f3d480 + sourceCommit: a16fecbf75f71fc11e03ef6cd0b0c34ad6f3d480 --- {{AddonSidebar}} @@ -16,7 +16,7 @@ l10n: - `format` {{optional_inline}} - : {{WebExtAPIRef('extensionTypes.ImageFormat')}}。结果图片的格式，默认为 `"png"`。 - `quality` {{optional_inline}} - - : `integer`。当格式是 `"jpeg"` 时，这将决定结果图片的质量。这应是 0—100 之间的数字并将转为 0—1 之间的值，传递为 [`HTMLCanvasElement.toDataURL()`](/zh-CN/docs/Web/API/HTMLCanvasElement/toDataURL) 方法的 `encoderOptions` 参数。若省略该属性则将使用 92 作为取值。随着质量的降低，结果图片将有更多视觉伪影，存储所需的字节数将减少。对于 PNG 图片，该值将被忽略。 + - : `integer`。当格式是 `"jpeg"` 时，这将决定结果图片的质量。这应是 0—100 之间的数字，并将被转换为 0—1 之间的取值，作为 [`HTMLCanvasElement.toDataURL()`](/zh-CN/docs/Web/API/HTMLCanvasElement/toDataURL) 方法的 `encoderOptions` 参数传递给函数。若该属性被省略，则将使用 92 作为取值。随着质量的降低，结果图片将有更多视觉伪影，存储所需的字节数将减少。对于 PNG 图片，该值将被忽略。 - `rect` {{optional_inline}} - : `object`，指定要捕获的文档区域，单位为 CSS 像素，相对于页面。所有属性默认为 `0`。这些属性是： @@ -26,7 +26,7 @@ l10n: - `width`：矩形的宽度。 - `height`：矩形的高度。 - 该选项在 Firefox 82 中引入。若省略，则捕获当前可见视口。 + 该选项在 Firefox 82 中引入。若省略该属性，则将捕获当前可见视口。 - `scale` {{optional_inline}} - : `number`，渲染的比例，默认为 [`devicePixelRatio`](/zh-CN/docs/Web/API/Window/devicePixelRatio)。该选项在 Firefox 82 中引入。 From 385d1e70ea8b22f717c567a6795e22a073c26e3c Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Fri, 20 Sep 2024 20:03:17 +0800 Subject: [PATCH 3/4] feat: improvements --- .../api/extensiontypes/imagedetails/index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md index 885f8035698c90..d7ec98f14325b8 100644 --- a/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/extensiontypes/imagedetails/index.md @@ -2,12 +2,12 @@ title: extensionTypes.ImageDetails slug: Mozilla/Add-ons/WebExtensions/API/extensionTypes/ImageDetails l10n: - sourceCommit: a16fecbf75f71fc11e03ef6cd0b0c34ad6f3d480 + sourceCommit: b8a0743ca8b1e1b1b1a95cc93a4413c020f11262 --- {{AddonSidebar}} -有关图片格式、质量、区域和缩放的详细信息。 +有关捕获图片格式、质量、区域和比例的详细信息。 ## 类型 @@ -16,7 +16,7 @@ l10n: - `format` {{optional_inline}} - : {{WebExtAPIRef('extensionTypes.ImageFormat')}}。结果图片的格式，默认为 `"png"`。 - `quality` {{optional_inline}} - - : `integer`。当格式是 `"jpeg"` 时，这将决定结果图片的质量。这应是 0—100 之间的数字，并将被转换为 0—1 之间的取值，作为 [`HTMLCanvasElement.toDataURL()`](/zh-CN/docs/Web/API/HTMLCanvasElement/toDataURL) 方法的 `encoderOptions` 参数传递给函数。若该属性被省略，则将使用 92 作为取值。随着质量的降低，结果图片将有更多视觉伪影，存储所需的字节数将减少。对于 PNG 图片，该值将被忽略。 + - : `integer`。当格式是 `"jpeg"` 时，这将决定结果图片的质量。这应是 0—100 之间的数字，并将被转换为 0—1 之间的取值作为 [`HTMLCanvasElement.toDataURL()`](/zh-CN/docs/Web/API/HTMLCanvasElement/toDataURL) 方法的 `encoderOptions` 参数传递给函数。在属性被忽略时将采用 92 作为默认取值。随着质量的降低，结果图片将有更多视觉伪影，存储所需的字节数也将减少。当图片格式设置为 PNG 时，该属性将被忽略。 - `rect` {{optional_inline}} - : `object`，指定要捕获的文档区域，单位为 CSS 像素，相对于页面。所有属性默认为 `0`。这些属性是： @@ -26,7 +26,7 @@ l10n: - `width`：矩形的宽度。 - `height`：矩形的高度。 - 该选项在 Firefox 82 中引入。若省略该属性，则将捕获当前可见视口。 + 该选项在 Firefox 82 中引入。若省略该属性，则将捕获当前可视视口。 - `scale` {{optional_inline}} - : `number`，渲染的比例，默认为 [`devicePixelRatio`](/zh-CN/docs/Web/API/Window/devicePixelRatio)。该选项在 Firefox 82 中引入。 @@ -38,7 +38,7 @@ l10n: {{WebExtExamples}} > [!NOTE] -> 此 API 基于 Chromium 的 [`chrome.extensionTypes`](https://developer.chrome.com/docs/extensions/reference/extensionTypes/#type-ImageDetails) API。该文档衍生自 Chromium 代码中的 [`extension_types.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/extension_types.json)。 +> 此 API 基于 Chromium 的 [`chrome.extensionTypes`](https://developer.chrome.com/docs/extensions/reference/api/extensionTypes/#type-ImageDetails) API。该文档衍生自 Chromium 代码中的 [`extension_types.json`](https://chromium.googlesource.com/chromium/src/+/master/extensions/common/api/extension_types.json)。