WordPress下拉列表输出页面标签:wp_dropdown_pages

WordPress模板标签wp_dropdown_pages用于输出页面列表,与其他输出页面列表的函数比较,wp_dropdown_pages()函数不是以

  • 列表输出,而是下拉列表。

    wp_dropdown_pages( array|string $args = '' )
    

    函数参数

    $args

    数组或字符串值

    wp_dropdown_pages()函数$args参数默认的值如下:

    $args = array(
    	'depth'                 => 0,
    	'child_of'              => 0,
    	'selected'              => 0,
    	'echo'                  => 1,
    	'name'                  => 'page_id',
    	'id'                    => null,
    	'class'                 => null,
    	'show_option_none'      => null,
    	'show_option_no_change' => null,
    	'option_none_value'     => null,
    );
    

    wp_dropdown_pages()函数$args参数可用的值如下:

    depth

    整数型,默认值:0

    • 0:输出所有的页面和子页面,按层级的方式输出;
    • 1:只输出顶级页面,不包含任何子页面;
    • n:根据n的具体数字来显示相应等级的页面;
    • -1:输出所有的页面和子页面,不以层级的方式输出;

    child_of

    整数型,默认值:0

    指定一个页面ID,将输出该页面的子页面,不包含该页面。

    selected

    整数型,默认值:0

    指定一个页面ID,这个页面的标签将添加selected属性,也就是选中状态。

    echo

    布尔值,默认值:1

    是否输出结果,如果为0,只返回结果而不输出。

    name

    字符串值,默认值:page_id

    标签name属性的值

    id

    字符串值,默认值:与name的值相同

    标签id属性的值

    class

    字符串值,默认为空

    标签class属性的值

    show_option_none

    字符串值,默认为空

    通常情况下,下拉列表有一个名为“请选择”的空,该值指定这个空的文本。

    option_none_value

    字符串值,默认为空

    为show_option_none添加的指定value值

    show_option_no_change

    字符串值,默认为空

    添加一个value为-1的选项,show_option_no_change的值为这个的文本。

    exclude

    字符串值,默认为空

    要排除的页面ID,多个ID用逗号分隔。

    exclude_tree

    字符串值,默认为空

    要排除的页面ID,多个ID用逗号分隔,连同子页面一起排除。

    函数使用示例

    只显示顶级页面,设置ID为15的页面默认被选中,并添加了一个“请选择”的选项

     1,
    		'selected' => 15,
    		'show_option_none' => '请选择'
    	);
    	wp_dropdown_pages($args);
    ?>
    

    下面的代码输出一样的结果:

    
    

    扩展阅读

    wp_dropdown_pages()函数位于:wp-includes/post-template.php

    相关函数:

    原创文章,作者:,如若转载,请注明出处:https://ce.771633.xyz/1517.html

  • Like (0)
    Previous 2025年3月8日
    Next 2025年3月8日

    相关推荐

    发表回复

    您的邮箱地址不会被公开。 必填项已用 * 标注