跳到主要内容
版本：v7

颜色

Ionic 有九种默认颜色，可用于更改许多组件的颜色。每种颜色实际上是多个属性的集合，包括在整个 Ionic 中使用的 shade（暗色调）和 tint（亮色调）。

可以使用 color 属性将颜色应用到 Ionic 组件，以更改默认颜色。注意下方按钮中，文本和背景会根据设置的 color 而变化。当按钮上没有设置 color 时，默认使用 primary 颜色。

<ion-button>默认</ion-button>
<ion-button color="primary">Primary</ion-button>
<ion-button color="secondary">Secondary</ion-button>
<ion-button color="tertiary">Tertiary</ion-button>
<ion-button color="success">Success</ion-button>
<ion-button color="warning">Warning</ion-button>
<ion-button color="danger">Danger</ion-button>
<ion-button color="light">Light</ion-button>
<ion-button color="medium">Medium</ion-button>
<ion-button color="dark">Dark</ion-button>

分层颜色​

每种颜色包含以下属性：base（基础色）、contrast（对比色）、shade（暗色调）和 tint（亮色调）。base 和 contrast 颜色还需要一个 rgb 属性，它是相同的颜色，只是使用 rgb 格式。请参阅 Alpha 问题 了解为什么还需要 rgb 属性。从下面的下拉列表中选择，查看 Ionic 提供的所有默认颜色及其变体。

NamePropertyDefault ValueDescription

修改颜色​

要更改颜色的默认值，应设置该颜色的所有列出的变体。例如，要将次要颜色更改为 #006600，设置以下 CSS 属性：

:root {
  --ion-color-secondary: #006600;
  --ion-color-secondary-rgb: 0, 102, 0;
  --ion-color-secondary-contrast: #ffffff;
  --ion-color-secondary-contrast-rgb: 255, 255, 255;
  --ion-color-secondary-shade: #005a00;
  --ion-color-secondary-tint: #1a751a;
}

当 secondary 应用于按钮时，不仅使用基础色 #006600，还使用对比色 #ffffff 作为文本颜色，以及暗色调 #005a00 和亮色调 #1a751a 用于按钮的不同状态。

备注

不知道如何从基础色获取变体颜色？试试我们的 Color Generator，它可以计算所有变体并提供可复制/粘贴到应用中的代码！

有关 CSS 变量的更多信息，请参阅 CSS Variables 文档。

添加颜色​

可以通过在 Ionic 组件上设置 color 属性或使用 CSS 设置样式来添加颜色，以便在整个应用中使用。继续阅读了解如何手动添加新颜色，或使用 New Color Creator 快速生成新颜色的代码以复制粘贴到应用中。

要添加新颜色，首先在根级别定义该颜色所有变体的 CSS 变量。例如，要添加一个名为 favorite 的新颜色，我们可以定义以下变量：

:root {
  --ion-color-favorite: #69bb7b;
  --ion-color-favorite-rgb: 105, 187, 123;
  --ion-color-favorite-contrast: #ffffff;
  --ion-color-favorite-contrast-rgb: 255, 255, 255;
  --ion-color-favorite-shade: #5ca56c;
  --ion-color-favorite-tint: #78c288;
}

然后，创建一个使用这些 CSS 变量的新类。类必须使用 .ion-color-{COLOR} 格式编写，其中 {COLOR} 是要添加的颜色名称：

.ion-color-favorite {
  --ion-color-base: var(--ion-color-favorite);
  --ion-color-base-rgb: var(--ion-color-favorite-rgb);
  --ion-color-contrast: var(--ion-color-favorite-contrast);
  --ion-color-contrast-rgb: var(--ion-color-favorite-contrast-rgb);
  --ion-color-shade: var(--ion-color-favorite-shade);
  --ion-color-tint: var(--ion-color-favorite-tint);
}

添加类后，该颜色可用于任何支持 color 属性的 Ionic 组件。以下是在 Ionic 按钮上使用 favorite 颜色的示例：

<ion-button color="favorite">收藏</ion-button>

在根级别定义的 CSS 变量也可用于使用 CSS 设置任何元素的样式：

div {
  background: var(--ion-color-favorite);
  color: var(--ion-color-favorite-contrast);
}

有关设置和使用 CSS 变量的更多信息，请参阅 CSS Variables 文档。

新颜色创建器​

在下面通过更改名称和值来创建新颜色，然后将代码复制并粘贴到您的项目中。

:root {
	--ion-color-new: #69bb7b;
	--ion-color-new-rgb: 105,187,123;
	--ion-color-new-contrast: #000000;
	--ion-color-new-contrast-rgb: 0,0,0;
	--ion-color-new-shade: #5ca56c;
	--ion-color-new-tint: #78c288;
}

.ion-color-new {
	--ion-color-base: var(--ion-color-new);
	--ion-color-base-rgb: var(--ion-color-new-rgb);
	--ion-color-contrast: var(--ion-color-new-contrast);
	--ion-color-contrast-rgb: var(--ion-color-new-contrast-rgb);
	--ion-color-shade: var(--ion-color-new-shade);
	--ion-color-tint: var(--ion-color-new-tint);
}

目录

编辑此页