Undocumented attributes - mat-subheader, mat-line, mat-list-icon

[akunaatrium]

I am looking at the example source code of List component on this page: https://material.angular.io/components/list/examples and am a bit confused as to where some of the used attributes come from.

The example looks like this:

<mat-list>
  <h3 mat-subheader>Folders</h3>
  <mat-list-item *ngFor="let folder of folders">
    <mat-icon mat-list-icon>folder</mat-icon>
    <h4 mat-line>{{folder.name}}</h4>
    <p mat-line> {{folder.updated | date}} </p>
  </mat-list-item>
  <mat-divider></mat-divider>
  <h3 mat-subheader>Notes</h3>
  <mat-list-item *ngFor="let note of notes">
    <mat-icon mat-list-icon>note</mat-icon>
    <h4 mat-line>{{note.name}}</h4>
    <p mat-line> {{note.updated | date}} </p>
  </mat-list-item>
</mat-list>

I can't find documentation about the mat-subheader attribute used in the example, as well as mat-line and mat-list-icon. Is there any? I just started to use Angular, so I could as well be overlooking something.

[thw0rted]

I found this issue because I have both mat-list-icon and matListIcon in my code and both seem to work. If one or the other is canonically correct -- especially, if there's a good reason why one or the other is correct here -- I haven't found it. Closest I've come is #3125 which says "@Components are dash-case and @Directives are camelCase". I guess mat-list-icon is a Directive so it's supposed to be camel-cased, but they still support dash-case some years later. Should I switch all my "legacy" directives over?

[atn832]

This page doesn't list everything but it lists some more classes related to typography: https://material.angular.io/guide/typography#what-is-typography-

[thw0rted]

That's a good page -- I've used it extensively -- but as far as I can tell it's all CSS classes, not directives, which is what the OP is asking about.

[devversion]

It looks like we excluded those styling directives from the docs. See: 0a7e293.

Though we have each of the disabled one explicitly mentioned/described in the list overview. See: https://material.angular.io/components/list/overview.

I'm closing this as these attributes are considered documented. Happy to re-open when someone has strong feelings that this could be improved, or that we need them show up in the API as actual directive.

[thw0rted]

@devversion Looking back at the OP, maybe the actual resolution is that this is effectively a duplicate of #3125. That issue more directly address the problem.

[angular-automatic-lock-bot]

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

_{This action has been performed automatically by a bot.}