JSプラグインの作り方 *

# (1) なでしこのプログラム内で「取り込む」文を使う
!「xxx.js」を取り込む

<!-- (2) HTMLファイル内で<script>タグを記述する -->
<script src="xxx.js"></script>

// プラグインを表すオブジェクトを定義
const pluginHello = {
  'meta': {
    type: 'const',
    value: { // プラグインに関する情報を指定する
      pluginName: 'nadesiko3-hello', // プラグインの名前
      description: 'プラグインのひな形', // プラグインの説明
      pluginVersion: '3.6.15', // プラグインのバージョン
      nakoRuntime: ['wnako'], // 対象ランタイム
      nakoVersion: '3.6.15' // 要求なでしこバージョン
    }
  },
  // 関数を定義
  '掛算テスト': { // @掛け算をするだけのテスト関数 // @かけざんてすと
    type: 'func', // 関数であれば func にする
    josi: [['と'],['を']], // 助詞を配列で宣言する
    fn: function (a, b) {
        return a * b
    }
  }
}
// なでしこにプラグインを登録
if (typeof (navigator) === 'object') {
  navigator.nako3.addPluginObject("pluginHello", pluginHello)
} else {
  module.exports = pluginHello
}

// --- なでしこプラグインのオブジェクトを宣言 ---
const pluginObj = {
  '関数名': { 定義 },
  '定数名': { 定義 },
}
// --- なでしこ3の本体に関数を登録する ---
if (typeof (navigator) === 'object') {
  navigator.nako3.addPluginObject("プラグイン名", pluginObj)
} else {
  module.exports = pluginObj
}

<!-- HTMLファイル内で<script>タグを記述する -->
<script src="https://n3s.nadesi.com/plain/nadesiko3-hello.js"></script>

3と5を掛算テストして表示。

// ESModule方式
export default {
  '関数名': { 定義 },
  '定数名': { 定義 },
}

const pluginHello = {
  'meta': {
    type: 'const',
    value: { // プラグインに関する情報を指定する
      pluginName: 'nadesiko3-hello', // プラグインの名前
      description: 'プラグインのひな形', // プラグインの説明
      pluginVersion: '3.6.15', // プラグインのバージョン
      nakoRuntime: ['wnako'], // 対象ランタイム
      nakoVersion: '3.6.15' // 要求なでしこバージョン
    }
  },
  '掛算テスト': { // @掛け算をするだけのテスト関数 // @かけざんてすと
    type: 'func', // 関数であれば func にする
    josi: [['と'],['を']], // 助詞を配列で宣言する
    fn: function (a, b) {
        return a * b
    }
  }
}
export default pluginHello

{
  '関数名': { // @関数の説明 // @よみがな
    type: 'func', // 関数であれば func にする
    josi: [['を', 'から'], ['まで']], // 助詞を配列で宣言する (可変長引数として扱いたい助詞は末尾で宣言する)
    isVariableJosi: false, // 末尾の助詞を可変長引数として扱う場合 true にする
    uses: [], // この関数から別の関数を呼ぶ場合に記述する // (TODO: #282)
    asyncFn: false, // async関数定義かPromiseを返す関数を定義する場合 true にする (参照: #1154)
    fn: function (aFrom, aTo, sys) { ... }, // 関数の実態
    return_none: false // 戻り値を返すかどうか
  },
  ...
}

{
    '変数名': { type: 'var', value: 100 }, // @よみがな
    '定数名': { type: 'const', value: 100 }, // @よみがな
....
}

{
  '初期化': {
    type: 'func',
    josi: [],
    fn: function (sys) { ... }
  }
  ...
}

  'meta': {
    type: 'const',
    value: {
      pluginName: 'plugin_***', // プラグインの名前
      description: '説明',
      pluginVersion: '3.6.0', // プラグインのバージョン
      nakoRuntime: ['wnako', 'cnako', 'phpnako'], // 対象ランタイム
      nakoVersion: '3.6.0' // 最小要求なでしこバージョン
    }
  },

{
  '!クリア': {
    type: 'func',
    josi: [],
    fn: function (sys) { ... }
  }
  ...
}

{
  type: 'func',
  josi: [],
  fn: function (sys) {
    console.log(sys)
  }
}

// 廃止されたシステム変数へのアクセス
const value1 = sys.__v0["変数名"]
sys.__v0["変数名"] = value1
const value2 = sys.__varslist[0]["変数名"]
sys.__varslist[0][変数名] = value2

// 今後、利用可能なシステム変数へのアクセス
sys.__setSysVar("変数名", 値) ... なでしこ変数の設定
sys.__getSysVar("変数名") ... 変数の値の取得