safecss_filter_attr

（2.8.1以降）
safecss_filter_attr - インラインスタイルをサニタイズする

説明

string safecss_filter_attr( string $css [ , string $deprecated = '' ] )
インラインスタイルをサニタイズする。

パラメータ

  • $css
    style属性値を指定。
  • $deprecated
    使用不可（省略時は''）。

返り値

ルールに適合しない内容を取り除いたstyle属性値を返す。

注意

有効なスタイルのプロパティ名はバージョンによって異なる（適宜追加されてきている）。

プロパティ名6.1.05.8.05.7.15.3.05.2.05.1.0
プロパティ名6.1.05.8.05.7.15.3.05.2.05.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〇〇〇〇〇〇
margin-block-start〇
margin-block-end〇
margin-inline-start〇
margin-inline-end〇
padding〇〇〇〇〇〇
padding-right〇〇〇〇〇〇
padding-bottom〇〇〇〇〇〇
padding-left〇〇〇〇〇〇
padding-top〇〇〇〇〇〇
padding-block-start〇
padding-block-end〇
padding-inline-start〇
padding-inline-end〇
flex〇〇〇〇
flex-basis〇〇〇〇
flex-direction〇〇〇〇
flex-flow〇〇〇〇
flex-grow〇〇〇〇
flex-shrink〇〇〇〇
flex-wrap〇
gap〇
column-gap〇
row-gap〇
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〇〇〇〇〇〇
list-style-type〇〇〇〇〇〇
object-fit〇
object-position〇〇〇
overflow〇〇〇〇〇〇
vertical-align〇〇〇〇〇〇
calc()〇〇
var()〇〇
min()〇
max()〇
minmax()〇
clamp()〇

'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

最終更新 : 2022年11月05日 15:11

参考

Code Reference: safecss_filter_attr

お勧め

Login rebuilderに「XML-RPC設定」を追加しました（2018年5月27日 更新）

公式サイトで公開しているプラグイン「Login rebuilder」をバージョンアップし、XML-RPCリクエストの管理機能を追加しました。Login rebuilderの主たる機能は、ログインページをサイト別にユニークなURLに変更し、ログインページへの不正アクセスを回避することです。WordPressのXML-RPCリクエストはピンバックや外部ツールやサイトなどとの連携に利用されていますが、今回追加した機能ではXML-RPCリクエストの処理に対していくつかの制限できるようにしています。

絵文字画像がPNGからSVGへ（2018年5月27日 更新）

WordPressでは絵文字に対応していないブラウザ環境で絵文字を表示する仕組みをバージョン4.2から提供。絵文字に対応しているブラウザとそん色がない表示を実現する。

4.4では投稿ページも専用テンプレートが適用できる（2018年5月27日 更新）

従来、特定の固定ページには専用テンプレートを適用できるのですが、投稿ページに適用させるためにはアクションやフィルターを利用する必要がありました。4.4では特定の投稿ページに標準で専用テンプレートを適用できるようになりそうです。

5.7の新機能：HTTPからHTTPSへの移行（2021年3月13日 更新）

先週は「WordPress 5.7 Beta 2（以降Beta 2）」が公開され、正式版リリースへ一歩進みました。WordPress 5.7の注目ポイントの1つに「HTTPからHTTPSへの移行」を手助けする機能があり、それに関連する機能を含んだhttps-detection.phpファイルとhttps-migration.phpが追加されていた。

wp_titleからwp_get_document_titleへ（2018年5月27日 更新）

先週、WordPress 4.4 beta1（以降4.4 beta1）が公開されました。この4.4 beta1では新テーマ「Twenty Sixteen」が追加されたほか、wp-includesディレクトリ以下のファイルが大幅に変更された感じです。