color自始可用

A color in a specific color space.

Typst supports:

sRGB through the rgb function
Device CMYK through the cmyk function
D65 Gray through the luma function
Oklab through the oklab function
Oklch through the oklch function
Linear RGB through the color.linear-rgb function
HSL through the color.hsl function
HSV through the color.hsv function
Color spaces described by spot colorants through the color.spot type

All color spaces except for CMYK and spot colorants have alpha channels.

Throughout the documentation, we use the term process color for colors that can be blended with each other (currently all colors other than spot colors). In this term, process signifies that the shade is being created throughout the printing process instead of ahead of time.

Example


#rect(fill: aqua)

Predefined colors

Typst defines the following built-in colors:

Color	Definition
`black`	`luma(0)`
`gray`	`luma(170)`
`silver`	`luma(221)`
`white`	`luma(255)`
`navy`	`rgb("#001f3f")`
`blue`	`rgb("#0074d9")`
`aqua`	`rgb("#7fdbff")`
`teal`	`rgb("#39cccc")`
`eastern`	`rgb("#239dad")`
`purple`	`rgb("#b10dc9")`
`fuchsia`	`rgb("#f012be")`
`maroon`	`rgb("#85144b")`
`red`	`rgb("#ff4136")`
`orange`	`rgb("#ff851b")`
`yellow`	`rgb("#ffdc00")`
`olive`	`rgb("#3d9970")`
`green`	`rgb("#2ecc40")`
`lime`	`rgb("#01ff70")`

The predefined colors and the most important color constructors are available globally and also in the color type’s scope, so you can write either color.red or just red.

Predefined color maps

Typst also includes a number of preset color maps that can be used for gradients. These are simply arrays of colors defined in the module color.map.


#circle(fill: gradient.linear(..color.map.crest))

Map	Details
`turbo`	A perceptually uniform rainbow-like color map. Read this blog post for more details.
`cividis`	A blue to gray to yellow color map. See this blog post for more details.
`rainbow`	Cycles through the full color spectrum. This color map is best used by setting the interpolation color space to HSL. The rainbow gradient is not suitable for data visualization because it is not perceptually uniform, so the differences between values become unclear to your readers. It should only be used for decorative purposes.
`spectral`	Red to yellow to blue color map.
`viridis`	A purple to teal to yellow color map.
`inferno`	A black to red to yellow color map.
`magma`	A black to purple to yellow color map.
`plasma`	A purple to pink to yellow color map.
`rocket`	A black to red to white color map.
`mako`	A black to teal to white color map.
`coolwarm`	A blue to white to red color map with smooth transitions.
`vlag`	A light blue to white to red color map.
`icefire`	A light teal to black to orange color map.
`flare`	A orange to purple color map that is perceptually uniform.
`crest`	A light green to blue color map.

Some popular presets are not included because they are not available under a free licence. Others, like Jet, are not included because they are not color blind friendly. Feel free to use or create a package with other presets that are useful to you!

定义

`luma`自始可用

Create a grayscale color.

A grayscale color is represented by lightness (ratio) and alpha (ratio) components.

These components are also available using the components method.

展开示例


#for x in range(250, step: 50) {
  box(square(fill: luma(x)))
}

color.luma(

int ratio,int ratio,color,

) → color

`lightness`
int or ratio
必需参数
位置参数

The lightness component.

`alpha`
int or ratio
必需参数
位置参数

The alpha component.

`color`
color
必需参数
位置参数

Alternatively: The color to convert to grayscale.

If this is given, the individual components should not be given.

`oklab`0.9.0起可用

Create an Oklab color.

This color space is well suited for the following use cases:

Color manipulation such as saturating while keeping perceived hue
Creating grayscale images with uniform perceived lightness
Creating smooth and uniform color transition and gradients

A linear Oklab color is represented internally by an array of four components:

lightness (ratio)
a (float or ratio. Ratios are relative to 0.4; meaning 50% is equal to 0.2)
b (float or ratio. Ratios are relative to 0.4; meaning 50% is equal to 0.2)
alpha (ratio)

These components are also available using the components method.

展开示例


#square(
  fill: oklab(27%, 20%, -3%, 50%)
)

color.oklab(

ratio,float ratio,float ratio,ratio,color,

) → color

`lightness`
ratio
必需参数
位置参数

The lightness component.

`a`
float or ratio
必需参数
位置参数

The a (“green/red”) component.

`b`
float or ratio
必需参数
位置参数

The b (“blue/yellow”) component.

`alpha`
ratio
必需参数
位置参数

The alpha component.

`color`
color
必需参数
位置参数

Alternatively: The color to convert to Oklab.

If this is given, the individual components should not be given.

`oklch`0.10.0起可用

Create an Oklch color.

This color space is well suited for the following use cases:

Color manipulation involving lightness, chroma, and hue
Creating grayscale images with uniform perceived lightness
Creating smooth and uniform color transition and gradients

A linear Oklch color is represented internally by an array of four components:

lightness (ratio)
chroma (float or ratio. Ratios are relative to 0.4; meaning 50% is equal to 0.2)
hue (angle)
alpha (ratio)

These components are also available using the components method.

展开示例


#square(
  fill: oklch(40%, 0.2, 160deg, 50%)
)

color.oklch(

ratio,float ratio,angle,ratio,color,

) → color

`lightness`
ratio
必需参数
位置参数

The lightness component.

`chroma`
float or ratio
必需参数
位置参数

The chroma component.

`hue`
angle
必需参数
位置参数

The hue component.

`alpha`
ratio
必需参数
位置参数

The alpha component.

`color`
color
必需参数
位置参数

Alternatively: The color to convert to Oklch.

If this is given, the individual components should not be given.

`linear-rgb`0.9.0起可用

Create an RGB(A) color with linear luma.

This color space is similar to sRGB, but with the distinction that the color component are not gamma corrected. This makes it easier to perform color operations such as blending and interpolation. Although, you should prefer to use the oklab function for these.

A linear RGB(A) color is represented internally by an array of four components:

red (ratio)
green (ratio)
blue (ratio)
alpha (ratio)

These components are also available using the components method.

展开示例


#square(fill: color.linear-rgb(
  30%, 50%, 10%,
))

color.linear-rgb(

int ratio,int ratio,int ratio,int ratio,color,

) → color

`red`
int or ratio
必需参数
位置参数

The red component.

`green`
int or ratio
必需参数
位置参数

The green component.

`blue`
int or ratio
必需参数
位置参数

The blue component.

`alpha`
int or ratio
必需参数
位置参数

The alpha component.

`color`
color
必需参数
位置参数

Alternatively: The color to convert to linear RGB(A).

If this is given, the individual components should not be given.

`rgb`自始可用

Create an RGB(A) color.

The color is specified in the sRGB color space.

An RGB(A) color is represented internally by an array of four components:

red (ratio)
green (ratio)
blue (ratio)
alpha (ratio)

These components are also available using the components method.

展开示例


#square(fill: rgb("#b1f2eb"))
#square(fill: rgb(87, 127, 230))
#square(fill: rgb(25%, 13%, 65%))

color.rgb(

int ratio,int ratio,int ratio,int ratio,str,color,

) → color

`red`
int or ratio
必需参数
位置参数

The red component.

`green`
int or ratio
必需参数
位置参数

The green component.

`blue`
int or ratio
必需参数
位置参数

The blue component.

`alpha`
int or ratio
必需参数
位置参数

The alpha component.

`hex`
str
必需参数
位置参数

Alternatively: The color in hexadecimal notation.

Accepts three, four, six or eight hexadecimal digits and optionally a leading hash.

If this is given, the individual components should not be given.

展开示例


#text(16pt, rgb("#239dad"))[
  *Typst*
]

`color`
color
必需参数
位置参数

Alternatively: The color to convert to RGB(a).

If this is given, the individual components should not be given.

`cmyk`自始可用

Create a CMYK color.

This is useful if you want to target a specific printer. The conversion to RGB for display preview might differ from how your printer reproduces the color.

A CMYK color is represented internally by an array of four components:

cyan (ratio)
magenta (ratio)
yellow (ratio)
key (ratio)

These components are also available using the components method.

Note that CMYK colors are not currently supported when PDF/A output is enabled.

展开示例


#square(
  fill: cmyk(27%, 0%, 3%, 5%)
)

color.cmyk(

ratio,ratio,ratio,ratio,color,

) → color

`cyan`
ratio
必需参数
位置参数

The cyan component.

`magenta`
ratio
必需参数
位置参数

The magenta component.

`yellow`
ratio
必需参数
位置参数

The yellow component.

`key`
ratio
必需参数
位置参数

The key component.

`color`
color
必需参数
位置参数

Alternatively: The color to convert to CMYK.

If this is given, the individual components should not be given.

`hsl`0.9.0起可用

Create an HSL color.

This color space is useful for specifying colors by hue, saturation and lightness. It is also useful for color manipulation, such as saturating while keeping perceived hue.

An HSL color is represented internally by an array of four components:

hue (angle)
saturation (ratio)
lightness (ratio)
alpha (ratio)

These components are also available using the components method.

展开示例


#square(
  fill: color.hsl(30deg, 50%, 60%)
)

color.hsl(

angle,int ratio,int ratio,int ratio,color,

) → color

`hue`
angle
必需参数
位置参数

The hue angle.

`saturation`
int or ratio
必需参数
位置参数

The saturation component.

`lightness`
int or ratio
必需参数
位置参数

The lightness component.

`alpha`
int or ratio
必需参数
位置参数

The alpha component.

`color`
color
必需参数
位置参数

Alternatively: The color to convert to HSL.

If this is given, the individual components should not be given.

`hsv`0.9.0起可用

Create an HSV color.

This color space is useful for specifying colors by hue, saturation and value. It is also useful for color manipulation, such as saturating while keeping perceived hue.

An HSV color is represented internally by an array of four components:

hue (angle)
saturation (ratio)
value (ratio)
alpha (ratio)

These components are also available using the components method.

展开示例


#square(
  fill: color.hsv(30deg, 50%, 60%)
)

color.hsv(

angle,int ratio,int ratio,int ratio,color,

) → color

`hue`
angle
必需参数
位置参数

The hue angle.

`saturation`
int or ratio
必需参数
位置参数

The saturation component.

`value`
int or ratio
必需参数
位置参数

The value component.

`alpha`
int or ratio
必需参数
位置参数

The alpha component.

`color`
color
必需参数
位置参数

Alternatively: The color to convert to HSL.

If this is given, the individual components should not be given.

`components`0.9.0起可用

Extracts the components of this color.

The size and values of this array depends on the color space. You can obtain the color space using space. Below is a table of the color spaces and their components:

Color space	C1	C2	C3	C4
`luma`	Lightness
`oklab`	Lightness	`a`	`b`	Alpha
`oklch`	Lightness	Chroma	Hue	Alpha
`linear-rgb`	Red	Green	Blue	Alpha
`rgb`	Red	Green	Blue	Alpha
`cmyk`	Cyan	Magenta	Yellow	Key
`hsl`	Hue	Saturation	Lightness	Alpha
`hsv`	Hue	Saturation	Value	Alpha
`spot`	Tint

For the meaning and type of each individual value, see the documentation of the corresponding color space. The alpha component is optional and only included if the alpha argument is true. The length of the returned array depends on the number of components and whether the alpha component is included.

展开示例


// note that the alpha component is included by default
#rgb(40%, 60%, 80%).components()

self.components(alpha: bool) → array

`alpha`
bool
默认值：`true`

Whether to include the alpha component.

`space`0.9.0起可用

Returns the constructor function for this color’s space.

Returns one of:

luma
oklab
oklch
linear-rgb
rgb
cmyk
hsl
hsv

展开示例


#let color = cmyk(1%, 2%, 3%, 4%)
#(color.space() == cmyk)

self.space() → spotany

`to-hex`0.9.0起可用

Returns the color’s RGB(A) hex representation (such as #ffaa32 or #020304fe). The alpha component (last two digits in #020304fe) is omitted if it is equal to ff (255 / 100%).

self.to-hex() → str

`lighten`自始可用

Lightens a color by a given factor.

self.lighten(ratio) → color

`factor`
ratio
必需参数
位置参数

The factor to lighten the color by.

`darken`自始可用

Darkens a color by a given factor.

self.darken(ratio) → color

`factor`
ratio
必需参数
位置参数

The factor to darken the color by.

`saturate`0.9.0起可用

Increases the saturation of a color by a given factor.

Only process colors can be saturated. If you want to saturate a spot color, convert it into a process color first.

self.saturate(ratio) → color

`factor`
ratio
必需参数
位置参数

The factor to saturate the color by.

`desaturate`0.9.0起可用

Decreases the saturation of a color by a given factor.

Only process colors can be desaturated. If you want to desaturate a spot color, convert it into a process color first.

self.desaturate(ratio) → color

`factor`
ratio
必需参数
位置参数

The factor to desaturate the color by.

`negate`自始可用

Produces the complementary color using a provided color space. You can think of it as the opposite side on a color wheel.

展开示例


#square(fill: yellow)
#square(fill: yellow.negate())
#square(fill: yellow.negate(space: rgb))

self.negate(space: auto spotany) → color

`space`
auto or spot or any
默认值：`auto`

The color space used for the transformation. By default, a perceptual color space is used.

`rotate`0.9.0起可用

Rotates the hue of the color by a given angle.

This function only works on color models with a well-defined hue component, i.e. Oklch, HSL, and HSV.

self.rotate(

angle,space: any,

) → color

`angle`
angle
必需参数
位置参数

The angle to rotate the hue by.

`space`
any
默认值：`oklch`

The color space used to rotate. By default, this happens in a perceptual color space (oklch).

`mix`0.7.0起可用

Create a color by mixing two or more colors.

In color spaces with a hue component (HSL, HSV, Oklch), only two colors can be mixed at once. Mixing more than two colors in such a space will result in an error!

展开示例


#set block(height: 20pt, width: 100%)
#block(fill: red.mix(blue))
#block(fill: red.mix(blue, space: rgb))
#block(fill: color.mix(red, blue, white))
#block(fill: color.mix((red, 70%), (blue, 30%)))

color.mix(

..color array,space: auto spotany,

) → color

`colors`
color or array
必需参数
位置参数
变长参数

The colors, optionally with weights, specified as a pair (array of length two) of color and weight (float or ratio).

The weights do not need to add to 100%, they are relative to the sum of all weights.

`space`
auto or spot or any
默认值：`auto`

The color space to mix in. By default, this happens in a perceptual color space (oklab) or, if all colors use the same spot colorant, using that colorant.

All colors will be converted into this color space.

`transparentize`0.11.0起可用

Makes a color more transparent by a given factor.

This method is relative to the existing alpha value. If the scale is positive, calculates alpha - alpha * scale. Negative scales behave like color.opacify(-scale).

展开示例


#block(fill: red)[opaque]
#block(fill: red.transparentize(50%))[half red]
#block(fill: red.transparentize(75%))[quarter red]

self.transparentize(ratio) → color

`scale`
ratio
必需参数
位置参数

The factor to change the alpha value by.

`opacify`0.11.0起可用

Makes a color more opaque by a given scale.

This method is relative to the existing alpha value. If the scale is positive, calculates alpha + scale - alpha * scale. Negative scales behave like color.transparentize(-scale).

展开示例


#let half-red = red.transparentize(50%)
#block(fill: half-red.opacify(100%))[opaque]
#block(fill: half-red.opacify(50%))[three quarters red]
#block(fill: half-red.opacify(-50%))[one quarter red]

self.opacify(ratio) → color

`scale`
ratio
必需参数
位置参数

The scale to change the alpha value by.

spot0.15.0起可用

A spot colorant from which spot colors can be created.

Use spot colors to request a precise pigment in a professional print environment. Once you have created a spot colorant, you can create colors using its tint method.

构造函数
0.15.0起可用

Create a new spot colorant.

color.spot(

none str,color,

) → spot

`name`
none or str
必需参数
位置参数

Name of the spot colorant to use.

In production, this name will be manually checked and matched to a colorant, so this value needs to be unambiguous. It’s best to reference a color from a registry like PANTONE, HKS, RAL, Toyo & DIC, etc.

Values in here may be treated case-sensitively during production: "PANTONE 2221 C" and "PANTONE 2221 c" may be treated as separate colors. Ensure that you are using a consistent naming convention, either referencing a registry or through coordination with your production printing experts.

If this value is "all" and your print will involve multiple color plates, use of this colorant will result in the specified tint being applied equally to all plates. If you choose none, no colorant will be applied when using this color. This special value is often used to indicate cuts or varnishes. Be sure to discuss this with your production printer!

We do not recommend using the names "Cyan", "Magenta", "Yellow", "Key", "Black", or their translations to your local language. Depending on your printer, they may or may not be interpreted as CMYK process colors.

Variant	Details
`"all"`	Use all available color plates instead of only a specific colorant.

`fallback`
color
必需参数
位置参数

How to render this color if the specified colorant is not available.

Many mediums, like on-screen preview and household printers, will not have this specific spot colorant available. To display an approximation of the intended print, another, available color is used instead.

`spot`上的定义

`tint`0.15.0起可用

Create a spot color at a specific tint of this colorant.

The tint represents what percentage of the colorant is applied. A tint of 100% means the colorant is applied at full strength, while 0% means no colorant is applied.

展开示例


#let pantone = color.spot(
  "PANTONE 2221 C",
  rgb("#239dad")
)

#square(fill: pantone.tint(100%))
#square(fill: pantone.tint(70%))
#square(fill: pantone.tint(40%))

self.tint(ratio) → color

`value`
ratio
必需参数
位置参数

The tint percentage, between 0% and 100%.

转到官方文档（英文）

Circle上一页

Curve下一页

color自始可用Go to source

Example

Predefined colors

Predefined color maps

定义Question mark这些函数和类型带有附属定义。要访问这种定义，请先写上函数或类型的名称，再加上定义的名称，并用句点在中间分隔。

luma自始可用Go to source

lightnessint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

alphaint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

colorcolor必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

oklab0.9.0起可用Go to source

lightnessratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

afloat or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

bfloat or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

alpharatio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

colorcolor必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

oklch0.10.0起可用Go to source

lightnessratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

chromafloat or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

hueangle必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

alpharatio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

colorcolor必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

linear-rgb0.9.0起可用Go to source

redint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

greenint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

blueint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

alphaint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

colorcolor必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

rgb自始可用Go to source

redint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

greenint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

blueint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

alphaint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

hexstr必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

colorcolor必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

cmyk自始可用Go to source

cyanratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

magentaratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

yellowratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

keyratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

colorcolor必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

hsl0.9.0起可用Go to source

hueangle必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

saturationint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

lightnessint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

alphaint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

colorcolor必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

hsv0.9.0起可用Go to source

hueangle必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

saturationint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

valueint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

alphaint or ratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

colorcolor必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

components0.9.0起可用Go to source

alphabool默认值：true

space0.9.0起可用Go to source

to-hex0.9.0起可用Go to source

lighten自始可用Go to source

factorratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

darken自始可用Go to source

factorratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

saturate0.9.0起可用Go to source

factorratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

desaturate0.9.0起可用Go to source

factorratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

negate自始可用Go to source

spaceauto or spot or any默认值：auto

rotate0.9.0起可用Go to source

angleangle必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

spaceany默认值：oklch

mix0.7.0起可用Go to source

colorscolor or array必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。变长参数Question mark变长参数可以传入多次。

spaceauto or spot or any默认值：auto

transparentize0.11.0起可用Go to source

scaleratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

opacify0.11.0起可用Go to source

scaleratio必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

spot0.15.0起可用Go to source

构造函数Question mark若某类型提供构造函数，可调用它生成该类型的新实例。0.15.0起可用Go to source

namenone or str必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

fallbackcolor必需参数Question mark必需参数在调用函数时必须传入。位置参数Question mark位置参数按顺序传入，不带参数名。

color自始可用

定义

`luma`自始可用

`lightness`
int or ratio
必需参数
位置参数

`alpha`
int or ratio
必需参数
位置参数

`color`
color
必需参数
位置参数

`oklab`0.9.0起可用

`lightness`
ratio
必需参数
位置参数

`a`
float or ratio
必需参数
位置参数

`b`
float or ratio
必需参数
位置参数

`alpha`
ratio
必需参数
位置参数

`color`
color
必需参数
位置参数

`oklch`0.10.0起可用

`lightness`
ratio
必需参数
位置参数

`chroma`
float or ratio
必需参数
位置参数

`hue`
angle
必需参数
位置参数

`alpha`
ratio
必需参数
位置参数

`color`
color
必需参数
位置参数

`linear-rgb`0.9.0起可用

`red`
int or ratio
必需参数
位置参数

`green`
int or ratio
必需参数
位置参数

`blue`
int or ratio
必需参数
位置参数

`alpha`
int or ratio
必需参数
位置参数

`color`
color
必需参数
位置参数

`rgb`自始可用

`red`
int or ratio
必需参数
位置参数

`green`
int or ratio
必需参数
位置参数

`blue`
int or ratio
必需参数
位置参数

`alpha`
int or ratio
必需参数
位置参数

`hex`
str
必需参数
位置参数

`color`
color
必需参数
位置参数

`cmyk`自始可用

`cyan`
ratio
必需参数
位置参数

`magenta`
ratio
必需参数
位置参数

`yellow`
ratio
必需参数
位置参数

`key`
ratio
必需参数
位置参数

`color`
color
必需参数
位置参数

`hsl`0.9.0起可用

`hue`
angle
必需参数
位置参数

`saturation`
int or ratio
必需参数
位置参数

`lightness`
int or ratio
必需参数
位置参数

`alpha`
int or ratio
必需参数
位置参数

`color`
color
必需参数
位置参数

`hsv`0.9.0起可用

`hue`
angle
必需参数
位置参数

`saturation`
int or ratio
必需参数
位置参数

`value`
int or ratio
必需参数
位置参数

`alpha`
int or ratio
必需参数
位置参数

`color`
color
必需参数
位置参数

`components`0.9.0起可用

`alpha`
bool
默认值：`true`

`space`0.9.0起可用

`to-hex`0.9.0起可用

`lighten`自始可用

`factor`
ratio
必需参数
位置参数

`darken`自始可用

`factor`
ratio
必需参数
位置参数

`saturate`0.9.0起可用

`factor`
ratio
必需参数
位置参数

`desaturate`0.9.0起可用

`factor`
ratio
必需参数
位置参数

`negate`自始可用

`space`
auto or spot or any
默认值：`auto`

`rotate`0.9.0起可用

`angle`
angle
必需参数
位置参数

`space`
any
默认值：`oklch`

`mix`0.7.0起可用

`colors`
color or array
必需参数
位置参数
变长参数

`space`
auto or spot or any
默认值：`auto`

`transparentize`0.11.0起可用

`scale`
ratio
必需参数
位置参数

`opacify`0.11.0起可用

`scale`
ratio
必需参数
位置参数

spot0.15.0起可用

构造函数
0.15.0起可用

`name`
none or str
必需参数
位置参数

`fallback`
color
必需参数
位置参数

`spot`上的定义

`tint`0.15.0起可用

`value`
ratio
必需参数
位置参数