{"id":228473,"date":"2022-10-20T14:21:00","date_gmt":"2022-10-20T11:21:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=228473"},"modified":"2022-11-09T02:36:41","modified_gmt":"2022-11-08T23:36:41","slug":"use-una-ventana-emergente-modal-para-agregar-atributos-adicionales-con-registerblockformat","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/es\/use-una-ventana-emergente-modal-para-agregar-atributos-adicionales-con-registerblockformat\/","title":{"rendered":"Use una ventana emergente modal para agregar atributos adicionales con registerBlockFormat"},"content":{"rendered":"\n<p>Hemos echado un vistazo a <a href=\"https:\/\/wholesomecode.ltd\/blog\/format-your-post-content-with-registerformattype\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">la aplicaci\u00f3n de formatos al contenido de su publicaci\u00f3n con registerFormatType<\/a>. Pero, \u00bfy si queremos a\u00f1adir colores adicionales a nuestro rotulador?<\/p>\n<p>En esta gu\u00eda, vamos a expandir lo que trabajamos anteriormente y agregar una ventana emergente modal que nos permitir\u00e1 seleccionar un color de resaltado.<\/p>\n<p>Tenga en cuenta que en esta ventana emergente modal podr\u00eda contener cualquier n\u00famero de elementos, incluidos iconos personalizados, im\u00e1genes o incluso campos de formulario.<\/p>\n<p>Todo el c\u00f3digo utilizado en este tutorial se puede encontrar en el complemento <strong>gratuito<\/strong> <a href=\"https:\/\/wholesomecode.ltd\/plugins\/highlighter\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">&#8216;Highlighter&#8217;<\/a>.<\/p>\n<p>Aplicar un tipo de formato usando el complemento Highlighter.<\/p>\n<p>El video de arriba muestra el complemento Resaltador, nuestro tipo de formato y la ventana emergente en acci\u00f3n. Saltemos a ello.<\/p>\n<h2>requisitos previos<\/h2>\n<ul>\n<li>Lea la gu\u00eda <a href=\"https:\/\/wholesomecode.ltd\/guides\/creating-plugin-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Creaci\u00f3n de un complemento para el editor de bloques de WordPress (Gutenberg)<\/a> para que pueda comenzar a crear el complemento.<\/li>\n<li>Siga los pasos del <a href=\"https:\/\/wholesomecode.ltd\/blog\/format-your-post-content-with-registerformattype\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">art\u00edculo Dar formato al contenido de su publicaci\u00f3n con registerFormatType<\/a>.<\/li>\n<li>Opcionalmente <a href=\"https:\/\/github.com\/wholesomecode\/wholesome-highlighter\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">, descargue el complemento gratuito &#8216;Highlighter&#8217; de GitHub<\/a> y mire el archivo<code>\/src\/formats\/highlight-colours.js<\/code><\/li>\n<\/ul>\n<h2>Crear el modal<\/h2>\n<p>Para crear el popover modal, vamos a usar el estado, para determinar si se ha hecho clic en el bot\u00f3n o no. Para realizar esta importaci\u00f3n <code>useState<\/code>desde <code>'@wordpress\/element'<\/code>.<\/p>\n<p>Dentro del componente de bot\u00f3n, arriba de la declaraci\u00f3n de devoluci\u00f3n, vamos a usar esto para establecer un estado inicial y crear nuestras funciones de establecimiento de estado.<\/p>\n<pre><code> \/\/ State to show popover.\n const [ showPopover, setShowPopover ] = useState( false );\n<\/code><\/pre>\n<p>Luego vamos a modificar el evento de clic del bot\u00f3n para establecer el estado.<\/p>\n<pre><code>onClick={() =&gt; { \n    setShowPopover( true );\n} }\n<\/code><\/pre>\n<p>Ahora que el estado est\u00e1 configurado, podemos usarlo para activar el popover. Primero importe el <code>URLPopover<\/code>componente desde <code>'@wordpress\/block-editor'<\/code>. Luego, dentro de la declaraci\u00f3n de retorno, debajo del bot\u00f3n, agregue un condicional que tome la <code>showPopover<\/code>variable y represente el <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>Tenga en cuenta que hemos envuelto los dos componentes con etiquetas vac\u00edas <code>&lt;&gt;&lt;\/&gt;<\/code>. Estos cumplen el prop\u00f3sito de la <code>&lt;Fragment&gt;<\/code>etiqueta y permiten que dos componentes JSX se representen sin generar marcas en la interfaz.<\/p>\n<h2>Agregue el contenido emergente modal<\/h2>\n<p>Debido a que este es un complemento de resaltado, vamos a importarlo <code>ColorPalette<\/code>y <code>'@wordpress\/block-editor'<\/code>colocarlo en la ventana emergente 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>El c\u00f3digo anterior utilizar\u00e1 la paleta de colores predeterminada en la ventana emergente. Se necesitar\u00e1 m\u00e1s trabajo para agregar nuestros colores personalizados.<\/p>\n<h2>El c\u00f3digo en su totalidad<\/h2>\n<p>Para demostrar c\u00f3mo agregamos colores personalizados a la paleta, probablemente sea mejor mostrar el c\u00f3digo completo. Tambi\u00e9n puede <a href=\"https:\/\/github.com\/wholesomecode\/wholesome-highlighter\/blob\/master\/src\/formats\/highlight-colours.js\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">descargar este archivo, junto con las \u00faltimas actualizaciones de 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>Aseg\u00farese de establecer los colores para sus colores personalizados en el <code>\/src\/style.scss<\/code>archivo, y ah\u00ed lo tiene, un formato de rotulador resaltador con paleta de colores.<\/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 una ventana emergente modal para agregar atributos adicionales con registerBlockFormat\" \/>Resaltador icono de color seleccionado<\/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\">Agregue una barra lateral de bloque con InspectorControls<\/a><\/li>\n<li>Mire el uso <a href=\"https:\/\/wholesomecode.ltd\/guides\/post-meta-fields-store-attributes-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">de metacampos de publicaci\u00f3n en bloques de Gutenberg<\/a><\/li>\n<li>Mire el uso de <a href=\"https:\/\/wholesomecode.ltd\/guides\/options-settings-data-wordpress-gutenberg\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">opciones y configuraciones en bloques de Gutenberg<\/a><\/li>\n<li>Mire la creaci\u00f3n de una <a href=\"https:\/\/wholesomecode.ltd\/guides\/create-settings-page-wordpress-gutenberg-components\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">p\u00e1gina de opciones y configuraciones usando componentes de Gutenberg<\/a><\/li>\n<\/ul>\n<p><div id=\"PostUnique_PostSource\" style=\"padding-top: 50px\">Fuente de grabaci\u00f3n:  <a target=\"_blank\" rel=\"noopener nofollow\" href=\"\/\/wholesomecode.ltd\" class=\"external external_icon\">wholesomecode.ltd<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Hemos echado un vistazo a la aplicaci\u00f3n de formatos al contenido de su publicaci\u00f3n con registerFormatType. Pero, \u00bfy si queremos a\u00f1adir colores adicionales a nuestro rotulador? En esta gu\u00eda vamos a&#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":[892,716,914,840,861],"tags":[1172],"class_list":["post-228473","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-codigo","category-desarrollador","category-otro","category-tutoriales","category-wordpress-2","tag-affiai-es"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/posts\/228473","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/comments?post=228473"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/posts\/228473\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/media\/220968"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/media?parent=228473"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/categories?post=228473"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/es\/wp-json\/wp\/v2\/tags?post=228473"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}