Visualforce 開発者ガイド
jVisualforce PDF 表示の考慮事項および制限
PDF に表示する Visualforce ページを設計するときは、次の考慮事項および制限を確認してください。本番環境で使用する前にページの PDF 版の形式や外観を必ず確認してください。
Visualforce PDF 表示サービスの制限は次のとおりです。
- サポートされている表示サービスは PDF のみです。
- PDF 表示サービスでは PDF バージョン 1.4 と、CSS バージョン 2.1 以前が表示されます。
- Visualforce ページを PDF ファイルとして表示する機能は、印刷用にデザインされ、最適化されたページのためのものです。
- PDF ファイルとして表示された Visualforce ページは、ブラウザーの設定に応じて、ブラウザーに表示されるかダウンロードされます。特定の動作は、ブラウザー、バージョン、ユーザー設定によって異なり、Visualforce では制御できません。
- PDF 表示サービスはページにマークアップとデータを表示しますが、ページに追加されたリッチテキストエリア項目のコンテンツ内に含まれる書式設定は表示されない可能性があります。
- 空白やダッシュなどのブレークポイントがない長いテキスト行は、PDF 表示サービスではラップされません。このシナリオは、長い URL やレジストリエントリなどでよく発生します。これらの行がページよりも広い場合、ページのコンテンツの幅が PDF ページの幅を超えて拡張されます。その結果、コンテンツはページの端からはみ出し、途中で切れてしまいます。
- 印刷用の書式設定が容易ではないか、入力やボタンなどのフォーム要素が含まれる標準コンポーネント、または書式設定に JavaScript が必要なコンポーネントは使用しないでください。
- PDF 表示では、JavaScript で表示されるコンテンツはサポートされていません。
- Salesforce モバイルアプリケーションのページでは、PDF 表示はサポートされていません。
- ページで使用するフォントは、Visualforce PDF 表示サービスで使用できる必要があります。Web フォントはサポートされていません。
- PDF ファイルでページのすべてのテキスト (特に日本語などのマルチバイト文字やアクセント記号付きの国際文字) が表示されない場合は、CSS を調整してそれに対応するフォントを使用します。次に例を示します。マルチバイト文字を含む拡張文字セットでサポートされているフォントは「Arial Unicode MS」のみです。
1<apex:page showHeader="false" applyBodyTag="false" renderAs="pdf"> 2 <head> 3 <style> 4 body { font-family: 'Arial Unicode MS'; } 5 </style> 6 </head> 7 <body> 8 9 これはサンプルページです。<br/> 10 This is a sample page: API version 28.0 11 12 </body> 13</apex:page> - インライン CSS スタイルを使用する場合は、API バージョンを 28.0 以降に設定します。また、前の例のように <apex:page applyBodyTag="false"> を設定し、有効な静的 <head> および <body> タグをページに追加します。
- PDF ファイル作成時の最大応答サイズは、PDF ファイルとして表示される前で 15 MB 未満です。この制限は、すべての Visualforce 要求の標準制限です。
- 生成される PDF ファイルの最大ファイルサイズは、60 MB です。
- 生成された PDF に含まれるすべての画像の最大合計サイズは 30 MB です。
- PDF 表示では、data: URI ス��ーム形式で符号化された画像はサポートされていません。
- PDF 表示では、WebP 画像および SVG マークアップはサポートされません。
- 次のコンポーネントは、PDF として表示するときに 2 バイトのフォントをサポートしません。
- <apex:pageBlock>
- <apex:sectionHeader>
- <apex:dataTable> または <apex:pageBlockTable> に表示される <apex:column> コンポーネントがない場合、PDF としてのページの表示に失敗します。この問題を回避するには、その子 <apex:column> コンポーネントが表示されない場合にテーブルコンポーネントの rendered 属性を false に設定します。