BotShadeコマンドビルダーコンポーネント
コンポーネントの結果変数
「ボタン」「選択メニュー」ノードの「変数名」(結果変数名 variable_name)に名前を入れておくと、操作されたときの情報がその名前のローカル変数に入ります。後続のノードから {変数名}(プライマリ値)や {変数名.プロパティ} で参照でき、分岐や次の処理に使えます。「変数名」が空欄なら結果変数は作られません。
ボタンの結果変数
結果変数名を btn にした場合の例です。
| 参照 | 内容 |
|---|---|
{btn} / {btn.label} | 押されたボタンのラベル({btn} がプライマリ値)。 |
{btn.style} | ボタンのスタイル(PRIMARY / SECONDARY / SUCCESS / DANGER / LINK)。 |
{btn.disabled} | ボタンが無効化されているかどうか。 |
{btn.user} | ボタンを押したユーザー({btn.user.mention} {btn.user.name} など)。 |
{btn.channel} | ボタンが押されたチャンネル({btn.channel.name} など)。 |
{btn.guild} | ボタンが押されたサーバー({btn.guild.name} など)。 |
選択メニューの結果変数
結果変数名を select にした場合の例です。
| 参照 | 内容 |
|---|---|
{select} / {select.value} | 選ばれた値({select} がプライマリ値)。複数選択のときは、選ばれた値がカンマ(,)区切りでつながった 1 つの文字列になります。 |
{select.user} | 選択メニューを操作したユーザー({select.user.mention} {select.user.name} など)。 |
{select.channel} | 操作されたチャンネル({select.channel.name} など)。 |
{select.guild} | 操作されたサーバー({select.guild.name} など)。 |
使い方の例
「はい」「いいえ」など複数のボタンに同じ結果変数名(例: btn)を付け、ボタンの後につないだ「比較による条件分岐」で {btn} を はい などと比較すると、押されたボタンごとに処理を振り分けられます。選択メニューも同様に {select} で振り分けられます。
注意点
{btn.user}や{select.user}は、コマンドを実行した人ではなく、そのボタン・選択メニューを操作した人を表します。- 結果変数はローカル変数で、コマンドの実行が終わると消えます。残したい場合はカスタム変数に反映してください。
次のステップ / 関連ページ
- 条件分岐 — 結果変数を使った処理の振り分け
- ノードの種類リファレンス — ボタン・選択メニューの上限と有効期限
最終更新: