wp_text_diff

パラメータ

• $left_string
  古い方の文字列を指定。
• $right_string
  新しい方の文字列を指定。
• $args
  取得条件を連想配列または文字列で指定（省略時はnull）。主なキーは次の通り。

  キー	内容	省略時の値
  'show_split_view'	比較結果を左右で表示する場合はtrueを指定	true
  'title'	表全体のタイトルを指定	''
  'title_left'	$left_stringのタイトルを指定	''
  'title_right'	$right_stringのタイトルを指定	''

返り値

文字列の違いを示すHTML（table要素）を返す。違いがない場合は空の文字列を返す。

注意

比較は行単位で行われ、左右比較モード（'show_split_view'がtrue）では、以下のような内容になる。

単一モード（'show_split_view'がfalse）では、以下のような内容になる。

なおパラメータ$argsに'title'、'title_left'、'title_right'のいずれかを指定するとthead要素内が4カラムになり、tbody要素内とカラム数が異なってしまい、意図した表示にならない（バージョン4.9.8で確認）。タイトルを付けたい場合は本関数を使用せず、本関数を参考にして独自に実装する方がいいだろう。

使用例

• 投稿とリビジョンの本文部分を比較し、結果を左右比較モードで表示する。
  <?php echo wp_text_diff( $revisions[0]->post_content, $post->post_content ); ?>
• 投稿とリビジョンの本文部分を比較し、結果を単一モードで表示する。
  <?php echo wp_text_diff( $revisions[0]->post_content, $post->post_content, array( 'show_split_view' => false ) ); ?>

フィルター

アクション

ソースファイル