BootstrapツリーメニュープラグインTreeView.jsの使い方を詳しく解説

jQuery マルチレベル リスト ツリー プラグインは Twitter Bootstrap に基づいており、ビュー ツリー、リスト ツリーなどのいくつかの継承ツリー構造をシンプルかつエレガントな方法で表示します。

Bootstrap Tree View は実用的な Bootstrap ツリー メニューの特殊効果プラグインです。Bootstrap で作成された多くのページではこの機能が必要です。上記のように、色、背景色、アイコン、リンクなどの多くのパラメーターのカスタマイズ機能がサポートされています。

レンダリング:

特定の使用法:

プラグインの依存関係

Bootstrap v3.0.3
jQuery v2.0.3

上記の 2 つの外部依存関係ファイルはテストされており、正常に使用できます。ブートストラップのバージョンは個別にテストする必要があります。このプラグインはブートストラップ 2 をサポートしていません。

使い方

まず、依存関係ファイルとbootstrap-treeview.jsファイルをページに導入します。

<!-- Required Stylesheets -->
<link href="./css/bootstrap.css" rel="stylesheet">
  
<!-- Required Javascript -->
<script src="./js/jquery.js"></script>
<script src="./js/bootstrap-treeview.js"></script>

HTML 構造

任意の HTML DOM 要素をリスト ツリーのコンテナとして使用できます:

呼び出しメソッドは次のとおりです:

function getTree() {
 // Some logic to retrieve, or generate tree structure
 return data;
}
  
$('#tree').treeview({data: getTree()});

データ構造

ツリーの継承構造を作成するには、リストツリープラグインに入れ子構造のjsオブジェクトを提供する必要があります。例:

var tree = [
 {
 text: "Parent 1",
 nodes: [
  {
  text: "Child 1",
  nodes: [
   {
   text: "Grandchild 1"
   },
   {
   text: "Grandchild 2"
   }
  ]
  },
  {
  text: "Child 2"
  }
 ]
 },
 {
 text: "Parent 2"
 },
 {
 text: "Parent 3"
 },
 {
 text: "Parent 4"
 },
 {
 text: "Parent 5"
 }
];

最も単純なツリー構造にはノードが 1 つだけあり、テキスト属性を持つ js オブジェクトを使用して実装できます。

{
 text: "Node 1"
}

さらにコンテンツをカスタマイズする必要がある場合は、以下参照:

{
 text: "Node 1",
 icon: "glyphicon glyphicon-stop",
 selectedIcon: "glyphicon glyphicon-stop",
 color: "#000000",
 backColor: "#FFFFFF",
 href: "#node-1",
 selectable: true,
 state: {
 checked: true,
 disabled: true,
 expanded: true,
 selected: true
 },
 tags: ['available'],
 nodes: [
 {},
 ...
 ]
}

グローバルパラメータ

パラメータは、ツリービューのデフォルトの外観と動作をカスタマイズできます。このパラメーターは、プラグインの初期化時に渡されるオブジェクトを使用します。

// Example: initializing the treeview
// expanded to 5 levels
// with a background color of green
$('#tree').treeview({
 data: data,   // data is not optional
 levels: 5,
 backColor: 'green'
});

使用可能なメソッド

メソッドは 2 つの方法で呼び出すことができます:

1. プラグイン ラッパー: プラグイン ラッパー基になるメソッド エージェントにアクセスするために使用できます。
$('#tree').treeview('methodName', args)

複数のパラメータは配列オブジェクトを使用して渡す必要があります。

2. ツリービューを直接使用する: 次の 2 つの方法のいずれかを使用して、ツリービュー オブジェクトのインスタンスを取得できます。
りー