From 078756389d376e49c5063ac06a4fdaa6b53477be Mon Sep 17 00:00:00 2001 From: JasonLamv-t Date: Tue, 22 Aug 2023 09:01:12 +0800 Subject: [PATCH 1/3] [zh-cn]: Update translation of String.fontColor() --- .../global_objects/string/fontcolor/index.md | 37 +++++++++++-------- 1 file changed, 21 insertions(+), 16 deletions(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/fontcolor/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/fontcolor/index.md index c167d91baea2cb..2819669c1b9144 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/fontcolor/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/fontcolor/index.md @@ -5,50 +5,54 @@ slug: Web/JavaScript/Reference/Global_Objects/String/fontcolor {{JSRef}} {{deprecated_header}} -**`fontcolor()`**方法创建一个{{HTMLElement("font")}}的 HTML 元素让字符串被显示成指定的字体颜色。 +{{jsxref("String")}} 值的 **`fontcolor()`**方法会创建一个 {{HTMLElement("font")}} 元素字符串，其中嵌入了调用字符串（`str`），从而导致该字符串以指定的字体颜色显示。 -> **备注：** \ 元素已经在在[HTML5 中](/zh-CN/docs/Web/Guide/HTML/HTML5)被移除并且不应该在使用。替代的是，Web 开发者应该使用[CSS](/zh-CN/docs/Web/CSS)属性。 +> **备注：** 所有的 [HTML 包装方法](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#html_包装器方法)都已经被弃用，并且仅为了兼容性而标准化。对于 `fontcolor()` 方法来说，`` 元素本身在 [HTML5](/zh-CN/docs/Glossary/HTML5) 中已被移除，不应再使用。Web 开发者应该使用 [CSS](/zh-CN/docs/Web/CSS) 属性来代替。 ## 语法 -```plain -str.fontcolor(color) +```js-nolint +fontcolor(color) ``` ### 参数 - `color` - - : 代表颜色的一个字符串，可以是三个一组的十六进制的 RGB 值，也可以是一个颜色名称的字符串字面量，颜色名称的字符串字面量被列在了这里 [CSS 颜色参考](/zh-CN/docs/Web/CSS/color_value)。 + - : 该参数可以接受十六进制 RGB 三元组或字符串字面量来表示颜色。颜色名称的字符串字面量可以参考 [CSS 颜色参考](/zh-CN/docs/Web/CSS/color_value)。 ### 返回值 -一个包含一个{{HTMLElement("font")}} HTML 元素的字符串。 +一个以 `` 开头的字符串（`color` 中的双引号被替换为 `"`），然后是文本 `str`，最后以 `` 结束标记。 ## 描述 -如果你表示的颜色为十六进制 RGB 三原色，则必须使用的格式`rrggbb`。例如，对于橙红色的十六进制 RGB 值是红色=FA，绿色=80，和蓝=72，所以橙红色的 RGB 三原色`"FA8072"`。 +`fontcolor()` 方法本身只是简单地将字符串部分连接在一起，没有进行任何验证或规范化。然而，为了创建有效的 {{HTMLElement("font")}} 元素，如果你将颜色表示为十六进制 RGB 三元组，你必须使用格式 `rrggbb`。例如，salmon（鲑鱼色）的十六进制 RGB 值为红色 = FA，绿色=80，蓝色=72，因此 salmon 的 RGB 三元组为 `"FA8072"`。 ## 示例 -### 使用 `fontcolor()` +### 使用 fontcolor() -下面的示例使用`fontcolor()`方法来改变字符串的颜色，通过产生一个被 HTML \ 标签包裹的字符串。 +下面的示例使用 `fontcolor()` 方法通过生成一个带有 HTML `` 元素的字符串来改变字符串的颜色。 ```js -var worldString = "Hello, world" -console.log(worldString.fontcolor('red') + ' is red in this line'); -// Hello, world is red in this line" -console.log（worldString.fontcolor('FF00') + ' is red in hexadecimal' -// Hello，world is red in hexadecimal +const worldString = "Hello, world"; + +console.log(`${worldString.fontcolor("red")} is red in this line`); +// 'Hello, world is red in this line' + +console.log( + `${worldString.fontcolor("FF00")} is red in hexadecimal in this line` +); +// 'Hello, world is red in hexadecimal in this line' ``` -和{{domxref("HTMLElement.style","element.style")}}对象一起，你可以访问元素的`style`属性，并且更随意的去操纵它，例如： +使用 {{domxref("HTMLElement/style", "element.style")}} 对象，你可以获取元素的 `style` 属性并进行更通用的操作，例如： ```js document.getElementById("yourElemId").style.color = "red"; ``` -## Specifications +## 规范 {{Specifications}} @@ -58,4 +62,5 @@ document.getElementById("yourElemId").style.color = "red"; ## 参见 +- [`core-js` 的 `String.prototype.fontcolor` 的 polyfill](https://github.com/zloirock/core-js#ecmascript-string-and-regexp) - {{jsxref("String.prototype.fontsize()")}} From 484b7f0bf658a6121329317a3fc75206db951681 Mon Sep 17 00:00:00 2001 From: Jason Lam Date: Tue, 22 Aug 2023 09:06:24 +0800 Subject: [PATCH 2/3] Apply suggestions from code review Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- .../reference/global_objects/string/fontcolor/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/fontcolor/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/fontcolor/index.md index 2819669c1b9144..17e24eed3d8c21 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/fontcolor/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/fontcolor/index.md @@ -41,7 +41,7 @@ console.log(`${worldString.fontcolor("red")} is red in this line`); // 'Hello, world is red in this line' console.log( - `${worldString.fontcolor("FF00")} is red in hexadecimal in this line` + `${worldString.fontcolor("FF00")} is red in hexadecimal in this line`, ); // 'Hello, world is red in hexadecimal in this line' ``` From 0849f1ba768322f36bd45f065603d15e3bf06555 Mon Sep 17 00:00:00 2001 From: A1lo Date: Tue, 22 Aug 2023 09:28:08 +0800 Subject: [PATCH 3/3] Apply suggestions from code review --- .../reference/global_objects/string/fontcolor/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/fontcolor/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/fontcolor/index.md index 17e24eed3d8c21..67f648e86c8f34 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/fontcolor/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/fontcolor/index.md @@ -5,7 +5,7 @@ slug: Web/JavaScript/Reference/Global_Objects/String/fontcolor {{JSRef}} {{deprecated_header}} -{{jsxref("String")}} 值的 **`fontcolor()`**方法会创建一个 {{HTMLElement("font")}} 元素字符串，其中嵌入了调用字符串（`str`），从而导致该字符串以指定的字体颜色显示。 +{{jsxref("String")}} 值的 **`fontcolor()`** 方法会创建一个 {{HTMLElement("font")}} 元素字符串，其中嵌入了调用字符串（`str`），从而导致该字符串以指定的字体颜色显示。 > **备注：** 所有的 [HTML 包装方法](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#html_包装器方法)都已经被弃用，并且仅为了兼容性而标准化。对于 `fontcolor()` 方法来说，`` 元素本身在 [HTML5](/zh-CN/docs/Glossary/HTML5) 中已被移除，不应再使用。Web 开发者应该使用 [CSS](/zh-CN/docs/Web/CSS) 属性来代替。