Documentation is unclear about how to get data into a Dialog.

Bug, feature request, or proposal:

Documentation bug.

What is the expected behavior?

When I use the MdDialog service to open a dialog with some component, I’d love to be able to pass some configuration into that component.

What is the current behavior?

The dialogRef exposes componentInstance, which allows me to set properties / call functions on the component after construction, however I’m unsure if this is the recommended approach since it is not mentioned in the docs.

What are the steps to reproduce?

Read the docs at https://github.com/angular/material2/blob/master/src/lib/dialog/README.md, and notice the example uses a “static” dialog.

What is the use-case or motivation for changing an existing behavior?

It would improve the documentation and reduce the number of future issues.

Which versions of Angular, Material, OS, browsers are affected?

Latest /all

Is there anything else we should know?

I can submit a PR for improved documentation of an answer from this threads provides sufficient information!

[tmburnell]

I figured it out from another post: use this when opening

let dialogRef = this.dialog.open(myModal);
dialogRef.componentInstance.data = myData;

use this in the modal

ngOnInit() {
    this.data = this.dialogRef.componentInstance.data;
}

[SamMousa]

I’ve added this to my todo list.