# @dflat-core/web 中文文档

规范地址：https://npmcn.com/package/%40dflat-core/web/

版本：1\.7\.2095
npm 元数据更新时间：2026-11-10T10:48:47.766Z
中文译文更新时间：2026-11-12T05:32:05.066Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dflat-core/web
原文对照：https://npmcn.com/package/%40dflat-core/web/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：18.9 MB，985 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：rxjs ^7\.4\.0，echarts ^6\.0\.0，lodash-es ^4\.17\.21，jwt-decode ^2\.2\.0，ngx-toastr ^20\.0\.5，@angular/cdk ^22\.2\.0，ngx-dropzone ^3\.1\.0，@angular/core ^22\.2\.0，@angular/forms ^22\.2\.0，ng-http-loader ^20\.0\.0，ng-recaptcha-2 ^22\.0\.1，@angular/common ^22\.2\.0，@angular/router ^22\.2\.0，guid-typescript ^1\.0\.9，@microsoft/signalr ^7\.0\.12，ngx-image-compress ^13\.1\.13，@angular/animations ^22\.2\.0，@ng-select/ng-select ^24\.2\.0，@kolkov/angular-editor ^2\.1\.0，@samotics/ngx-treeview ^20\.1\.2，@angular/platform-browser ^22\.2\.0
- 首次发布：2026-09-15T09:01:25.894Z
- 最新版本发布：2026-11-10T10:48:47.538Z
- 近 30 天下载量：5021（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：87（近 12 个月 87 个）

## 中文简介

角平面(核心、核心-_系统_和资产 partagés, empaquetées en unmouse npm 独有.

## 安装

```sh
npm install @dflat-core/web
```

也可以使用：`pnpm add @dflat-core/web`、`yarn add @dflat-core/web`、`bun add @dflat-core/web`

## README

# @dflow-core/web (中文(简体) )

平面平面(Libraries Angular de Dflat, empaquetées en unmouse npm 独有(Angular Package Format, construit avec ng-packagr)).

## 出处

| 导入 | 康特努语Name |
| --- | --- |
| `@dflat-core/web/core` | 乌蒂泰尔人, `EnvironmentBase` |
| `@dflat-core/web/core-model` | 基站(Modèle de base (interfaces générées depuis Dfilt.))是一座位于基站上方的建筑. 内尔。 型号) |
| `@dflat-core/web/core-services` | 认证,信件,菜单,中枢信号R... |
| `@dflat-core/web/core-data` | `DataService`, (中文(简体) ), `EntityDataService` |
| `@dflat-core/web/core-ux` | 构件、指令和服务 |
| `@dflat-core/web/core-ux/testing` | 测试标准`describeBaseComponent`, (中文(简体) ), `describeGeneratedModule`和双重性,促进自由 `.spec.ts` |
| `@dflat-core/web/system-model` | 模块系统(généré) |
| `@dflat-core/web/system-data` | 模块系统服务 |
| `@dflat-core/web/system-root` | 权限、任务和模块菜单系统 |
| `@dflat-core/web/system-ux` | 模块系统和应用 |

源码非类型Script livrées dans le 包 :

-   `assets/` : 样式`site.scss`, (中文(简体) ), `variables.scss`, (中文(简体) ), `text.scss`......)、图像与政策;
-   `scss/` : 样式 globaux (`dflat-app.scss`, (中文(简体) ), `core-ux.scss`, (中文(简体) ), `layout/default/default-layout.scss`(......) (中文(简体) ).

## 科奎尔应用

`system-ux` 4nit, en plus des écrans du module System, to ce qui faisait auparavant (法语) 申请时间`system-ux/src/lib/app`) :

| 符号e | 罗尔 |
| --- | --- |
| `DflatAppModule` | Socle du 模块racine : 模块 Angular 等分级, 截取器 HTTP, 权限, 菜单, langue |
| `DFlatLayoutComponent` | 页:1 |
| `HomepageComponent`, (中文(简体) ), `SearchComponent`, (中文(简体) ), `SearchResultComponent` | 全球信息和研究 |
| `UserMenuComponent`, (中文(简体) ), `UserProfileComponent` | 利用方法的菜单 |
| `AccessDeniedComponent`, (中文(简体) ), `HistoryComponent`, (中文(简体) ), `DFlatSpinnerComponent` | 功用物质 |
| `DflatAppService` | 编号、标识和应用程序版本(`EnvironmentBase`(中文(简体) ) |
| `DFlatAuthInterceptor`, (中文(简体) ), `DFlatPermissionService` | 被拘押者、可居留者 |

A. 模块racine d'une应用se réduit alors à:

```ts
@NgModule({
    declarations: [AppComponent],
    imports: [DflatAppModule.forRoot(environment), routing],
    bootstrap: [AppComponent]
})
export class AppModule {}
```

`environment` 请求 `EnvironmentBase` : URL de l'API, du Central and des fichiers, et, en 选项, `appName`, (中文(简体) ), `appLogoUrl` 页:1 `appVersion`,页和页 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}这太疯狂了 Pour remplaceer un service du socle(菜单、权限、截取器), li suffit 四分卫 `DflatAppModule` 法语 `providers` 月光舱.

申请资料来源全球研究:une classe 厄立特里亚 `DflatSearchProvider` 四分卫 `multi` 沙发 `DFLAT_SEARCH_PROVIDERS`。 。 。 .

## 测试器

```bash
yarn test                              # tous les *.spec.ts du package (Vitest, jsdom)
yarn vitest run core-ux                # un dossier ou un fichier
yarn tsc -p tsconfig.spec.json         # contrôle des types des tests
```

`@dflat-core/web/core-ux/testing` 测试标准 `BaseComponent` 数字 :

```ts
describeBaseComponent('BaseCountryComponent', (app, route) => new TestCountryComponent(app, route), {
    entityKey: 'country', path: '/sys/country', title: 'Pays', permissionKey: 'system.country', requestsSections: true
});
```

埃勒·韦里菲(Elle vérifie le Contrat de) `BaseComponent` (原始内容存档于2012-10-10). sans rendre de gabarit: création dans un celfe (注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注:注 我坚持, `ngOnInit` (Ariane女士,收费处) `dataService.search`,双联轴器 登记机关的要求 `EntitySections`, (中文(简体) ), `Search` 编号 : `refresh`,错误 通知时间, `ngOnDestroy`。 。 。 . Ele n'Utilise que les fonctions globales de l'outil de test (法语:`describe`, (中文(简体) ), `it`, (中文(简体) ), `beforeEach`, (中文(简体) ), `expect`与 `TestBed` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我从头开始. `BaseComponentTestContext` 四分卫 复合型服务 `DataService` 页:1 `Router`) (中文(简体) ).

-   `core-ux/src/lib/v2/components/base-component/base-component.spec.ts` 套间 最低堆肥量和水平试验;
-   `dflat -g ts` génère,倒出彩绘 `Base<X>Component` d'un模块, `<x>.component.generated.spec.ts` (la même套房,avec les valeurs sunces du générateur) 等, par 模块, `<module>-components.generated.spec.ts` (单位:千美元)`describeGeneratedModule` : 色调 搭配一条圣道、独有的圣道、圣道和圣道 模块、菜单、路线存在 (原始内容存档于2018-10-21) (中文(中国大陆) ). and porteurs d'une permission du modu.

公民权利委员会 `@relations` 国家妇女委员会 通用服务单元 `<Module>GeneratedSectionService` (单位:千美元)`<module>-sections.generated.ts`), seul fichier généré qui introduction les composants des oglets. (原始内容存档于2018-09-25). 角质模块 `<module>-ux` 我的儿子建筑师, `EntitySections.register(injector.get(<Module>GeneratedSectionService))`和 `Base<X>Component` 国家权力机关 (单位:千美元)`EntitySections.registerSections(this.getEntityKey(), this.facade)`页:1 复合物:依赖性碳化物。 问讯处 fois par enté: la définition des loglets est gardée dans le scription des écrans) 互联网档案馆的存檔,存档日期2013-12-21. 互联网档案馆的存檔,存档日期2013-12-21. 互联网档案馆的存檔,存档日期2014-12-21. 互联网档案馆的存檔,存档日期2014-12-21 (单位:千美元)`InitCacheService`, (中文(简体) ), `DataService.getCachedValue`),"活字报"(comme les descripeers de filltre and le filltre) (原始内容存档于2018-09-25). vide, et vidée avec eux; l'engistrement sur la façade est seven à chaque 初始化.

Dans le 包件, Vest est lancé directment (`vitest.config.mts`, (中文(简体) ), `tools/vitest.setup.ts`),桑语 `angular.json` : 以 " JIT " 和 " gabarits remplacés par un " 模式为规范 恶作剧 应用 lance les mêmes 测试 `test` (单位:千美元)`@angular/build:unit-test`, Vitest et jsdom), que le modèle (英语: `dflat-webhost` 德拉尔 (单位:千美元)`yarn test` 达斯 `webapps`) (中文(简体) ). 莱斯 `.spec.ts` (原始内容存档于2013-10-12). ne sont pas publiés; seul le point d'entrée `testing` 我最爱的.

## 构造

```bash
yarn install
yarn build           # <dépôt>/artifacts/nodejs/dflat-web (compilation partielle, publiable)
yarn watch           # reconstruction continue pendant le développement
yarn run pack        # <dépôt>/artifacts/nodejs/dflat-web-<version>.tgz
```

(原始内容存档于2013-10-12). Depuis la racine du dépôt,, `scripts/publish-dflat.ps1` (原始内容存档于2018-03-26) (英语). enchaîne ces étapes:

```powershell
.\scripts\publish-dflat.ps1 -bw                  # yarn install si besoin, build, vidage du cache Angular de webapps
.\scripts\publish-dflat.ps1 -pn                  # package versionné + archive .tgz (version calculée depuis npmjs.com)
.\scripts\publish-dflat.ps1 -pn -Push            # ... puis publication sur npmjs.com, après confirmation
```

`yarn install` 简单 `tools/patch-ng-packagr.js` : 纠正 d'un bug de ng-packagr 19.2 sur la réécriture 页:1 `url()` 文稿评论员.

## Utiliser dans un espace de travail Angular / Nx 变相器

1.  依赖性, dans `package.json` : la version publiée sur npmjs.com (英语) (单位:千美元)`"@dflat-core/web": "1.0.2"`), cas de toute 应用程序, 不要将单元格 créées par `dflat -newhost`。 。 。 .
    
    `webapps`, dans le dépôt, n'en dépend pas: il 编译了 libraries depuis leurs 源, (原始内容存档于2012-10-10). Pour développer le packet and l'application en même trips. 化学剂 `webapps/tsconfig.json` 迈恩特 `webapps/libs/dflat-web`, une jonction par point d'entrée 时 数字 `web/dflat-web` 数字 :
    
    ```json
    "@dflat-core/web": ["libs/dflat-web/src/index.ts"],
    "@dflat-core/web/*": ["libs/dflat-web/*/src/index.ts"]
    ```
    
    缩写( 非版本) sont créées par `webapps/tools/check-dflat-web.js`中文无 `yarn start` 页:1 `dflat -r` 编号 : `dflat -rc`. Elles sont individuelles: une seule jonction (英语) 数字 `web/dflat-web` ferrait résoudre 角地达斯 `web/dflat-web/node_modules` (双 (见A/CN.9/WG.III/WP.III/WP.1号文件)。 TypeScript, 模板, 样式) est 重新编译 `nx serve` dans la fulée (quelques secondes), sans 汇编器 `dist` 尼维德 le 缓存. 自动安装器 `peerDependencies` 包装: 解放 角分层使用量`ngx-toastr`, (中文(简体) ), `ng-http-loader`(......) (中文(简体) ). 基础和阶级风格 使用 sant dans 资产(`assets/components/bootstrap-lite.scss`) (中文(简体) ). Les icônes “ fa fa ” , “不使用” 外加字体优美 : sce sont des SVG des 资产 (单位:千美元)`assets/images/icons/fa`, feuille (法语) `assets/components/icons.scss`) (中文(简体) ). 勒莫代尔 `dflat-webhost` 名单 `package.json` (原始内容存档于2018-03-26). du front qu'il génère.
    
2.  Dans les option de building de l'Application (《建立申请的备选办法》)`project.json`) :
    
    ```json
    "preserveSymlinks": true,
    "stylePreprocessorOptions": { "includePaths": ["node_modules", "node_modules/@dflat-core/web/assets"] },
    "assets": [{ "input": "node_modules/@dflat-core/web/assets", "glob": "*/**", "output": "assets" }]
    ```
    
    `preserveSymlinks` 昂古拉尔·德皮斯 `web/dflat-web/node_modules` (双例. 莱斯 `includePaths` 误入歧途 `dflat-app.scss` 《一揽子资产协定》.
    
3.  样式 globaux (`styles.scss`) :
    
    ```scss
    @import "../../../node_modules/@dflat-core/web/scss/dflat-app.scss";
    ```
    
    `dflat-app.scss` (a) 使用基准和课程的变数、样式和类别, avec le Thème Pulse du 包件 (中文(简体) )`assets/components/bootstrap-lite.scss`,générée par `tools/generate-bootstrap-lite.js` 4, de `assets/theme-variables.scss` 页:1 `assets/theme.scss`, (中文(简体) ), `core-ux.scss`, (中文(简体) ), `site.scss` 和《联合国宪章》 科奎尔。 使用“靴子”安装和导入类 4月的聚会 `dflat-app.scss`。 。 。 .
    
    斯多克(托斯特) 静态的 dans le tableau `styles` 建设选项.
    

## 自由之路

平面结构 :

-   **进口自由桶** (单位:千美元)`@dflat-core/web/core-ux` depuis core-ux):使用器 un 克林素相对法. 解放者、游手好闲者 `@dflat-core/web/<librairie>` · ;
-   **用于出口的图特类** 简写 `src/index.ts` 自由之地(NG3001);
-   **pas de cycle d'imports entre uncomposant and ce qu'utilise 儿子模板** (NG3003) (英语). Pour casser 未循环 : `import type` lorsque le siculate ne sert qu'au 打字法, ou un `InjectionToken` lorsqu'un 类型去堆肥 离别 `core-ux/src/lib/modals/dialog-component.tokens.ts`, (中文(简体) ), `RowRefHost` 达斯 `row-ref.directive.ts`\* ;
-   **d'imports centle une classe and sa classe classe 括号**même 间接: chamque point d'entrée est apladi en un soul fichier and la classe foure pourrait 和 étre émise anvant la parente(父子双亲双亲) (单位:千美元)`Cannot access 'X' before initialization` (au démarrage de l'application). `tools/check-bundles.js`中文无 `npm run build`{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}别这样.

## 法典

`codegenerator -ts -webpkg <dépôt>\web\dflat-web` 核心型、系统型、, 海关和海关总署(海关总署) `@dflat-core/web/<librairie>`桑斯语 `-webpkg` (申请时间) (原始内容存档于2018-09-29). hors dépôt, ces libraries ne sont pas générées:elles sont 4nies par le packet. `dbmanager` 语 文 系统 dans `system-root/src/lib`。 。 。 .

## 常见问题

### @dflat-core/web 是什么？

角平面\(核心、核心-系统和资产 partagés, empaquetées en unmouse npm 独有\.

### 如何安装 @dflat-core/web？

在项目目录运行 npm install @dflat-core/web，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：rxjs（^7\.4\.0）、echarts（^6\.0\.0）、lodash-es（^4\.17\.21）、jwt-decode（^2\.2\.0）、ngx-toastr（^20\.0\.5）、@angular/cdk（^22\.2\.0）、ngx-dropzone（^3\.1\.0）、@angular/core（^22\.2\.0）、@angular/forms（^22\.2\.0）、ng-http-loader（^20\.0\.0）、ng-recaptcha-2（^22\.0\.1）、@angular/common（^22\.2\.0）、@angular/router（^22\.2\.0）、guid-typescript（^1\.0\.9）、@microsoft/signalr（^7\.0\.12）、ngx-image-compress（^13\.1\.13）、@angular/animations（^22\.2\.0）、@ng-select/ng-select（^24\.2\.0）、@kolkov/angular-editor（^2\.1\.0）、@samotics/ngx-treeview（^20\.1\.2）、@angular/platform-browser（^22\.2\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @dflat-core/web 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @dflat-core/web 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @dflat-core/web 可以商用吗？

@dflat-core/web 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @dflat-core/web 的下载量有多少？

根据 npm 官方下载统计，@dflat-core/web 在 2026/10/12 – 2026/11/10 这 30 天内被下载 5,021 次，日均约 167 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dflat-core/web 还在维护吗？

最新版本 1\.7\.2095 发布于 2026/11/10（1 天前）；至今共发布 87 个版本，其中过去 12 个月发布了 87 个；首次发布于 2026/09/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

