tp5框架前台无限极导航菜单类实现方法分析

$frontNav = new FrontNav('category', '', 'pid', array(
'sortField' =  'sort',
'sortOrder' =  'asc'
), array(
array(
'linkUrl' =  'index/artlist/index',
'catName' =  'name',
'catDesc' =  'desc'
),
array(
'linkUrl' =  'index/artlist/index',
'catName' =  'name',
'catDesc' =  'desc'
)
));

$navHtml = $frontNav- createNavHtml('<li <a class="navi_home" href="/" rel="external nofollow" rel="external nofollow"  首页</a </li ', array(
'<ul id="jsddm" class="topNav" ',
'<li <a href="linkUrl" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" title="catDesc" catName</a ',
'</li ',
'</ul '
), array(
'<ul class="twoLevel" ',
'<li <a href="linkUrl" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" title="catDesc" catName</a ',
'</li ',
'</ul '
), '');

$this- assign(array(
'navHtml' =  $navHtml
));

<div id="navi" 
{$navHtml}
</div 

<?php
/**
* Created by PhpStorm.
* User: Chao Chao
* Date: 2017/9/23
* Time: 10:18
* versions: 1.0.0
* url: null
* email: 2776332953@qq.com
* phone: ***
*/
namespace app\index\controller;
use think\Db;    // 引用 Db (数据库链接) 类
use think\Url;   // 引用 Url ( 创建 url) 类
use think\Loader;  // 引用 Loader ( 加载 ) 类
class FrontNav {
// 数据库实例
protected $db;
// 无限极字段名称
protected $pidName = '';
// 排序设置
protected $sort = array();
// 一级导航html模版
protected $levelOne = array();
// 二级导航html模版
protected $levelTwo = array();
// n级导航html模版
protected $levelN = array();
// nav html
protected $navHtml = '';
// 替换关键词
protected $replaceKeywords = array();
/**
* FrontNav constructor.  构造方法用于生成数据实例与配置参数
* @param string $name 数据表名称或模型名称
* @param string $modelPath 模型所在路径，默认为 admin/model （admin模块下的model目录）
* @param string $pidName 无限极分类的字段（如：pid 或 parentid 等）
* @param string $sort 要排序的字段名称
* @param array $replaceKeywords 定义的替换关键词
*/
public function __construct($name, $modelPath, $pidName, $sort, $replaceKeywords) {
// $name 为必填参数
if (empty($name) || !is_string($name)) {
throw new \think\Exception('参数错误 $name（表名称或模型名称），实例化时该参数必须为字符串类型且不能为空！');
}
// 模型优先考虑 如果 模型类先存在 就返回 模型实例，否则返回 Db 类实例。
// 防止大小写错误，先都转换成小写在将第一个字母大写 如：Category，因为 linux 区分大小写
$fileName = ucwords(strtolower($name));
// 一般栏目的模型都在后台，所以这里就写死了地址 '/admin/model/'，也可以传参制定位置
$modelPath = !empty($modelPath) ? strtolower($modelPath) : 'admin/model';
if (class_exists('app\\' . str_replace('/', '\\', $modelPath) . '\\' . $fileName)) {
$this- db = Loader::model($fileName, 'model', false, 'admin');
} else {
// 不确定在 linux 下数据库名称是否区分大小写，所以都转换成小写。
$this- db = Db::name(strtolower($fileName));
}
// 无限极父类字段不能为空
if (!empty($pidName)) {
$this- pidName = $pidName;
} else {
throw new \think\Exception('参数错误 $pidName（父栏目id），实例化时字段名称不能为空！');
}
// 替换关键词
if (empty($replaceKeywords) || !is_array($replaceKeywords)) {
throw new \think\Exception('参数错误 $replaceKeywords（替换关键词），实例化时该参数必须是而为数组类型且不能为空！');;
} else {
$this- replaceKeywords = $replaceKeywords;
}
$this- sort = $sort;
}
/**
* 控制器调用，生成导航菜单。顶层导航的样式( 参数2 $levelOneTemplate )为必填项，也就是说最基本的是一层导航，二级和多级是选填项( 参数3: $levelTwoTemplate 与 参数4 $levelNTemplate 非必填项 )
* @param string $homePageHml 首页 标签的html样式,如: <li <a class="navi_home" href="/" rel="external nofollow" rel="external nofollow"  首页</a </li 
* @param array $levelOneTemplate 必填 顶部导航的html样式,如: array(
* '<ul id="jsddm" class="topNav" ',  最外层 ul
* '<li <a href="linkUrl" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" title="catDesc" catName</a ',  li标签
* '</li ',  li 结束
* '</ul ' ul 结束
* )
* @param array $levelTwoTemplate 选填 二级菜单的html样式,如: array(
* '<ul class="twoLevel" ',  二级菜单的 ul
* '<li <a href="linkUrl" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" title="catDesc" catName</a ',  li标签
* '</li ',li 结束
* '</ul 'ul 结束
* )
* @param array $levelNTemplate 选填 多级菜单的html样式,如: array(
* '<ul class="nLevel" ',  N级菜单的 ul
* '<li <a href="linkUrl" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" rel="external nofollow" title="catDesc" catName</a ',  li标签
* '</li ',li 结束
* '</ul 'ul 结束
* @return string
*/
public function createNavHtml($homePageHml, $levelOneTemplate, $levelTwoTemplate, $levelNTemplate) {
// 第一层导航不能为空且必须是数组
if (empty($levelOneTemplate) || !is_array($levelOneTemplate)) {
throw new \think\Exception('参数错误 $levelOneTemplate（一级导航模版），该参数必须是数组类型且不能为空！');
}
$this- levelOne = $levelOneTemplate;
// 二级导航
if (!empty($levelTwoTemplate) && !is_array($levelTwoTemplate)) {
throw new \think\Exception('参数错误 $levelTwoTemplate（二级导航模版），该参数可以为空 \'\' 或 array()，否则必须是数组类型！');
}
$this- levelTwo = $levelTwoTemplate;
// N级导航
if (!empty($levelNTemplate) && !is_array($levelNTemplate)) {
throw new \think\Exception('参数错误 $levelNTemplate（N级导航模版），该参数可以为空 \'\' 或 array()，否则必须是数组类型！');
}
$this- levelN = $levelNTemplate;
$treeData = $this- getTreeData($this- getAllData(), 0);
//print_r($treeData);
$this- createHtml($treeData);
return $this- levelOne[0] . (!empty($homePageHml) ? $homePageHml : '') . $this- navHtml .
$this- levelOne[3] . "\n";
}
/**
* 获取所有数据
* @return array
*/
private function getAllData() {
if (empty($this- sort) || empty($this- sort['sortField']) || empty($this- sort['sortOrder'])) {
return collection($this- db- where(1)
- select())- toArray();
} else {
return collection($this- db- where(1)
- order($this- sort['sortField'] . ' ' . $this- sort['sortOrder'])
- select())- toArray();
}
}
/**
* 将所有数据攒成树状结构的数组
* 增加 levels （层级） children （子数组）
* @param $allData   传递过来的所有非树状结构的数组
* @param $parentId   初始化时的父栏目id
* @return array    树状结构的数组
*/
private function getTreeData($allData, $parentId) {
$tree = array();
// 层级计数
static $number = 1;
foreach ($allData as $v) {
if ($v[$this- pidName] == $parentId) {
if ($v[$this- pidName] == 0) {
$v['levels'] = 0;
} else {
$v['levels'] = $number;
++$number;
}
$v['children'] = $this- getTreeData($allData, $v['id']);
$tree[] = $v;
} else {
$number = 1;
}
}
return $tree;
}
/**
* 递归生成树状结构的html
* @param $allData array  由 createNavHtml() 方法传递过来的 树形结构 数据（数组）
* @return     string 返回（最外层ul内部的html）树状结构的html
*/
private function createHtml($allData) {
foreach ($allData as $v) {
// 顶部导航
if ($v['levels'] == 0) {
$tempStr0 = $this- levelOne[1];
foreach ($this- replaceKeywords[0] as $k1 =  $v1) {
if ($k1 == 'linkUrl') {
$tempStr0 = str_replace($k1, Url::build($v1, 'id=' . $v['id']), "\n" . $tempStr0);
} else {
$tempStr0 = str_replace($k1, $v[$v1], $tempStr0);
}
}
$this- navHtml .= $tempStr0;
if (empty($v['children'])) {
$this- navHtml .= $this- levelOne[2] . "\n";
} else if (!empty($v['children']) && !empty($this- levelTwo)) {
$this- navHtml .= "\n" . $this- levelTwo[0] . "\n";
$this- createHtml($v['children']);
$this- navHtml .= $this- levelTwo[3] . $this- levelOne[2];
}
}
//　二级菜单
if ($v['levels'] == 1) {
$tempStr2 = $this- levelTwo[1];
foreach ($this- replaceKeywords[1] as $k1 =  $v1) {
if ($k1 == 'linkUrl') {
$tempStr2 = str_replace($k1, Url::build($v1, 'id=' . $v['id']),       $tempStr2);
} else {
$tempStr2 = str_replace($k1, $v[$v1], $tempStr2);
}
}
$this- navHtml .= $tempStr2;
if (empty($v['children'])) {
$this- navHtml .= $this- levelTwo[2] . "\n";
} else if (!empty($v['children']) && !empty($this- levelN)) {
// 是否多级导航，有 children ，还必须有3级 html 模版
$this- navHtml .= "\n" . $this- levelN[0] . "\n";
$this- createHtml($v['children']);
$this- navHtml .= $this- levelN[3] . $this- levelTwo[2] . "\n";
}
}
// 多级菜单
if (!empty($this- levelN) && $v['levels']   1) {
$tempStrN = $this- levelN[1];
foreach ($this- replaceKeywords[2] as $k1 =  $v1) {
if ($k1 == 'linkUrl') {
$tempStrN = str_replace($k1, Url::build($v1, 'id=' . $v['id']), $tempStrN);
} else {
$tempStrN = str_replace($k1, $v[$v1], $tempStrN);
}
}
$this- navHtml .= $tempStrN;
if (empty($v['children'])) {
$this- navHtml .= $this- levelN[2] . "\n";
} else {
$this- navHtml .= $this- levelN[0];
$this- createHtml($v['children']);
$this- navHtml .= $this- levelN[3] . $this- levelN[2];
}
}
}
return $this- navHtml;
}
}