components README

The project's README from github.com/angular/components. As one markdown file: README.md.

Official components for Angular

npm version Build status Gitter

The Angular team builds and maintains both common UI components and tools to help you build your own custom components. The team maintains several npm packages.

Package Description Docs
@angular/aria Collection of headless, accessible directives that implement common WAI-ARIA patterns Docs
@angular/cdk Library that helps you author custom UI components with common interaction patterns Docs
@angular/material Material Design UI components for Angular applications Docs
@angular/google-maps Angular components built on top of the Google Maps JavaScript API Docs
@angular/youtube-player Angular component built on top of the YouTube Player API Docs

Documentation, demos, and guides | Frequently Asked Questions | Community Google group | Contributing | StackBlitz Template

Getting started

See our Getting Started Guide if you're building your first project with Angular Material.

Contributing

If you'd like to contribute, please follow our contributing guidelines. Please see our help wanted label for a list of issues with good opportunities for contribution. You can also use the good first issue label to find issues if you are just starting to contribute to the project.

About the team

The Angular Components team is part of the Angular team at Google. The team includes both Google employees and community contributors from around the globe.

Our team has two primary goals:

What do we mean by "high-quality" components?

Support policy

Angular Material and the CDK follow the same support and release policy as the Angular framework. For details on supported versions and update practices, see the Angular support policy and schedule.

Browser and screen reader support

The Angular Components team supports the most recent two versions of all major browsers: Chrome (including Android), Firefox, Safari (including iOS), and Edge.

We aim for great user experience with the following screen readers:

components (angular/components)

Searching Database…

25K ·GitHub
Components
这是什么？这是 Angular 官方团队的代码仓库，提供 Angular 应用的组件基础设施和 Material Design 界面组件，涵盖 @angular/material、@angular/cdk、@angular/aria 等 npm 包。
这是一个库还是多个包？这是一个包含多个 npm 包的单体仓库（monorepo）：@angular/material（现成的 Material Design 组件）、@angular/cdk（用于构建自定义组件的基础模块）、@angular/aria（无样式的无障碍指令），以及 @angular/google-maps 和 @angular/youtube-player 两个封装包。
怎样把它添加到 Angular 项目中？请按照官方的入门指南，将 Angular Material 添加到你的 Angular 应用中；这些包通过 pnpm 或 npm 从 Angular 团队的 npm 仓库安装。
使用它之前，我需要先配置好 Angular 吗？需要。它构建在现有的 Angular 应用之上，并依赖 @angular/core、@angular/common、@angular/forms、@angular/compiler 等 Angular 核心包。
它遵循自己的发布计划，还是 Angular 的？Angular Material 和 CDK 与 Angular 框架本身遵循相同的支持和发布策略，因此升级时需要关注 Angular 的版本号。
实际支持哪些浏览器和屏幕阅读器？团队支持 Chrome、Firefox、Safari 和 Edge 的最新两个版本，并以良好的用户体验为目标适配以下屏幕阅读器：Windows 上的 NVDA 和 JAWS、macOS 和 iOS 上的 VoiceOver、Android 上的 TalkBack，以及 Chrome OS 上的 ChromeVox。
在这个项目看来，什么样的组件才算“高质量”？团队追求支持国际化且易于无障碍访问的组件、简洁直观的 API、广泛的测试覆盖、在 Material Design 规范内可定制、尽可能低的性能开销，以及清晰且有文档说明的代码。
@angular/material 和 @angular/cdk 有什么区别？@angular/material 提供开箱即用、带有 Material Design 样式的组件；@angular/cdk 则提供无样式的基础模块和交互模式，供你编写自己的自定义组件。
@angular/google-maps 和 @angular/youtube-player 是什么？它们分别是基于 Google Maps JavaScript API 和 YouTube Player API 构建的轻量级 Angular 组件封装。
What are similar projects?material, vuetify, chakra-ui, material-design-lite, base-ui, mdb-ui-kit, kumo, react-spectrum
Which topics is it in?wai-aria, design-tokens, material, responsive, angular, material-design, design-system, accessibility, component-library, ui-components, npm, frontend
Creator
angular
Size
154.2 MB
Stars
25K
Updated
CommitOct 16Releasev22.2.3Oct 14
Age
10y
Commits · 90 Days