ライブスクリプトへの対話型コントロールの追加

R2026b

スライダー、スピナー、ドロップダウンリスト、チェックボックス、編集フィールド、ボタン、ファイルブラウザー、カラーピッカー、および日付ピッカーをライブスクリプトに追加して、変数の値を対話的に制御できます。ライブスクリプトに対話型コントロールを追加すると、ライブスクリプトを他のユーザーと共有する場合に便利です。対話型コントロールにより、使い慣れたユーザーインターフェイスコンポーネントを使用して、ライブスクリプトにある変数の値の設定や変更を行うことができます。

コントロールの挿入

ライブスクリプトにコントロールを挿入するには、[ライブエディター] タブの [コード] セクションで [コントロール] をクリックします。次に、利用可能なオプションから選択します。既存の値をコントロールで置き換えるには、値を選択するか値の横にカーソルを置いてから、コントロールを挿入します。[コントロール] メニューには、選択した値に対して利用可能なオプションのみが表示されます。コントロールを構成するには、ライブスクリプトでそのコントロールを右クリックして [コントロールの構成] を選択します。

ライブスクリプトにコントロールが既に含まれていると、場合によっては、同様の機能をもつ別のコントロールに置き換えることができます。コントロールを別のコントロールに置き換えるには、そのコントロールを右クリックして [Control Name に置き換え] を選択します。ライブスクリプトでコントロールを選択して [ライブエディター] タブに移動し、[コントロール] をクリックして使用可能なオプションから選択することもできます。コントロールを別のコントロールに置き換えるとき、範囲や既定値などの関連する構成の値は維持されます。

次の表に、コントロールの完全なリストを示します。

コントロール説明構成の詳細

コントロール	説明	構成の詳細
ボタン	ボタンコントロールを使用して、ボタンのクリックで対話的にコードを実行します。	ボタンに表示されているテキストを変更するには、[ラベル] セクションでラベルテキストを入力します。ボタンのクリック時にどのコードを実行するかを指定するには、[実行] セクションで [実行] オプションを指定します。詳細については、コントロールの実行の変更を参照してください。
チェックボックス	チェックボックスを使用して、変数の値を logical 値 `1` (`true`) または logical 値 `0` (`false`) のいずれかに対話的に設定します。表示されているチェックボックスの状態 (オンまたはオフ) によって、現在の値が決まります。	該当なし
カラーピッカー (R2023b 以降)	カラーピッカーを使用して対話的に色を選択します。カラーピッカーに表示される色は、現在選択されている色です。	[形式] セクションで、利用可能なオプションから選択して、カラーピッカーの色の形式を指定します。有効な形式には次のものがあります。 RGB [0-1] — 範囲 `[0,1]` の値をもつ 3 要素の配列として指定した RGB 3 成分 (たとえば、`[0.4 0.6 0.7]`)。 RGB [0-255] — 範囲 `[0,255]` の値をもつ 3 要素の配列として指定した RGB 3 成分 (たとえば、`[34 89 90]`)。 16 進数 — ハッシュ記号 (`#`) で始まり、3 桁または 6 桁の `0` から `F` までの範囲の 16 進数が続く string スカラーまたは文字ベクトルとして指定された 16 進数カラーコード (たとえば、`"#c24463"`)。この値は大文字と小文字を区別しません。 HSV (色相、彩度、明度) — 3 要素の配列として指定された HSV 3 成分。最初の要素 (`H`) は `[0,360]` の範囲内で、2 番目と 3 番目の要素 (`S` と `V`) は `[0,100]` の範囲内でなければなりません (たとえば、`[345 65 76]`)。
日付ピッカー (R2024a 以降)	日付ピッカーを使用して対話的に日付を選択します。日付ピッカーに表示される日付は、現在選択されている日付です。	[形式] セクションで、利用可能なオプションから選択して、日付ピッカーの日付の形式を指定します。
ドロップダウンリスト	ドロップダウンリストを使用して項目のリストから選択することで、変数の値を対話的に変更します。ドロップダウンリストに表示されている項目にカーソルを合わせると、その値が表示されます。	[項目] 、 [項目のラベル] フィールドで、ドロップダウンリストの各項目に表示するテキストを指定します。 [項目] 、 [項目の値] フィールドで、ドロップダウンリストの各項目の値を指定します。テキストの値は必ず一重引用符または二重引用符で囲んでください。また、変数に格納された値を使用してドロップダウンリストに項目を設定できます。詳細については、コントロールの値への変数のリンクを参照してください。
編集フィールド	編集フィールドを使用して、変数の値を任意の入力値に対話的に設定します。編集フィールドに表示されるテキストと設定したデータ型によって、現在の値が決まります。	[タイプ] セクションの [データ型] フィールドで、利用可能なオプションから選択して、編集フィールドのテキストのデータ型を指定します。
ファイルブラウザー (R2023a 以降)	ファイルブラウザーを使用して、ファイル選択ダイアログボックスを開いてファイルを対話的に選択するか、フォルダー選択ダイアログボックスを開いてフォルダーを対話的に選択します。編集フィールドに表示されるテキストによって、現在の値が決まります。	[タイプ] セクションで、ファイルブラウザーを使用してファイルを選択する場合は [ファイル] を選択し、ファイルブラウザーを使用してフォルダーを選択する場合は [フォルダー] を選択します。 [ファイルの選択] ボタンの横にテキストを表示するには、[ラベル] セクションでラベルテキストを入力します。
範囲スライダー (R2024b 以降)	範囲スライダーを使用して、左右の範囲スライダーのつまみを目的の最小範囲値と最大範囲値に移動することで、範囲を対話的に選択します。範囲スライダーの左側にある値は現在の値です。	[値] セクションで、[最小値]、[最大値]、および [ステップ] の値を指定するか、ドロップダウンリストからワークスペース変数を選択します。変数を使用した範囲スライダー値の指定の詳細については、コントロールの値への変数のリンクを参照してください。
スライダー	スライダーを使用して、スライダーのつまみを目的の数値に動かすことで、変数の値を対話的に変更します。スライダーの左側にある値は現在の値です。	[値] セクションで、[最小値]、[最大値]、および [ステップ] の値を指定するか、ドロップダウンリストからワークスペース変数を選択します。変数を使用したスライダー値の指定の詳細については、コントロールの値への変数のリンクを参照してください。
スピナー	スピナーを使用して、値の右側にある上下の矢印ボタンをクリックすることで変数の値を対話的にインクリメントまたはデクリメントします。また、数値編集フィールドにスピナーの数値を入力することもできます。数値編集フィールドの値はスピナーの現在の値です。	[値] セクションで、[最小値]、[最大値]、および [ステップ] の値を指定するか、ドロップダウンリストからワークスペース変数を選択します。変数を使用したスピナー値の指定の詳細については、コントロールの値への変数のリンクを参照してください。
状態ボタン (R2023b 以降)	状態ボタンを使用して、ボタンをクリックしてオンまたはオフにすることで、logical 変数の値を対話的に設定します。表示されている状態ボタンの状態 (押された状態または押されていない状態) によって、現在の値が決まります。	状態ボタンに表示されるテキストを変更するには、[ラベル] セクションでラベルテキストを入力します。
変数セレクター (R2026b 以降)	変数セレクターを使用して、対話的にワークスペース変数を選択したり、変数の値をワークスペース変数に設定したりします。選択された変数の値が、変数セレクターの現在の値になります。	変数セレクターで特定の型の変数のみを表示するには、[項目] 、 [データ型] フィールドで、表示する変数のデータ型を選択します。たとえば、logical 変数のみを表示する場合は `[logical]` を、すべての変数を表示する場合は `[すべて]` を選択します。正規表現を使用して表示する変数の型を指定するには、`[正規表現]` を選択し、その下のテキストフィールドに正規表現を指定します。

ボタン

Sample of a button

ボタンコントロールを使用して、ボタンのクリックで対話的にコードを実行します。

ボタンに表示されているテキストを変更するには、[ラベル] セクションでラベルテキストを入力します。

ボタンのクリック時にどのコードを実行するかを指定するには、[実行] セクションで [実行] オプションを指定します。詳細については、コントロールの実行の変更を参照してください。

チェックボックス

Sample of a check box

チェックボックスを使用して、変数の値を logical 値 1 (true) または logical 値 0 (false) のいずれかに対話的に設定します。

表示されているチェックボックスの状態 (オンまたはオフ) によって、現在の値が決まります。

該当なし

カラーピッカー (R2023b 以降)

Sample of a color picker

カラーピッカーを使用して対話的に色を選択します。

カラーピッカーに表示される色は、現在選択されている色です。

[形式] セクションで、利用可能なオプションから選択して、カラーピッカーの色の形式を指定します。有効な形式には次のものがあります。

RGB [0-1] — 範囲 [0,1] の値をもつ 3 要素の配列として指定した RGB 3 成分 (たとえば、[0.4 0.6 0.7])。
RGB [0-255] — 範囲 [0,255] の値をもつ 3 要素の配列として指定した RGB 3 成分 (たとえば、[34 89 90])。
16 進数 — ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く string スカラーまたは文字ベクトルとして指定された 16 進数カラーコード (たとえば、"#c24463")。この値は大文字と小文字を区別しません。
HSV (色相、彩度、明度) — 3 要素の配列として指定された HSV 3 成分。最初の要素 (H) は [0,360] の範囲内で、2 番目と 3 番目の要素 (S と V) は [0,100] の範囲内でなければなりません (たとえば、[345 65 76])。

日付ピッカー (R2024a 以降)

Sample of a date picker

日付ピッカーを使用して対話的に日付を選択します。

日付ピッカーに表示される日付は、現在選択されている日付です。

[形式] セクションで、利用可能なオプションから選択して、日付ピッカーの日付の形式を指定します。

ドロップダウンリスト

Sample of a drop-down list

ドロップダウンリストを使用して項目のリストから選択することで、変数の値を対話的に変更します。

ドロップダウンリストに表示されている項目にカーソルを合わせると、その値が表示されます。

[項目] 、 [項目のラベル] フィールドで、ドロップダウンリストの各項目に表示するテキストを指定します。

[項目] 、 [項目の値] フィールドで、ドロップダウンリストの各項目の値を指定します。テキストの値は必ず一重引用符または二重引用符で囲んでください。

また、変数に格納された値を使用してドロップダウンリストに項目を設定できます。詳細については、コントロールの値への変数のリンクを参照してください。

編集フィールド

Sample of an edit field

編集フィールドを使用して、変数の値を任意の入力値に対話的に設定します。

編集フィールドに表示されるテキストと設定したデータ型によって、現在の値が決まります。

[タイプ] セクションの [データ型] フィールドで、利用可能なオプションから選択して、編集フィールドのテキストのデータ型を指定します。

ファイルブラウザー (R2023a 以降)

Sample of a file browser

ファイルブラウザーを使用して、ファイル選択ダイアログボックスを開いてファイルを対話的に選択するか、フォルダー選択ダイアログボックスを開いてフォルダーを対話的に選択します。

編集フィールドに表示されるテキストによって、現在の値が決まります。

[タイプ] セクションで、ファイルブラウザーを使用してファイルを選択する場合は [ファイル] を選択し、ファイルブラウザーを使用してフォルダーを選択する場合は [フォルダー] を選択します。

[ファイルの選択] ボタンの横にテキストを表示するには、[ラベル] セクションでラベルテキストを入力します。

範囲スライダー (R2024b 以降)

Sample of a range slider

範囲スライダーを使用して、左右の範囲スライダーのつまみを目的の最小範囲値と最大範囲値に移動することで、範囲を対話的に選択します。

範囲スライダーの左側にある値は現在の値です。

[値] セクションで、[最小値]、[最大値]、および [ステップ] の値を指定するか、ドロップダウンリストからワークスペース変数を選択します。

変数を使用した範囲スライダー値の指定の詳細については、コントロールの値への変数のリンクを参照してください。

スライダー

Sample of a slider

スライダーを使用して、スライダーのつまみを目的の数値に動かすことで、変数の値を対話的に変更します。

スライダーの左側にある値は現在の値です。

変数を使用したスライダー値の指定の詳細については、コントロールの値への変数のリンクを参照してください。

スピナー

Sample of a spinner

スピナーを使用して、値の右側にある上下の矢印ボタンをクリックすることで変数の値を対話的にインクリメントまたはデクリメントします。また、数値編集フィールドにスピナーの数値を入力することもできます。

数値編集フィールドの値はスピナーの現在の値です。

変数を使用したスピナー値の指定の詳細については、コントロールの値への変数のリンクを参照してください。

状態ボタン (R2023b 以降)

Sample of a state button

状態ボタンを使用して、ボタンをクリックしてオンまたはオフにすることで、logical 変数の値を対話的に設定します。

表示されている状態ボタンの状態 (押された状態または押されていない状態) によって、現在の値が決まります。

状態ボタンに表示されるテキストを変更するには、[ラベル] セクションでラベルテキストを入力します。

変数セレクター (R2026b 以降)

Sample of a variable selector

変数セレクターを使用して、対話的にワークスペース変数を選択したり、変数の値をワークスペース変数に設定したりします。

選択された変数の値が、変数セレクターの現在の値になります。

変数セレクターで特定の型の変数のみを表示するには、[項目] 、 [データ型] フィールドで、表示する変数のデータ型を選択します。たとえば、logical 変数のみを表示する場合は [logical] を、すべての変数を表示する場合は [すべて] を選択します。

正規表現を使用して表示する変数の型を指定するには、[正規表現] を選択し、その下のテキストフィールドに正規表現を指定します。

コントロールのラベルの変更

ライブスクリプトでコードを非表示にし、書式設定済みテキスト、ラベル付きのコントロール、タスク、および出力のみを表示できます。ライブスクリプトの共有やエクスポートに際しては、コードを非表示にすると便利です。コードを非表示にするには、ライブスクリプトの右にある [コードを非表示] ボタンをクリックします。[ビュー] タブの [ビュー] セクションでも [コードを非表示] をクリックできます。コードを再度表示するには、[インラインで出力] ボタンまたは [右側に出力] ボタンをクリックします。

コードを非表示にすると、コントロールの横にラベルが表示されます。コントロールのラベルを変更するには、コントロールを右クリックして [コントロールの構成] を選択します。次に、[ラベル] セクションで、ラベルテキストを入力します。ラベルテキストは、すべてのビューのボタンコントロールに表示されるテキストでもあります。Tab キーまたは Enter キーを押すか、コントロールの構成メニューの外側をクリックしてライブスクリプトに戻ります。

既定値の指定

スライダー、スピナー、ドロップダウンリスト、チェックボックス、編集フィールド、状態ボタン、カラーピッカー、日付ピッカー、変数セレクターなど、一部のコントロールの既定値を設定できます。

コントロールの既定値を設定するには、コントロールを右クリックして [コントロールの構成] を選択します。次に、[既定] セクションで、値を入力するかリストからワークスペース変数を選択して既定値を指定します。リストには、コントロールに有効な変数のみが表示されます。ドロップダウンリストおよび変数セレクターの場合は、項目のリストから既定値を選択します。

コントロールの既定値に戻すには、コントロールを右クリックして [既定値に戻す] を選択します。ライブスクリプト内のすべてのコントロールの既定値を復元するには、ライブスクリプト内の任意のコントロールを右クリックし、[すべてのコントロールを既定値に戻す] を選択します。

コントロールの値への変数のリンク

ワークスペース変数をスライダーの値、スピナーの値、およびドロップダウン項目にリンクして動的なコントロールを作成できます。また、ワークスペース変数を、スライダー、スピナー、チェックボックス、編集フィールド、および状態ボタンの既定値にリンクすることもできます。

スライダーとスピナー

ワークスペース変数を使用してスライダーまたはスピナーの最小値、最大値、およびステップ値を指定するには、コントロールを右クリックして [コントロールの構成] を選択します。[値] セクションで [変数] を選択し、[最小値]、[最大値]、および [ステップ] のワークスペース変数を選択します。数値をもつ変数のみがドロップダウンリストに表示されます。

選択する変数がリストされていない場合、ライブスクリプトを実行してワークスペースで変数を作成します。選択されている変数に対する変更はスライダーまたはスピナーに自動的に反映されます。

R2026a より前: double 型の数値をもつ変数のみがサポートされます。

Slider configuration menu with the smin, smax, sstep, and svalue variables selected

ドロップダウンリスト

ワークスペース変数に格納された値を使用してドロップダウンリストにデータを設定するには、コントロールを右クリックして [コントロールの構成] を選択します。次に、[項目] セクションで、[変数] リストからワークスペース変数を選択します。リストには、string 配列、categorical 配列、文字配列、cell 配列、または数値配列を含む変数のみが表示されます。

選択する変数がリストされていない場合、ライブスクリプトを実行してワークスペースで変数を作成します。選択されている変数に対する変更はドロップダウンリストに自動的に反映されます。

R2024b より前: string 配列のみがサポートされます。

たとえば、ライブスクリプトを作成して、姓のリストを含む変数 lastnames を定義します。

lastnames = ["Houston","Vega","Obrien","Potter","Rivera","Hanson","Fowler","Tran","Briggs"];

ライブスクリプトを実行して、ワークスペースで lastnames を作成します。次に、[ライブエディター] タブの [コード] セクションで [コントロール] 、 [ドロップダウン] を選択します。コントロールの構成メニューの [項目] セクションで、[変数] に lastnames を選択します。

Drop-down list configuration menu with the lastnames variable selected and the lists of item labels and item values populated with the variable values

構成メニューを閉じてライブスクリプトに戻ります。ドロップダウンリストには、lastnames で定義された姓が含まれます。

Drop-down list containing nine last names

lastnames の値を追加、削除、編集すると、ドロップダウンリストの項目が MATLAB^® によって更新されます。

メモ

ドロップダウンリストの項目が変数にリンクされており、その変数の 1 つ以上の値がライブスクリプトの実行中に削除されると、削除された値のいずれかが選択したリスト項目であった場合にエラーが発生する可能性があります。このエラーが発生する可能性を最小限に抑えるには、ライブスクリプトの実行中に、リンクされている変数から値を削除しないようにしてください。

既定値

ワークスペース変数を使用してスライダー、スピナー、チェックボックス、編集フィールド、または状態ボタンの既定値を指定するには、コントロールを右クリックして [コントロールの構成] を選択します。[既定] セクションで [変数] を選択し、ワークスペース変数を選択します。ドロップダウンリストには、コントロールの値として有効な値をもつ変数のみが表示されます。たとえば、スライダーやスピナーでは、数値をもつ変数のみが表示されます。編集フィールドでは、指定されたテキストデータ型に一致する値をもつ変数のみが表示されます。

コントロールの既定値をワークスペース変数に設定すると、コントロールはその変数にリンクされます。変数の値が変更されると、コントロールの値も自動的に更新されます。このリンクは、たとえばスライダーのつまみを移動するなど、コントロールの値が手動で変更されるまで有効なままです。

コントロールの実行の変更

コントロールの値が変化したときに、いつ、どのコードを実行するかを変更できます。既定では、コントロールの値が変化すると、MATLAB は現在のセクションでコードを実行します。この動作を構成するには、コントロールを右クリックして [コントロールの構成] を選択します。次に、[実行] セクションで、次の表で説明されているフィールドの値を変更します。Tab キーまたは Enter キーを押すか、コントロールの構成メニューの外側をクリックしてライブスクリプトに戻ります。

フィールドオプション

フィールド	オプション
実行タイミング (スライダーとスピナーのみ)	次のいずれかのオプションを選択して、コードを実行するタイミングを指定します。 `値の変化中` (既定値) — スライダーまたはスピナーの値の変化中にコードを実行します。 `値の変化後` — スライダーまたはスピナーの値が変化した後 (ユーザーがスライダーのつまみまたはスピナーの上下矢印ボタンを放したとき) にコードを実行します。
実行	次のいずれかのオプションを選択して、コントロールの値が変化したときにどのコードを実行するかを指定します。 `現在のセクション` (既定) — コントロールが含まれるセクションを実行します。 `現在のセクションと、上のセクションのうち変更済みまたは未実行のセクション` — 現在のセクションと、コントロールの上にある変更済みまたは未実行のコードを実行します。ライブスクリプトがまだ実行されていない場合は、コントロールの値を変更すると、現在のセクションと、それより前のすべてのセクションが実行されます。 `現在のセクションから最後まで` — コントロールが含まれるセクションとそれに続くセクションを実行します。 `すべてのセクション` — ライブスクリプト内のすべてのセクションを実行します。 `ユーザー定義コード` (ボタンコントロールのみ) — コマンドウィンドウの [実行] フィールドの下にあるテキストボックスで指定されたコードを実行します。テキストボックスは、このオプションが選択されている場合にのみ表示されます。 `なし` — コードを実行しません。ヒントライブスクリプトのボタンコントロールを使用する場合は、ライブスクリプトの他のすべてのコントロールの [実行] フィールドを `[なし]` に設定することを検討してください。そうすれば、ボタンコントロールをクリックした場合にのみコードが実行されます。これは、コードを実行する前にライブスクリプトで複数のコントロール値を設定する必要がある場合に便利です。

実行タイミング (スライダーとスピナーのみ)

次のいずれかのオプションを選択して、コードを実行するタイミングを指定します。

値の変化中 (既定値) — スライダーまたはスピナーの値の変化中にコードを実行します。
値の変化後 — スライダーまたはスピナーの値が変化した後 (ユーザーがスライダーのつまみまたはスピナーの上下矢印ボタンを放したとき) にコードを実行します。

実行

次のいずれかのオプションを選択して、コントロールの値が変化したときにどのコードを実行するかを指定します。

現在のセクション (既定) — コントロールが含まれるセクションを実行します。
現在のセクションと、上のセクションのうち変更済みまたは未実行のセクション — 現在のセクションと、コントロールの上にある変更済みまたは未実行のコードを実行します。ライブスクリプトがまだ実行されていない場合は、コントロールの値を変更すると、現在のセクションと、それより前のすべてのセクションが実行されます。
現在のセクションから最後まで — コントロールが含まれるセクションとそれに続くセクションを実行します。
すべてのセクション — ライブスクリプト内のすべてのセクションを実行します。
ユーザー定義コード (ボタンコントロールのみ) — コマンドウィンドウの [実行] フィールドの下にあるテキストボックスで指定されたコードを実行します。テキストボックスは、このオプションが選択されている場合にのみ表示されます。
なし — コードを実行しません。

ヒント

ライブスクリプトのボタンコントロールを使用する場合は、ライブスクリプトの他のすべてのコントロールの [実行] フィールドを [なし] に設定することを検討してください。そうすれば、ボタンコントロールをクリックした場合にのみコードが実行されます。これは、コードを実行する前にライブスクリプトで複数のコントロール値を設定する必要がある場合に便利です。

ライブスクリプトの共有

ライブスクリプトが完了したら、他のユーザーと共有します。ユーザーはライブスクリプトを MATLAB で開いて、コントロールを対話的に使用してライブスクリプトを体験できます。

ライブスクリプトを対話型ドキュメントとして共有している場合は、ライブスクリプトを共有する前にライブスクリプト内のコードを非表示にすることを検討してください。コードが非表示の場合、書式設定済みテキスト、ラベルの付いたコントロール、タスク、および出力のみが表示されます。ライブスクリプトのタスクがコードのみを表示してコントロールは表示しない構成になっている場合、コードを非表示にするとタスクは表示されません。コードを非表示にするには、ライブスクリプトの右にある [コードを非表示] ボタンをクリックします。[ビュー] タブの [ビュー] セクションでも [コードを非表示] をクリックできます。

ライブスクリプトを PDF ファイル、Microsoft^® Word ドキュメント、HTML ファイル、LaTeX ファイル、マークダウンファイル、または Jupyter^® Notebook として共有すると、MATLAB はコントロールをコードとして保存します。たとえば、複数の対話型コントロールをもつライブスクリプトの作成の例のライブスクリプトが ([ライブエディター] タブの [エクスポート] オプションを使用して) HTML にエクスポートされると、ファイルブラウザーコントロールがその現在の値 ("patients.xls") に置き換えられ、ドロップダウンリストコントロールがその現在の値 (locationStrings(1)) に置き換えられ、チェックボックスコントロールがその現在の値 (false) に置き換えられ、スライダーコントロールがその現在の値 (31) に置き換えられ、テキストボックスコントロールがその現在の値 ("e") に置き換えられます。[Filter Data] ボタンは表示されません。

Live script exported to HTML with the interactive controls replaced by their values at export time

参考

export

ライブ スクリプトへの対話型コントロールの追加