1: <?php
 2: /*
 3:  * Copyright (c) 2014 @trashtoy
 4:  * https://github.com/trashtoy/
 5:  * 
 6:  * Permission is hereby granted, free of charge, to any person obtaining a copy of
 7:  * this software and associated documentation files (the "Software"), to deal in
 8:  * the Software without restriction, including without limitation the rights to use,
 9:  * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
10:  * Software, and to permit persons to whom the Software is furnished to do so,
11:  * subject to the following conditions:
12:  * 
13:  * The above copyright notice and this permission notice shall be included in all
14:  * copies or substantial portions of the Software.
15:  * 
16:  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17:  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
18:  * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
19:  * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
20:  * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
21:  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
22:  */
23: /**
24:  * PHP class file.
25:  * @auhtor trashtoy
26:  * @since  2.0.0
27:  */
28: namespace Peach\Markup;
29: 
30: /**
31:  * SGML 形式の文書を書式化するための Formatter です.
32:  *
33:  * HTML を整形する場合はこちらを使用します.
34:  */
35: class SgmlRenderer extends AbstractRenderer
36: {
37:     /**
38:      * このクラスをインスタンス化することはできません.
39:      */
40:     private function __construct() {}
41:     
42:     /**
43:      * このクラスの唯一のインスタンスを取得します.
44:      * 
45:      * @return SgmlRenderer このクラスの唯一のインスタンス
46:      * @codeCoverageIgnore
47:      */
48:     public static function getInstance()
49:     {
50:         static $instance = null;
51:         if ($instance === null) {
52:             $instance = new self();
53:         }
54:         return $instance;
55:     }
56:     
57:     /**
58:      * 値の省略された属性を書式化します.
59:      * この実装は, 指定された属性名をそのまま返します.
60:      * 
61:      * @see AbstractRenderer::formatBooleanAttribute()
62:      * @param  string $name 属性名
63:      * @return string       引数と同じ文字列
64:      */
65:     protected function formatBooleanAttribute($name)
66:     {
67:         return $name;
68:     }
69:     
70:     /**
71:      * 指定された属性を書式化します. name="value" 形式の文字列を返します.
72:      * 
73:      * @see    AbstractRenderer::formatAttribute()
74:      * @param  string $name  属性名
75:      * @param  string $value 属性値
76:      * @return string name="value" 形式の文字列
77:      */
78:     protected function formatAttribute($name, $value)
79:     {
80:         return $name . '="' . htmlspecialchars($value) . '"';
81:     }
82:     
83:     /**
84:      * 空要素タグの末尾を書式化します. 文字列 ">" を返します.
85:      * 
86:      * @see AbstractRenderer::formatEmptyTagSuffix()
87:      * @return string 文字列 ">"
88:      */
89:     protected function formatEmptyTagSuffix()
90:     {
91:         return ">";
92:     }
93: }
94: