詳細ガイド
テンプレート構文

クラスとスタイルのバインディング

クラスとスタイルのバインディングを使用して、要素の class 属性からCSSクラス名を追加および削除したり、スタイルを動的に設定したりします。

単一の CSS class へのバインディング

単一のクラスバインディングを作成するには、次のように入力します。

[class.sale]="onSale"

バインドされた式 onSale が真の場合、Angularはクラスを追加し、式が偽の場合、クラスを削除します。ただし、undefined を除きます。undefined の動作は、要素上の異なるディレクティブで同じクラスに複数のバインディングが存在する場合に特に役立ちます。

複数の CSS クラスへのバインディング

複数のクラスにバインドするには、次のように入力します。

[class]="classExpression"

式は次のいずれかになります。

  • クラス名のスペース区切り文字列。
  • クラス名をキー、真または偽の式を値とするオブジェクト。
  • クラス名の配列。

オブジェクト形式を使用すると、Angularは関連付けられた値が真の場合にのみクラスを追加します。

IMPORTANT: オブジェクトのような式(objectArrayMapSet など)を使用する場合、Angularがクラスリストを更新するにはオブジェクトのIDが変更されている必要があります。 オブジェクトのIDを変更せずにプロパティを更新しても、効果はありません。

同じクラス名に複数のバインディングがある場合、Angularはスタイリングの優先順位を使用して、どのバインディングを使用するかを決定します。

次の表は、クラスバインディング構文をまとめたものです。

バインディングの種類 構文 入力の種類 入力値の例
単一のクラスバインディング [class.sale]="onSale" boolean undefined
複数のクラスバインディング [class]="classExpression" string "my-class-1 my-class-2 my-class-3"
複数のクラスバインディング [class]="classExpression" Record undefined
複数のクラスバインディング [class]="classExpression" Array ['foo', 'bar']

単一のスタイルへのバインディング

単一のスタイルバインディングを作成するには、プレフィックス style の後にドットとCSSスタイルの名前を続けます。

たとえば、width スタイルを設定するには、次のように入力します。[style.width]="width"

Angularは、通常は文字列であるバインドされた式の値にプロパティを設定します。オプションで、em% などの単位拡張子を付けることができます。これには数値型が必要です。

  1. スタイルをダッシュケースで記述するには、次のように入力します。

          
    <nav [style.background-color]="expression"></nav>
  2. スタイルをキャメルケースで記述するには、次のように入力します。

          
    <nav [style.backgroundColor]="expression"></nav>

複数のスタイルへのバインディング

複数のスタイルを切り替えるには、[style] 属性にバインドします(例:[style]="styleExpression")。styleExpression は次のいずれかになります。

  • "width: 100px; height: 100px; background-color: cornflowerblue;" などのスタイルの文字列リスト。
  • {width: '100px', height: '100px', backgroundColor: 'cornflowerblue'} などの、スタイル名をキー、スタイル値を値とするオブジェクト。

[style] に配列をバインドすることはサポートされていないことに注意してください。

IMPORTANT: [style] をオブジェクト式にバインドする場合、Angularがクラスリストを更新するにはオブジェクトのIDが変更されている必要があります。 オブジェクトのIDを変更せずにプロパティを更新しても、効果はありません。

単一スタイルと複数スタイルのバインディングの例

nav-bar.component.ts

      
import {Component} from '@angular/core';
@Component({
standalone: true,
selector: 'app-nav-bar',
template: ` <nav [style]="navStyle">
<a [style.text-decoration]="activeLinkStyle">Home Page</a>
<a [style.text-decoration]="linkStyle">Login</a>
</nav>`,
})
export class NavBarComponent {
navStyle = 'font-size: 1.2rem; color: cornflowerblue;';
linkStyle = 'underline';
activeLinkStyle = 'overline';
/* . . . */
}

同じスタイル属性に複数のバインディングがある場合、Angularはスタイリングの優先順位を使用して、どのバインディングを使用するかを決定します。

次の表は、スタイルバインディング構文をまとめたものです。

バインディングの種類 構文 入力の種類 入力値の例
単一のスタイルバインディング [style.width]="width" string undefined
単一のスタイルバインディング(単位付き) [style.width.px]="width" number undefined
複数のスタイルバインディング [style]="styleExpression" string "width: 100px; height: 100px"
複数のスタイルバインディング [style]="styleExpression" Record undefined

スタイリングの優先順位

単一のHTML要素には、CSSクラスリストとスタイル値が複数のソース(たとえば、複数のディレクティブからのホストバインディング)にバインドされている場合があります。

次へ