オプション
オプションの導入
Options let you influence the beautifiying process. They are passed to the renderer and thus, you have to check, whether the renderer you are using supports the options you want to use.
As there currently is only one renderer (Plain) available, you should not worry about this too much.
オプションは、XML_Beautifierのコンストラクタ への連想配列として渡すことが出来ます。 You may also use setOption(), or setOptions() to set one or more options after the instance of XML_Beautifier has been created.
すべての有効なオプション
ここに、 XML_Beautifierでサポートされたすべてのオプションの一覧があります。
| オプション | 可能な値 | デフォルト | 説明 |
|---|---|---|---|
| removeLineBreaks | TRUE or FALSE | TRUE | Sets, whether linebreaks should be stripped from cdata sections |
| indent | any string | " " (4つの半角空白) | The string passed to this option will be used to indent the tags in one level. |
| linebreak | any string | "\n" | The string passed to this option will be used for linebreaks You should use "\n" or "\r\n". |
| caseFolding | TRUEかFALSE | FALSE | Disable or enable case folding for tags and attributes |
| caseFoldingTo | "uppercase"か"lowercase" | "uppercase" | Can be used, if caseFolding is set to TRUE to define whether tags and attributes should be converted to upper- or lowercase |
| normalizeComments | FALSE or TRUE | FALSE | If set to true, all adjacent whitespaces in an XML comment will be converted to one space. This will convert comments with more than one line to a comment with one line. |
| maxCommentLine | integer | -1 | コメント行の最大長です。 コメントがこの限度を越えれば、それは自動的にラッピングされるでしょう。 もし-1にセットされれば、行長は無制限になります。 |
| multilineTags | TRUEか FALSE | FALSE | If set to true, a linebreak will be added inside the tags after each attribute and attributes will be indeted. |
オプション例
次の例は、XML_Beautifierのためにオプションを設定する方法の手引きです。
setOptions()とsetOption()の使用例
<?php
require_once "XML/Beautifier.php";
$options = array(
"caseFolding" => true,
"caseFoldingTo" => "uppercase",
"normalizeComments" => true
);
$fmt = new XML_Beautifier($options);
$result = $fmt->formatFile('originalFile.xml', 'outputFile.xml');
?>
Options example setting options at a later point
インスタンスが既に作成されている場合、 次の例はXML_Beautifierのオプションを設定する方法手引きです。
XML_Beautifierオプション
<?php
require_once "XML/Beautifier.php";
$fmt = new XML_Beautifier();
$options = array(
"caseFolding" => true,
"caseFoldingTo" => "uppercase",
"normalizeComments" => true
);
$fmt->setOptions($options);
$fmt->setOption("indent", "\t");
$result = $fmt->formatFile('originalFile.xml', 'outputFile.xml');
?>
忘却曲線を使ってこの知識を確実に記憶に残す
