From 9f4ae674a3f256e637b6539363f76a323e96f20c Mon Sep 17 00:00:00 2001 From: Mars Yao Date: Tue, 16 Mar 2021 01:40:33 +0800 Subject: Add and translate pages about @property. (#171) * 'add_@property_contents' --- files/zh-cn/web/css/@property/index.html | 89 ++++++++++++++ files/zh-cn/web/css/@property/inherits/index.html | 100 ++++++++++++++++ .../web/css/@property/initial-value/index.html | 101 ++++++++++++++++ files/zh-cn/web/css/@property/syntax/index.html | 128 +++++++++++++++++++++ 4 files changed, 418 insertions(+) create mode 100644 files/zh-cn/web/css/@property/index.html create mode 100644 files/zh-cn/web/css/@property/inherits/index.html create mode 100644 files/zh-cn/web/css/@property/initial-value/index.html create mode 100644 files/zh-cn/web/css/@property/syntax/index.html diff --git a/files/zh-cn/web/css/@property/index.html b/files/zh-cn/web/css/@property/index.html new file mode 100644 index 0000000000..164b4d5b21 --- /dev/null +++ b/files/zh-cn/web/css/@property/index.html @@ -0,0 +1,89 @@ +--- +title: '@property' +slug: Web/CSS/@property +tags: + - At-rule + - CSS + - Reference + - Web + - Property + - Houdini +--- +
{{CSSRef}}{{SeeCompatTable}}
+ +

@property CSS {{cssxref("at-rule")}}是CSS Houdini API的一部分, 它允许开发者显式地定义他们的{{cssxref('--*', 'CSS自定义属性')}}, 允许进行属性类型检查、设定默认值以及定义该自定义属性是否可以被继承。

+ +

@property 规则提供了一个直接在样式表中注册自定义属性的方式，而无需运行任何JS代码。有效的 @property 规则会注册一个自定义属性, 就像 {{domxref('CSS.registerProperty')}} 函数被使用同样的参数调用了一样。

+ +

Syntax(语法描述符)

+ +
@property --property-name {
+  syntax: '<color>';
+  inherits: false;
+  initial-value: #c0ffee;
+}
+ +

一个有效的 @property 规则代表一项自定义属性的注册,使用自定义属性名作为规则内代码序列的序部。

+ +

@property 规则中 syntax 和 inherits 描述符是必需的; 如果其中任何一项缺失, 整条规则都将失效并且会被忽略。 initial-value 描述符仅在syntax描述符为通用syntax定义时是可选的，否则initial-value也是必需的——如果此时该描述符缺失,整条规则都将失效且被忽略。

+ +

未知的描述符自身都是无效的，且会被忽略。但是不会造成整条@property规则的失效。

+ +

实例

+ +

为 --my-color {{cssxref('--*', '自定义属性')}}添加颜色值类型检测、设置默认值并且设置属性值不允许被继承。

+ +

使用 CSS {{cssxref('@property')}} 规则:

+ +
@property --my-color {
+  syntax: '<color>';
+  inherits: false;
+  initial-value: #c0ffee;
+}
+
+ +

使用 JavaScript中的 {{domxref('CSS.registerProperty')}}函数:

+ +
window.CSS.registerProperty({
+  name: '--my-color',
+  syntax: '<color>',
+  inherits: false,
+  initialValue: '#c0ffee',
+});
+
+ +

标准语法

+ +
{{csssyntax}}
+ +

规范

+ + + + + + + + + + + + + + +
规范状态提案
{{SpecName('CSS Properties and Values API', '#at-property-rule')}}{{Spec2('CSS Properties and Values API')}}初始定义.
+ +

浏览器兼容性

+ + + +

{{Compat("css.at-rules.property")}}

+ +

另见

+ + diff --git a/files/zh-cn/web/css/@property/inherits/index.html b/files/zh-cn/web/css/@property/inherits/index.html new file mode 100644 index 0000000000..c2421f9535 --- /dev/null +++ b/files/zh-cn/web/css/@property/inherits/index.html @@ -0,0 +1,100 @@ +--- +title: '继承性' +slug: Web/CSS/@property/inherits +tags: + - CSS + - Reference + - Web + - Property + - Houdini +--- +
{{CSSRef}}{{SeeCompatTable}}
+ +

inherits CSS 描述符在使用{{cssxref("@property")}} {{cssxref("at-rule")}}时是必需的，它控制由 @property声明注册的自定义属性默认情况下是否会被继承。

+ +

Syntax（类型描述符）

+ +
@property --property-name {
+  syntax: '<color>';
+  inherits: false;
+  initial-value: #c0ffee;
+}
+
+@property --property-name {
+  syntax: '<color>';
+  inherits: true;
+  initial-value: #c0ffee;
+}
+
+ +

取值

+ +
+
true
+
属性默认继承
+
false
+
属性默认不继承
+
+ +

规范定义

+ +

{{cssinfo}}

+ +

标准语法

+ +
{{csssyntax}}
+ +

实例

+ +

为 --my-color {{cssxref('--*', '自定义属性')}}添加颜色值类型检测、设置默认值并且设置属性值不允许被继承。

+ +

使用 CSS {{cssxref('@property')}} @规则:

+ +
@property --my-color {
+  syntax: '<color>';
+  inherits: false;
+  initial-value: #c0ffee;
+}
+
+ +

使用 JavaScript中的 {{domxref('CSS.registerProperty')}}函数:

+ +
window.CSS.registerProperty({
+  name: '--my-color',
+  syntax: '<color>',
+  inherits: false,
+  initialValue: '#c0ffee',
+});
+
+ +

规范

+ + + + + + + + + + + + + + +
规范状态提议
{{SpecName('CSS Properties and Values API', '#inherits-descriptor', 'inherits')}}{{Spec2('CSS Properties and Values API')}}初始定义.
+ +

浏览器兼容性

+ + + +

{{Compat("css.at-rules.property.inherits")}}

+ +

另见

+ + \ No newline at end of file diff --git a/files/zh-cn/web/css/@property/initial-value/index.html b/files/zh-cn/web/css/@property/initial-value/index.html new file mode 100644 index 0000000000..61363a59fb --- /dev/null +++ b/files/zh-cn/web/css/@property/initial-value/index.html @@ -0,0 +1,101 @@ +--- +title: '初始值' +slug: Web/CSS/@property/initial-value +tags: + - CSS + - Reference + - Web + - Property + - Houdini +--- + +
{{CSSRef}}{{SeeCompatTable}}
+ +

initial-value CSS描述符在使用{{cssxref("@property")}} {{cssxref("at-rule")}}的时候是必需的，除非syntax属性接受了任何有效的token流。 它为属性设置初始值。

+ +

被选定为initial-value的参数，依照syntax描述符定义，必须可以正确地解析。 因此,如果syntax描述符为<color>，那么初始值必须是一个有效的{{cssxref("color")}}值。

+ +

语法

+ +
@property --property-name {
+  syntax: '<color>';
+  inherits: false;
+  initial-value: #c0ffee;
+}
+
+@property --property-name {
+  syntax: '<color>';
+  inherits: true;
+  initial-value: #c0ffee;
+}
+ +

取值

+ +

对于设定的syntax，具有正确值的字符串。

+ +

标准定义

+ +

{{cssinfo}}

+ +

标准语法

+ +
{{csssyntax}}
+ +

实例

+ +

为 --my-color {{cssxref('--*', '自定义属性')}}添加颜色值类型检测、设置默认值并且设置属性值不允许被继承。

+ +

使用 CSS {{cssxref('@property')}} 规则:

+ +
@property --my-color {
+  syntax: '<color>';
+  inherits: false;
+  initial-value: #c0ffee;
+}
+
+ +

使用 JavaScript中的 {{domxref('CSS.registerProperty')}}函数:

+ +
window.CSS.registerProperty({
+  name: '--my-color',
+  syntax: '<color>',
+  inherits: false,
+  initialValue: '#c0ffee',
+});
+
+ +

标准语法

+ +
{{csssyntax}}
+ +

规范

+ + + + + + + + + + + + + + +
规范状态提案
{{SpecName('CSS Properties and Values API', '#at-property-rule')}}{{Spec2('CSS Properties and Values API')}}初始定义.
+ +

浏览器兼容性

+ + + +

{{Compat("css.at-rules.property")}}

+ +

另见

+ + diff --git a/files/zh-cn/web/css/@property/syntax/index.html b/files/zh-cn/web/css/@property/syntax/index.html new file mode 100644 index 0000000000..ab6fae937d --- /dev/null +++ b/files/zh-cn/web/css/@property/syntax/index.html @@ -0,0 +1,128 @@ +--- +title: syntax +slug: Web/CSS/@property/syntax +tags: + - CSS + - Reference + - Web + - Property + - Houdini +--- +
{{CSSRef}}{{SeeCompatTable}}
+ +

syntax CSS 描述符在使用{{cssxref("@property")}} {{cssxref("at-rule")}}时是必需的，它描述了该属性所允许的语法结构。

+ +

Syntax

+ +

如下是所有的有效syntax字符串:

+ +
syntax: '<color>'; /* 接收一个颜色值 */
+
+syntax: '<length> | <percentage>'; /* 接收长度或百分比参数，但是二者之间不进行计算合并 */
+
+syntax: 'small | medium | large'; /* 接收这些参数值之一作为自定义标识符 */
+
+syntax: '*'; /* 任何有效字符 */
+
+ +

取值

+ +

规范定义的、受语法支持的字符串。支持的语法是CSS types的子集。 这些可以单独使用，一些类型也可以结合使用。

+ +
+
"<length>"
+
任何有效的 {{cssxref("<length>")}} 值.
+
"<number>"
+
任何有效的 {{cssxref("<number>")}} 值.
+
"<percentage>"
+
任何有效的 {{cssxref("<percentage>")}} 值.
+
"<length-percentage>"
+
任何有效的 {{cssxref("<length-percentage>")}} 值.
+
"<color>"
+
任何有效的 {{cssxref("<color>")}} 值.
+
"<image>"
+
任何有效的 {{cssxref("<image>")}} 值.
+
"<url>"
+
任何有效的 {{cssxref("url()","url()")}} 值.
+
"<integer>"
+
任何有效的 {{cssxref("<integer>")}} 值.
+
"<angle>"
+
任何有效的 {{cssxref("<angle>")}} 值.
+
"<time>"
+
任何有效的 {{cssxref("<time>")}} 值.
+
"<resolution>"
+
任何有效的 {{cssxref("<resolution>")}} 值.
+
"<transform-function>"
+
任何有效的 {{cssxref("<transform-function>")}} 值.
+
"<custom-ident>"
+
任何有效的 {{cssxref("<custom-ident>")}} 值.
+
"<transform-list>"
+
A list of valid {{cssxref("<transform-function>")}} 值.
+
+ +

标准定义

+ +

{{cssinfo}}

+ +

标准语法

+ +
{{csssyntax}}
+ +

实例

+ +

为 --my-color {{cssxref('--*', '自定义属性')}}添加颜色值类型检测、设置默认值并且设置属性值不允许被继承。

+ +

使用 CSS {{cssxref('@property')}} 规则:

+ +
@property --my-color {
+  syntax: '<color>';
+  inherits: false;
+  initial-value: #c0ffee;
+}
+
+ +

使用 JavaScript中的 {{domxref('CSS.registerProperty')}}函数:

+ +
window.CSS.registerProperty({
+  name: '--my-color',
+  syntax: '<color>',
+  inherits: false,
+  initialValue: '#c0ffee',
+});
+
+ +

标准语法

+ +
{{csssyntax}}
+ +

规范

+ + + + + + + + + + + + + + +
规范状态提案
{{SpecName('CSS Properties and 值 API', '#at-property-rule')}}{{Spec2('CSS Properties and 值 API')}}初始定义.
+ +

浏览器兼容性

+ + + +

{{Compat("css.at-rules.property")}}

+ +

另见

+ + -- cgit v1.2.3-54-g00ecf