wp_strip_all_tags

説明

string wp_strip_all_tags( string $string [ , bool $remove_breaks = false ] )
文字列からHTMLタグを取り除く。

パラメータ

  • $string
    文字列を指定。
  • $remove_breaks
    連続した空白文字を1つのスペースに変換する場合はtrueを指定(省略時はfalse)。

返り値

HTMLタグを取り除いた文字列を返す。

注意

文字列からHTMLタグを取り除く関数としてPHPのstrip_tags関数があるが、本関数ではstrip_tags関数を呼ぶ前にSTYLEタグとSCRIPTタグを取り除いている。さらにHTMLタグを取り除いた後に先頭と末尾の空白文字も取り除く。

パラメータ$remove_breaksがtrueの場合、連続する空白文字(改行、復帰、タブ、スペース)をスペースに変換する。

変換前の文字列
<html lang="ja">
<head>
<title>Hello world!</title>
<style type="text/css" media="screen">
	html { margin-top: 32px !important; }
</style>
</head>
<body>
	<h1 class="entry-title">Hello world!</h1>
	<div class="entry-content">
		<p>WordPress へようこそ。</p>
	</div><!-- .entry-content -->
</body>
</html>
strip_tags関数の処理後


Hello world!

	html { margin-top: 32px !important; }



	Hello world!
	
		WordPress へようこそ。
	


wp_strip_all_tags関数($remove_breaks = false)の処理後
Hello world!



	Hello world!
	
		WordPress へようこそ。
wp_strip_all_tags関数($remove_breaks = true)の処理後
Hello world! Hello world! WordPress へようこそ。

使用例

  • 文字列からHTMLタグを取り除く。
    <?php $text = wp_strip_all_tags( $text ); ?>
  • 文字列からHTMLタグと連続する空白文字を取り除く。
    <?php $text = wp_strip_all_tags( $text, true ); ?>

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/formatting.php

最終更新 : 2018年05月27日 10:42


お勧め

カテゴリー専用の投稿一覧と新規投稿メニューを追加する(2012年1月23日 更新)

サイト更新の1クリックを省くため、特定カテゴリーの投稿に対して同じようにメニューを追加してみた。カスタム投稿タイプの専用投稿メニューみたいな感じである。

ブロックエディターの文字サイズ設定を変えてみる(2019年12月12日 更新)

今回は「前回投稿した内容」の続きブロックエディターの文字サイズ設定を変えようと思う。参考にするテーマはもちろん「Twenty Twenty」である。

4.2で始まるiOSの絵文字ケア(2018年5月27日 更新)

WordPress 4.2のベータ1、ベータ2が立て続けにリリースされ、4.2の正式版リリースが近づいています。4.2のポイントの1つは絵文字のクロスブラウザ対応です。ここでの絵文字とは、UTF-8で4バイトのコードが割り当てられている(基本的にはiOSの)絵文字を指します。この絵文字を含んだ投稿が正しく保存できなかったり、iOS以外の環境で意図した通りに表示できないといった問題があり、4.2ではそのような問題を対処をコードが組み込まれています。

「不明な書式」って何ですか。(2024年11月13日 更新)

オートコンプリート機能を利用して四字熟語を挿入するプラグインを作った際、ツールバーに「不明な書式をクリア(Clear Unknown Formatting)」ボタンが表示されるようになった。この「書式」、何を指しているのかわからないんだが。

決まった値を返すだけの関数群(2018年5月27日 更新)

WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。