常见问题

提问之前,请先查阅下面的常见问题。

基础

Can't Bind to since it isn't a known property of

当你有多个懒模块时,希望每个子模块都需要使用组件库时(例如:NgZorroAntdModuleNgxTinymceModule)应在 ShareModule 中 export,请参考模块注册指导原则

Expression Changed After It Has Been Checked Error 错误

Angular 下常见错误,这篇文章 会帮助你理解原因。

Can't bind to 'formGroup' since it isn't a known property of 'form'

Angular 下常见错误,使用 Reactive Forms 需要额外引入 ReactiveFormsModule,可以参考官方文档

数据修改后页面为什么没有更新

NG-ZORRO 及 @delon/* 组件默认在 OnPush 模式下工作,mutate 对象或者数组不会触发 Angular 的变更检测,请使用 immutable 方式。

如何使用@delon每日构建版本

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 脚本。

安装

为什么找不到 ng-zorro-antd/src/*.less 样式?

两种情况:

  • 使用 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

配置

如何本地部署 antd 图标?

首先,最新的 iconfont 文件可以到 此链接镜像) 下载。

最后,在 src/styles/theme.less 重新定义新的路径:

@icon-url: "/assets/iconfont";

使用绝对路径或CDN地址。

Missing locale data for the locale "zh-cn"

缺少语言导入,参考app.module.ts

如何本地部署ng-alain.com文档

我们提供一份在线快照:

git clone --depth 1 --branch gh-pages https://github.com/ng-alain/delon.git docs

你可以简单的创建一个 Docker 容器来快速部署 ng-alain.com 相同的