Angular Material

@angular/material & @angular/cdk

Version: 21.0.3 (Feb 2026) Tags: Material Design, CDK, Components, UI Library

References: Docs — components, guides • CDK Docs • GitHub Issues • Changelog

API Changes

This section documents recent version-specific API changes.

• NEW: Angular Aria — New low-level component library for accessible, headless components that can be styled custom source

• NEW: CDK overlays now use browser's built-in popovers for improved accessibility source

• NEW: Material Design system tokens — Use utility classes to apply Material tokens directly in templates source

• NEW: CDK Drag & Drop improvements — Allow copying items between lists source

• NEW: Angular v21 — Full support for new Angular features including zoneless change detection

Best Practices

• Use standalone components — Import Material components directly without NgModule

import { Component } from '@angular/core';
import { MatButtonModule } from '@angular/material/button';
import { MatCardModule } from '@angular/material/card';

@Component({
  standalone: true,
  imports: [MatButtonModule, MatCardModule],
  // ...
})
export class ExampleComponent {}

• Use CDK for custom components — Use CDK (Component Dev Kit) for behavior primitives like drag-drop, overlays, menus without Material styling

• Use CDK Virtual Scroll for large lists — Improve performance with cdkVirtualScrollViewport instead of rendering all items

<cdk-virtual-scroll-viewport itemSize="50" class="viewport">
  <div *cdkVirtualFor="let item of items">{{item.name}}</div>
</cdk-virtual-scroll-viewport>

• Use trackBy with ngFor — Prevent unnecessary DOM re-renders

• Customize themes with SCSS — Use Material's theming system for custom colors and typography

• Use ChangeDetectionStrategy.OnPush — Improve performance with default change detection strategy

• Follow accessibility guidelines — Use ARIA labels, keyboard navigation, and focus management provided by CDK components

Discussions Reference Index

GitHub Discussions

• Angular Material Discussions
• Angular Community

Stack Overflow

• angular-material tag
• angular-cdk tag

Docs Reference Index

Official Documentation

• Angular Material - Main documentation
• Angular CDK - Component Dev Kit
• Getting Started
• Theming Guide
• Component Preview

API Reference

• Material Components API
• CDK API

External Resources

• Angular Official
• Material Design

Issues Reference Index

GitHub Issues

• Angular Material Issues
• Angular CDK Issues

Bug Reports

Search for common issues:

• Theme issues
• Performance issues
• Accessibility issues

Releases Reference Index

GitHub Releases

• Angular Material Changelog
• All Releases

Blog Posts

• Announcing Angular v21
• Angular v20 Blog