定义样式¶

样式定义是包含一个或多个用于设置颜色和属性的单词的字符串。

要指定前景色，请使用 256 种标准色之一。例如，要以洋红色打印“Hello”：

console.print("Hello", style="magenta")

您也可以将颜色的数字（0 到 255 之间的整数）与语法一起使用。以下内容将给出等效的输出："color(<number>)"

console.print("Hello", style="color(5)")

或者，您可以使用类似 CSS 的语法来指定带有“#”后跟三对十六进制字符的颜色，或者以 RGB 形式指定三个十进制整数的颜色。以下两行都以相同的颜色（紫色）打印“Hello”：

console.print("Hello", style="#af00ff")
console.print("Hello", style="rgb(175,0,255)")

十六进制和 rgb 形式允许您从 16 万种颜色的完整真彩色集合中进行选择。

注意

某些终端仅支持 256 种颜色。如果您的颜色不可用，Rich 将尝试选择最接近的颜色。

颜色本身将更改前景色。要指定背景色，请在颜色前面加上单词“on”。例如，以下内容在白色背景上以红色打印文本：

console.print("DANGER!", style="red on white")

您还可以使用单词设置颜色，该单词会将颜色重置为由终端软件管理的默认值。这也适用于背景，因此样式是终端开始的样式。"default""default on default"

您可以通过添加以下一个或多个单词来设置样式属性：

• "bold"或粗体文本。"b"

• "blink"对于闪烁的文本（请谨慎使用）。

• "blink2"对于快速闪烁的文本（大多数终端不支持）。

• "conceal"对于隐藏文本（大多数终端不支持）。

• "italic"或斜体文本（在 Windows 上不受支持）。"i"

• "reverse"或前景色和背景色颠倒的文本。"r"

• "strike"或带有一行的文本。"s"

• "underline"或带下划线的文本。"u"

Rich 还支持以下样式，这些样式不太受支持，可能不会显示在您的终端中：

• "underline2"或双下划线文本。"uu"

• "frame"对于框架文本。

• "encircle"对于带圈子的文本。

• "overline"或带上划线的文本。"o"

样式属性和颜色可以相互组合使用。例如：

console.print("Danger, Will Robinson!", style="blink bold red underline on white")

可以通过在属性前面加上单词“not”来否定样式。这可用于关闭样式（如果它们重叠）。例如：

console.print("foo [not bold]bar[/not bold] baz", style="bold")

这将以粗体打印“foo”和“baz”，但“bar”将以普通文本打印。

样式也可能具有一个属性，该属性会将任何样式文本转换为超链接（如果您的终端软件支持）。"link"

若要添加指向样式的链接，定义应包含单词后跟 URL。以下示例将创建一个可单击的链接："link"

console.print("Google", style="link https://google.com")

注意

如果您熟悉 HTML，您可能会发现以这种方式应用链接有点奇怪，但终端认为链接是另一个属性，就像粗体、斜体等一样。

样式类¶

最终，将解析样式定义并创建类的实例。如果您愿意，可以使用 Style 类代替样式定义。下面是一个示例：

from rich.style import Style
danger_style = Style(color="red", blink=True, bold=True)
console.print("Danger, Will Robinson!", style=danger_style)

像这样构造 Style 类会稍微快一些，因为样式定义需要一点时间来解析 - 但仅在第一次调用时，因为 Rich 将缓存解析的样式定义。

可以通过将样式相加来组合样式，如果要修改现有样式的属性，这将非常有用。下面是一个示例：

from rich.console import Console
from rich.style import Style
console = Console()

base_style = Style.parse("cyan")
console.print("Hello, World", style = base_style + Style(underline=True))

可以使用该方法显式分析样式定义，该方法接受样式定义并返回 Style 实例。例如，以下两行是等效的：

style = Style(color="magenta", bgcolor="yellow", italic=True)
style = Style.parse("italic magenta on yellow")

样式主题¶

如果您重复使用样式，如果要修改属性或颜色，则可能会使维护问题头疼 - 您必须更改使用该样式的每一行。Rich 提供了一个类，可用于定义可按名称引用的自定义样式。这样，您只需在一个地方更新样式。

样式主题可以使你的代码更具语义性，例如，一种名为 Better 的样式表达了意图。"warning""italic magenta underline"

若要使用样式主题，请构造一个实例并将其传递给构造函数。下面是一个示例：

from rich.console import Console
from rich.theme import Theme
custom_theme = Theme({
    "info": "dim cyan",
    "warning": "magenta",
    "danger": "bold red"
})
console = Console(theme=custom_theme)
console.print("This is information", style="info")
console.print("[warning]The pod bay doors are locked[/warning]")
console.print("Something terrible happened!", style="danger")

注意

样式名称必须为小写，以字母开头，并且只能包含字母或字符 、、。".""-""_"

from rich.console import Console
from rich.theme import Theme
console = Console(theme=Theme({"repr.number": "bold green blink"}))
console.print("The total is 128")

python -m rich.theme
python -m rich.default_styles

[styles]
info = dim cyan
warning = magenta
danger = bold red