@angular/commonlink

Implements fundamental Angular framework functionality, including directives and pipes, location services used in routing, HTTP services, localization support, and so on.

Implements an HTTP client API for Angular apps that relies on the XMLHttpRequest interface exposed by browsers.

Supplies a testing module for the Angular HTTP subsystem.

Supplies infrastructure for testing functionality supplied by @angular/common.

Provides tools for upgrading from the $location service provided in AngularJS to Angular's unified location service.

导出所有基本的 Angular 指令和管道，例如 NgIf、NgForOf、DecimalPipe 等。 它会由 BrowserModule 进行二次导出，当你使用 CLI 的 new 命令创建新应用时，BrowserModule 会自动包含在根模块 AppModule 中。

Exports all the basic Angular directives and pipes, such as NgIf, NgForOf, DecimalPipe, and so on. Re-exported by BrowserModule, which is included automatically in the root AppModule when you create a new app with the CLI new command.

此 LocationStrategy用来配置 Location服务，以便在浏览器 URL 的 hash 片段中表示其状态。

A LocationStrategyused to configure the Locationservice to represent its state in the hash fragment of the browser's URL.

一个服务，应用可以用它来与浏览器的 URL 互动。

A service that applications can use to interact with a browser's URL.

使 Location 服务能够从浏览器的 URL 读取路由状态。 Angular 提供了两种策略： HashLocationStrategy 和 PathLocationStrategy 。

Enables the Location service to read route state from the browser's URL. Angular provides two strategies: HashLocationStrategy and PathLocationStrategy.

根据语言环境返回复数形式

Returns the plural case based on the locale

此 LocationStrategy用来配置 Location服务，以便在浏览器 URL 的 path 中表示其状态。

A LocationStrategyused to configure the Locationservice to represent its state in the path of the browser's URL.

此类不应由应用程序开发人员直接使用。而应使用 Location。

This class should not be used directly by an application developer. Instead, use Location.

定义滚动位置管理器。由 BrowserViewportScroller 实现。

Defines a scroll position manager. Implemented by BrowserViewportScroller.

A wrapper around the XMLHttpRequest constructor.

使用区域设置规则将数字格式化为货币。

Formats a number as currency using locale rules.

基于区域规则格式化日期。

Formats a date according to locale rules.

将数字格式化为文本格式，并根据区域来设置组大小、分隔符和其他参数。

Formats a number as text, with group sizing, separator, and other parameters based on the locale.

根据语言环境规则将数字格式化为百分比。

Formats a number as a percentage according to locale rules.

检索给定货币代码的货币符号。

Retrieves the currency symbol for a given currency code.

检索给定语言环境的默认货币代码。

Retrieves the default currency code for the given locale.

检索与给定语言环境相对应的主要国家/地区的货币名称。对于 en-US 是 “US Dollar”。

Retrieves the name of the currency for the main country corresponding to a given locale. For example, 'US Dollar' for en-US.

检索用于表示与给定语言环境对应的主要国家/地区的货币的符号。对于 en-US 为 $。

Retrieves the symbol used to represent the currency for the main country corresponding to a given locale. For example, '$' for en-US.

检索本地化的日期-值格式字符串。

Retrieves a localized date-value formating string.

检索本地化的日期时间格式字符串。

Retrieves a localized date-time formatting string.

使用公历来检索给定语言环境下的星期几。

Retrieves days of the week for the given locale, using the Gregorian calendar.

检索给定语言环境的一天时段字符串。

Retrieves day period strings for the given locale.

检索指定语言环境的书写方向

Retrieves the writing direction of a specified locale

检索给定语言环境的格里高利历日历。

Retrieves Gregorian-calendar eras for the given locale.

检索特定于语言环境的规则，该规则用于确定在为一个语言环境中定义了多个时段时要使用的一天时段。

Retrieves locale-specific rules used to determine which day period to use when more than one period is defined for a locale.

检索特定于语言环境的一天时段，该时段大致指示如何用不同的语言分解一天。例如，对于 en-US，这些时段为 morning、noon、afternoon、evening 和 midnight。

Retrieves locale-specific day periods, which indicate roughly how a day is broken up in different languages. For example, for en-US, periods are morning, noon, afternoon, evening, and midnight.

检索给定语言环境中一周的第一天。

Retrieves the first day of the week for the given locale.

从当前已加载的语言环境中检索语言环境 ID。加载的语言环境也可能是全球语言环境，而不是区域性语言环境。

Retrieves the locale ID from the currently loaded locale. The loaded locale could be, for example, a global one rather than a regional one.

使用公历来检索给定语言环境下一年中的月份。

Retrieves months of the year for the given locale, using the Gregorian calendar.

检索给定语言环境下的数字格式。

Retrieves a number format for a given locale.

检索本地化的数字符号，该符号可用于替换数字格式的占位符。

Retrieves a localized number symbol that can be used to replace placeholders in number formats.

Retrieves the plural function used by ICU expressions to determine the plural case to use for a given locale.

检索本地化的时间值格式字符串。

Retrieves a localized time-value formatting string.

在给定语言环境中被视为周末的工作日范围。

Range of week days that are considered the week-end for the given locale.

报告给定货币的小数位数。其值取决于该特定货币中分币是否存在。

Reports the number of decimal digits for a given currency. The value depends upon the presence of cents in that particular currency.

返回平台 ID 是否代表浏览器平台。

Returns whether a platform id represents a browser platform.

返回平台 ID 是否代表服务器平台。

Returns whether a platform id represents a server platform.

返回平台 ID 是否代表 Web Worker 应用平台。

Returns whether a platform id represents a web worker app platform.

返回平台 ID 是否代表 Web Worker UI 平台。

Returns whether a platform id represents a web worker UI platform.

注册全局数据以供 Angular 内部使用。请参阅 “I18n 指南”以了解如何导入其他语言环境的数据。

Register global data to be used internally by Angular. See the "I18n guide" to know how to import additional locale data.

字符串的上下文相关翻译形式。通常，独立版本用于单词的主格形式，格式化的版本则用于所有格。

Context-dependant translation forms for strings. Typically the standalone version is for the nominative form of the word, and the format version is used for the genitive case.

可用于日期时间格式的字符串宽度。特定的字符宽度是特定于语言环境的。示例中是给 en-US 的示例。

String widths available for date-time formats. The specific character widths are locale-specific. Examples are given for en-US.

一个键值对。通常用于表示 Map 或 Object 中的键值对。

A key value pair. Usually used to represent the key value pairs from a Map or Object.

来自 onPopState 或 onHashChange 的事件的可序列化版本

A serializable version of the event from onPopState or onHashChange

可用来表示数字的格式化样式。

Format styles that can be used to represent numbers.

可用于替换数字模式中占位符的符号。例如基于 en-US 的值。

Symbols that can be used to replace placeholders in number patterns. Examples are based on en-US values.

用于将复数形式转换为不同语言的复数形式。

Plurality cases used for translating plurals to different languages.

字符串宽度可用于翻译。特定的字符宽度是特定于语言环境的。这里给出了英语中 “Sunday” 一词的示例。

String widths available for translations. The specific character widths are locale-specific. Examples are given for the word "Sunday" in English.

一周中每一天的值（基于 en-US 语言环境）

The value for each day of the week, based on the en-US locale

从 HTML 元素上添加和移除 CSS 类。

Adds and removes CSS classes on an HTML element.

实例化单个 Component类型，并将其宿主视图插入当前视图。NgComponentOutlet 为动态组件创建提供了一种声明式方法。

Instantiates a single Componenttype and inserts its Host View into current View. NgComponentOutlet provides a declarative approach for dynamic component creation.

一种结构型指令，为集合中的每个条目渲染一个模板。如果指令放置在一个元素上，该元素就会成为克隆后的模板的父级。

A structural directive that renders a template for each item in a collection. The directive is placed on an element, which becomes the parent of the cloned templates.

本结构型指令用于根据表达式的值（强转为 boolean）是否为真值，来有条件的包含某个模板。当表达式计算为 true 时，Angular 会渲染 then 子句中提供的模板，当为 false 或 null 时则渲染可选的 else 子句中的模板。else 子句的默认模板是空白模板。

A structural directive that conditionally includes a template based on the value of an expression coerced to Boolean. When the expression evaluates to true, Angular renders the template provided in a then clause, and when false or null, Angular renders the template provided in an optional else clause. The default template for the else clause is blank.

根据数字值添加/删除 DOM 子树。为支持复数词量身定制。

Adds / removes DOM sub-trees based on a numeric value. Tailored for pluralization.

创建一个视图，当给定表达式根据 CLDR 规则与复数表达式匹配时，将在父视图 NgPlural中添加/删除该视图。

Creates a view that will be added/removed from the parent NgPluralwhen the given expression matches the plural expression according to CLDR rules.

一个属性指令，用于更新容器元素的样式。可以通过指定用冒号分隔的键值对来设置一个或多个样式属性。其键是样式名称，带有可选的 <unit> 后缀（比如 'top.px'，'font-style.em'）；其值是待求值的表达式。如果求值结果不是 null，则把用指定单位表示的结果赋值给指定的样式属性；如果是 null，则删除相应的样式。

An attribute directive that updates styles for the containing HTML element. Sets one or more style properties, specified as colon-separated key-value pairs. The key is a style name, with an optional .<unit> suffix (such as 'top.px', 'font-style.em'). The value is an expression to be evaluated. The resulting non-null value, expressed in the given unit, is assigned to the given style property. If the result of evaluation is null, the corresponding style is removed.

容器上的 [ngSwitch] 指令指定要匹配的表达式。匹配的表达式由容器内视图上的 ngSwitchCase 指令提供。

The [ngSwitch] directive on a container specifies an expression to match against. The expressions to match are provided by ngSwitchCase directives on views within the container.

提供一个 switch case 表达式来匹配一个封闭的 ngSwitch 表达式。当表达式匹配时，将渲染给定的 NgSwitchCase 模板。如果多个匹配表达式与开关表达式值相匹配，则会全部显示。

Provides a switch case expression to match against an enclosing ngSwitch expression. When the expressions match, the given NgSwitchCase template is rendered. If multiple match expressions match the switch expression value, all of them are displayed.

创建一个当没有任何 NgSwitchCase 表达式能匹配 NgSwitch 表达时要渲染的视图。该语句应该是 NgSwitch 的最后一种情况。

Creates a view that is rendered when no NgSwitchCase expressions match the NgSwitch expression. This statement should be the final case in an NgSwitch.

根据一个提前备好的 TemplateRef 插入一个内嵌视图。

Inserts an embedded view from a prepared TemplateRef.

从一个异步回执中解出一个值。

Unwraps a value from an asynchronous primitive.

Transforms a number to a currency string, formatted according to locale rules that determine group sizing and separator, decimal-point character, and other locale-specific configurations.

根据区域设置规则格式化日期值。

Formats a date value according to locale rules.

Formats a value according to digit options and locale rules. Locale determines group sizing and separator, decimal point character, and other locale-specific configurations.

将值映射到根据语言环境规则对该值进行复数化的字符串。

Maps a value to a string that pluralizes the value according to locale rules.

通用选择器，用于显示与当前值匹配的字符串。

Generic selector that displays the string that matches the current value.

把一个值转换成 JSON 字符串格式。在调试时很有用。

Converts a value into its JSON-format representation. Useful for debugging.

将 Object 或 Map 转换为键值对数组。

Transforms Object or Map into an array of key value pairs.

把文本转换成全小写形式。

Transforms text to all lower case.

Transforms a number to a percentage string, formatted according to locale rules that determine group sizing and separator, decimal-point character, and other locale-specific configurations.

从一个 Array 或 String 中创建其元素一个新子集（slice）。

Creates a new Array or String containing a subset (slice) of the elements.

把文本转换成标题形式。 把每个单词的第一个字母转成大写形式，并把单词的其余部分转成小写形式。 单词之间用任意空白字符进行分隔，比如空格、Tab 或换行符。

Transforms text to title case. Capitalizes the first letter of each word and transforms the rest of the word to lower case. Words are delimited by any whitespace character, such as a space, tab, or line-feed character.

把文本转换成全大写形式。

Transforms text to all upper case.

预定义的 DI 令牌，用于和 PathLocationStrategy 一起使用的 base href。base href 是在生成和识别 URL 时应保留的 URL 前缀。

A predefined DI token for the base href to be used with the PathLocationStrategy. The base href is the URL prefix that should be preserved when generating and recognizing URLs.

表示主要渲染上下文的 DI 令牌。在浏览器中，这是 DOM 文档。

A DI Token representing the main rendering context. In a browser this is the DOM Document.

指示何时初始化 location。

Indicates when a location is initialized.

用小时和分钟表示的时间值。

Represents a time value with hours and minutes.