Esquema
Para aprimorar o desenvolvimento com preenchimento automático e validação no IDE, Blockstudio apresenta seu próprio esquema:
O esquema Blockstudio é uma cópia (sempre atualizada) do esquema principal WordPress block.json, com uma propriedade adicional blockstudio que contém todos os recursos do plugin, como esquemas de campos, sem interferir em possíveis propriedades principais futuras.
Adicionar ao JSON
Basta adicionar uma chave $schema com o valor https://blockstudio.dev/schema/block ao seu block.json para que o IDE comece a sugerir propriedades específicas de Blockstudio.
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "blockstudio/native",
"title": "Native Block",
"category": "text",
"icon": "star-filled",
"description": "Native Blockstudio block.",
"blockstudio": true
}
Suporte a IDEs
VS Code
VS Code detecta automaticamente o esquema a partir da propriedade $schema.
Para configurações de todo o workspace, adicione a .vscode/settings.json:
{
"json.schemas": [
{
"fileMatch": ["**/block.json"],
"url": "https://blockstudio.dev/schema/block"
}
]
}
IDEs JetBrains
PhpStorm e outros IDEs JetBrains oferecem suporte ao esquema JSON automaticamente por meio da propriedade $schema.
Esquemas disponíveis
| Esquema | URL |
|---|---|
| Esquema de blocos | https://blockstudio.dev/schema/block |
| Esquema de extensão | https://blockstudio.dev/schema/extend |
Benefícios
- Preenchimento automático: receba sugestões para todas as propriedades disponíveis
- Validação: detecte erros antes da execução
- Documentação: passe o cursor sobre as propriedades para ver a documentação em linha
- Segurança de tipos: garanta os tipos de valores corretos