跳到主要内容
版本：v8

颜色

Ionic 内置了九种默认颜色，可用于改变许多组件的颜色。每种颜色实际上是一组包含多个属性的集合，包括 shade（暗调）和 tint（亮调），这些属性在整个 Ionic 框架中被广泛使用。

可以通过 color 属性将颜色应用到 Ionic 组件上，从而改变其默认颜色。观察下面的按钮，你会发现文本和背景颜色会根据所设置的 color 值而改变。当按钮未设置 color 属性时，默认会使用 primary 颜色。

<ion-button>Default</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 格式呈现。关于为何需要 rgb 属性的解释，请参阅 透明通道问题。从下面的下拉菜单中选择，可以查看 Ionic 提供的所有默认颜色及其变体。

NamePropertyDefault ValueDescription

修改颜色​

要修改颜色的默认值，需要设置该颜色所有列出的变体属性。例如，要将次要颜色（secondary）更改为 #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 作为按钮不同状态的颜色。

备注

不确定如何从基色计算出变体颜色？试试我们的 颜色生成器，它可以计算所有变体并提供可直接复制/粘贴到应用中的代码！

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

添加颜色​

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

要添加新颜色，首先需要在根元素中定义该颜色所有变体的 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">Favorite</ion-button>

在根元素定义的 CSS 变量也可以通过 CSS 用于样式化任何元素：

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

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

新颜色生成器​

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

: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);
}

Contents

编辑此页