Vue.js

SpreadJSでは、JavaScriptライブラリの1つであるVue.jsがサポートされます。Vue.jsは、開発者に複雑なユーザーインターフェイスおよびWebアプリケーションを構築するためにツールを提供します。

SpreadJSでは、次の2つの方法でVue.jsを使用できます。

Npmパッケージを使用してVue3とVue2を実装する

次の手順を実行します。

Vue3

Composition API を使用してアプリケーションを作成するには、次の手順を実行します。

Vueアプリを作成する
コマンドプロンプトウィンドウを開き、次のコマンドを入力します。
```
npm init vue@latest // プロジェクト名に「sjs-vue-app」を指定します
cd sjs-vue-app
```
コマンドを実行すると、ディレクトリ内の指定の場所にVue.jsプロジェクトが作成されます。Vue.jsプロジェクトの作成方法については、https://ja.vuejs.org/guide/quick-start.html を参照してください。
SpreadJS Vueモジュールをインストールする
次のコマンドを使用して、SpreadJS Vue モジュールをプロジェクトにインストールします。
```
npm install @mescius/spread-sheets@xx.x.x
npm install @mescius/spread-sheets-vue@xx.x.x
npm install @mescius/spread-sheets-resources-ja@xx.x.x
```
type=warning
'xx.x.x'の部分には製品のバージョンを指定してください。バージョンの指定を省略すると最新バージョンがインストールされますが、日本語版での動作保証は日本語版サイトで公開しているバージョンのみとなります。
Vue.jsアプリでSpreadJSを使用する
次のサンプルコードを使用して、main.jsファイルを編集します。

import { createApp } from 'vue'
import App from './App.vue'
import { GcSpreadSheets, GcWorksheet, GcColumn } from '@mescius/spread-sheets-vue';

let app = createApp(App);
app.component('gc-spread-sheets', GcSpreadSheets);
app.component('gc-worksheet', GcWorksheet);
app.component('gc-column', GcColumn);
app.mount('#app')

次のサンプルコードを使用して、App.vueファイルを編集します。

<template>
  <div>
    <gc-spread-sheets
      :hostClass="hostClass"
      @workbookInitialized="initWorkbook">
    </gc-spread-sheets>
  </div>
</template>

<script setup>
import "@mescius/spread-sheets/styles/gc.spread.sheets.excel2016colorful.css";
import * as GC from "@mescius/spread-sheets";
import "@mescius/spread-sheets-vue";
import "@mescius/spread-sheets-resources-ja";

// 日本語カルチャを設定します
GC.Spread.Common.CultureManager.culture('ja-jp');

const hostClass = "spread-host";

function initWorkbook(spread) {
  let sheet = spread.getActiveSheet();
  sheet.setValue(0, 0, "Hello");
}
</script>

<style>
.spread-host {
  width: 100%;
  height: 600px;
}
</style>

アプリケーションを保存して実行する
```
npm run dev
```

Vue2

Vue.jsプロジェクトを作成する
コマンドプロンプトウィンドウを開き、次のコマンドを入力します。
```
npm install -g @vue/cli
vue create sjs-vue-app　// ここでVue 2を選択します
cd sjs-vue-app
```
コマンドを実行すると、ディレクトリ内の指定の場所にVue.jsプロジェクトが作成されます。
Spread.Sheets Vue.jsモジュールをインストールする
Spread.Sheets Vue.jsモジュール、および日本語リソースを、npmからインストールします。
```
npm install @mescius/spread-sheets
npm install @mescius/spread-sheets-vue
npm install @mescius/spread-sheets-resources-ja
```

Vue.jsアプリでSpread.Sheetsを使用する

必要に応じてApp.vueファイルを編集します。ブラウザウィンドウを更新すると、変更が反映されます。例として、次のサンプルコードを使用します。

<template>
  <div>
      <gc-spread-sheets :hostClass='hostClass'>
        <gc-worksheet
          :dataSource="dataTable"
          :autoGenerateColumns = 'autoGenerateColumns'
        >
          <gc-column
            :width="width"
            :dataField="'price'"
            :visible = 'visible'
            :formatter = 'formatter'
            :resizable = 'resizable'
          ></gc-column>
        </gc-worksheet>
      </gc-spread-sheets>
  </div>
</template>
<script>
  import '@mescius/spread-sheets/styles/gc.spread.sheets.excel2016colorful.css'
  import '@mescius/spread-sheets-vue'
  import '@mescius/spread-sheets-resources-ja';
  import * as GC from "@mescius/spread-sheets";

  // カルチャ設定
  GC.Spread.Common.CultureManager.culture('ja-jp');

  export default {
    data(){
      return {
        hostClass:'spread-host',
        autoGenerateColumns:true,
        width:300,
        visible:true,
        resizable:true,
        formatter:"$ #.00"
      }
    },
    computed:{
      dataTable(){
        let dataTable = [];
        for (let i = 0; i < 42; i++) {
          dataTable.push({price: i + 0.56})
        }
        return dataTable
      }
    }
  }
</script>
<style scoped>
.spread-host {
    width: 500px;
    height: 600px;
}
</style>

アプリケーションを保存して実行する
```
npm run serve
```

従来のHTMLを使用してVue2を実装する

SpreadJSでは、従来のHTMLを使用してVue2を使用できます。この方法には、次の手順があります。

HTMLページを作成する
最初の手順として、HTMLページを作成します。
HTMLテンプレートにSpread.SheetsおよびVue-Spread.Sheetsを追加する
gc.spread.sheets.all...*.min.js 、 gc.SpreadJS...*.css および gc.spread.sheets.vue...*.js ファイルへの参照を、HTMLテンプレート（index.htmlファイル）に追加します。

VueアプリケーションでSpread.Sheetsを使用する

これで、Spread.SheetsをVue.jsアプリケーション内で使用できるようになりました。例として、次のサンプルコードを使用します。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Hello SpreadJS Vue</title>
    <link rel="stylesheet" href="lib/gc.spread.sheets.excel2016colorful.0.0.0.css" type="text/css"/>
    <style>
        #app{
            width: 100%;
            height:100%;
        }
        .vue-demo{
            width: 800px;
            height:400px;
            margin: 0 auto;
        }
    </style>
</head>
<body>
<div id="app">
 <app></app>
</div>
<script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.js"></script>
<script src="lib/gc.spread.sheets.all.0.0.0.js"></script>
<script src="lib/gc.spread.sheets.vue.js"></script>
<script type="text/x-template" id="app-template">
     <div>
        <gc-spread-sheets
          v-bind:hostClass='hostClass'
          @workbookInitialized='spreadInitHandle'
        >
            <gc-worksheet  >
            </gc-worksheet>
        </gc-spread-sheets>
     </div>
</script>
<script type="text/javascript">
    window.onload = function () {
        Vue.component('app', {
            template: '#app-template',
            data:function () {
                return {
                    hostClass: "vue-demo"
                }
            },
            methods: {
                spreadInitHandle: function (spread) {
                    window.mySpread = spread;
                    console.log('now you can also get spread from window');
                }
            }
        });
        new Vue({
            el:"#app",
        })
    }
</script>
</body>
</html>

<gc-spread-sheets>、<gc-worksheet>、および、<gc-column>は、タグ階層の基本要素です。他の要素は、それぞれ設定して使用します。なお、タグ階層は、以下のとおりです。

<gc-spread-sheets>
<gc-worksheet>
<gc-column></gc-column>
    ...
</gc-worksheet>
  ...
</gc-spread-sheets>

以下の各トピックでは、さまざまな要素（ディレクティブ）について説明します。