大网数据广告活动
Web 标准与前端开发

CSSFunctionRule

· 52CE 我爱测

The **`CSSFunctionRule`** interface of the CSS Object Model represents CSS @function (custom function) at-rules.

CSSOM

The CSSFunctionRule interface of the CSS Object Model represents CSS @function (custom function) at-rules.

Instance properties

This interface also inherits properties from CSSGroupingRule.

  • CSSFunctionRule.name
    • : Returns a string representing the custom function's name.
  • CSSFunctionRule.returnType
    • : Returns a string representing the custom function's return type.

Instance methods

This interface also inherits methods from CSSGroupingRule.

  • CSSFunctionRule.getParameters()
    • : Returns an array of objects representing the custom function's parameters.

Examples

Basic CSSFunctionRule usage

In this example, we define a CSS custom function and then access it using the CSSOM.

CSS

Our CSS defines a custom function using the @function at-rule. The function is called --lighter(), and outputs a lightened version of an input color. --lighter() accepts two parameters, a <color> and a <number>. It returns an color_value/oklch color created using relative color syntax; the input color is transformed into an oklch() color and its lightness channel is increased by the input number.

@function --lighter(--color <color>, --lightness-adjust <number>: 0.2) returns
  <color> {
  result: oklch(from var(--color) calc(l + var(--lightness-adjust)) c h);
}

JavaScript

Our script starts by getting a reference to the stylesheet attached to our document using HTMLStyleElement.sheet, then getting a reference to the only rule in the stylesheet, the CSSFunctionRule — via CSSStylesheet.cssRules. We then log each of the CSSFunctionRule members to the console.

// Get a CSSFunctionRule
const cssFunc = document.getElementById("css-output").sheet.cssRules[0];

// Accessing CSSFunctionRule members
console.log(cssFunc.name);
console.log(cssFunc.returnType);
console.log(cssFunc.getParameters());
  • The name property is equal to --lighter.
  • The returnType property is equal to <color>.
  • The getParameters() method returns an array that looks like so:
    [
      { name: "--color", type: "<color>" },
      { defaultValue: "0.2", name: "--lightness-adjust", type: "<number>" },
    ];
    

Specifications

Browser compatibility

See also

  • @function
  • CSSFunctionDescriptors
  • CSSFunctionDeclarations

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。