Function Reference/Walker Class

Walker角色

walker class压缩了用来输出html，用树结构代表WordPress的基本函数。例如，网页和类别是两种类型的objects，WordPress2.2代码使用walker class来enumuerate。虽然通过使用right fuc并且looping through them用它来显示多数操作，在母类别下安排子类别，你可以总是显示类别。walker class为你执行大多数这样的操作。

方法和属性

注意Walker class的属性通常是有扩展的class设置而且可能在一个例子中不会更改。

同时start_el, end_el, start_lvl, end_lvl的定义方法，只是列出了一个参数，但是使用call_user_func_array调用，正是列出了这些参数。

属性

$tree_type

classes在WordPress2.2版本中扩展了Walker，并且将这个设置为'类别' 或者 '网页'。这个代码没有使用这个参数值。

$db_fields

拥有keys的数组。parent 和id。这些keys的参数值应该是objects walker中的属性的名称，应该用来分别放入当前object和母object的id。

例子

class Walker_Page extends Walker {
	var $tree_type = 'page';
	var $db_fields = array ('parent' =>
                  'post_parent', 'id' => 'ID');

因此Walker_Page class（WordPress 2.2版本的一部分）期望如果page是个网页object那么 page->post_parent会给出那个网页的母网页的id而且page->ID会给出那个网页的id。

方法

walk($elements, $to_depth)

得到一组有序的元素，以便子元素在母元素和整数$to_depth下面。非零的$to_depth指出了可以嵌套的的最大的层级。如果$to_depth是 -1，array进行操作时候，就像是平的（没有子元素）。任何传递给walk的额外参数，会传递，为改变到其它的类别walk调用。

walk一个一个地通过数组$elements。每次当元素是先前元素的子元素的时候walk，调用start_lvl。每次元素作为walk调用处理的时候，调用start_el然后调用end_el。每次元素不再当前母walk的下面的时候，调用end_lvl。

start_el($output, $element, $depth, \[optional args\])

Classes extending Walker should define this function to return $output concatenated with the markup starting an element.

start_el($output, $element, $depth, \[optional args\])

Classes 扩展Walker应该定一个这个函数返回$output与开始一个元素的标记相连接。

end_el($output, $element, $depth, \[optional args\])

Classes extending Walker should define this function to return $output concatenated with the markup ending an element. Note that elements are not ended until after all of their children have been added.

end_el($output, $element, $depth, \[optional args\])

Classes extending Walker应该定义这个函数返回$output与结束元素的标记相连接。注意只有添加了这些元素的子元素之后，这些元素才会结束。

start_lvl($output, $depth, \[optional args\])

Classes extending Walker should define this function to return $output concatenated with the markup that should precede any of the child elements. For instance this often outputs a ul or ol tag.

start_lvl($output, $depth, \[optional args\])

Classes extending Walker应该定义这个函数返回$output与子元素之前标记相连接。例如，这个通常输出ul或者ol标签。

end_lvl($output, $depth, \[optional args\])

Classes extending Walker should define this function to return $output concatenated with the markup that should end any of the child elements. For instance this often ends a ul or ol tag.

end_lvl($output, $depth, \[optional args\])

Classes extending Walker应该定义这个函数返回$output，与结束任何子元素的标记相连接。例如，这个通常结束ul或者ol标签。

例子

See WordPress:Function_Reference/Walker_Page, WordPress:Function_Reference/Walker_PageDropDown, WordPress:Function_Reference/Walker_Category, WordPress:Function_Reference/Walker_CategoryDropdown

请看看 Function_Reference/Walker_Page, Function_Reference/Walker_PageDropDown, Function_Reference/Walker_Category, Function_Reference/Walker_CategoryDropdown