view.yml 設定ファイル

ビューレイヤーのコンフィギュレーションは view.yml ファイルのなかで変更できます。

設定ファイルの原則の章で述べたように、view.yml ファイルでは、コンフィギュレーションカスケードのメカニズムがはたらいており、定数を定義することができます。

ビュー設定のリストは view.yml ファイルに用意されています。

VIEW_NAME_1:
  # コンフィギュレーション
 
VIEW_NAME_2:
  # コンフィギュレーション
 
# ...

layout

デフォルトコンフィギュレーション:

default:
  has_layout: true
  layout:     layout

アプリケーションによって使われるデフォルトの layout は view.yml ファイルのなかで定義されます。デフォルトの名前は layout で、すべてのページはアプリケーションの templates/ ディレクトリに配置されている layout.php ファイルによってデコレートされます。has_layout エントリに false をセットすれば、デコレーション処理を完全に無効にすることもできます。

stylesheets

デフォルトコンフィギュレーション:

default:
  stylesheets: [main.css]

stylesheets エントリは現在のビューで使われるスタイルシートの配列を定義します。

複数のファイルが定義されている場合、定義と同じ順番でインクルードされます。

stylesheets: [main.css, foo.css, bar.css]

media 属性を変更もしくは .css 拡張子を省略することもできます。

stylesheets: [main, foo.css, bar.css, print.css: { media: print }]

use_stylesheet() ヘルパーを使うやりかたのほうが望ましいので、この設定を変更することは推奨されていません。

<?php use_stylesheet('main.css') ?>

javascripts

デフォルトコンフィギュレーション:

default:
  javascripts: []

javascripts エントリは現在のビューに使う JavaScript ファイルの配列を定義します。

複数のファイルが定義されている場合、定義と同じ順番でこれらのファイルがインクルードされます。

javascripts: [foo.js, bar.js]

.js 拡張子を省略することもできます。

javascripts: [foo, bar]

use_javascript() ヘルパーを使うやりかたのほうが望ましいので、この設定を変更することは推奨されていません。

<?php use_javascript('foo.js') ?>

metas と http_metas

デフォルトコンフィギュレーション:

default:
  http_metas:
    content-type: text/html
 
  metas:
    #title:        symfony project
    #description:  symfony project
    #keywords:     symfony, project
    #language:     en
    #robots:       index, follow

レイアウトのなかでインクルードするメタタグは http_metas と metas 設定によって定義できます。

変化しないメタ情報 (Content-Type など) のためにレイアウトのなかで HTML を純粋に保つため、もしくは動的なメタ情報 (タイトルや説明) のスロットのほうが望ましいので、これらの設定は推奨されていません。