safecss_filter_attr

説明

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

パラメータ

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

返り値

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


注意

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

プロパティ名6.5.06.4.06.3.06.2.06.1.05.8.05.7.15.3.05.2.05.1.0
プロパティ名6.5.06.4.06.3.06.2.06.1.05.8.05.7.15.3.05.2.05.1.0
background
background-color
background-image
background-position
background-repeat
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
filter
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
writing-mode
position
top
right
bottom
left
z-index
box-shadow
aspect-ratio
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

最終更新 : 2024年04月03日 17:15


お勧め

5.3の新機能:クエリーログに任意の項目を追加できる新フィルター(2019年10月23日 更新)

5.3 RC2」が公開され、正式リリースまであと20日。公式ディレクトリにプラグインを公開していることもあり、5.3に関する開発者向けの情報「Miscellaneous Developer Focused Changes in 5.3」を読んでいる。

個人データのエクスポートメール向けに追加された新フィルター(2020年4月2日 更新)

先週「WordPress 5.4 RC3」が公開され、正式リリースまであと1週間。ブロックエディターの機能強化が目立つわけですが、地味な変更点もちらほらと。今回はその中の1つ、「個人データのエクスポート」機能に関連するフィルターを紹介する。

投稿内容に応じてwpautopを制御する(2013年8月13日 更新)

投稿内容を表示する the_content関数では、 wpautop関数がフィルターの1つとして呼び出され、改行をbrタグに変換したり、pタグで調整したりする。この機能自体は便利なのだが、きちんとデザインされたHTMLソースを流し込んだ場合はこの機能は好ましくない。そんなわけで、記事内容に応じてwpautop関数を制御できないか考えてみた。

新「WordPress Events and News」ウィジェットが興味深い(2018年5月27日 更新)

4.8のベータ版ですぐに新機能とわかるのが管理者ダッシュボードの新「WordPress Events and News」ウィジェット。ユーザーが指定した地域近隣で開催されるイベント情報を表示してくれるウィジェットで、この中のフォームがちょっと興味深かった。なおこの記事はWordPress 4.8 beta-2をもとにしており、以降のバージョンで変更される可能性があることをあらかじめ断っておく。

各種リンクを取得する関数一覧(2014年6月12日 更新)

サイト設計において、ページ間の相互リンクは重要である。WordPressでは各種ページのリンク(パーマリンク)を取得する関数を用意しており、それらを一通り把握しておくべきだろう。