- 入门
介绍 体系结构 升级到 13.0 版本
- 开发
如何开始 新增页面 新增业务组件 和服务端进行交互 使用第三方类库 构建和发布 升级脚手架 全局配置项 服务端渲染(SSR)
- 进阶
主题系统 图表 国际化 用户认证 ACL Mock 缓存 优化 编码规范建议
- 其他
命令行工具 常见问题 模块注册指导原则 贡献指南 更新日志
提问之前,请先查阅下面的常见问题。
当你有多个懒模块时,希望每个子模块都需要使用组件库时(例如:NgZorroAntdModule
、NgxTinymceModule
)应在 ShareModule
中 export,请参考模块注册指导原则。
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
版本过旧导致部分组件无法加载到相应样式
最简单是使用 networkEnv 插件。
或手动修复:
yarn config set registry https://registry.npmmirror.com
yarn config set sass_binary_site https://npmmirror.com/mirrors/node-sass
# 恢复
yarn config delete registry
yarn config delete sass_binary_site
首先,最新的 iconfont 文件可以到 此链接(镜像) 下载。
最后,在 src/styles/theme.less
重新定义新的路径:
@icon-url: "/assets/iconfont";
使用绝对路径或CDN地址。
缺少语言导入,参考app.module.ts。
我们提供一份在线快照:
git clone --depth 1 --branch gh-pages https://github.com/ng-alain/delon.git docs
你可以简单的创建一个 Docker 容器来快速部署 ng-alain.com 相同的