Laravel 5 中基于 jQuery 实现分层级的类目树结构方法

今天，我要来分享下如何在Laravel 5中通过jQuery实现动态类目树结构：有些时候我们确实需要为类目及其子类目生成树结构以便于使用。

在本教程中，我只是简单在Laravel应用中创建一个“categories”表并通过一个嵌套的树结构来管理父类目和子类目。我使用jQuery来生成树视图布局，使用类目模型为层级数据设置关联关系，还为在类目树中创建新类目添加了表单。

在正式开始之前，先贴上最终效果图：

laravel-category-tree-view

下面正式开始开发之路。

第一步：安装Laravel 5.3应用

如果你还没有安装Laravel 5.3的话，那么第一步肯定是安装它。我们使用Composer进行安装：

composer create-project --prefer-dist laravel/laravel blog

如果没有Homestead之类的开发环境的话，需要在.env文件中配置数据库连接信息。

第二步：创建类目表和模型

在这一步中我们使用Laravel提供的Artisan命令为类目表生成迁移文件：

php artisan make:migration create_category_table

运行完该命令之后你会发现在database/migrations目录下新生成了一个迁移文件，编辑该文件代码如下：

use IlluminateSupportFacadesSchema;
use IlluminateDatabaseSchemaBlueprint;
use IlluminateDatabaseMigrationsMigration;

class CreateCategoryTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('categories', function (Blueprint $table) {
            $table->increments('id');
            $table->string('title');
            $table->integer('parent_id');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::drop("categories");
    }
}

然后我们运行如下命令生成该表：

php artisan migrate

创建完数据表之后还需要创建一个与该数据表相对应的模型类app/Category.php：

namespace App;

use IlluminateDatabaseEloquentModel;

class Category extends Model
{

    public $fillable = ['title','parent_id'];

    /**
     * Get the index name for the model.
     *
     * @return string
     */
    public function childs() {
        return $this->hasMany('AppCategory','parent_id','id') ;
    }
}

第三步：创建路由

在这一步中我们需要创建两个路由，一个用于渲染类目树视图，一个用于添加新的类目。打开routes/web.php文件，添加如下两个路由：

Route::get('category-tree-view',['uses'=>'CategoryController@manageCategory']);
Route::post('add-category',['as'=>'add.category','uses'=>'CategoryController@addCategory']);

第四步：创建控制器

到了这里，我们需要创建路由中定义的控制器app/Http/Controllers/CategoryController.php，编写该文件代码如下：

namespace AppHttpControllers;

use IlluminateHttpRequest;
use AppHttpRequests;
use AppCategory;

class CategoryController extends Controller
{
    /**
     * Show the application dashboard.
     *
     * @return IlluminateHttpResponse
     */
    public function manageCategory()
    {
        $categories = Category::where('parent_id', '=', 0)->get();
        $allCategories = Category::pluck('title','id')->all();
        return view('categoryTreeview',compact('categories','allCategories'));
    }

    /**
     * Show the application dashboard.
     *
     * @return IlluminateHttpResponse
     */
    public function addCategory(Request $request)
    {
        $this->validate($request, [
            'title' => 'required',
        ]);
        $input = $request->all();
        $input['parent_id'] = empty($input['parent_id']) ? 0 : $input['parent_id'];

        Category::create($input);

        return back()->with('success', 'New Category added successfully.');
    }

}

第五步：创建视图

在这一步中，我们来创建两个Blade视图文件。首先是resources/views/categoryTreeview.blade.php：

   
       
        css/font-awesome.min.css" />
       
       
       
   
   
       

然后是resources/views/manageChild.blade.php：

    @foreach($childs as $child)
   
• 
          {{ $child->title }}
          @if(count($child->childs))
              @include('manageChild',['childs' => $child->childs])
          @endif
     

    @endforeach

第六步：添加CSS和JS文件

最后一步，我们来添加视图文件所需要的CSS和JS文件。

public/css/treeview.css：

.tree, .tree ul {
    margin:0;
    padding:0;
    list-style:none
}
.tree ul {
    margin-left:1em;
    position:relative
}
.tree ul ul {
    margin-left:.5em
}
.tree ul:before {
    content:"";
    display:block;
    width:0;
    position:absolute;
    top:0;
    bottom:0;
    left:0;
    border-left:1px solid
}
.tree li {
    margin:0;
    padding:0 1em;
    line-height:2em;
    color:#369;
    font-weight:700;
    position:relative
}
.tree ul li:before {
    content:"";
    display:block;
   
    height:0;
    border-top:1px solid;
    margin-top:-1px;
    position:absolute;
    top:1em;
    left:0
}
.tree ul li:last-child:before {
    background:#fff;
    height:auto;
    top:1em;
    bottom:0
}
.indicator {
    margin-right:5px;
}
.tree li a {
    text-decoration: none;
    color:#369;
}
.tree li button, .tree li button:active, .tree li button:focus {
    text-decoration: none;
    color:#369;
    border:none;
    background:transparent;
    margin:0px 0px 0px 0px;
    padding:0px 0px 0px 0px;
    outline: 0;
}
public/js/treeview.js：

$.fn.extend({
    treed: function (o) {

        var openedClass = 'glyphicon-minus-sign';
        var closedClass = 'glyphicon-plus-sign';

        if (typeof o != 'undefined'){
            if (typeof o.openedClass != 'undefined'){
                openedClass = o.openedClass;
            }
            if (typeof o.closedClass != 'undefined'){
                closedClass = o.closedClass;
            }
        };

        /* initialize each of the top levels */
        var tree = $(this);
        tree.addClass("tree");
        tree.find('li').has("ul").each(function () {
            var branch = $(this);
            branch.prepend("");
            branch.addClass('branch');
            branch.on('click', function (e) {
                if (this == e.target) {
                    var icon = $(this).children('i:first');
                    icon.toggleClass(openedClass + " " + closedClass);
                    $(this).children().children().toggle();
                }
            })
            branch.children().children().toggle();
        });

        /* fire event from the dynamically added icon */
        tree.find('.branch .indicator').each(function(){
            $(this).on('click', function () {
                $(this).closest('li').click();
            });
        });

        /* fire event to open branch if the li contains an anchor instead of text */
        tree.find('.branch>a').each(function () {
            $(this).on('click', function (e) {
                $(this).closest('li').click();
                e.preventDefault();
            });
        });

        /* fire event to open branch if the li contains a button instead of text */
        tree.find('.branch>button').each(function () {
            $(this).on('click', function (e) {
                $(this).closest('li').click();
                e.preventDefault();
            });
        });
    }
});

/* 初始化树状图 */
$('#tree1').treed();

好了，至此所有代码已经编写完成，你可以在浏览器中查看效果了。