当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「関数リファレンス/dynamic sidebar」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(原文タグの更新)
(最新版のマージ {{原文|Function Reference/dynamic_sidebar|150438}}<!-- 10:45, 30 March 2015‎ Ramiy 版 -->)
13行目: 13行目:
 
== パラメーター==
 
== パラメーター==
  
{{Parameter|$number|int/string|<tt>名称、またはサイドバーのID</tt>|optional|1}}
+
{{Parameter|$number|int/string|<tt>名称、またはサイドバーのID</tt>|オプション|1}}
  
 
== 返り値 ==
 
== 返り値 ==
19行目: 19行目:
 
; (boolean) : サイドバーの中にウィジェットが登録されているときは True を、ウィジェットが登録されていない、サイドバーが見つからない時は False を返します。
 
; (boolean) : サイドバーの中にウィジェットが登録されているときは True を、ウィジェットが登録されていない、サイドバーが見つからない時は False を返します。
  
==サンプル==
+
==用例==
  
 
致命的なエラーを防ぐために、以下のように使用することをお勧めします。
 
致命的なエラーを防ぐために、以下のように使用することをお勧めします。
 +
 +
<pre>
 +
<?php if ( is_active_sidebar( 'left-sidebar' ) ) : ?>
 +
<ul id="sidebar">
 +
<?php dynamic_sidebar( 'left-sidebar' ); ?>
 +
</ul>
 +
<?php endif; ?>
 +
</pre>
 +
 +
<pre>
 +
<ul id="sidebar">
 +
<?php dynamic_sidebar( 'right-sidebar' ); ?>
 +
</ul>
 +
</pre>
  
 
<pre>
 
<pre>
 
<ul id="sidebar">
 
<ul id="sidebar">
<?php if ( !function_exists('dynamic_sidebar') || !dynamic_sidebar() ) : ?>
+
<?php if ( ! dynamic_sidebar() ) : ?>
<li>{static sidebar item 1}</li>
+
<li>{static sidebar item 1}</li>
<li>{static sidebar item 2}</li>
+
<li>{static sidebar item 2}</li>
 
<?php endif; ?>
 
<?php endif; ?>
 
</ul>
 
</ul>
 
</pre>
 
</pre>
 +
 +
=== "Twenty Ten" テーマ内 (3.0以降) ===
 +
 +
* {{Trac|wp-content/themes/twentyten/sidebar.php}}
 +
* {{Trac|wp-content/themes/twentyten/sidebar-footer.php}}
 +
  
 
==複数のサイドバー==
 
==複数のサイドバー==
38行目: 58行目:
  
 
IDを使って呼び出す場合、 ( <tt>dynamic_sidebar(1)</tt> ) あなたはサイドバーの名称を必要としませんが、これはdynamic_sidebar関数でサイドバーを呼び出す際に把握しにくくなります。IDは1から始まることに注意してください。
 
IDを使って呼び出す場合、 ( <tt>dynamic_sidebar(1)</tt> ) あなたはサイドバーの名称を必要としませんが、これはdynamic_sidebar関数でサイドバーを呼び出す際に把握しにくくなります。IDは1から始まることに注意してください。
 +
 +
If you name your own ID values in the <tt>register_sidebar()</tt> WordPress function, you might increase readability of the code. The ID should be all lowercase alphanumeric characters and not contain white space. You can also use the <tt>-</tt> and <tt>_</tt> characters. IDs must be unique and cannot match a sidebar name. Using your own IDs can also make the sidebar name translatable.
 +
 +
<pre>// See the __() WordPress function for valid values for $text_domain.
 +
register_sidebar( array(
 +
    'id'          => 'top-menu',
 +
    'name'        => __( 'Top Menu', $text_domain ),
 +
    'description' => __( 'This sidebar is located above the age logo.', $text_domain ),
 +
) );
 +
</pre>
 +
This allows the use of <tt>dynamic_sidebar( 'top-menu' )</tt> which uses an ID and is readable.
  
 
== 変更履歴 ==
 
== 変更履歴 ==
  
Since: 2.2.0
+
新規導入: [[Version 2.2|2.2.0]]
  
 
== ソースファイル ==
 
== ソースファイル ==
50行目: 81行目:
  
 
* [http://www.prelovac.com/vladimir/wordpress-theme-flexibility-with-dynamic-sidebars WordPress theme flexibility with dynamic sidebars]
 
* [http://www.prelovac.com/vladimir/wordpress-theme-flexibility-with-dynamic-sidebars WordPress theme flexibility with dynamic sidebars]
 
+
* [http://wordpress.org/support/topic/the-meaning-of-spitting-out-widgets The meaning of "spitting out" widgets]
  
  
60行目: 91行目:
  
 
{{Tag Footer}}
 
{{Tag Footer}}
 +
 +
{{NeedTrans}}
  
 
{{DEFAULTSORT:Dynamic_sidebar}}
 
{{DEFAULTSORT:Dynamic_sidebar}}
65行目: 98行目:
 
[[Category:wp2.2]]
 
[[Category:wp2.2]]
  
{{原文|Function Reference/dynamic_sidebar|148139}}<!-- 13:08, 26 November 2014‎ Ishihara takashi 版 -->
+
{{原文|Function Reference/dynamic_sidebar|150438}}<!-- 10:45, 30 March 2015‎ Ramiy 版 -->

2015年7月2日 (木) 07:44時点における版

説明

この関数はアクティブなウィジェットコールバック関数を順に呼び出し、サイドバーに表示します。複数のサイドバーがある場合、表示するサイドバーの番号または名前を知らせる必要があります。この関数が正しく実行されると true を返し、失敗すると false を返します。

静的なサイドバーを表示するかどうかを決定するのに、返り値を使用すべきです。こうすることで、ウィジェットプラグインがアクティブでない場合にも、テーマがきちんと表示されるようにできます。

サイドバーを番号で登録している場合、番号で呼び出します。名前で登録している場合は、名前で呼び出します。

使い方

<?php dynamic_sidebar( $number ); ?>

パラメーター

$number
int/string) (オプション名称、またはサイドバーのID
初期値: 1

返り値

(boolean) 
サイドバーの中にウィジェットが登録されているときは True を、ウィジェットが登録されていない、サイドバーが見つからない時は False を返します。

用例

致命的なエラーを防ぐために、以下のように使用することをお勧めします。

<?php if ( is_active_sidebar( 'left-sidebar' ) ) : ?>
	<ul id="sidebar">
		<?php dynamic_sidebar( 'left-sidebar' ); ?>
	</ul>
<?php endif; ?>
<ul id="sidebar">
	<?php dynamic_sidebar( 'right-sidebar' ); ?>
</ul>
<ul id="sidebar">
<?php if ( ! dynamic_sidebar() ) : ?>
	<li>{static sidebar item 1}</li>
	<li>{static sidebar item 2}</li>
<?php endif; ?>
</ul>

"Twenty Ten" テーマ内 (3.0以降)


複数のサイドバー

名称 ( idを文字列で指定した場合 )、または ID (整数値で指定、または指定しなかった場合)のいずれかで特定のサイドバーをロードすることができます。 例として、 register_sidebar(array('name'=>'top_menu',)) という定義でサイドバーを登録している場合、dynamic_sidebar('top_menu')という記述で呼び出すことができます。

IDを使って呼び出す場合、 ( dynamic_sidebar(1) ) あなたはサイドバーの名称を必要としませんが、これはdynamic_sidebar関数でサイドバーを呼び出す際に把握しにくくなります。IDは1から始まることに注意してください。

If you name your own ID values in the register_sidebar() WordPress function, you might increase readability of the code. The ID should be all lowercase alphanumeric characters and not contain white space. You can also use the - and _ characters. IDs must be unique and cannot match a sidebar name. Using your own IDs can also make the sidebar name translatable.

// See the __() WordPress function for valid values for $text_domain.
register_sidebar( array(
    'id'          => 'top-menu',
    'name'        => __( 'Top Menu', $text_domain ),
    'description' => __( 'This sidebar is located above the age logo.', $text_domain ),
) );

This allows the use of dynamic_sidebar( 'top-menu' ) which uses an ID and is readable.

変更履歴

新規導入: 2.2.0

ソースファイル

dynamic_sidebar()wp-includes/widgets.php にあります。

合わせて読みたい記事


関連資料

サイドバー: is_active_sidebar(), is_dynamic_sidebar(), dynamic_sidebar(), register_sidebars(), register_sidebar(), unregister_sidebar(), wp_register_sidebar_widget() / en, wp_unregister_sidebar_widget() / en, wp_get_sidebars_widgets() / en, wp_set_sidebars_widgets() / en,



ウィジェット API: is_active_widget(), the_widget(), register_widget(), unregister_widget() / en, wp_register_widget_control() / en, wp_unregister_widget_control() / en, wp_convert_widget_settings() / en, wp_get_widget_defaults() / en, wp_widget_description() / en



関数リファレンステンプレートタグ目次もご覧ください。


このページ「関数リファレンス/dynamic sidebar」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

最新英語版: WordPress Codex » Function Reference/dynamic_sidebar最新版との差分