- 入门
- 介绍
- 体系结构
- 更新日志
21.3.0 - 升级到 21.0 版本
- AI
- LLMs.txt
新增
- 开发
- 如何开始
- 新增页面
- 新增业务组件
- 和服务端进行交互
- 使用第三方类库
- 构建和发布
- 升级脚手架
- 全局配置项
- 服务端渲染(SSR)
- 进阶
- 主题系统
- 图表
- 国际化
- 用户认证
- ACL
- Mock
- 缓存
- 优化
- 编码规范建议
- 其他
- 命令行工具
- 常见问题
- 模块注册指导原则
- 贡献指南
提问之前,请先查阅下面的常见问题。
Angular 下常见错误,这篇文章 会帮助你理解原因。
Angular 下常见错误,使用 Reactive Forms 需要额外引入 ReactiveFormsModule,可以参考官方文档。
NG-ZORRO 及 @delon/* 组件默认在 OnPush 模式下工作,mutate 对象或者数组不会触发 Angular 的变更检测,请使用 immutable 方式。
NG-ALAIN 提供一个 delon-builds 仓储作为每日构建版本,它并不是最终稳定版本,但包含最新已修复BUG、最新功能,要使用可以在根目录创建 delon.sh:
#!/usr/bin/env bash
set -e
echo "Download latest @delon version"
rm -rf delon-builds
git clone --depth 1 https://github.com/ng-alain/delon-builds.git
rm -rf node_modules/@delon
rm -rf node_modules/ng-alain
rsync -am delon-builds/ node_modules/
NG_ALAIN_VERSION=$(node -p "require('./node_modules/ng-alain/package.json').version")
rm -rf delon-builds
echo "Using ng-alain version: ${NG_ALAIN_VERSION}"
当需要使用@delon的每日构建版本,只需要在运行:
bash delon.sh
如果是 Windows 环境,请使用 WSL 来执行 Bash 脚本。
两种情况:
cnpm 安装依赖包,会遇到无法找到样式文件。这是由于 cnpm 采用的是软链接路径形式,导致 ng-zorro-antd 文件夹名有所变动,因此建议改用 yarn 安装依赖包,如果是网络因素,请参考下方的如何正确使用淘宝源。ng-zorro-antd 版本过旧导致部分组件无法加载到相应样式安装 nnrm 插件。
# 安装 nnrm
npm install -g nnrm
# 将Npm切换至淘宝源(不同 npm 源管理器命令有点不一样,更多细节请参考 nnrm 文档)
nnrm use taobao
首先,最新的 iconfont 文件可以到 此链接(镜像) 下载。
最后,在 src/styles/theme.less 重新定义新的路径:
@icon-url: "/assets/iconfont";
使用绝对路径或CDN地址。
缺少语言导入,参考app.module.ts。
线上文档将只保留最近三个主版本号的数据,若是低版本可以通过本地部署来查看:
git clone --depth 1 -b full https://github.com/ng-alain/archive-docs.git ng-alain-doc
cd ng-alain-doc
npm install
npm start
部分360浏览器内置的 Chrome 核心过低,导致部分 CSS3 未支持,可以手动增加 .browserslistrc 更多细节参考 #2310。