save<\/code>fun\u00e7\u00e3o.<\/p>\n![\"Como](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151739-61e4cecf0099f.png\")
<\/a><\/p>\nIsso acontece porque o WordPress compara o bloco salvo no banco de dados com o c\u00f3digo atual na save<\/code>fun\u00e7\u00e3o do seu bloco e eles n\u00e3o correspondem. O WordPress n\u00e3o \u00e9 capaz de corrigir a diferen\u00e7a. Na maioria dos casos, voc\u00ea pode clicar nos tr\u00eas pontos do bloco e escolher “Tentativa de recupera\u00e7\u00e3o do bloco". Se as altera\u00e7\u00f5es feitas na save<\/code>fun\u00e7\u00e3o foram pequenas (por exemplo, uma mudan\u00e7a de classe), o WordPress \u00e9 capaz de restaurar o bloco. d precisar clicar em “Converter para HTML” e voc\u00ea perder\u00e1 a edit<\/code>funcionalidade do seu bloco. Obviamente n\u00e3o podemos esperar que os usu\u00e1rios do nosso c\u00f3digo de bloco encontrem manualmente todos os posts usando este bloco e executem estes passos para cada um.<\/p>\nPortanto, antes de fazer atualiza\u00e7\u00f5es na save<\/code>fun\u00e7\u00e3o, adicionaremos algum c\u00f3digo para informar ao WordPress como lidar com o conte\u00fado antigo que foi salvo com a save<\/code>fun\u00e7\u00e3o antiga.<\/p>\nVamos ao c\u00f3digo!<\/h2>\n
Na verdade \u00e9 bem simples. Em suma, o que precisamos fazer \u00e9; adicione uma deprecated<\/code>propriedade \u00e0 registerBlockType()<\/code>chamada de fun\u00e7\u00e3o. Esta propriedade espera uma matriz. Isso significa que voc\u00ea pode descontinuar um bloco v\u00e1rias vezes, fornecendo v\u00e1rias entradas na matriz. Cada deprecia\u00e7\u00e3o \u00e9 definida como um objeto que cont\u00e9m a attributes<\/code>propriedade completa e a fun\u00e7\u00e3o (antiga) save<\/code>.<\/p>\nEm outras palavras, voc\u00ea define uma deprecated<\/code>propriedade como um array e ent\u00e3o copia seus blocos attributes<\/code>e save<\/code>fun\u00e7\u00f5es nele. Voc\u00ea precisar\u00e1 incluir atributos mesmo que n\u00e3o esteja alterando nada neles na atualiza\u00e7\u00e3o. Voc\u00ea n\u00e3o precisa incluir a edit<\/code>fun\u00e7\u00e3o na deprecia\u00e7\u00e3o.<\/p>\ndeprecated: [\n {\n attributes: { ... },\n save: (props) => { ... }\n }\n]<\/code><\/pre>\nVamos fazer isso em um exemplo mais pr\u00e1tico.<\/p>\n
Suponha que nosso c\u00f3digo de bloco seja algo assim. A edit<\/code>fun\u00e7\u00e3o \u00e9 exclu\u00edda, pois n\u00e3o precisamos lidar com ela na deprecia\u00e7\u00e3o.<\/p>\nconst { __ } = wp.i18n;\nconst { registerBlockType } = wp.blocks;\nconst { RichText } = wp.blockEditor;\n\u00a0\nimport edit from '.\/edit';\n\u00a0\nregisterBlockType( 'awp\/deprecated-block-example', {\n title: __( 'Example of deprecating a block' ),\n icon: 'format-aside',\n category: 'widgets',\n attributes: {\n alignment: {\n type: 'string',\n default: 'center'\n },\n exampleString: {\n type: 'string'\n },\n },\n edit,\n save: (props) => { \n const { exampleString } = props;\n return(\n <div className=\"deprecated-block-example\">\n <RichText.Content value={ exampleString } \/>\n <\/div>\n );\n }\n});<\/code><\/pre>\nEnt\u00e3o vamos supor que queremos fazer altera\u00e7\u00f5es em ambos os atributos e salvar e evitar quebrar os blocos existentes. Adicionamos a deprecated<\/code>propriedade e copiamos o elemento inteiro attributes<\/code>e save<\/code>como um elemento de matriz nele. Ent\u00e3o, somos livres para fazer quaisquer altera\u00e7\u00f5es attributes<\/code>e\/ou save<\/code>funcionar.<\/p>\nconst { __ } = wp.i18n;\nconst { registerBlockType } = wp.blocks;\nconst { RichText } = wp.blockEditor;\n\u00a0\nimport edit from '.\/edit';\n\u00a0\nregisterBlockType( 'awp\/deprecated-block-example', {\n title: __( 'Example of deprecating a block' ),\n icon: 'format-aside',\n category: 'widgets',\n attributes: {\n alignment: {\n type: 'string',\n default: 'center'\n },\n exampleString: {\n type: 'string'\n },\n newThing: {\n type: 'string'\n },\n },\n edit,\n save: (props) => { \n const { exampleString, newThing } = props;\n return(\n <div className=\"deprecated-block-example\">\n <RichText.Content value={ exampleString } \/>\n <div className=\"new-content\">\n <RichText.Content value={ newThing } \/>\n <\/div>\n <\/div>\n );\n },\n deprecated: [\n {\n attributes: {\n alignment: {\n type: 'string',\n default: 'center'\n },\n exampleString: {\n type: 'string'\n },\n },\n save: (props) => { \n const { exampleString } = props;\n return(\n <div className=\"deprecated-block-example\">\n <RichText.Content value={ exampleString } \/>\n <\/div>\n );\n },\n }\n ]\n});<\/code><\/pre>\nCom este c\u00f3digo compilado, voc\u00ea pode encontrar uma postagem existente usando o c\u00f3digo de bloco antigo e n\u00e3o deve obter nenhum c\u00f3digo quebrado!<\/p>\n
O WordPress descobrir\u00e1 que o bloco est\u00e1 usando nosso c\u00f3digo obsoleto e carregar\u00e1 o conte\u00fado usando o save<\/code>c\u00f3digo obsoleto. Depois de fazer altera\u00e7\u00f5es no bloco e atualizar a postagem, o bloco ser\u00e1 salvo usando a nova save<\/code>fun\u00e7\u00e3o.<\/p>\nDeprecia\u00e7\u00e3o mais avan\u00e7ada e leitura adicional<\/h2>\n
O exemplo de c\u00f3digo acima \u00e9 a forma mais b\u00e1sica de deprecia\u00e7\u00e3o. O WordPress suporta mais funcionalidades, como incluir migrate<\/code>e supports<\/code>at\u00e9 atribuir constantes (pense em n\u00fameros de vers\u00e3o) ao seu c\u00f3digo obsoleto. D\u00ea uma olhada na documenta\u00e7\u00e3o do WordPress sobre deprecia\u00e7\u00e3o de blocos<\/a>.<\/p>\n