옵션 채우기
Posts, Users 또는 Terms와 같은 서로 다른 필드 유형을 제공하는 대신, Blockstudio을 사용하면 block.json에서 바로 데이터를 채우는 모듈식 방식을 사용할 수 있습니다. 이 기능은 select, radio, checkbox, color 및 gradient 필드 유형에서 작동합니다.
데이터를 채우는 방법은 네 가지입니다.
- 쿼리 – 게시물, 사용자 또는 용어 쿼리 결과 반환
- 가져오기 – 외부 소스의 결과 반환
- 함수 – 사용자 지정 함수의 결과 반환
- 사용자 지정 – 사용자 지정 데이터 세트의 결과 반환
쿼리
쿼리 모드를 선택하면 Posts, Users 또는 Terms를 채울 수 있습니다.
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/native",
"title": "Native Block",
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "query",
"query": "posts"
}
}
]
}
}
사용 가능한 쿼리 유형은 내부적으로 다음 WordPress 함수를 사용합니다.
인수
arguments 속성을 사용해 사용자 지정 인수를 전달할 수 있습니다.
{
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "jobs",
"numberposts": "20"
}
}
}
]
}
}
반환 형식
기본적으로 Blockstudio은 다음을 반환합니다.
| 쿼리 | 값 | 레이블 |
|---|---|---|
posts |
게시물 객체 | post_title |
users |
사용자 객체 | display_name |
terms |
용어 객체 | name |
returnFormat으로 응답을 사용자 지정하세요.
{
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "posts",
"numberposts": "20"
},
"returnFormat": {
"value": "id",
"label": "post_name"
}
}
}
]
}
}
가져오기 모드
fetch 옵션으로 동적 검색을 활성화하세요.
{
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "query",
"query": "posts",
"fetch": true,
"arguments": {
"post_type": "posts",
"numberposts": "20"
}
}
}
]
}
}
이 옵션을 사용하면 stylisedUi이 활성화되고 처음에 게시물 20개를 가져옵니다. 선택 필드에 입력하면 s 인수로 게시물을 검색합니다.
함수
사용자 지정 함수로 옵션을 채우세요.
{
"blockstudio": {
"attributes": [
{
"id": "postTypes",
"type": "checkbox",
"label": "Post types",
"populate": {
"type": "function",
"function": "get_post_types"
}
}
]
}
}
인수
인수를 배열로 전달하세요(내부적으로 call_user_func_array 사용).
{
"blockstudio": {
"attributes": [
{
"id": "postTypes",
"type": "checkbox",
"label": "Post types",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": [[], "objects"]
}
}
]
}
}
반환 형식
{
"blockstudio": {
"attributes": [
{
"id": "postTypes",
"type": "checkbox",
"label": "Post types",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": [[], "objects"],
"returnFormat": {
"value": "name",
"label": "label"
}
}
}
]
}
}
옵션 혼합
정적 옵션과 채워진 데이터를 결합하세요.
{
"blockstudio": {
"attributes": [
{
"id": "users",
"type": "radio",
"label": "Users",
"options": [
{
"value": "administrators",
"label": "Administrators"
},
{
"value": "editors",
"label": "Editors"
}
],
"populate": {
"type": "query",
"query": "users",
"position": "before"
}
}
]
}
}
position 옵션(before 또는 after)은 채워진 옵션이 정적 옵션과 비교해 어디에 표시될지 제어합니다.
경고
가져오기 모드에서는 옵션 혼합과 데이터 채우기를 지원하지 않습니다.
사용자 지정 데이터
blockstudio/blocks/attributes/populate 필터로 재사용 가능한 데이터 세트를 만드세요. 이 필터는 이름을 키로 사용하는 모든 사용자 지정 데이터 세트의 배열인 인수 하나를 받습니다. 키 아래에 데이터 세트를 추가하고 배열을 반환하세요.
add_filter('blockstudio/blocks/attributes/populate', function($options) {
$options['customData'] = [
['value' => '1', 'label' => 'Option 1'],
['value' => '2', 'label' => 'Option 2'],
];
return $options;
});
그런 다음 블록에서 키를 참조하세요.
{
"blockstudio": {
"attributes": [
{
"id": "posts",
"type": "select",
"label": "Posts",
"populate": {
"type": "custom",
"custom": "customData"
}
}
]
}
}
외부 데이터
외부 소스에서 데이터를 가져오세요.
{
"blockstudio": {
"attributes": [
{
"id": "select",
"type": "select",
"label": "Select",
"multiple": true,
"populate": {
"type": "fetch",
"arguments": {
"urlSearch": "https://example.com/wp-json/wp/v2/posts?search="
},
"returnFormat": {
"value": "id",
"label": "title.rendered"
}
}
}
]
}
}
검색어가 urlSearch에 추가됩니다.
동적 인수
채우기 인수는 {attributes.*} 구문을 사용해 다른 블록 속성을 참조할 수 있습니다. 참조된 속성이 바뀌면 필드가 옵션을 자동으로 다시 가져옵니다.
{
"blockstudio": {
"attributes": [
{
"id": "post_type",
"type": "select",
"label": "Post Type",
"options": [
{ "label": "Pages", "value": "page" },
{ "label": "Posts", "value": "post" }
]
},
{
"id": "selected_post",
"type": "select",
"label": "Select Post",
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "{attributes.post_type.value}",
"numberposts": 10
}
}
}
]
}
}
이 기능은 모든 채우기 유형(query, function, custom)에서 작동합니다. 채우기 설정에서 {attributes.*}을 포함하는 값은 쿼리가 실행되기 전에 현재 속성 값으로 클라이언트 측에서 확인됩니다.
참조에는 편집기에 저장된 값이 사용됩니다. 선택 항목의 경우 값에는 {attributes.post_type.value}를, 라벨에는 {attributes.post_type.label}를 사용하세요. returnFormat는 템플릿 값에 적용되며, 이 저장된 편집기 데이터 형식에는 적용되지 않습니다.
중첩 인수는 템플릿 문자열로 직렬화하지 않고 확인됩니다.
하나의 플레이스홀더로 구성된 인수는 참조된 유형을 유지하며, 숫자, 불리언, 배열, 객체가 여기에 포함됩니다. 다른 텍스트에 포함된 플레이스홀더는 문자열을 생성합니다. 누락된 참조는 변경되지 않으며, 따옴표가 포함된 값이나 여러 줄 값도 그대로 전달됩니다.
함수 콜백은 위치 인수 목록을 유지합니다. 편집기는 검색 인수 WordPress를 query 채우기 함수에만 추가하며, 함수 호출에는 추가하지 않습니다.
종속 선택 항목 렌더링
블록을 등록할 때는 종속 옵션을 불러오지 않습니다. 각 블록 인스턴스마다 인수가 다를 수 있기 때문입니다. 렌더링은 빈 옵션 목록을 기준으로 저장된 선택 항목을 버리는 대신 해당 항목을 사용합니다. 프런트엔드에서는 채우기 콜백을 다시 실행하지 않습니다.
필드의 returnFormat는 계속 적용됩니다:
returnFormat |
단일 선택 | 다중 선택 |
|---|---|---|
value (기본값) |
저장된 값(예: "a") |
저장된 값의 배열(예: ["a", "b"]) |
label |
저장된 레이블 | 저장된 레이블의 배열 |
both |
저장된 {value, label} 옵션 |
저장된 옵션의 배열 |
쿼리로 채워지는 선택 항목의 경우, populate.returnFormat.value이 "id"가 아닌 한 값은 계속 해당 WordPress 게시물, 사용자 또는 용어 객체로 확인됩니다. 레이블은 저장된 선택 항목에서 가져옵니다. 가져온 선택 항목에 레이블이 없으면 해당 값이 레이블로 사용됩니다. options에 선언된 일치하는 정적 옵션이 저장된 옵션보다 우선하므로 현재 레이블이 적용됩니다.
빈 선택 항목은 false(또는 필드에 설정된 fallback)으로 유지됩니다. 일반 정적 옵션의 유효성 검사에는 영향이 없습니다. 정적 옵션 목록에 더 이상 없는 저장된 값은 계속 false을 반환합니다.
동적 선택 필드도 옵션이 지연되는 동안 default 및 fallback 선택 항목을 유지합니다. 다중 선택에는 스칼라 값, {value, label} 옵션 또는 둘 중 하나의 배열을 사용하세요. 스칼라 값은 선언된 정적 옵션과 일치하지 않는 한 해당 값을 레이블로 사용합니다. 옵션 객체는 제공된 레이블을 유지하며, 일치하는 정적 옵션이 우선합니다. 서버에서는 이러한 기본값을 조회하기 위해 populate 콜백을 실행하지 않습니다.