Fundamental Library for Angular 使用教程
1. 项目介绍
1.1 项目概述
Fundamental Library for Angular 是一个由 SAP 设计系统提供的 Angular 组件库,旨在帮助开发者构建具有 SAP 外观和感觉的现代化产品用户体验。该项目包含两个主要的 npm 包:
- @fundamental-ngx/core: 提供了 Fundamental Library Styles 的基础 Angular 实现,为开发者提供了丰富的组件库,用于构建 Angular 应用程序。
- @fundamental-ngx/platform: 在核心库的基础上,提供了更高层次的抽象和额外的功能,以满足应用程序的需求,并隐藏了大部分内部实现细节,从而提高开发效率。
1.2 项目目标
- 提供一套符合 SAP 设计标准的 Angular 组件库。
- 支持 Angular 15 及以上版本。
- 提供灵活的组件定制选项。
- 促进开发者社区的贡献和反馈。
2. 项目快速启动
2.1 环境准备
在开始之前,请确保你已经安装了以下工具:
- Node.js (建议版本 14 及以上)
- Yarn (通过
corepack enable
启用)
2.2 安装步骤
-
克隆项目仓库:
git clone https://github.com/SAP/fundamental-ngx.git
-
进入项目目录:
cd fundamental-ngx
-
安装依赖:
yarn install
-
启动开发服务器:
yarn start
2.3 示例代码
以下是一个简单的示例,展示如何在你的 Angular 项目中使用 Fundamental Library for Angular 的按钮组件:
import { Component } from '@angular/core';
@Component({
selector: 'app-root',
template: `
<fd-button label="Click Me"></fd-button>
`,
})
export class AppComponent {}
3. 应用案例和最佳实践
3.1 应用案例
Fundamental Library for Angular 广泛应用于 SAP 内部和外部的各种项目中,特别是在需要符合 SAP 设计标准的 Angular 应用程序中。例如,SAP 的云平台和内部管理系统都使用了该库来确保一致的用户体验。
3.2 最佳实践
- 组件定制: 充分利用组件的灵活性,直接在 HTML 模板中进行细粒度的定制。
- 版本管理: 确保你的项目使用的是与 Angular 版本兼容的 Fundamental Library for Angular 版本。
- 社区贡献: 积极参与社区,贡献代码和反馈问题,帮助改进库的质量和功能。
4. 典型生态项目
4.1 Fundamental-react
Fundamental-react 是 Fundamental Library Styles 的 React 实现,提供了与 Angular 版本类似的组件库,适用于 React 开发者。
4.2 Fundamental-vue
Fundamental-vue 是 Fundamental Library Styles 的 Vue 实现,为 Vue 开发者提供了符合 SAP 设计标准的组件库。
4.3 其他相关项目
- SAP Fiori: SAP 的 Fiori 设计系统,提供了更广泛的设计指南和组件库。
- SAP UI5: SAP 的 UI5 框架,提供了丰富的 UI 组件和工具,适用于企业级应用开发。
通过这些生态项目,开发者可以构建出更加统一和高质量的用户界面,满足不同技术栈的需求。