フィールドタイプ
Blockstudioには、ブロックインターフェースを構築するためのさまざまなフィールドタイプが用意されています。
プロジェクトで独自の名前空間付きフィールドタイプをblockstudio/field_typesに登録することもできます。新しいエディターコントロールや構造化された値の形式が必要な場合に使います。既存フィールドのグループを再利用するだけなら、custom/{name}フィールドを使います。
条件付きグループ、スマートセレクト、リピーター、クエリ可能なストレージの実践的なレシピ。
共通プロパティ
以下の表に、共通プロパティと一般的な値のオプションを示します。defaultとfallbackは、各フィールドタイプのプロパティ表に記載されている場合にサポートされます。
| プロパティ | 型 | 説明 |
|---|---|---|
id |
string | 属性の一意の識別子 |
type |
string | フィールドタイプ |
label |
string | エディターに表示されるラベル |
description |
string | フィールドの下に表示される説明文 |
default |
mixed | フィールドのデフォルト値 |
fallback |
mixed | フィールドが空の場合のフォールバック値 |
help |
string | ラベルの横にツールチップとして表示されるヘルプテキスト |
hidden |
boolean | UIからフィールドを非表示にする |
switch |
boolean | フィールドを無効化できる切り替えを表示します。デフォルトはfalseです。 |
translate |
boolean | フィールドを設定WPMLから除外するにはfalseに設定します |
conditions |
array | 条件付きロジックのルール |
"returnFormat": "id"を持つファイルフィールドは、リピーター内の単一の値を含め、インポートされた文字列参照を保持します。解決できない名前はサムネイルのないフォールバックカードとして表示されます。Blockstudioはこれらを添付ファイルIDに変換しません。詳しくは移植可能なメディア参照をご覧ください。
ピッカーのリクエスト、再試行、アイコンのサブセットについては、アイコンの読み込みをご覧ください。
属性
データ属性の入力欄を表示します。
{
"type": "attributes"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
array |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
array |
フィールドの値が空の場合に表示するフォールバック値。 |
link |
boolean |
ドロップダウンからリンクを選択できるようにします。 |
media |
boolean |
ドロップダウンからメディアを選択できるようにします。 |
ブロック
別のBlockstudioブロックを参照し、そのフィールドをインラインで展開します。テンプレートでは、値としてレンダリングされたブロックの出力を返します。
{
"type": "block"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
block |
string |
参照するブロックの名前(e.g、"mytheme/card")。 |
returnFormat |
string |
テンプレートで値を返す方法。 |
チェックボックス
チェックボックス入力のセットをレンダリングします。
{
"type": "checkbox",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
array | string | number |
ブロックを初めて追加するときに適用するデフォルト値。 |
fallback |
array | string | number |
フィールド値が空のときに表示されるフォールバック値。 |
options |
array |
選択可能なオプション。 |
returnFormat |
string |
戻り値の形式を指定します。 |
populate |
object |
|
toggle |
boolean | string |
すべてのオプションを選択または解除するチェックボックスを、オプションの上に追加します。文字列を指定するとその文字列がラベルになり、trueを指定するとデフォルトのラベルが使われます。 |
クラス
CSSクラスを選択するフィールドをレンダリングします。
{
"type": "classes"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
string |
フィールドの値が空の場合に表示するフォールバック値。 |
tailwind |
boolean |
この入力フィールドでTailwindクラスを有効にするかどうか。 |
コード
コードエディターをレンダリングします。
{
"type": "code"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加したときに適用される初期値。 |
fallback |
string |
フィールドの値が空の場合に表示されるフォールバック値。 |
autoCompletion |
boolean |
オートコンプリートを有効にするかどうか。 |
foldGutter |
boolean |
折りたたみ用ガターを表示するかどうか。 |
height |
string |
エディターの高さ。 |
language |
string |
構文ハイライトに使用する言語。 |
lineNumbers |
boolean |
行番号を表示するかどうか。 |
maxHeight |
string |
エディターの最大高さ。 |
minHeight |
string |
エディターの最小高さ。 |
popout |
boolean |
エディターをポップアップウィンドウで開くボタンを表示するかどうか。 |
asset |
boolean |
フィールドのCSS、SCSS、またはJavaScriptをブロックアセットとして出力するため、テンプレートでスタイルタグやスクリプトタグを出力する必要がありません。 |
色
カラーパレットとカラーピッカーをレンダリングします。
{
"type": "color",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加したときに選択されるオプションの値。 |
fallback |
string |
フィールドの値が空の場合に表示されるオプションの値。 |
options |
array |
|
populate |
object |
|
clearable |
boolean |
パレットにクリアボタンを表示するかどうか。 |
disableCustomColors |
boolean |
カスタムカラーを許可するかどうか。 |
日付
日付ピッカーをレンダリングします。
{
"type": "date"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
string |
フィールドの値が空の場合に表示するフォールバック値。 |
startOfWeek |
number |
週の開始曜日。0は日曜日、1は月曜日などを示します。 |
日時
日付と時刻のピッカーをレンダリングします。
{
"type": "datetime"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
string |
フィールドの値が空の場合に表示するフォールバック値。 |
is12Hour |
boolean |
12時間制を使用するかどうか。12時間制では午前/午後のウィジェットが表示され、時刻形式はデフォルトのDD-MM-YYYYではなくMM-DD-YYYYとして扱われます。 |
ファイル
メディアライブラリを開くボタンをレンダリングします。選択した項目はインラインで並べ替えられます。
{
"type": "files",
"min": 0,
"max": 100,
"multiple": false
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
array | object | number |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
array | object | number |
フィールドの値が空の場合に表示するフォールバック値。 |
addToGallery |
boolean |
trueの場合、ギャラリーのメディアモーダルはメディアライブラリを直接開き、追加の画像を追加できます。falseの場合、既存画像の並べ替え、削除、属性変更ができる編集モードで開きます。gallery === trueの場合にのみ適用されます。 |
allowedTypes |
array | string |
メディアライブラリからアップロード/選択できるメディアの種類の配列。各種類は、一般的なMIMEタイプe.g(’image’、’audio’、’text’など)または完全なMIMEタイプe.g(’audio/mpeg’、’image/gif’など)を含む文字列です。allowedTypesが未設定の場合、すべてのMIMEタイプが許可されます。 |
gallery |
boolean |
trueの場合、ギャラリーを表示するために必要なすべての状態をコンポーネントで初期化します。デフォルトではメディアモーダルはギャラリー編集フレームで開きますが、addToGalleryflagを使って変更できます。 |
max |
number |
追加できるファイルの最大数。 |
min |
number |
追加できるファイルの最小数。 |
multiple |
boolean |
複数選択を許可するかどうか。 |
size |
boolean |
フィールドにメディアサイズのドロップダウンを追加します。 |
textMediaButton |
string |
メディアボタンのテキスト。 |
title |
string |
メディアモーダルに表示するタイトル。 |
returnFormat |
string |
返却値の形式を指定します。 |
returnSize |
string |
URLの返却形式を使用するときに返すメディアサイズ。 |
グラデーション
グラデーションパレットとグラデーションピッカーをレンダリングします
{
"type": "gradient",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加したときに選択されるオプションの値。 |
fallback |
string |
フィールドの値が空の場合に表示されるオプションの値。 |
options |
array |
|
populate |
object |
|
clearable |
boolean |
パレットにクリアボタンを表示するかどうか。 |
disableCustomGradients |
boolean |
カスタムカラーを許可するかどうか。 |
グループ
複数のフィールドを、折りたたみ可能なコンテナー(任意)にレンダリングします。
{
"type": "group"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
title |
string |
タイトルのテキスト。コンポーネントを閉じているときも表示されます。 |
opened |
boolean |
trueに設定すると、initialOpenプロパティに関係なくコンポーネントは開いたままになり、 |
initialOpen |
boolean |
パネルを最初に開いた状態にするかどうか。 |
scrollAfterOpen |
boolean |
表示時にコンテンツをビュー内へスクロールします。 |
class |
string |
グループに適用するカスタムCSSクラス。 |
style |
object |
グループに適用するカスタムCSSスタイル。 |
attributes |
array |
別のtabs以外のすべてのフィールドタイプを受け付けます。 |
HTMLタグ
HTMLタグセレクターをレンダリングします。見出しレベルやセマンティック要素の選択に便利です。
{
"type": "html-tag"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
string |
フィールドの値が空の場合に表示するフォールバック値。 |
tags |
string | array |
含めるタグ。プリセット文字列またはタグ名の配列を使用します。 |
exclude |
array |
プリセットから除外するタグ。tagsにプリセット文字列を使用する場合にのみ適用されます。 |
アイコン
アイコンセットからSVGアイコンをレンダリングします。
{
"type": "icon"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
object |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
object |
フィールドの値が空の場合に表示するフォールバック値。 |
sets |
array | string |
含めるアイコンセット。空欄の場合はすべてを含めます。 |
subSets |
array | string |
含めるサブアイコンセット。空欄の場合はすべてを含めます。 |
returnFormat |
string |
アイコンの返却形式。 |
リンク
内部リンクまたは外部リンクを選択するリンクコントロールをレンダリングします。
{
"type": "link"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
object |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
object |
フィールドの値が空の場合に表示するフォールバック値。 |
hasRichPreviews |
boolean |
URLを追加するときにリッチプレビューを表示するかどうか。 |
noDirectEntry |
boolean |
URLのような検索クエリを直接リンクに変換できるかどうか。 |
noURLSuggestion |
boolean |
検索クエリをURLとして扱うフォールバック候補を追加するかどうか。 |
opensInNewTab |
boolean |
リンクモーダルに切り替えコントロールを追加します。 |
showSuggestions |
boolean |
URLの入力中に候補を表示するかどうか。 |
textButton |
string |
リンクボタン内に表示するカスタムテキスト。 |
withCreateSuggestion |
boolean |
一致するリンク検索がない場合に、新しい下書きページの候補を作成できるかどうか。 |
メッセージ
カスタムコンテンツを含むメッセージをレンダリングします。
{
"type": "message"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
string |
フィールドの値が空の場合に表示するフォールバック値。 |
value |
string |
表示するメッセージ。ブロックと属性のデータは角括弧構文で利用できます。e.g:{block.title}または{attributes.text} |
数値
数値入力をレンダリングします。
{
"type": "number",
"min": 0,
"max": 100,
"step": 1
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
number |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
number |
フィールドの値が空の場合に表示するフォールバック値。 |
dragDirection |
string |
値を増減するドラッグ軸を決定します。 |
dragThreshold |
number |
isDragEnabledがtrueの場合、値が変化するまでにドラッグするピクセル数を指定します。 |
hideHTMLArrows |
boolean |
trueの場合、デフォルトの入力HTML矢印を非表示にします。 |
isShiftStepEnabled |
boolean |
trueの場合、マウスのドラッグ操作で数値を増減できます。ドラッグ中にSHIFTを押すと、shiftStep分だけ値が増加します。 |
max |
number |
値の最大長。 |
min |
number |
値の最小長。 |
required |
boolean |
trueの場合、コントロールの最小値/最大値の範囲内で有効な数値を必須にします。falseの場合、空文字列も有効な値として許可します。 |
shiftStep |
number |
SHIFTキーを押しながら操作するときの増分。shift値はstep値に対する倍率です。たとえばstep値が5、shiftStepが10の場合、1回の操作で50ずつ増減します。 |
step |
number |
値を増減するときの変化量。また、値が有効となるにはstepの倍数(minが指定されている場合はminを基準とする)である必要があるため、検証にも使われます。特別な文字列値anyを指定すると検証制約が無効になり、操作ごとに1ずつ増減します。 |
ラジオボタン
ラジオ入力のセットをレンダリングします。
{
"type": "radio",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
]
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string | number |
ブロックを最初に追加したときに適用される初期値。 |
fallback |
string | number |
フィールドの値が空の場合に表示されるフォールバック値。 |
options |
array |
選択可能なオプション。 |
returnFormat |
string |
戻り値の形式を指定します。 |
populate |
object |
|
display |
string |
buttonGroupに設定すると、ラジオ入力の代わりにボタングループとしてオプションを表示します。 |
allowNull |
boolean |
選択済みのラジオ入力をもう一度クリックすると、値をクリアできるようにします。 |
範囲
2点間の数値を設定する範囲入力をレンダリングします。
{
"type": "range",
"min": 0,
"max": 100,
"step": 1
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
number |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
number |
フィールドの値が空の場合に表示するフォールバック値。 |
allowReset |
boolean |
trueの場合、スライダーをリセットするボタンを表示します。 |
initialPosition |
number |
値が渡されない場合に使用するスライダーの開始位置。initialPositionは指定されたminおよびmaxプロパティ値の範囲内に収まるよう調整されます。 |
isShiftStepEnabled |
boolean |
trueの場合、マウスのドラッグ操作で数値を増減できます。ドラッグ中にSHIFTを押すと、shiftStep分だけ値が増加します。 |
marks |
array |
ステップ目盛りを視覚的に表示します。Arrayでカスタムマークを指定できます。 |
max |
number |
値の最大長。 |
min |
number |
値の最小長。 |
railColor |
string |
CSSカラー文字列でレール要素の背景をカスタマイズします。 |
resetFallbackValue |
number |
リセットボタン(allowResetで有効)をクリックしたときに戻す値。 |
separatorType |
string |
コントロール行の下/上にある区切り線を無効にするか、全幅にするかを指定します。デフォルトでは、コントロールアイコンの下線を除いて下に配置されます。 |
shiftStep |
number |
SHIFTキーを押しながら操作するときの増分。shift値はstep値に対する倍率です。たとえばstep値が5、shiftStepが10の場合、1回の操作で50ずつ増減します。 |
showTooltip |
boolean |
TooltipUIを表示するか非表示にするかを強制します。stepに特別な文字列値anyが設定されている場合、falseに上書きされます。 |
step |
number |
値を増減するときの変化量。また、値が有効となるにはstepの倍数(minが指定されている場合はminを基準とする)である必要があるため、検証にも使われます。特別な文字列値anyを指定すると検証制約が無効になり、操作ごとに1ずつ増減します。 |
trackColor |
string |
CSSカラー文字列でトラック要素の背景をカスタマイズします。 |
withInputField |
boolean |
数値入力欄をRangeControlの横に表示するかどうかを指定します。stepに特別な文字列値anyが設定されている場合、falseに上書きされます。 |
選択
単一選択または複数選択に対応した選択入力をレンダリングします。
{
"type": "select",
"options": [
{
"value": "option1",
"label": "Option 1"
},
{
"value": "option2",
"label": "Option 2"
}
],
"multiple": false
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
array | string | number |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
array | string | number |
フィールドの値が空の場合に表示するフォールバック値。 |
multiple |
boolean |
trueの場合、複数の選択肢を選べます。「stylisedUi」は自動的に有効になります。 |
options |
array |
選択肢。 |
returnFormat |
string |
返却値の形式を指定します。 |
populate |
object |
|
stylisedUi |
boolean |
項目を検索できる、スタイル付きの選択コントロールをレンダリングします。 |
allowNull |
boolean | string |
空の選択肢を選べるようにします。trueの場合、ラベルは空になり、falseの場合は指定された文字列が表示されます。 |
allowReset |
boolean |
trueの場合、選択をリセットするボタンを表示します。 |
タブ
フィールドをグループ化するタブ付きインターフェースをレンダリングします。
{
"type": "tabs"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
tabs |
array |
表示するタブ。 |
テキスト
1行のテキスト入力をレンダリングします。
{
"type": "text",
"min": 0,
"max": 100
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
string |
フィールドの値が空の場合に表示するフォールバック値。 |
max |
number |
値の最大長。 |
min |
number |
値の最小長。 |
テキストエリア
テキストエリア入力をレンダリングします。
{
"type": "textarea",
"min": 0,
"max": 100,
"rows": 4
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
string |
フィールドの値が空の場合に表示するフォールバック値。 |
max |
number |
値の最大長。 |
min |
number |
値の最小長。 |
rows |
number |
テキストエリアに含める行数。 |
トグル
true/false切り替えをレンダリングします。
{
"type": "toggle"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
boolean |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
boolean |
フィールドの値が空の場合に表示するフォールバック値。 |
繰り返し
繰り返し可能なフィールドのセットを表示します。
{
"type": "repeater",
"min": 0,
"max": 100
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
array |
新しいブロックの開始時に作成される行。各行はフィールド値のオブジェクトです。minで作成される行より優先されます。 |
min |
number |
行の最小数。 |
max |
number |
行の最大数。 |
minimized |
boolean |
エディターを開いたときに既存の行を折りたたみます。エディターで追加した行は展開された状態で始まります。 |
textButton |
string |
追加ボタンのテキスト。 |
textMinimized |
string | object |
行を最小化したときに表示されるテキスト。 |
textRemove |
string | boolean |
繰り返しフィールドの行を削除するときにエディターに表示する確認メッセージ。空でない文字列を指定するとメッセージが変更され、falseを指定すると確認ダイアログなしで直ちに削除されます。省略、true、または空文字列の場合はデフォルトのメッセージが使われます。 |
attributes |
array |
別のタブ以外のすべてのフィールドタイプを受け付けます。 |
リッチテキスト
RichTextフィールド用の属性フィールドです。
{
"type": "richtext"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
string |
フィールド値が空のときに表示するフォールバック値。 |
単位
単位のドロップダウン付き数値入力を表示します。
{
"type": "unit"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加するときに適用するデフォルト値。 |
fallback |
string |
フィールド値が空のときに表示するフォールバック値。 |
disableUnits |
boolean |
trueの場合、単位選択フィールドを非表示にします。 |
isPressEnterToChange |
boolean |
trueの場合、onChangeを発生させるにはENTERキーを押す必要があります。有効にすると、フォーカスを移したときにも変更が発生します。 |
isResetValueOnUnitChange |
boolean |
trueで、選択した単位にデフォルト値がある場合、単位を変更するとその値が設定されます。 |
isUnitSelectTabbable |
boolean |
単位選択フィールドをTabキーで移動できるかどうかを指定します。 |
units |
array |
WYSIWYG
WYSIWYGエディターを表示します。
{
"type": "wysiwyg"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
default |
string |
ブロックを最初に追加したときに適用される初期値。 |
fallback |
string |
フィールドの値が空の場合に表示されるフォールバック値。 |
toolbar |
object |
エディターのツールバー設定。 |
mode |
string |
codeに設定するとフィールドをコードビューで開きます。bothに設定すると、ビジュアルビューとコードビューを切り替えるボタンが追加されます。 |
アイコンの読み込み
エディターは、ブロックを選択したときではなく、ピッカーを初めてフォーカスしたとき、またはセットやサブセットを変更したときにアイコンセットを読み込みます。同じセットを要求するフィールドは、進行中のリクエストを共有します。読み込み前も保存済みのアイコン名は表示され、読み込みに失敗した場合はピッカーに再度フォーカスすると再試行されます。
tabler-iconsはoutlineとfilledをサポートします。選択したセットに明示的に設定されたサブセットが優先されます。設定されていない場合は、利用可能であればsolidを使用し、そうでなければセットの最初のサブセットを使用します。サブセットのないセットではsubSetは省略されます。セット名はバンドルされたファイルにのみ解決されます。フロントエンドのレンダリングでは、アイコンセット全体をデータベースのtransientに保存せず、個々のアイコンをキャッシュします。
インポートされたオプション値
"multiple": trueを使用するチェックボックスとセレクトは、通常、{ "value": "...", "label": "..." }オブジェクトの配列を保存します。また、単一のオプションオブジェクト、文字列または数値のスカラー値、あるいはRESTAPIやコンテンツツールを通じてインポートされたスカラー値の配列も受け付けます。これは繰り返しフィールドの行内でも機能します。
エディターは、変更されていない状態で保存した場合、保存済みの形式を書き換えずにこれらの値を選択状態で表示します。選択を追加または削除すると、通常のオプションオブジェクトの配列が書き込まれます。数値の0と文字列の"0"は有効な選択値です。テンプレートには、エディターで選択した値と同様に、フィールドで設定されたreturnFormatが渡されます。オプションは、引き続きフィールドで宣言または入力された選択肢と一致している必要があります。
保存済みの値もデフォルト値もないネイティブの単一選択セレクトでは、最初のオプションではなく、無効状態の空のプレースホルダーが表示されます。最初のオプションを明示的に選ぶと、その値が保存されます。選択が保存されると、プレースホルダーは表示されなくなります。編集者も選択をクリアできるようにするにはallowNullを使用してください。空のプレースホルダーがあっても、それだけで必須の選択肢をクリアできるようにはなりません。
繰り返しフィールドの初期行
エディターでは、デフォルト値に、挿入前の入れ子になった最小行数も含まれます。これらを初期化するためにブロックの設定を開く必要はなく、ブロックの挿入によってそれらの行のための2つ目の取り消し手順が追加されることもありません。
リピーターにminがあり、保存済みの値も明示的なdefaultもない場合、サーバーはその数の行を、各行フィールドのデフォルト値で初期化します。これは、PHPの埋め込み、ブロックタグ、エディターで一度も開かれていないファイルベースのページソースにも適用されます。たとえば、テキストフィールドのデフォルト値が"New item"である"min": 2は、その値を含む2行を表示します。
保存済みの行と明示的なリピーターのdefaultが優先されます。明示的に保存された空のリストであるfalseやnullによって、削除済みの行が再作成されることはありません。レンダリング時に、生成されたデフォルト値が投稿に書き戻されることはありません。minとmaxはエディターの操作を制限しますが、レンダリング時に保存済みリストを切り詰めたり、値を補ったりすることはありません。インポートしたコンテンツの行数制限違反を報告するには、bs_validate_block()を使用します。
defaultを持たない行フィールドは、生成された行ではfalseになるため、そのような行にはコンテンツがありません。エディターで追加され、空のままの行も同じように表示されます。すべての行にカード、見出し、リスト項目を出力するテンプレートでは、エディター外ではコンテンツのない行をスキップし、エディター内ではフィールドを編集できる状態に保つため、行を残してください。
<?php foreach ( $a['items'] as $item ) : ?>
<?php if ( ! $isEditor && ! $item['title'] && ! $item['text'] ) continue; ?>
<div class="item">
<h3><?php echo $item['title']; ?></h3>
<p><?php echo $item['text']; ?></p>
</div>
<?php endforeach; ?>
リピーター行の削除
行を削除すると、エディターの確認ダイアログに削除ボタンとキャンセルボタンが表示されます。キャンセルまたはEscapeを選ぶと、行は変更されません。入れ子になったリピーター内も含め、確認後にのみ行が削除されます。
textRemoveはすべてのリピーターで同じ動作を制御します。
| 値 | 動作 |
|---|---|
省略、true、または"" |
デフォルトの確認メッセージを表示します。 |
| 空でない文字列 | 既存のカスタムテキスト翻訳の仕組みを使って、そのカスタムメッセージを表示します。 |
false |
ダイアログを表示せず、行をすぐに削除します。 |
たとえば、"textRemove": "Remove this team member?"は確認メッセージを変更します。
既存のmin制限により、最小数を下回る行の削除は引き続き防止されます。
リピーターの入れ子
リピーターの行では、tabsを除くすべてのフィールドタイプを使用できます。idを持たないグループ内も含め、行にtabsフィールドがあると、そのフィールドではなく通知がエディターに表示されます。PHPStan拡張機能は、block.jsonとfield.jsonでこの問題を報告します。行のフィールドはフラットに保つか、タブをリピーターの外に移動してください。
WYSIWYGリンク
WYSIWYGのリンクツールバーは、デフォルトではtargetもrelも追加せず、同じタブで開くリンクを挿入します。新しいタブで開くオプションを有効にするには、toolbar.formats.link.opensInNewTabを設定します。
{
"id": "content",
"type": "wysiwyg",
"toolbar": {
"formats": {
"link": {
"opensInNewTab": true
}
}
}
}
新しいタブで開く設定を選ぶと、target="_blank"とrel="noreferrer noopener"が追加されます。
この設定をオフにすると、それらの自動属性が削除されます。このフィールドのすべてのリンクに属性を適用するには、toolbar.formats.link.attributesを設定します。たとえば、{ "class": "content-link", "rel": "nofollow" }のようにします。明示的な設定は保持され、新しいタブで開く場合の安全性トークンは、設定済みのrelに追加されます。
URLを入力しても自動的にリンクにはなりません。また、フィールド内の既存のリンクをクリックしても、エディターから移動することはありません。既存のコンテンツに保存済みのリンク属性はそのまま残り、自動的に移行されることはありません。