プロパティとは？

ezbloxのプロパティは、ミニプラグインの設定項目です。
プロパティを用意することで、表示内容や処理内容をアプリに合わせて変更できます。

💡 ヒント：［現在時刻入力］ミニプラグインの場合

・ボタンの表示テキスト
・時刻を入力するフィールド

などをプロパティとして用意しておくことで、利用者がアプリに合わせて設定できます。

プロパティ定義の例

実際にプロパティを定義する例を紹介します。

［テキスト生成 by ChatGPT］ミニプラグインのプロパティ定義

下記のプロパティ定義は［テキスト生成 by ChatGPT］ミニプラグインのものです。
生成AIの実行に必要な項目が定義されています。

例えば、ChatGPTのAPI認証に必要な［APIキー］を［暗号化文字列］として定義したり、指示を出すための［プロンプト］を［文字列（複数行）］として定義したりなど、このミニプラグインを利用してもらう上で、汎用的に扱う必要がある項目を定義しています。

💡 ヒント

プロパティには様々な種類が存在していて、用途に合わせて柔軟に定義できます。
プロパティについて詳しく知りたい場合は ezbloxで利用可能なプロパティの一覧 を確認してください。

［テキスト生成 by ChatGPT］ミニプラグインの利用例

［テキスト生成 by ChatGPT］ミニプラグインを利用する場合は、下記のように表示されます。

［APIキー］や［プロンプト］がプロパティ定義通りに、表示されていることが分かります。

プロパティの作り方とブロックとの接続

プロパティの作り方

プロパティ定義はミニプラグイン編集で行います。
プロパティを［追加する］ことで自由に定義できます。

ブロックとの接続

定義されたプロパティをプログラムから利用するにはブロックで呼び出す必要があります。

💡 ヒント

ブロックの基本的な扱い方を知りたい場合は ミニプラグインを１から作ってみる のスタートガイドを体験してみてください。

プロパティを横並びに表示したい時

プロパティを横並びに表示するには、［行グループ］プロパティを利用します。
プロパティ定義時に、横並びに表示したいプロパティを［行グループ］プロパティに含めます。

❗️ 注意

［行グループ］プロパティに次のプロパティを含めることはできません。
・［行グループ］プロパティ
・［繰り返し］プロパティ

同じ内容のプロパティを複数設定したい時

同じ内容のプロパティを複数設定するには、［繰り返し］プロパティを利用します。
プロパティ定義時に、複数設定したいプロパティを［繰り返し］プロパティに含めます。

❗️ 注意

［繰り返し］プロパティに次のプロパティを含めることはできません。
・［繰り返し］プロパティ