【vue2 & G6】快速上手

封面.jpg

G6 是一個圖可視化引擎。它提供了圖的繪制、布局、分析、交互、動畫等圖可視化的基礎能力。旨在讓關系變得透明,簡單。讓用戶獲得關系數據的 Insight。

翻譯成白話: G6可以實現 拓撲圖、流程圖、腦圖 等各種奇奇怪怪的圖表的開發,并在瀏覽器呈現出來。

01.png



開發環境

  • chrome ^88.0.4324.104(正式版本)
  • vue ^2.6.11
  • g6 ^4.1.11


請認清本文所使用的開發環境。本例使用 Vue2 進行開發!!!

如果在練習中所使用到的庫或瀏覽器版本與文本不一致,可能會出現某些功能無法實現。


本文的運行環境是 chrome 瀏覽器,如果在其他瀏覽器出現兼容問題,可以留言一起探討一起解決。



學前準備

  1. 有一定的 htmlcss 基礎,本文不講解這方面的基礎知識。
  2. 有一定的 vue 2 開發經驗,本文不會講解 vue 基礎用法。
  3. 建議有 canvas 基礎(沒有也沒關系)。


本文使用 vue-cli 進行開發,所以會使用 npm 的方式安裝 G6



快速上手

快速上手 - 官方文檔


1、安裝

CDN 的方式很簡單,可以自行看文檔

本文使用 vue-cli 進行開發,所以會使用 npm 的方式安裝 G6

這里默認讀者已經使用 vue-cli 創建好一個 vue 2 的項目了。


進入創建好的 vue 項目,在終端輸入以下命令進行安裝:

$ npm install --save @antv/g6

$ 號不需要輸入, $ 號代表命令。


安裝成功后可以在 node_modules 目錄查看到:在@antv 目錄下找到 g6 目錄,證明安裝成功了。

02.png


2、代碼+注釋

根據官方文檔提示,要快速創建圖表只需5大步驟。

  1. 創建容器
  2. 引入G6
  3. 準備數據
  4. 創建關系圖
  5. 匹配數據源并渲染


以上步驟,會在代碼中以“【步驟xxx】”的注釋方式一一對應。

<template>
  <div class="page-x">
    <!-- 【步驟1】 創建容器 -->
    <div class="g6-x" id="containerG6" ref="containerG6"></div>
  </div>
</template>

<script>
// 【步驟2】 引入G6
import G6 from '@antv/g6'

export default {
  name: "Started",
  data() {
    return {
      graph: null,
      // 【步驟3】 準備數據
      graphData: {
        // 點集
        nodes: [
          {
            id: "node1", // String,該節點存在則必須,節點的唯一標識
            x: 100, // Number,可選,節點位置的 x 值
            y: 200 // Number,可選,節點位置的 y 值
          },
          {
            id: "node2", // String,該節點存在則必須,節點的唯一標識
            x: 300, // Number,可選,節點位置的 x 值
            y: 200 // Number,可選,節點位置的 y 值
          }
        ],
        // 邊集
        edges: [
          {
            source: "node1", // String,必須,起始點 id
            target: "node2" // String,必須,目標點 id
          },
        ]
      }
    }
  },
  methods: {
    // 初始化關系圖,并渲染數據
    initGraph() {
      // 【步驟4】 創建關系圖
      const containerG6  = this.$refs.containerG6 // 獲取容器(DOM元素)
      this.graph = new G6.Graph({
        container: containerG6, // String | HTMLElement,必須,在 Step 1 中創建的容器 id 或容器本身
        width: containerG6.offsetWidth, // Number,必須,圖的寬度
        height: containerG6.offsetHeight // Number,必須,圖的高度
      })

      // 【步驟5】 匹配數據源并渲染
      this.graph.data(this.graphData) // 讀取 Step 2 中的數據源到圖上
      this.graph.render() // 渲染圖
    }
  },
  mounted() {
    this.initGraph()
  }
};
</script>

<style scoped>
.g6-x {
  width: 800px;
  height: 500px;
  box-sizing: border-box;
  border: 1px solid #ccc;
  margin-left: 20px;
}
</style>

效果如下圖所示

03.png


這個案例參考了官方的起步案例


步驟3 的數據中,主要用到 nodesedges

nodes 是所有點的集合,是數據類型。每個點都需要有一個 id 屬性,且 id 是唯一的。

nodes 里的 xy 代表該點在畫布中的位置。

本例的 edges 是依賴于 nodes 的。

edges 是所有邊的集合,是數組類型。需要畫多少條邊就有多少個對象元素。

每條邊需要一個 source 和 一個 target

source 是指 起始點,值是 起始點id

target 是指 目標點,值是 目標點id


步驟4 使用 new G6.Graph 創建關系圖。

其中 containerwidthheight 是必填項。如果沒填這幾項會報錯。

container 是容器的 id 或者容器實例。本例使用 vue 2 開發,所以使用了 $refs 獲取容器實例(本例中容器實例為 containerG6)。

width 是圖的寬度,本例使用了 containerG6.offsetWidth ,讓容器的寬度作為圖的寬度。

height 是圖的高度,本例使用了 `containerG6.offsetHeight,讓容器的高度作為圖的高度。


步驟5

使用 graph.data() 來初始化圖數據。傳入的參數就是 步驟2 中準備的數據。

使用 graph.render() 方法把數據渲染出來。

graph.data() 官方文檔

graph.render() 官網文檔



3、源碼地址

本例源碼地址

這個項目里還是用了 vue-router 進行開發,但 vue-router 部分不會影響 G6 的使用。


本例所參考的文獻


延伸閱讀

G6 國內官網

G6官方快速上手文檔

本例源碼地址(歡迎Star,長期維護)

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,156評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,401評論 3 415
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,069評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,873評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,635評論 6 408
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,128評論 1 323
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,203評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,365評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,881評論 1 334
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,733評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,935評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,475評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,172評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,582評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,821評論 1 282
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,595評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,908評論 2 372

推薦閱讀更多精彩內容