※この翻訳ドキュメントはスクリプトによって出力・同期されています。内容が怪しそうな場合はGitHubにissueを追加したり英語の原文の確認をお願いします。

variable_name_suffix の引数設定

このページではvariable_name_suffixの引数設定について説明します。

引数の概要

variable_name_suffix引数は出力されるJavaScriptの変数名のサフィックスを変更します。

この設定は出力されたJavaScriptに対してデバッグを行う際などに便利なことがあります。

基本的な使い方

apyscの各クラスはvariable_name_suffix引数を持っており、その引数を使ってサフィックスを設定することができます。

以下のコード例ではmy_intというサフィックスをap.Intクラスのインスタンスへと設定しています:

import apysc as ap

ap.Stage(stage_width=150, stage_height=150, stage_elem_id="stage")
int_val: ap.Int = ap.Int(10, variable_name_suffix="my_int")
ap.trace(int_val)

ap.save_overall_html(
    dest_dir_path="./variable_name_suffix_basic_usage_1/", minify=False
)

出力されたJavaScriptコード内で、ap.Intクラスが変換されて作成された変数が以下のように指定された_my_intというサフィックスを持っていることを確認できます:

  // ...
  var i_9__my_int = 10;
  console.log(i_9__my_int, "Called from: tmp.py, line number: 5");
  // ...

クラスの属性の値はそのクラスへ指定されたサフィックスの値を引き継ぎます。

例えばvariable_name_suffix引数にmy_rectangleというサフィックスを指定した場合、そのクラスの属性（例 : xやfill_colorなど）は同様にmy_rectangleというサフィックスを持つようになります:

import apysc as ap

ap.Stage(stage_width=150, stage_height=150, stage_elem_id="stage")
rectangle: ap.Rectangle = ap.Rectangle(
    x=50,
    y=50,
    width=50,
    height=50,
    fill_color=ap.Color("#0af"),
    variable_name_suffix="my_rectangle",
)

ap.save_overall_html(
    dest_dir_path="./variable_name_suffix_basic_usage_2/", minify=False
)

このようなケースではxやwidthなどの属性の識別用のサフィックスも同様に設定されます:

  var i_9__my_rectangle__x = 50;
  var i_10__my_rectangle__y = 50;
  var i_12__my_rectangle__width = 50;
  // ...
  var rect_1__my_rectangle = stage
    .rect(i_16__my_rectangle__width, i_17__my_rectangle__height)
    .attr({
      fill: s_1__my_rectangle__fill_color,
      "fill-opacity": n_2__my_rectangle__fill_alpha,
      "stroke-width": i_15__my_rectangle__line_thickness,
      "stroke-opacity": n_3__my_rectangle__line_alpha,
      x: i_9__my_rectangle__x,
      y: i_10__my_rectangle__y,
    });
  // ...