diff --git a/src/cdk/table/table.md b/src/cdk/table/table.md index 6eb285d3baf1..487b1e37822c 100644 --- a/src/cdk/table/table.md +++ b/src/cdk/table/table.md @@ -135,6 +135,18 @@ updates. This can be based on _anything_: websocket connections, user interactio time-based intervals, etc. Most commonly, updates will be triggered by user interactions like sorting and pagination. +##### `fixedLayout` +The CDK table measures the dimensions of sticky elements before applying the styles that make them +"stick". Because native tables derive column widths from the content within each cell, these +dimensions are re-checked when the underlying data changes. + +Enabling `fixedLayout` will enforce uniform column widths, so the table can reliably cache and reuse +them when calculating sticky styles. This can reduce rendering latency for large native tables. + +```html + +``` + ##### `trackBy` To improve performance, a `trackBy` function can be provided to the table similar to Angular’s @@ -145,6 +157,16 @@ table how to uniquely identify rows to track how the data changes with each upda
``` +##### `recycleRows` +By default, `CdkTable` creates and destroys an internal Angular view for each row. This allows rows +to participate in animations and to toggle between different row templates with `cdkRowDefWhen`. If +you don't need these features, you can instruct the table to cache and recycle rows by specifying +`recycleRows`. + +```html +
+``` + ### Alternate HTML to using native table The CDK table does not require that you use a native HTML table. If you want to have full control