CSSによるドキュメントのレイアウト

Copper PDFはHTMLとXMLをCSSによってスタイル付けすることができます。

Copper PDFは CSS Level 2 Revision 1 に準拠しています。 Copper PDFがサポートするCSSプロパティの一覧は資料集を参照してください。

スタイルシートの型

Copper PDFは、特に型が指定されていないスタイルシートをCSS(MIME型text/css)として認識します。 Content-Style-Typeヘッダ (HTML中ではといった記述) やstyle要素のtype属性等によってtext/css以外がスタイルシートの型として指定されている場合は、 スタイルシートをCSSとして認識しません。

メディアタイプ

style要素のmedia属性、あるいはCSSの@media指示子等でスタイルシートが適用されるメディアタイプが限定されている場合、 通常Copper PDFは印刷メディア向けのスタイルだけを適用します。 すなわち、Copper PDFのメディアタイプはall print paged visual bitmap staticのいずれかです。

なお、Copper PDFのメディアタイプは output.media_types 入出力プロパティによって変更することができます。 これによって、印刷メディア向け以外のスタイルを適用することができます。

ドキュメント中にスタイルシートを記述する

ドキュメント中にスタイルおよびスタイルシートを記述する方法は以下の3通りがあります。

  1. HTMLのstyle属性
  2. HTMLのstyle要素
  3. jp.cssj.stylesheet処理命令

HTMLのstyle属性

style属性により、各要素に直接スタイルを指定する方法です。 style属性には、適用したいCSSのプロパティを記述してください。



題名

本文大きなテキスト本文

]]>

上記の例は以下のように表示されます。

題名
本文大きなテキスト本文

style要素はHTMLだけではなく、XML文書内でも利用可能です。 ただし、style要素が名前空間"http://www.w3.org/1999/xhtml"に属するように、名前空間宣言を行ってください。



題名

本文大きなテキスト本文

]]>

HTMLのstyle要素

一般的なブラウザと同じくstyle要素内にスタイルシートを記述することができます。






題名

本文大きなテキスト本文

]]>

style要素はなるべくhead要素内に記述してください。 Copper PDFは他の場所のstyle要素も認識しますが、 ドキュメント中でstyle要素が現れる以前の部分には、記述されたスタイルが適用されなくなります。

また、XMLドキュメント中ではstyle要素によるスタイル指定は行わず、 次に説明するjp.cssj.stylesheet処理命令を使用するか、 あるいは一般的なブラウザでもサポートされているxml-stylesheet処理命令を使用してください。

jp.cssj.stylesheet処理命令

jp.cssj.stylesheet処理命令はHTMLのstyle要素に相当する機能を処理命令 (<?で始まり?>で終わるHTMLやXML中の特別な記述。) によって実現したものです。 HTML, XMLの両方のドキュメントの先頭で使用することができます。

style要素のtype, media属性に相当する部分はHTMLの属性と同様の形式で記述し、 スタイルシートは'[]'で囲みます。




題名

本文大きなテキスト本文

]]>

外部のCSSの使用

ドキュメントと外部のスタイルシートを結びつける方法は以下の3通りがあります。

  1. HTMLのlink要素
  2. CSSの@import指示子
  3. xml-stylesheet処理命令

HTMLのlink要素

一般的なブラウザと同様に、link要素によってスタイルシートをドキュメントに関連付けることができます。


]]>

rel属性にキーワードalternateを加えることで、 1つのドキュメントに対して、複数の代替スタイルシートを用意することができます。 title属性は代替スタイルシートの名前です。



]]>

代替スタイルシートは通常は適用されませんが、 入出力プロパティ input.stylesheet.titles に代替スタイルシートのtitleを設定することで、適用するスタイルシートを選択することができます。

CSSの@import指示子

これは、HTMLのstyle要素とCSSの@importを組み合わせる方法です。


	@import url(スタイルシートのURL);

]]>

HTMLのstyle要素の代わりに、jp.cssj.stylesheet処理命令を使うこともできます。


]]>

xml-stylesheet処理命令

xml-stylesheet処理命令を使う方法は、 一般的なブラウザでXMLとスタイルシートを結びつけるために広くサポートされている方法です。

スタイルシートを適用したいドキュメントの冒頭で、以下のように記述してください。


]]>

alternate属性はlink要素のrel属性に対するalternateの指定に相当するものです。 xml-stylesheet処理命令でalternate="yes"を指定することは、link要素にrel="alternate stylesheet"を設定するのと同じ意味です。



]]>

xml-stylesheetのtype属性にはCSSだけでなくXSLTスタイルシートを指定することもできます。 この場合、type属性にtext/xslを設定し、href属性にはXSLTファイルの指定してください。

デフォルトのスタイルシート

Copper PDFでは、ドキュメント内の記述に関係なく、特定のスタイルシートを適用する機能が用意されています。 input.default-stylesheet 入出力プロパティで指定されたスタイルシートが最初に適用されます。