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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(整形、未翻訳)
(新規翻訳)
1行目: 1行目:
 
{{NeedTrans}}
 
{{NeedTrans}}
== Description ==
+
== 説明 ==
  
This function calls each of the active widget callbacks in order, which prints the markup for the sidebar. If you have more than one sidebar, you should give this function the name or number of the sidebar you want to print. This function returns true on success and false on failure.
+
この関数はアクティブなウィジェットコールバック関数を順に呼び出し、サイドバーに表示します。複数のサイドバーがある場合、表示するサイドバーの番号または名前を知らせる必要があります。この関数が正しく実行されると true を返し、失敗すると false を返します。
  
The return value should be used to determine whether to display a static sidebar. This ensures that your theme will look good even when the Widgets plug-in is not active.
+
静的なサイドバーを表示するかどうかを決定するのに、返り値を使用すべきです。こうすることで、ウィジェットプラグインがアクティブでない場合にも、テーマがきちんと表示されるようにできます。
  
If your sidebars were registered by number, they should be retrieved by number. If they had names when you registered them, use their names to retrieve them.
+
サイドバーを番号で登録している場合、番号で呼び出します。名前で登録している場合は、名前で呼び出します。
  
== Usage ==
+
== 使い方 ==
  
<?php dynamic_sidebar( $number ); ?>
+
<?php dynamic_sidebar( $number ); ?>
  
== Parameters ==
+
== パラメーター ==
  
{{Parameter|$number|int/string|Name or ID of dynamic sidebar.|optional|1}}
+
{{パラメーター|$number|int/string|名称、またはサイドバーのID|optional|1}}
  
== Return Value ==
+
== 返り値 ==
  
 
; (boolean) : True, if widget sidebar was found and called. False if not found or not called.
 
; (boolean) : True, if widget sidebar was found and called. False if not found or not called.
  
==Examples==
+
==サンプル==
  
Here is the recommended use of this function:
+
致命的なエラーを防ぐために、以下のように使用することをお勧めします。
  
 
<pre>
 
<pre>
<ul id="sidebar">
+
<ul id="sidebar">
<?php if ( !function_exists('dynamic_sidebar') || !dynamic_sidebar() ) : ?>
+
<?php if ( !function_exists('dynamic_sidebar') || !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>
  
==Multiple Sidebars==
+
==複数のサイドバー==
  
You can load a specific sidebar by either their name (if given a string) or ID (if given an integer). For example, <tt>dynamic_sidebar('top_menu')</tt> will present a sidebar registered with <tt>register_sidebar(array('name'=>'top_menu',))</tt>.  
+
You can load a specific sidebar by either their name (if given a string) or ID (if given an integer). For example, <tt>dynamic_sidebar('top_menu')</tt> will present a sidebar registered with <tt>register_sidebar(array('name'=>'top_menu',))</tt>.
  
 
Using ID's ( <tt>dynamic_sidebar(1)</tt> ) is easier in that you don't need to name your sidebar, but they are harder to figure out which is which without looking into your <tt>functions.php</tt> file or in the widgets administration panel and thus make your code less readable. Note that ID's begin at 1.
 
Using ID's ( <tt>dynamic_sidebar(1)</tt> ) is easier in that you don't need to name your sidebar, but they are harder to figure out which is which without looking into your <tt>functions.php</tt> file or in the widgets administration panel and thus make your code less readable. Note that ID's begin at 1.
  
== Change Log ==
+
== 変更履歴 ==
  
 
Since: 2.2.0
 
Since: 2.2.0
  
== Source File ==
+
== ソースファイル ==
  
<tt>dynamic_sidebar()</tt> is located in {{Trac|wp-includes/widgets.php}}.
+
<tt>dynamic_sidebar()</tt> {{Trac|wp-includes/widgets.php}} にあります。
  
== Further Reading ==
+
== 合わせて読みたい記事 ==
  
 
* [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]
53行目: 53行目:
 
{{原文|Function Reference/dynamic_sidebar|78546}}<!-- 11:17, 28 September 2009 Ramiy 版 -->
 
{{原文|Function Reference/dynamic_sidebar|78546}}<!-- 11:17, 28 September 2009 Ramiy 版 -->
  
== Related ==
+
== 関連 ==
  
 
{{Widget Tags}}
 
{{Widget Tags}}
63行目: 63行目:
 
[[Category:wp2.2]]
 
[[Category:wp2.2]]
  
[[en:Function Reference/dynamic_sidebar]]
+
最新英語版 : [[en:Function Reference/dynamic_sidebar]]

2014年11月26日 (水) 21:40時点における版

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

説明

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

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

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

使い方

<?php dynamic_sidebar( $number ); ?>

パラメーター

テンプレート:パラメーター

返り値

(boolean) 
True, if widget sidebar was found and called. False if not found or not called.

サンプル

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

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

複数のサイドバー

You can load a specific sidebar by either their name (if given a string) or ID (if given an integer). For example, dynamic_sidebar('top_menu') will present a sidebar registered with register_sidebar(array('name'=>'top_menu',)).

Using ID's ( dynamic_sidebar(1) ) is easier in that you don't need to name your sidebar, but they are harder to figure out which is which without looking into your functions.php file or in the widgets administration panel and thus make your code less readable. Note that ID's begin at 1.

変更履歴

Since: 2.2.0

ソースファイル

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

合わせて読みたい記事

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

関連

ウィジェット 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



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

最新英語版 :