WordPress shortcode_atts() 函式應用

【函式介紹】

shortcode_atts() 函式是與 WordPress 短程式碼函式:add_shortcode() 一起使用的, 結果返回短程式碼中的屬性系列陣列。

【函式使用】

<?php shortcode_atts( $pairs , $atts ); ?>

【引數說明】

$pairs
(array) (必須) 所有支援的屬性和他們預設值的完整列表。
預設: None

$atts
(array) (必須) 使用者在短程式碼標籤中輸入的屬性值
預設: None

【返回值】

(array)
使用者輸入和預設兩者合併和過濾之後的陣列列表。

【函式例項】

在你主題的 functions.php 檔案新增如下程式碼

function bartag_func($atts) {
	extract(shortcode_atts(array(
		'foo' => 'no foo',  //預設為 no foo
		'bar' => 'default bar'//預設為 default bar
	), $atts));

	return 'bartag: ' . $foo . ' ' . $bar;
}
add_shortcode('bartag', 'bartag_func');

編輯檔案時切換到文字模式新增如下短程式碼：

[bartag foo="koala" bar="bears"] 

輸出內容如下:
bartag: koala bears

【原始檔】

shortcode_atts() 位於 wp-includes/shortcodes.php.

相關函式：add_shortcode()