{"id":228943,"date":"2022-10-20T14:44:00","date_gmt":"2022-10-20T11:44:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=228943"},"modified":"2022-11-09T04:54:17","modified_gmt":"2022-11-09T01:54:17","slug":"use-um-pop-up-modal-para-adicionar-atributos-adicionais-com-registerblockformat","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/use-um-pop-up-modal-para-adicionar-atributos-adicionais-com-registerblockformat\/","title":{"rendered":"Use um pop-up modal para adicionar atributos adicionais com registerBlockFormat"},"content":{"rendered":"\n<p>Demos uma olhada em <a href=\"https:\/\/wholesomecode.ltd\/blog\/format-your-post-content-with-registerformattype\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Aplicar formatos ao seu conte\u00fado de postagem com registerFormatType<\/a>. Mas e se quisermos adicionar cores adicionais \u00e0 nossa caneta marcadora?<\/p>\n<p>Neste guia, vamos expandir o que trabalhamos anteriormente e adicionar um pop-up modal que nos permitir\u00e1 selecionar uma cor de destaque.<\/p>\n<p>Observe que neste pop-up modal pode conter qualquer n\u00famero de itens, incluindo \u00edcones personalizados, imagens ou at\u00e9 mesmo campos de formul\u00e1rio.<\/p>\n<p>Todo o c\u00f3digo usado neste tutorial pode ser encontrado no <a href=\"https:\/\/wholesomecode.ltd\/plugins\/highlighter\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">plugin &#8216;Highlighter&#8217;<\/a> <strong>gratuito<\/strong>.<a href=\"https:\/\/wholesomecode.ltd\/plugins\/highlighter\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external\"><\/a><\/p>\n<p>Aplicando um tipo de formato usando o plugin Highlighter.<\/p>\n<p>O v\u00eddeo acima mostra o plugin Highlighter, nosso tipo de formato e o pop-up em a\u00e7\u00e3o. Vamos pular para ele.<\/p>\n<h2>Pr\u00e9-requisitos<\/h2>\n<ul>\n<li>Leia o guia <a href=\"https:\/\/wholesomecode.ltd\/guides\/creating-plugin-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Criando um Plugin para o Editor de Blocos do WordPress (Gutenberg)<\/a> para que voc\u00ea possa ter uma vantagem inicial na cria\u00e7\u00e3o do plugin.<\/li>\n<li>Siga as etapas no <a href=\"https:\/\/wholesomecode.ltd\/blog\/format-your-post-content-with-registerformattype\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">artigo Formatar seu conte\u00fado de postagem com registerFormatType<\/a>.<\/li>\n<li>Opcionalmente <a href=\"https:\/\/github.com\/wholesomecode\/wholesome-highlighter\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">, baixe o plug-in &#8216;Highlighter&#8217; gratuito do GitHub<\/a> e veja o arquivo<code>\/src\/formats\/highlight-colours.js<\/code><\/li>\n<\/ul>\n<h2>Crie o Modal<\/h2>\n<p>Para criar o popover modal, vamos usar state, para determinar se o bot\u00e3o foi clicado ou n\u00e3o. Para fazer essa importa\u00e7\u00e3o <code>useState<\/code>de <code>'@wordpress\/element'<\/code>.<\/p>\n<p>Dentro do componente de bot\u00e3o, acima da instru\u00e7\u00e3o de retorno, vamos usar isso para definir um estado inicial e criar nossas fun\u00e7\u00f5es de configura\u00e7\u00e3o de estado.<\/p>\n<pre><code> \/\/ State to show popover.\n const [ showPopover, setShowPopover ] = useState( false );\n<\/code><\/pre>\n<p>Vamos ent\u00e3o alterar o evento click do bot\u00e3o para definir o estado.<\/p>\n<pre><code>onClick={() =&gt; { \n    setShowPopover( true );\n} }\n<\/code><\/pre>\n<p>Agora que o estado est\u00e1 definido, podemos usar isso para acionar o popover. Primeiro importe o <code>URLPopover<\/code>componente do <code>'@wordpress\/block-editor'<\/code>. Em seguida, dentro da instru\u00e7\u00e3o return, sob o bot\u00e3o, adicione uma condicional que receba a <code>showPopover<\/code>vari\u00e1vel e renderize o arquivo <code>URLPopover<\/code>.<\/p>\n<pre><code>return (&lt;&gt;\n    &lt;RichTextToolbarButton\n      icon='edit'\n      onClick={() =&gt; { \n        setShowPopover( true );\n      } }\n      title={ __( 'Highlight', 'wholesome-highlighter') }\n      \/&gt;\n    { showPopover &amp;&amp; (&lt;URLPopover\n        className=\"components-inline-color-popover\"\n        onClose={ () =&gt; setShowPopover( false) }\n        &gt;\n        ...\n      &lt;\/URLPopover&gt;) }\n    &lt;\/&gt;) <\/code><\/pre>\n<p>Observe que envolvemos os dois componentes com tags vazias <code>&lt;&gt;&lt;\/&gt;<\/code>. Eles servem ao prop\u00f3sito da <code>&lt;Fragment&gt;<\/code>tag e permitem que dois componentes JSX sejam renderizados sem gerar marca\u00e7\u00e3o no frontend.<\/p>\n<h2>Adicione o conte\u00fado popover modal<\/h2>\n<p><code>ColorPalette<\/code>Como este \u00e9 um plugin de destaque, vamos importar <code>'@wordpress\/block-editor'<\/code>e colocar isso no popover modal.<\/p>\n<pre><code>&lt;URLPopover\n   className=\"components-inline-color-popover\"\n   onClose={ () =&gt; setShowPopover( false) }\n &gt;\n &lt;ColorPalette\n    onChange={ (color) =&gt; {\n      setShowPopover( false );\n      if (color) {\n        onChange( \n          applyFormat( value, {\n            type: name,\n            attributes: { style: `background-color: ${color};` },\n          } \n        ));\n      } else {\n        onChange( toggleFormat( value, { type: name }) ); \n      }\n    } }\n    \/&gt;\n&lt;\/URLPopover&gt;\n<\/code><\/pre>\n<p>O c\u00f3digo acima usar\u00e1 a paleta de cores padr\u00e3o no popover. Mais trabalho ser\u00e1 necess\u00e1rio para adicionar nossas cores personalizadas.<\/p>\n<h2>O c\u00f3digo completo<\/h2>\n<p>Para demonstrar como adicionamos cores personalizadas \u00e0 paleta, provavelmente \u00e9 melhor mostrar o c\u00f3digo completo. Voc\u00ea tamb\u00e9m pode <a href=\"https:\/\/github.com\/wholesomecode\/wholesome-highlighter\/blob\/master\/src\/formats\/highlight-colours.js\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">baixar este arquivo, juntamente com as atualiza\u00e7\u00f5es mais recentes do Github<\/a>.<\/p>\n<pre><code>\nimport { ColorPalette, RichTextToolbarButton, URLPopover } from '@wordpress\/block-editor';\nimport { useState } from '@wordpress\/element';\nimport { __ } from '@wordpress\/i18n';\nimport { Icon } from '@wordpress\/icons';\nimport { applyFormat, registerFormatType, toggleFormat, useAnchorRef } from '@wordpress\/rich-text';\n\nimport '..\/style.scss';\n\nconst name = 'wholesome\/highlighter';\nconst cssClass = 'wholesome-highlight';\n\nconst HighlighterButton = (props) =&gt; {\n    const { contentRef, isActive, onChange, value } = props;\n    const { activeFormats } = value;\n    const anchorRef = useAnchorRef( { ref: contentRef, value } );\n\n    const highlighterIcon = &lt;svg width=\"20\" height=\"20\" viewBox=\"0 0 20 20\" fill=\"none\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\"&gt;\n        &lt;path d=\"M14.2186 3.31061C13.7838 2.89252 13.0834 2.89708 12.6543 3.32078L9.22512 6.70711C9.17494 6.75668 9.13068 6.80978 9.09236 6.86558L7.36613 8.57021L11.393 12.4419L16.362 7.50771L16.6812 7.1925C17.1103 6.76879 17.1056 6.08638 16.6708 5.66828L14.2186 3.31061Z\" fill=\"black\"\/&gt;\n        &lt;path d=\"M6.81914 9.10588L10.8041 12.9457L9.79592 13.9391C9.42424 14.3053 8.84982 14.3575 8.42039 14.0938L7.83675 13.8883L7.01822 14.6819L5.03321 12.7381L5.86163 11.9349L5.67624 11.454C5.39121 11.0373 5.43547 10.4692 5.811 10.0992L6.81914 9.10588Z\" fill=\"black\"\/&gt;\n        &lt;path d=\"M5.11329 13.6189L6.13911 14.5945L5.70907 15L4 14.592L5.11329 13.6189Z\" fill=\"black\"\/&gt;\n    &lt;\/svg&gt;;\n\n    const [ showPopover, setShowPopover ] = useState( false );\n    const [ activeColor, setActiveColor ] = useState( false );\n\n    const colors = [\n        { name: 'Yellow', color: '#fff300' },\n        { name: 'Green', color: '#79fe0c' },\n        { name: 'Blue', color: '#4af1f2' },\n        { name: 'Purple', color: '#df00ff' },\n        { name: 'Red', color: '#ff2226' },\n        { name: 'Orange', color: '#ff7b19' },\n        { name: 'Pink', color: '#ff70c5' },\n    ];\n\n    const getActiveColor = () =&gt; {\n        const formats = activeFormats.filter( format =&gt; name === format['type'] );\n\n        if (formats.length &gt; 0) {\n            const format = formats[0];\n            const { attributes, unregisteredAttributes } = format;\n\n            let atts = unregisteredAttributes;\n\n            if (attributes &amp;&amp; attributes.length) {\n                atts = attributes;\n            }\n\n            if (! atts) {\n                if (activeColor) {\n                    return { backgroundColor: activeColor };\n                }\n                return;\n            }\n\n            if (atts.hasOwnProperty('class')) {\n\n                const parts = atts.class.split( '--' );\n                const colorName = parts[ parts.length - 1 ];\n                const selectedColor = colors.filter( item =&gt; colorName === item.name.toLowerCase() )[0];\n                return { backgroundColor: selectedColor.color };\n            } else if (atts.hasOwnProperty('style')) {\n\n                const { style } = atts;\n                const parts = style.split( ': ' );\n                const selectedColor = parts[ parts.length - 1 ].replace( ';', '' );\n                return { backgroundColor: selectedColor };\n            }\n        }        \n    };\n\n    return (&lt;&gt;\n        &lt;RichTextToolbarButton\n            icon={\n                &lt;&gt;\n                    &lt;Icon icon={ highlighterIcon } \/&gt;\n                    { isActive &amp;&amp; (&lt;span\n                            className=\"format-library-text-color-button__indicator\"\n                            style={ getActiveColor() }\n                        \/&gt;) }\n                &lt;\/&gt;\n            }\n            key={ isActive? 'text-color': 'text-color-not-active' }\n            name={ isActive? 'text-color': undefined }\n            onClick={ () =&gt; { \n                setShowPopover( true );\n            } }\n            title={ __( 'Highlight', 'wholesome-highlighter') }\n        \/&gt;\n        { showPopover &amp;&amp; (&lt;URLPopover\n                anchorRef={ anchorRef }\n                className=\"components-inline-color-popover\"\n                onClose={ () =&gt; setShowPopover( false) }\n            &gt;\n                &lt;ColorPalette\n                    colors={ colors }\n                    onChange={ (color) =&gt; {\n                        setShowPopover( false );\n                        setActiveColor( color );\n\n                        if (color) {\n                            const selectedColor = colors.filter( item =&gt; color === item.color );\n                            const attributes  = {};\n                            if (selectedColor.length) {\n\n                                attributes.class = `${cssClass}--${selectedColor[0].name.toLowerCase()}`;\n                            } else {\n\n                                attributes.style = `background-color: ${color};`;\n                            }\n                            onChange( \n                                applyFormat( value, {\n                                    type: name,\n                                    attributes,\n                                } \n                            ));\n                        } else {\n                            onChange( toggleFormat( value, { type: name }) ); \n                        }\n                    } }\n                \/&gt;\n            &lt;\/URLPopover&gt;) }\n        &lt;\/&gt;) };\n\nregisterFormatType(\n    name, {\n        className: cssClass,\n        edit: HighlighterButton,\n        tagName: 'mark',\n        title: __( 'Highlight', 'wholesome-highlighter' ),\n    }\n);\n<\/code><\/pre>\n<p>Certifique-se de definir as cores para suas cores personalizadas no <code>\/src\/style.scss<\/code>arquivo, e a\u00ed est\u00e1, um formato de caneta marca-texto com paleta de cores.<\/p>\n<pre><code>\n.wholesome-highlight {\n    &amp;.wholesome-highlight--yellow {\n        background-color: #fff300;\n    }\n\n    &amp;.wholesome-highlight--green {\n        background-color: #79fe0c;\n    }\n\n    &amp;.wholesome-highlight--blue {\n        background-color: #4af1f2;\n    }\n\n    &amp;.wholesome-highlight--purple {\n        background-color: #df00ff;\n    }\n\n    &amp;.wholesome-highlight--red {\n        background-color: #ff2226;\n    }\n\n    &amp;.wholesome-highlight--orange {\n        background-color: #ff7b19;\n    }\n\n    &amp;.wholesome-highlight--pink {\n        background-color: #ff70c5;\n    }\n}\n<\/code><\/pre>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168426-61e7cca49a5ba.png\" alt=\"Use um pop-up modal para adicionar atributos adicionais com registerBlockFormat\" \/>\u00cdcone de cor selecionada do marca-texto<\/p>\n<ul>\n<li><a href=\"https:\/\/wholesomecode.ltd\/guides\/add-sidebar-controls-to-your-custom-wordpress-block-with-inspectorcontrols\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Adicione uma barra lateral de bloco com InspectorControls<\/a><\/li>\n<li>Veja o uso <a href=\"https:\/\/wholesomecode.ltd\/guides\/post-meta-fields-store-attributes-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">de meta campos post em blocos Gutenberg<\/a><\/li>\n<li>Veja como usar <a href=\"https:\/\/wholesomecode.ltd\/guides\/options-settings-data-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">op\u00e7\u00f5es e configura\u00e7\u00f5es em blocos Gutenberg<\/a><\/li>\n<li>Veja como criar uma <a href=\"https:\/\/wholesomecode.ltd\/guides\/create-settings-page-wordpress-gutenberg-components\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">p\u00e1gina de op\u00e7\u00f5es e configura\u00e7\u00f5es usando componentes do Gutenberg<\/a><\/li>\n<\/ul>\n<p><div id=\"PostUnique_PostSource\" style=\"padding-top: 50px\">Fonte de grava\u00e7\u00e3o:  <a target=\"_blank\" rel=\"noopener nofollow\" href=\"\/\/wholesomecode.ltd\" class=\"external external_icon\">wholesomecode.ltd<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Demos uma olhada em Aplicar formatos ao seu conte\u00fado de postagem com registerFormatType. Mas e se quisermos adicionar cores adicionais \u00e0 nossa caneta marcadora?Neste guia, vamos&#8230;<\/p>\n","protected":false},"author":1,"featured_media":220968,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[898,722,920,846,867],"tags":[1170],"class_list":["post-228943","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-codigo-2","category-desenvolvedor","category-outro","category-tutoriais","category-wordpress-8","tag-affiai-pt-pt"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/228943","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/comments?post=228943"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/228943\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media\/220968"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=228943"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/categories?post=228943"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/tags?post=228943"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}