説明
string safecss_filter_attr( string $css [ , string $deprecated = '' ] )
インラインスタイルをサニタイズする。
パラメータ
- $cssstyle属性値を指定。
- $deprecated使用不可（省略時は''）。
返り値
ルールに適合しない内容を取り除いたstyle属性値を返す。
注意
有効なスタイルのプロパティ名はバージョンによって異なる（適宜追加されてきている）。
| プロパティ名 | 5.3.0 | 5.2.0 | 5.1.0 |
|---|---|---|---|
| 'background' | 〇 | 〇 | 〇 |
| 'background-color' | 〇 | 〇 | 〇 |
| 'background-image' | 〇 | 〇 | 〇 |
| 'background-position' | 〇 | 〇 | |
| 'background-size' | 〇 | ||
| 'background-attachment' | 〇 | ||
| 'background-blend-mode' | 〇 | ||
| 'border' | 〇 | 〇 | 〇 |
| 'border-radius' | 〇 | ||
| 'border-width' | 〇 | 〇 | 〇 |
| 'border-color' | 〇 | 〇 | 〇 |
| 'border-style' | 〇 | 〇 | 〇 |
| 'border-right' | 〇 | 〇 | 〇 |
| 'border-right-color' | 〇 | 〇 | 〇 |
| 'border-right-style' | 〇 | 〇 | 〇 |
| 'border-right-width' | 〇 | 〇 | 〇 |
| 'border-bottom' | 〇 | 〇 | 〇 |
| 'border-bottom-color' | 〇 | 〇 | 〇 |
| 'border-bottom-style' | 〇 | 〇 | 〇 |
| 'border-bottom-width' | 〇 | 〇 | 〇 |
| 'border-left' | 〇 | 〇 | 〇 |
| 'border-left-color' | 〇 | 〇 | 〇 |
| 'border-left-style' | 〇 | 〇 | 〇 |
| 'border-left-width' | 〇 | 〇 | 〇 |
| 'border-top' | 〇 | 〇 | 〇 |
| 'border-top-color' | 〇 | 〇 | 〇 |
| 'border-top-style' | 〇 | 〇 | 〇 |
| 'border-top-width' | 〇 | 〇 | 〇 |
| 'border-spacing' | 〇 | 〇 | 〇 |
| 'border-collapse' | 〇 | 〇 | 〇 |
| 'caption-side' | 〇 | 〇 | 〇 |
| 'columns' | 〇 | ||
| 'column-count' | 〇 | ||
| 'column-fill' | 〇 | ||
| 'column-gap' | 〇 | ||
| 'column-rule' | 〇 | ||
| 'column-span' | 〇 | ||
| 'column-width' | 〇 | ||
| 'color' | 〇 | 〇 | 〇 |
| 'font' | 〇 | 〇 | 〇 |
| 'font-family' | 〇 | 〇 | 〇 |
| 'font-size' | 〇 | 〇 | 〇 |
| 'font-style' | 〇 | 〇 | 〇 |
| 'font-variant' | 〇 | 〇 | 〇 |
| 'font-weight' | 〇 | 〇 | 〇 |
| 'letter-spacing' | 〇 | 〇 | 〇 |
| 'line-height' | 〇 | 〇 | 〇 |
| 'text-align' | 〇 | 〇 | 〇 |
| 'text-decoration' | 〇 | 〇 | 〇 |
| 'text-indent' | 〇 | 〇 | 〇 |
| 'text-transform' | 〇 | 〇 | 〇 |
| 'height' | 〇 | 〇 | 〇 |
| 'min-height' | 〇 | 〇 | 〇 |
| 'max-height' | 〇 | 〇 | 〇 |
| 'width' | 〇 | 〇 | 〇 |
| 'min-width' | 〇 | 〇 | 〇 |
| 'max-width' | 〇 | 〇 | 〇 |
| 'margin' | 〇 | 〇 | 〇 |
| 'margin-right' | 〇 | 〇 | 〇 |
| 'margin-bottom' | 〇 | 〇 | 〇 |
| 'margin-left' | 〇 | 〇 | 〇 |
| 'margin-top' | 〇 | 〇 | 〇 |
| 'padding' | 〇 | 〇 | 〇 |
| 'padding-right' | 〇 | 〇 | 〇 |
| 'padding-bottom' | 〇 | 〇 | 〇 |
| 'padding-left' | 〇 | 〇 | 〇 |
| 'padding-top' | 〇 | 〇 | 〇 |
| 'flex' | 〇 | ||
| 'flex-basis' | 〇 | ||
| 'flex-direction' | 〇 | ||
| 'flex-flow' | 〇 | ||
| 'flex-grow' | 〇 | ||
| 'flex-shrink' | 〇 | ||
| 'grid-template-columns' | 〇 | 〇 | |
| 'grid-auto-columns' | 〇 | ||
| 'grid-column-start' | 〇 | ||
| 'grid-column-end' | 〇 | ||
| 'grid-column-gap' | 〇 | ||
| 'grid-template-rows' | 〇 | ||
| 'grid-auto-rows' | 〇 | ||
| 'grid-row-start' | 〇 | ||
| 'grid-row-end' | 〇 | ||
| 'grid-row-gap' | 〇 | ||
| 'grid-gap' | 〇 | ||
| 'justify-content' | 〇 | ||
| 'justify-items' | 〇 | ||
| 'justify-self' | 〇 | ||
| 'align-content' | 〇 | ||
| 'align-items' | 〇 | ||
| 'align-self' | 〇 | ||
| 'clear' | 〇 | 〇 | 〇 |
| 'cursor' | 〇 | 〇 | 〇 |
| 'direction' | 〇 | 〇 | 〇 |
| 'float' | 〇 | 〇 | 〇 |
| 'overflow' | 〇 | 〇 | 〇 |
| 'vertical-align' | 〇 | 〇 | 〇 |
| 'list-style-type' | 〇 | 〇 | 〇 |
'safe_style_css'フィルターにて得られる内容が空の場合、パラメータ$cssはそのまま返り値となる。
使用例
- インラインスタイルをサニタイズする。
<?php $inline_style = safecss_filter_attr( $inline_style ); ?>
フィルター
[2.8.1]'safe_style_css'フィルターを呼び出す。パラメータ$attrには有効なスタイルのプロパティ名を列挙した配列が格納されている。$allowed_attr = apply_filters( 'safe_style_css', $attr );アクション
直接実行するアクションはありません。ソースファイル
/wp-includes/kses.php最終更新 : 2019年11月21日 11:06
お勧め
テーブルブロックを定形に整える（2021年12月27日 更新）
ブロックエディターについて調べていると、「段落ブロックをもう少しカスタマイズした」で使ったRichTextShortcutとは別にショートカットキーを使うためのKeyboardShortcutsが見つかった。今回はこのKeyboardShortcutsを使ってテーブルブロックを定形に整える仕組みを考えてみた。
各種リンクを取得する関数一覧（2014年6月12日 更新）
サイト設計において、ページ間の相互リンクは重要である。WordPressでは各種ページのリンク（パーマリンク）を取得する関数を用意しており、それらを一通り把握しておくべきだろう。
スクリプトファイルのバージョンパラメータを変更する（2018年5月27日 更新）
Java Scriptやスタイルシートの指定を直接head要素内に記述せず、wp_enqueue_scriptsフィルターなどを使って指定する場合、WordPressのバージョン番号が付与されている。このバージョン番号は、妥当なんだろうか。
4.2の「アクティビティ」ウィジェットに投稿以外の情報も表示する（2018年5月27日 更新）
ダッシュボードの「アクティビティ」ウィジェットは「投稿（post）」の状況を表示し、固定ページ（page）やカスタム投稿タイプの投稿記事の状況については標準では表示されない。このことに対して以前『3.8の「アクティビティ」ウィジェットに投稿以外の情報も表示する』を紹介したのだが、4.2では新しいフィルターが追加され、カスタマイズが少し容易になった。
投稿一覧に「投稿フォーマット」フィルターが追加される（2019年4月12日 更新）
WordPress 5.2 Beta2（以降5.2Beta2）のソースコードを眺めていると、投稿一覧ページのフィルター機能に「投稿フォーマット」（select要素）が追加されていた。