view release on metacpan or  search on metacpan

doc/Tripletail/TagCheck.html  view on Meta::CPAN

<p>
<span class="pod_lang">&quot;:&quot;で指定されたタグは、その閉じタグの存在が禁止される。
禁止された閉じタグは削除される。

</span>
</p>

<p>
<span class="pod_lang">&quot;;&quot;で指定されたタグは、その閉じタグの存在が要求される。
閉じタグが存在しない場合は、setTagBreakで指定された方法に従って
閉じタグが追加される。

</span>
</p>

<p>
<span class="pod_lang">&quot;;A(HREF,TARGET)&quot;のように&quot;(...)&quot;で属性の種類を制限可能。
列挙しなかった属性は削除される。

</span>
</p>

<p>
<span class="pod_lang">&quot;;TR[TD,TH]&quot;のように&quot;[...]&quot;で子要素の種類を制限可能。
列挙しなかった子要素はエスケープされる。また、このようにして子要素の種類を
制限した場合は、要素がテキストを持つ事も禁止される。禁止されたテキストは
削除される。&quot;;TR[TD,TH,*]&quot;のように要素名として&quot;*&quot;を指定すると、子要素としての
テキストが禁止されない。

</span>
</p>

<p>
<span class="pod_lang">&quot;;TD{none}&quot;のように&quot;{...}&quot;でsetTagBreakの指定を部分的に上書き可能。
このようにしてTagBreakが例外指定された要素については、setTagBreakでの設定が
適用されない。

</span>
</p>

<p>
<span class="pod_lang">上記&quot;(...)&quot;, &quot;[...]&quot;, &quot;{...}&quot;のオプションは任意の順序で同時に指定する事が可能。
但し同じ種類のオプションを一つのタグに対し複数個指定する事は出来ない。

</span>
</p>

<p>
<span class="pod_lang">デフォルト値は次の通り:

</span>
</p>

<pre class="pod_verbatim"><code>  &quot;:HR:BR;S;STRONG;I;U;EM;A(HREF,TARGET,NAME)&quot;</code></pre>

</dd>
<dt><a id="addAllowTag"><span class="pod_lang">addAllowTag

</span></a></dt>
<dd>
<pre class="pod_verbatim"><code>  $checker-&gt;addAllowTag('!EMBED;TABLE[TR];TR[TD,TH];TD{none};TH{none}')</code></pre>

<p>
<span class="pod_lang">既存のタグの許可情報が消されない事を除き、setAllowTagと同様。
また、このメソッドでのみ意味のある指定方式として、
&quot;!TAG&quot;のように特定のタグを改めて禁止する事が出来る。

</span>
</p>

</dd>
<dt><a id="setATarget"><span class="pod_lang">setATarget

</span></a></dt>
<dd>
<pre class="pod_verbatim"><code>  $checker-&gt;setATarget('_blank')</code></pre>

<p>
<span class="pod_lang">a要素のtarget属性を書換えるかどうか。undefを指定すると書換えが行われない。
setATargetを実行しない状態では'_blank'として設定されている。

</span>
</p>

</dd>
</dl>

<h2><a id="Xe8Xa3X9cXe8Xb6Xb3">
<span class="pod_lang">補足

</span></a></h2>

<p>
<span class="pod_lang">TagCheck は入力される文字列が HTML の文法的に正しい（well-formed である）
事を前提にしています。
出力は、文法的に正しく解釈しようとした結果で作られるため、
入力したタグの形と変わることがあります。

</span>
</p>


<hr />
<h1><a id="SEE_ALSO">
<span class="pod_lang">SEE ALSO

</span></a></h1>

<dl>
<dt><a id="X_"><span class="pod_lang"><a href=".././Tripletail.html">Tripletail</a>

</span></a></dt>
<dd>
</dd>
<dt><a id="X__00"><span class="pod_lang"><a href="http://search.cpan.org/perldoc/Tripletail::HtmlFilter">Tripletail::HtmlFilter</a>

</span></a></dt>
<dd>
</dd>
</dl>