# @arsedizioni/ars-utils 中文文档

规范地址：https://npmcn.com/package/%40arsedizioni/ars-utils/

版本：22\.7\.8
npm 元数据更新时间：2026-10-23T12:17:36.262Z
中文译文更新时间：2026-11-06T20:31:56.795Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：4.7 MB，95 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：tinymce ^8，date-fns ^4，file-saver ^2，@azure/msal-angular ^6，@azure/msal-browser ^5
- 首次发布：2020-03-10T16:28:35.836Z
- 最新版本发布：2026-10-23T12:17:36.045Z
- 近 30 天下载量：3613（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：2845（近 12 个月 578 个）

## 中文简介

ARS Edizioni Angular网络应用程序共享共同的工具和独立组件.

## 安装

```sh
npm install @arsedizioni/ars-utils
```

也可以使用：`pnpm add @arsedizioni/ars-utils`、`yarn add @arsedizioni/ars-utils`、`bun add @arsedizioni/ars-utils`

## README

# ARS 用户

ARS Edizioni Angular网络应用程序共享共同的工具和独立组件.

Rispetto alla 版本 单立体 先例 adotta la stuttura 进入点 内存 `@fabio.buscaroli/scm-utils`: 代码分割 e 树会摇动 sono il critrio di 平地取出无花果.

## 平台

角22+物质

## 入境点

I'enter point secondario e'l'unica unita' di (英语) 代码分割 riconosciuta da ng-packagr, quindi 认知 gruppo di simboli che ha un ciclo {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}这是个入口 Imprincation是Sempre Dal路径的特异性.

### 核心协商

| 利维罗 | 入境点 | 康特努托语Name | 说明 |
| --- | --- | --- | --- |
| L0 级 | `core` | `SystemUtils`,模型,定义,管子,急切验证器, servizi(广播,屏幕,主题,喷出,环境), `LoginOAuthType` | 角材料 |
| L0 级 | `core.date` | `provideArsDateFns`, (中文(简体) ), `provideArsLocalDates`, (中文(简体) ), `MAT_DATE_FNS_FORMATS`, (中文(简体) ), `arsLocalDateInterceptor`, (中文(简体) ), `ARS_TIME_ZONE` | 岛 `@angular/material/core` + 键 `datepicker` |
| L0 级 | `core.markdown` | `MarkdownUtils`, (中文(简体) ), `FormatMarkdownPipe` | 平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平地平 |
| L0 级 | `core.validators` | prottive 校验器每i 格式模板驱动(`ValidatorDirective`, (中文(简体) ), `ValidIfDirective`, (中文(简体) ), `EqualsValidatorDirective`, (中文(简体) ), `PasswordValidatorDirective`, (中文(简体) ), `EmailsValidatorDirective`, (...) (中文(简体) ) | 岛 `@angular/forms` (53 KB): (韩语) `core` (原始内容存档于2018-10-21) (英语). sta sul percorso di sot e nove trasinarselo |
| L0.5 号 | `ui.shell` | `ShellService` (单位:千美元)`info`, (中文(简体) ), `error`, (中文(简体) ), `busy*`, (中文(简体) ), `wait`, (中文(简体) ), `BusyTimer`, (中文(简体) ), `ShellMessageComponent`, (中文(简体) ), `ShellBusyComponent` | 0 材料 e 零 CDK: e' quello che shell, 截取器, 守护 e 应用 初始化 possono permetersi sul percorso di sot |
| L1 级 | `ui` | `FlexLayoutModule`, (中文(简体) ), `MediaObserver`, (中文(简体) ), `UIService`对话框 | 内核: deve restare magro, e 非导入无核材料 |
| L1 级 | `ui.paginator` | `PaginatorIntl` | 岛 `@angular/material/paginator`切西波塔迪特罗 `mat-select` 电子 `mat-option` |
| L1.5级 | `ui.dialogs` | `DialogService` (续) `ShellService`\+ 确认,删除,吐司, `open`,e 孔径猪笼草对话 | 土豆干酪干酪干酪干酪干酪干酪干酪干酪干 |
| L2 数据 | `ui.dialogs.auth` | 证书 重置密码 恢复密码, `OtpInputComponent`, (中文(简体) ), `PasswordStrengthComponent` | 独行路由 di 登录/账户 |
| L2 数据 | `ui.dialogs.prompt` | 即时、即时、即时 | 移植 `@angular/material/datepicker` |
| L2 数据 | `ui.dialogs.select` | 选择, 选择树, 发送到 | 移植 `mat-tree`, (中文(简体) ), `mat-list`, (中文(简体) ), `mat-chips` |
| L2 数据 | `ui.files` | 文件输入、 文件审查、 文件选择、 图片选择 |  |
| L2 数据 | `ui.controls` | 按钮选择器、按钮切换器、芯片选择器 | 基础材料库:按钮、图标、窗体字段 |
| L2 数据 | `ui.controls.date` | `MatDatepickerParseErrorFixDirective`, (中文(简体) ), `CalendarEmptyHeader` | 岛 `@angular/material/datepicker`数字 : `ui.dialogs.prompt` 独奏游戏 |
| L2 数据 | `ui.controls.tree` | `TreePickerComponent` | 岛 `mat-tree`, (中文(简体) ), `mat-tabs`, (中文(简体) ), `mat-input`, (中文(简体) ), `mat-checkbox`控制我们 |
| L2 数据 | `ui.filters` | `FilterBarComponent` + 型号 `Filters` |  |
| L2 数据 | `ui.navigation` | `NavigationBarComponent` + definizioni 键 | 外壳应用 |

### 具体

| 利维罗 | 入境点 | 康特努托语Name | 松花节 |
| --- | --- | --- | --- |
| L0.5 号 | `support.common` | `SupportService`名称、定义、信息 | \- 说吧 |
| L0.5 号 | `evolution.common` | `EvolutionService`、账户、遵守、登录、拦截器认证 | \- 说吧 |
| L2 数据 | `ui.oauth` | `LoginOAuthComponent`, (中文(简体) ), `LoginOAuthOkMSComponent` | `@azure/msal-angular`, (中文(简体) ), `@azure/msal-browser` |
| L2 数据 | `ui.help` | `HelpService`, (中文(简体) ), `HelpViewerComponent`, 模范代伊卡皮托利 | \- 说吧 |
| L2 数据 | `ui.tinymce` | `TinymceEditorDirective`, (中文(简体) ), `TinymceLoaderService`, (中文(简体) ), `TinymceUtils`, (中文(简体) ), `TinyMceEditorComponent`, (中文(简体) ), `langs/it.js` | `tinymce` (caricato a runtime) (英语) |
| L2 数据 | `ui.notifications` | `NotificationsBrowserComponent` (预算外) `support.ui`(中文(简体) ) | \- 说吧 |
| L2 数据 | `clipper.common` | `ClipperService`,文档,登录,canali econtatori 非活性,截取器认证 | {\\fn华文楷体\\fs20\\bord1\\shad1\\1che0e0e0\\2ch000000}相關相關相關相關相關相關相關相關相關相關相關相關相關相關相關相關相關相關相關相關相關相關相關相關相 |
| L4 级 | `clipper.ui` | 浏览器、文档、参考文献、搜索\* e `ClipperDocumentUtilsService` | `clipper.scss` |

我相对依赖opzionali(`@azure/msal-*`, (中文(简体) ), `tinymce`) 服务 单声道 `ui.oauth` 电子 `ui.tinymce`: sono dichiarati in (英语: `peerDependenciesMeta.optional` (原始内容存档于2017-09-21). prorio perche' nesun altro intent li aggancia.

### Grafo delle dipendenze 静态

```
core        core.date        core.markdown        core.validators        ui.paginator        ui.controls.date
 |    \
 |     ui.shell
 |        |
 ui ------|-----------------------------------------------------------
 |        |      |               |             |             |                 |               |
 |        | ui.controls  ui.controls.tree  ui.filters  ui.navigation  ui.dialogs.select  clipper.common
 |        |
ui.dialogs      <-- DialogService extends ShellService: dipende da `ui` E da `ui.shell`
 |         |                  |              |          |            |
 |   ui.dialogs.auth   ui.dialogs.prompt  ui.files   ui.help    ui.oauth
 |                                                   ui.notifications (+ support.common)
clipper.ui  (+ clipper.common, ui.controls, ui.controls.date, ui.files, ui.dialogs.select)

`ui.dialogs` --- import() --->  ui.dialogs.{auth,prompt,select}, ui.files
Gli archi dinamici puntano all'insu' e sono l'unica ragione per cui quei quattro entry point
restano fuori dal bundle iniziale. Regge finche' NESSUNO di loro importa `DialogService`: per
`error()` e `busy()` iniettano `ShellService`.

`ui.controls.date` non dipende da nulla della libreria (solo `@angular/core` e
`@angular/material/datepicker`): e' cio' che permette al chunk di `ui.dialogs.prompt` di
agganciare la direttiva senza linkare il file di `ui.controls`.
```

`evolution.common` 电子 `support.common` dipendono 独奏 `core`。 。 。 .

### 调制器

1.  伊格莱弗 **静态** tra 切入点去除 DAG : `ui.dialogs` raggiunge i 对话框 比索独奏会 `import()`, e quei quttro 切入点 `DialogService` 在nessun modo中——ng-packagr rifiuta la building con中——纳克-packagr rifiuta la building con中——纳克-帕克-克克克-克克克-克克克-克克克-克克克克克-克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克 `circular dependency` (原始内容存档于2018-03-21). al primo che lo fa. (原始内容存档于2018-06-21) (英语). Per messaggi e attesa iniettano `ShellService`{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}这真是太棒了.
2.  {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我直言不讳 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我和Pesanti Stanno对话 `ui` (单位:千美元)`dialog.definitions.ts`) (中文(简体) ). {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我就是这个意思`import()` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}请把车停在地上.
3.  我假装我们 `import type` 每i tipi dei 组件 e `import()` 每瓦罗里:e'quello {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我和fuori dal bund iniziale 对话 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我对着他.
4.  {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}多波·诺阿·莫迪卡 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080} `import()` sopravvivano alla 建设: `grep -o "import('@arsedizioni[^']*')" dist/ars-utils/fesm2022/*ui.dialogs.mjs` 脱口而出,我不懂.
5.  `ui.shell` 非导入无效 da `@angular/material` 没有 `@angular/cdk`,e nemmeno da (法语) `ui`。 。 。 . E'l'unica ragione per cui esiste:se ci finisce dentro un solo simbolo di material, la shell (英语) 撕裂一粒活泼活泼的靴子 Da verificare dopo 认知建筑: `grep -oE "@angular/(material|cdk)[^'\"]*" dist/ars-utils/fesm2022/*ui.shell.mjs` 不偏离 是无花果.
6.  萨夫拉波西齐奥尼 `ui.shell` 静脉管 **顶层** del浏览器,非nello sack del CDK. Da Angular CDK 22 认知覆盖 viene aperto 来 `popover="manual"`, quindi 解析对话框 非 sta piu' a z-index 1000: sta nel上层, che viene diegnato sopra tutta la pagina (原始内容存档于2018-10-21). qualunque cosa dica lo z-index della Pagina. 无纳米,每克克特高地,非克特高地: 每个任务 `ShellService` {\\fn黑体\\fs20\\shad2\\2ah82\\3ah20\\4ah33\\fscx95\\3ch592001\\be1}我该挂了 `showPopover()`。 。 。 . (原始内容存档于2018-07-21) (英语). Nel top place l'ordine e' quello di promozione, l'ultimo promosso sta sopra. 达 qui尔 备忘: `setBusy()` 有活要干,有活要干, `DialogService.open()` 奇亚玛 `raiseMessage()` dopo aver aperto 未对话框, e chiama `clearBusy(true)` (原始内容存档于2018-10-25). senza perio di grazia. 拉科皮亚 `--ars-shell-dialog-z-index`编号 :`--ars-shell-busy-z-index` (1100/1090) resta vicia e service ancora: e' quello che ordina gli over sui 浏览器 senza Popover API, dove nemmeno il CDK la usa. 维基语录链接:名人名言 - 文学作品 - 谚语 - 谚语 (出自"美国画报") poperover API del CDK con 软件 `{ provide: OVERLAY_DEFAULT_CONFIG, useValue: { usePopover: false } }`。 。 。 .
7.  `ui` 非进口valori da 材质. `PaginatorIntl` e'uscito da li' properio:时代 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我就是这个意思 `mat-paginator` + 键 `mat-select` + 键 `mat-option` 鸡尾酒 `ui.dialogs`雷斯塔诺应克塞齐奥尼, 通心电压: `MatFormFieldAppearance` 内 `dialog.definitions.ts`{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你为什么这么觉得 `import type` e 四分点 汇编中,e `@angular/cdk/layout` (1个KB) di Cui `MediaObserver` 哈比诺.

### 哀鸽花开

`core` + 键 `ui.shell`索诺一号应接点 che una applicazione ARS carica comunque priment di avere una rotta, e gli unici due che 非成本材料. `core` 移植 `SystemUtils`我建模里,我说, `BroadcastService`, (中文(简体) ), `SplashService`, (中文(简体) ), `EnvironmentService`, (中文(简体) ), `ThemeService`· ; `ui.shell` porta il modo (法语) 可怕的一切 e's scaduta o che l'API non risponde。 i't.

非索诺非入门点独奏, 或非 devono diventarlo : `core` e' L0 或 ci didendono 起搏 `clipper.common`, (中文(简体) ), `evolution.common` 电子 `support.common`{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我们一起来 丰德利语Name (原始内容存档于2017-03-21) (中文(中国大陆) ). Cioe' rompore la regola 1.

La Conseguenza practica per chi scrive l'applicazione : (原始内容存档于2018-09-29)

-   弹壳,拦截器,警卫, `provideAppInitializer` - > (中文) `ShellService` 数字 `ui.shell`
-   组件 di rotta - > `DialogService` 数字 `ui.dialogs`说吧 说吧

我tre servizi sono una catena, 非tre servizi diversi: re:

```
ShellService                info, error, busy*, wait, busyTimer     ui.shell
  └ DialogService           + open, confirm, delete, toast,         ui.dialogs
                              select, prompt, sendTo, ... (pigri)
```

Quindi chi inita (英语) `DialogService` (原始内容存档于2018-10-29) (英语). hatto quello che aveva priment: `info`, (中文(简体) ), `error` 电子 `busy` 无 索诺·斯帕里蒂 索诺·埃迪塔蒂 e'e una experimentazione sola, quella (英语) 桑扎物质.

`ShellService.info()` 电子 `ShellService.error()` 汉诺·克利·斯泰斯·帕尔米特里 内洛·斯泰索·奥尔丁, delle omonime di (法语) `DialogService`{\\fn方正黑体简体\\fs18\\b1\\bord1\\shad1\\3ch2f2f2f}美国海军陆战队 (原始内容存档于2018-07-21). iniettato e ninent'altro.

## Diverenze rispetto alla vatee excore (22.1.x 单立体) 互联网档案馆的存檔,存档日期2014-12-02

-   内孙管光: `@arsedizioni/ars-utils` 独奏 `ARS_UTILS_VERSION`。 。 。 .
-   `ui` 非折叠 piu' i 对话框 : `DialogService` 进入 `ui.dialogs`。 。 。 .
-   `ui.application` 不,不,不,不,不,不,不 `DialogService`我控制着Li sono在 `ui.controls`,则我存档于 `ui.files`中,我将filtri输入 `ui.filters`,在 `ui.navigation`。 。 。 .
-   `SystemUtils.markdownToHtml` 不偏执的 piu' : 我们是 `MarkdownUtils.toHtml` 达 `core.markdown`。 。 。 .
-   `SelectableModel` espone (英语) `first` 电子 `selectedAny` 邮政 `selectedFirst` 电子 `selectedAll`。 。 。 .
-   `support.ui` 奇亚玛 `ui.notifications`, (中文(简体) ), `help` 奇亚玛 `ui.help`, (中文(简体) ), `tinymce` 奇亚玛 `ui.tinymce`。 。 。 .
-   `PaginatorIntl` 非 s入 `ui`: 输入 `ui.paginator`。 。 。 .
-   `ui.tinymce` 非双双双 `@tinymce/tinymce-angular`{\\fn华文楷体\\fs20\\bord1\\shad1\\1che0e0e0\\2ch000000}:"我编辑了""""""""""""""""""""""""""" `[tinymceEditor]` 苏 奴纳 `<textarea>`{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}一个运行时间da `TinymceLoaderService`.Il 组件 `<editor>` 说不出口.
-   {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}不 斯坦诺 皮乌在 `core`: stanno 输入 `core.validators`{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我还好 切入点 : `@angular/forms`。 。 。 .
-   我表示CSS Della 贝壳 stanno tutti sotto `--ars-shell-dialog-*` 电子 `--ars-shell-busy-*`: 初级 时空 `--ars-dialog-*`, (中文(简体) ), `--ars-scrim-color`, (中文(简体) ), `--ars-busy-*` 电子 `--ars-progress-track-color`{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 孔通德瓦诺 con `--ars-dialog-item-*`{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我和素材公司对话 没用的 (原始内容存档于2018-10-21). sovrascrivva qualcuno deve rinominarlo.
-   La sell no deve piu' iniettare (英语:La sell un deve piu' iniettare) (法语). 拉贝壳(英语:La sell un deve piu' iniettare) (法语) `DialogService` 每多处出错e: c'e' `ShellService` 内 `ui.shell`。 。 。 .
-   `info`, (中文(简体) ), `error`, (中文(简体) ), `busy`, (中文(简体) ), `busySpinner`, (中文(简体) ), `busyHourglass`, (中文(简体) ), `wait`, (中文(简体) ), `busyTimer` 电子 `clearBusy` 索诺语 passati a (英语) `ShellService`。 。 。 . `DialogService` (原始内容存档于2012-10-12). liredita, quindi nesuna chiamata cambia.
-   `info()` 电子 `error()` 库克诺 `ShellMessageRef` 输入 di `MatDialogRef<InfoDialogComponent>`。 。 。 . (原始内容存档于2018-03-21) (英语). In myARS nesun chiamante usava quel valore; Controlale nelle altre applicazioni.
-   `clearBusy()` 阿凯塔 `immediate`数字 : `clearBusy(true)` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}不是阿斯佩塔 i 500ms dilzia.
-   `BusyTimer` i 导入a da `ui.shell`非比丘达 `ui.dialogs`。 。 。 .
-   `InfoDialogComponent` 电子 `BusyDialogComponent` 非esistono piu': li sostituiscono 互联网档案馆的存檔,存档日期2013-12-02 `ShellMessageComponent` 电子 `ShellBusyComponent`桑扎物质.

## 作者数

法比奥·布斯卡洛利,阿尔贝托·多里亚

## 常见问题

### @arsedizioni/ars-utils 是什么？

ARS Edizioni Angular网络应用程序共享共同的工具和独立组件\.

### 如何安装 @arsedizioni/ars-utils？

在项目目录运行 npm install @arsedizioni/ars-utils，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：date-fns（^4）、file-saver（^2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @arsedizioni/ars-utils 支持 TypeScript 吗？

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

### @arsedizioni/ars-utils 支持 ESM 还是 CommonJS？

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

### @arsedizioni/ars-utils 可以商用吗？

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

### @arsedizioni/ars-utils 的下载量有多少？

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

### @arsedizioni/ars-utils 还在维护吗？

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

