【Craft CMS】行列フィールドのブロックタイプ内に登録したフィールドをwith()で指定したい

公式リファレンスで記載されていたはずだが見つからないため備忘録

行列のフィールドは構成項目でブロックタイプを登録し、その中に更にフィールドを登録しますが、そのフィールドをwith()で指定したい。

次のような行列のフィールドがあるとすると

行列フィールドのハンドル： students
ブロックタイプのハンドル： results
ブロックタイプ内フィールドのハンドル： score

この”score”のフィールドを指定したいときは以下のようにする。

\craft\elements\Entry::find()
                        ->id($ids)
                        ->with(['students.results:score'])
                        ->all();