表格 Table

这个列的唯一名称。

Unique name for this column.

是否应该使用粘性定位。

Whether sticky positioning should be applied.

此列是否应粘性在该行的末尾。应该确保它模仿了混入接口 CanStick，当该值更改后必须把 _hasStickyChanged 设为 true。

Whether this column should be sticky positioned on the end of the row. Should make sure that it mimics the CanStick mixin such that _hasStickyChanged is set to true if the value has been changed.

列名的转换后版本，可以作为 CSS 类名的一部分。只允许字母、数字和两个特殊字符 “-” 和 “_”。除此之外的字符都会替换为 “-”。

Transformed version of the column name that can be used as part of a CSS classname. Excludes all non-alphanumeric characters and the special characters '-' and '_'. Any characters that do not match are replaced by the '-' character.

该表格的数据源可以通过三种方式提供（按复杂程度排序）：

The table's source of data, which can be provided in three ways (in order of complexity):

• 简单数据数组（每个对象代表格一个表格行）

  Simple data array (each object represents one table row)

• 每当数组发生变化时都会发出数据数组的流

  Stream that emits a data array each time the array changes

• 那些实现了 connect / disconnect 接口的 DataSource。

  DataSource object that implements the connect/disconnect interface.

如果提供了数组，那么在添加、删除或移动该数组的对象时，都必须通知该表格。 这可以通过调用 renderRows() 函数来完成，它会渲染自上次渲染表格以来的差异部分。如果数据数组的引用发生了变化，该表格会自动触发对行的更新。

If a data array is provided, the table must be notified when the array's objects are added, removed, or moved. This can be done by calling the renderRows() function which will render the diff since the last table render. If the data array reference is changed, the table will automatically trigger an update to the rows.

当提供一个可观察的流时，如果该流发出一个新的数据数组，该表格就会自动触发一次更新。

When providing an Observable stream, the table will trigger an update automatically when the stream emits a new array of data.

最后，在提供 DataSource 对象时，该表格将使用 connect 函数提供的 Observable 流，并在该流发出新的数据数组值时触发更新。 在表格的 ngOnDestroy 中，或者从表格中删除了数据源时，该表格会调用数据源的 disconnect 函数（这可能对清理在连接过程中注册的所有订阅很有帮助）。

Finally, when providing a DataSource object, the table will use the Observable stream provided by the connect function and trigger updates when that stream emits new data array values. During the table's ngOnDestroy or when the data source is removed from the table, the table will call the DataSource's disconnect function (may be useful for cleaning up any subscriptions registered during the connect process).

是否使用固定（fixed）表格布局。启用此选项会强制让所有列宽一致，并优化渲染原生表格的粘性样式。 对弹性（flex）表格无效。

Whether to use a fixed table layout. Enabling this option will enforce consistent column widths and optimize rendering sticky styles for native tables. No-op for flex tables.

通过计算哪些行的 'when' 谓词结果为 true 来允许其数据对象对应于多行。 如果 multiTemplateDataRows 为 false（这是默认值），那么每个数据对象都会渲染到其谓词结果为 true 的第一行（按照表格中定义的顺序）， 否则就使用默认行（即没有 when 谓词的行）。

Whether to allow multiple rows per data object by evaluating which rows evaluate their 'when' predicate to true. If multiTemplateDataRows is false, which is the default value, then each dataobject will render the first row that evaluates its when predicate to true, in the order defined in the table, or otherwise the default row which does not have a when predicate.

跟踪函数，用于检查数据变化的差异。类似于 ngFor 的 trackBy 函数。 可以优化行操作，方法是根据该函数处理后的数据来标识一行，以了解该行是否应添加/删除/移动。接受带两个参数 index 和 item 的函数。

Tracking function that will be used to check the differences in data changes. Used similarly to ngFor trackBy function. Optimize row operations by identifying a row based on its data relative to the function to know if a row should be added/removed/moved. Accepts a function that takes two parameters, index and item.

改写在 CdkTable 每个粘性单元元素上添加 position: sticky 的需求。

Overrides the need to add position: sticky on every sticky cell element in CdkTable.

CdkTable 设置的粘性 CSS 类。

Overrides the sticky CSS class set by the CdkTable.

要在行上显示的列。

The columns to be displayed on this row.

是否应该使用粘性定位。

Whether sticky positioning should be applied.

要在行上显示的列。

The columns to be displayed on this row.

是否应该使用粘性定位。

Whether sticky positioning should be applied.

要在行上显示的列。

The columns to be displayed on this row.

如果要把这个行模板用于所提供的索引和行数据，该函数应返回 true。如果未定义，那么当该函数对该数据返回 true 时，该行将被认为是默认的行模板。对于每一行，必须至少有一个函数能通过或者为 undefined 以便作为默认值。

Function that should return true if this row template should be used for the provided index and row data. If left undefined, this row will be considered the default row template to use when no other when functions return true for the data. For every row, there must be at least one when function that passes or an undefined to default.

访问器函数用来检索为要每个单元格渲染的数据。如果未设置此属性，数据单元格将渲染数据属性中与该列名匹配的值。 例如，如果列的名字是 id ，那么渲染的值就是 data 的 id 属性定义的值。

Accessor function to retrieve the data rendered for each cell. If this property is not set, the data cells will render the value found in the data's property matching the column's name. For example, if the column is named id, then the rendered value will be value defined by the data's id property.

要作为列表头的文本标签。如果未设置此属性，则表头文本默认使用列名的首字母大写形式。

Text label that should be used for the column header. If this property is not set, the header text will default to the column name with its first letter capitalized.

单元格中值的对齐方式。

Alignment of the cell values.

要用来引用这个列的列名。

Column name that should be used to reference this column.

要由表格渲染的数据数组，其中每个对象代表一行。

Array of data that should be rendered by the table, where each object represents one row.

要用来从数据数组中过滤对象的过滤器关键词。 要改写数据对象与此过滤器字符串的匹配方式，请为 filterPredicate 提供一个自定义函数。

Filter term that should be used to filter out objects from the data array. To override how data objects match to this filter string, provide a custom function for filterPredicate.

检查数据对象是否与数据源的过滤字符串匹配。默认情况下，会把每个数据对象都转换为其属性的字符串，如果该过滤器在该字符串中至少出现过一次，则返回 true。默认情况下，会修剪掉过滤字符串的空白，并且匹配时不区分大小写。可以改写为过滤器匹配算法的自定义实现。

Checks if a data object matches the data source's filter string. By default, each data object is converted to a string of its properties and returns true if the filter has at least one occurrence in that string. By default, the filter string has its whitespace trimmed and the match is case-insensitive. May be overridden for a custom implementation of filter matching.

通过过滤器字符串过滤过的数据集，如果没有过滤器，则全是数据。 需要知道表格所展现的数据集时，这非常有用。比如，'selectAll()' 函数可能会想给用户展示一组过滤过的数据，而不是所有的数据。

The filtered set of data that has been matched by the filter string, or all the data if there is no filter. Useful for knowing the set of data the table represents. For example, a 'selectAll()' function would likely want to select the set of filtered data shown to the user rather than all the data.

该表格使用的 MatPaginator 组件实例，用来控制要显示哪页数据。MatPaginator 发出的页面更改会触发表格渲染数据的更新。

Instance of the MatPaginator component used by the table to control what page of the data is displayed. Page changes emitted by the MatPaginator will trigger an update to the table's rendered data.

注意，数据源会使用此分页器的属性来计算应该显示哪个页面的数据。如果分页器要通过模板输入接收其属性，比如 [pageLength]=100 或者 [pageIndex]=1 ，那就要确保此分页器的视图已经初始化了，然后再赋值给这个数据源。

Note that the data source uses the paginator's properties to calculate which page of data should be displayed. If the paginator receives its properties as template inputs, e.g. [pageLength]=100 or [pageIndex]=1, then be sure that the paginator's view has been initialized before assigning it to this data source.

该表格使用 MatSort 指令的实例来控制它的排序。 MatSort 发出的排序变化会触发对该表格所渲染数据的更新。

Instance of the MatSort directive used by the table to control its sorting. Sort changes emitted by the MatSort will trigger an update to the table's rendered data.

根据 MatSort 的状态获取一个数据数组的已排序副本。在对已过滤的数据进行更改或从 MatSort 发出排序更改时调用。 默认情况下，使用该函数检索主动排序及其方向，并借助 sortingDataAccessor 检索数据来进行比较。可以改写为自定义的数据排序实现。

Gets a sorted copy of the data array based on the state of the MatSort. Called after changes are made to the filtered data or when sort changes are emitted from MatSort. By default, the function retrieves the active sort and its direction and compares data by retrieving data using the sortingDataAccessor. May be overridden for a custom implementation of data ordering.

数据访问器函数，用于访问数据属性，以便通过默认的 sortData 函数进行排序。 这个默认函数假设排序头的 ID（默认为列名）与数据的属性相匹配（比如列 Xyz 对应 data['Xyz']）。可以为不同的行为设置同一个自定义函数。

Data accessor function that is used for accessing data properties for sorting through the default sortData function. This default function assumes that the sort header IDs (which defaults to the column name) matches the data's properties (e.g. column Xyz represents data['Xyz']). May be set to a custom function for different behavior.