- 入门
介绍 体系结构 升级到 21.0 版本
- 开发
新增页面 新增业务组件 和服务端进行交互 使用第三方类库 构建和发布 升级脚手架 全局配置项 如何开始 服务端渲染(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。