← Toda la documentación

Referencia de configuración

Esta página enumera las opciones de configuración disponibles del editor. Consulta Configuración para ver patrones de configuración y orientación de uso.

En pantallas pequeñas, desplaza la tabla horizontalmente para ver todas las columnas. Los usuarios de teclado pueden dar el foco al área de la tabla y usar las teclas de flecha.

NombrePredeterminadoDescripción
skindefaultEl aspecto de la interfaz del editor. El valor se convierte en una clase del contenedor (rte-skin-<value>), así que el tema incluye dark, gray, blue y rounded-corner, y también funciona cualquier nombre al que des estilo tú mismo. Déjalo sin definir para la interfaz clara predeterminada. Consulta skin.
toolbardefaultDefault, basic o full. Auto configura la barra de herramientas con un conjunto de botones en escritorio.
toolbarMobilemobileEl conjunto de barra de herramientas en dispositivos móviles.
maxWidthForMobile992Cuando la pantalla (la ventana del navegador) es más pequeña que 992, el editor debe tener la barra de herramientas móvil.
timeoutAddToUndo900Cuando el usuario escribe rápido, espera 900ms para añadir un elemento de deshacer.
enableDragDroptrueActiva o desactiva la compatibilidad con arrastrar y soltar en el editor.
enableObjectResizingtrueIndica si se permite o no que los usuarios redimensionen un objeto dentro de RichTextEditor.
readOnlyfalseObtiene o establece un valor que indica si RichTextEditor debe ser un editor HTML activo o un visor de documentos de solo lectura.
focusOnLoadfalseIndica si el editor recibe el foco al cargarse la página. Si esta propiedad es true, el editor recibe el foco; si es false, no.
allowScriptCodefalseIndica si se eliminan todos los elementos script y su contenido del html para evitar la inyección de JavaScript. Cuando esta propiedad es false (el valor predeterminado), Rich Text Editor elimina del html todos los elementos script y su contenido.
tagWhiteList[]La lista blanca contiene las etiquetas que se pueden usar en el editor.
tagBlackList[]La lista negra contiene las etiquetas que no se pueden usar en el editor.
maxHTMLLength0Obtiene o establece el número máximo de caracteres, incluidas las etiquetas HTML, permitido en RichTextEditor. El valor predeterminado, 0, significa sin máximo. Por encima del límite, el editor vuelve al último estado correcto y lanza el hook customdialog reachmaxlength.
maxTextLength0Obtiene o establece el número máximo de caracteres, sin contar las etiquetas HTML, permitido en RichTextEditor. El valor predeterminado, 0, significa sin máximo. Por encima del límite, el editor vuelve al último estado correcto y lanza el hook customdialog reachmaxlength.
styleWithCSSfalseCómo se guardan la negrita, la cursiva y el subrayado. El valor predeterminado escribe etiquetas ( <b>, <i>, <u>), que boldTag e italicTag renombran y que un lector de pantalla anuncia como énfasis. Establece true para guardar en su lugar estilos en línea (<span style="font-weight: bold">). Core 2.6.8 y posteriores; antes, el resultado dependía de si el bundle de plugins terminaba de cargarse primero, así que el mismo contenido podía guardarse de las dos formas.
pasteStripThemeStylestrueAl pegar, descarta los estilos en línea que solo repiten el tema propio del editor. Los navegadores escriben los estilos calculados en el HTML copiado, así que el texto copiado dentro del editor llegaba con el margen, el tamaño de fuente y el color del tema, y eso se guardaba con el contenido. Se conservan los estilos que el autor definió y que difieren del tema. Establece false para conservar todos los estilos pegados. Core 2.6.8 y posteriores.
smartTypographytrueSustituye lo que escribe el autor por caracteres tipográficos: las comillas rectas se vuelven tipográficas, dos guiones se convierten en una raya, tres puntos en puntos suspensivos, y (c), (r) y (tm) en ©, ® y ™. No se cambia nada dentro de code, pre o kbd. Esto pertenece al core del editor y es independiente del plugin de autocorrección, así que autocorrectEnabled: false no lo desactiva. Establece false para conservar exactamente lo que se escribe; las cuatro opciones de abajo activan o desactivan cada sustitución por separado.
smartTypographyQuotestrueLas comillas dobles y simples rectas se convierten en tipográficas (“ ” ‘ ’), y un apóstrofo dentro de una palabra se convierte en ’ (don’t).
smartTypographyDashestrueDos guiones se convierten en una raya (—). Un solo guion no se toca.
smartTypographyEllipsistrueTres puntos se convierten en un único carácter de puntos suspensivos (…).
smartTypographyTrademarkstrue(c), (r) y (tm) se convierten en ©, ® y ™.
sanitizerAllowIframestrueConserva los elementos <iframe> en el contenido. Se aplica mientras el saneador de contenido está activo (contentSanitizer, parte del bundle de plugins). Solo sobreviven los marcos cuyo src es http o https; srcdoc, los controladores de eventos y las URL javascript: nunca sobreviven. Sin una lista sanitizerAllowedIframeHosts, cada marco conservado se pone en un sandbox con allow-scripts allow-same-origin allow-presentation: se retienen la navegación de nivel superior, las ventanas emergentes, las modales y los formularios, y un marco del propio origen de la página también pierde allow-same-origin. Establece false para descartar todos los iframes.
sanitizerAllowedIframeHosts[]Conserva solo los marcos de estos hosts y sus subdominios, por ejemplo ["www.youtube.com", "player.vimeo.com"]. Es el control más fuerte: establécelo siempre que sepas qué contenidos incrustados esperas.
maxUploadFileSize0Archivo más grande que el editor insertará o subirá, en bytes. El valor predeterminado, 0, significa sin límite. Se aplica a los cuadros de diálogo de imágenes y de documentos, al pegado y a arrastrar y soltar: por encima del límite, el archivo se rechaza antes de leerlo, así que no se incrusta nada en el documento ni se envía nada al controlador de carga. El mensaje viene de text_uploadtoobig; gestiona el hook customdialog uploadtoobig para mostrar tu propio cuadro de diálogo.
allowBase64ImagestrueSin controlador de carga ni file_upload_url, una imagen insertada se incrusta en el HTML como una URL data: en base64. Establece false para no incrustar nunca: la imagen se rechaza con el mensaje text_base64disabled (hook customdialog base64disabled), así que entonces es obligatorio un controlador de carga. Core 2.6.5 y posteriores.
base64ImageMaxSize204800Tamaño máximo de una imagen en base64, en bytes, después de reducirla (200 KB). Una imagen mayor se rechaza con el mensaje text_base64toobig (hook customdialog base64toobig). 0 significa sin límite, que es el comportamiento anterior a core 2.6.5.
base64ImageShrinktrueRedimensiona y vuelve a codificar en el navegador las imágenes JPEG, PNG, WebP y BMP antes de incrustarlas en base64. GIF y SVG nunca se vuelven a codificar. Establece false para incrustar los bytes originales cuando quepan bajo base64ImageMaxSize. Core 2.6.5 y posteriores.
base64ImageMaxDimension1600Lado más largo, en píxeles, de una imagen reducida para incrustarla en base64. Core 2.6.5 y posteriores.
file_upload_urlnullURL a la que el editor envía por POST los archivos insertados, pegados y soltados, como multipart/form-data. Defínela en lugar de escribir un file_upload_handler. La respuesta puede ser {"location": "..."} de TinyMCE, {"url": "..."} o {"urls": {"default": "..."}} de CKEditor, o READY:<url>; {"error": {"message": "..."}} y ERROR:<message> son fallos, igual que cualquier otro cuerpo. Un file_upload_handler tiene prioridad cuando están definidos los dos.
file_upload_fieldfileNombre del campo de formulario con el que se envía el archivo. Los endpoints al estilo de CKEditor esperan upload.
file_upload_base_pathnullSe antepone a una URL relativa que devuelve el endpoint, para servir las cargas desde un CDN.
file_upload_credentialsfalseEnvía las cookies y la autenticación HTTP con la carga, para un endpoint de otro origen.
file_upload_reuse_filenamefalseEnvía el archivo con su nombre original. De forma predeterminada se genera un nombre único, para que dos usuarios que suben image.png no puedan sobrescribirse.
file_upload_headersnullEncabezados de solicitud adicionales para la carga, p. ej., un token CSRF.
automaticUploadsfalseCon true, el editor sube sin que se le pida las imágenes incrustadas en el contenido como URL data: en base64: después de setHTMLCode y después de insertar o pegar HTML. Ejecuta uploadEmbeddedImages() por ti, con un debounce de automaticUploadsDelay (300 ms), y no hace nada cuando no hay ningún file_upload_handler configurado.
automaticUploadsDelay300Milisegundos de espera antes de que se ejecute la revisión automática, para que un pegado de varias imágenes se suba una sola vez.
uploadRetryCount0Intentos adicionales después de una carga fallida, antes de que el error llegue al callback de tu controlador y al usuario. Cada intento lanza un evento uploadretry. Una carga cancelada, o una cuya imagen se ha borrado, nunca se reintenta.
uploadRetryDelay1000Milisegundos antes del primer reintento. La espera se duplica en cada intento posterior.
autoSavenullGuarda el contenido en tu propio servidor mientras el usuario escribe: { onSave: function (html) { return promise; }, interval: 2000, indicator: true, retryCount: 3, retryDelay: 5000 }. onSave es obligatorio; devolver una promesa permite que el editor muestre si el guardado funcionó. Un guardado fallido se reintenta con una espera que se duplica, y de nuevo en cuanto el navegador vuelve a tener conexión. Consulta los métodos de editor.autoSave para el control manual.
editorResizeModebothboth, height o none. Obtiene o establece el modo de redimensionamiento.
toggleBordertrueIndica el estado de ToggleBorder. ToggleBorder es una función práctica que permite ver los bordes sin tener que poner border = 1 o algo parecido en el código.
showSelectedBlocktrueIndica si se muestra o no el bloque seleccionado dentro de RichTextEditor.
showFloatTextToolBarfalseIndica si se muestra la FloatTextToolBar definida en config.controltoolbar_TEXT.
showFloatLinkToolBarfalseIndica si se muestra la FloatLinkToolBar definida en config.controltoolbar_A.
showFloatImageToolBbarfalseIndica si se muestra la FloatImageToolBbar definida en config.controltoolbar_IMG.
showFloatTableToolBarfalseIndica si se muestra la FloatTableToolBar definida en config.controltoolbar_TD.
showFloatParagraphtrueIndica si se muestra FloatParagraph en el lado izquierdo.
floatParagraphPosleftLeft o right. Obtiene o establece la posición de FloatParagraph.
floatParagraphPosX0Un número que representa la coordenada horizontal de FloatParagraph, en píxeles.
floatParagraphPosY0Un número que representa la coordenada vertical de FloatParagraph, en píxeles.
showPlusButtontrueIndica si se muestra el botón de más del editor.
showTagListtrueIndica si se muestra el selector de etiquetas en la barra inferior del editor.
showStatisticstrueIndica si se muestran las estadísticas del contenido en la barra inferior del editor.
tabSpaces4Obtiene o establece el número de espacios que se insertan cuando el usuario pulsa la tecla "tab".
enterKeyTagpDetermina qué ocurre al pulsar la tecla "enter" en el editor. div, p o br.
htmlcode_forcehexformatfalseEscribe los colores como #993300 en lugar de rgb(153, 51, 0) en el HTML guardado. El editor deja pasar sin cambios el color elegido; es el navegador quien lo normaliza a rgb() al volver a leer el estilo, así que esta opción lo convierte a la salida. Se aplica a los colores que ya están en el contenido cargado o pegado y a los que aplica el usuario, y cubre tanto el color del texto como el del fondo. rgba() se deja como está porque un hex de 6 dígitos no puede llevar su canal alfa.
paragraphClassparagraphEl nombre de clase indicado se añade automáticamente al párrafo al crear un párrafo nuevo.
insertTableTag<table></table>Atributos de tabla predeterminados al insertar una tabla.
insertRowTag<tr></tr>Atributos de fila predeterminados al crear una fila de tabla.
insertCellTag<td><br/></td>Atributos de celda predeterminados al insertar una celda.
url_base/richtexteditorLa carpeta desde la que el editor carga sus propios archivos: las hojas de estilos del contenido y de la vista previa, el script de la vista previa, la página de ayuda y la página More del selector de color. Desde core 2.6.10, si la dejas sin definir, sigue a la carpeta desde la que se cargó rte.js, así que una instalación desde un CDN o en una subcarpeta no necesita ningún ajuste; antes, siempre era /richtexteditor. Establécela para servir esos archivos desde otro lugar.
onready(ninguno)Desde core 2.6.10: una función que se llama una vez cuando el editor se ha construido y se ha cargado su contenido inicial (el evento ready). Igual que editor.attachEvent("ready", fn).
pasteMode"Auto"Cómo se gestiona el contenido pegado: "Auto" conserva el formato y lo limpia, "PasteText" siempre pega texto sin formato, "PasteWord" siempre aplica la limpieza de Word y "Disabled" rechaza el pegado. Ctrl+Shift+V pega texto sin formato en todos los modos salvo Disabled.
smartLinkPastetruePegar una URL con texto seleccionado convierte el texto seleccionado en un enlace en lugar de sustituirlo.
autoLinkPastetrueDesde core 2.6.10: una dirección web en el texto sin formato pegado (https://… o www.…) se convierte en un enlace; la puntuación final se queda fuera. No se aplica con Ctrl+Shift+V ni dentro de un enlace o de código. Establécelo en false para pegar las direcciones como texto sin formato.
linkDefaultProtocol"http://"Desde core 2.6.10: el protocolo que se pone delante de una dirección que no lo tiene, como example.com escrito en el cuadro de diálogo de enlaces o una dirección www. pegada. Establécelo en "https://" para usar enlaces seguros de forma predeterminada.
pasteMarkdownfalseDesde core 2.6.10: con true, el Markdown pegado como texto sin formato (un README, un chat, una respuesta de IA) se convierte en contenido con formato: encabezados, negrita, cursiva, enlaces, listas, citas y bloques de código. El texto que no parece Markdown, Ctrl+Shift+V y lo que se pega dentro de código se dejan como texto sin formato. El resultado se sanea como cualquier pegado.
markdownShortcutsEnabledtrueAtajos de bloque de Markdown que se escriben al principio de un párrafo vacío: # a ###### para encabezados, - / * para viñetas, 1. / 1) para listas numeradas (un número distinto de 1 define el inicio), > para citas, [ ] para un elemento de tareas (con el plugin de tareas), ``` para un bloque de código y --- + Enter para una línea horizontal. Un solo Ctrl+Z devuelve los caracteres escritos.
markdownInlineEnabledtrueFormato automático de Markdown en línea al escribir el delimitador de cierre: **bold**, *italic*, `code`, ~~strike~~. El texto escrito después continúa sin formato.
contentCssUrl%url_base%/runtime/
richtexteditor_content.css
Indica la ubicación de la hoja de estilos que usará el área editable.
previewCssUrl%url_base%/runtime/
richtexteditor_preview.css
Indica la ubicación de la hoja de estilos que usará la ventana de vista previa.
previewScriptUrl%url_base%/runtime/
richtexteditor_preview.js
Indica la ubicación del archivo JavaScript que usará la ventana de vista previa.
contentCssText""Obtiene o establece el texto CSS en línea que usará el área editable. Por ejemplo, "body{background-color:#eee}".
previewCssText""Obtiene o establece el texto CSS en línea que usará la ventana de vista previa. Por ejemplo, "body{background-color:#eee}".
editorBodyCssClass""Obtiene o establece la clase del área de edición para cambiar de estilos.
editorBodyCssText""Obtiene o establece el texto CSS en línea que usará el body editable.
editablePaddingTop2Establece el relleno (espacio) superior del área editable.
editablePaddingBottom2Establece el relleno (espacio) inferior del área editable.
editablePaddingLeft2Establece el relleno (espacio) izquierdo del área editable.
editablePaddingRight2Establece el relleno (espacio) derecho del área editable.
zIndexFullPage9999Establece el z-index del editor cuando se abre en modo de pantalla completa.
zIndexFloat99999Establece el z-index de la barra de herramientas flotante del editor.
zIndexDialog999999Establece el z-index del cuadro de diálogo del editor.
zIndexDropDown9999999Establece el z-index de la lista desplegable del editor.
fontNameDropDownMinWidth90pxEstablece el min-width de la lista desplegable de fuentes.
fontNameDropDownMaxWidth110pxEstablece el max-width de la lista desplegable de fuentes.
tooltipAttributerte-tooltipEstablece el atributo de la información sobre herramientas del editor.
showKeyboardShortcutsInTooltipstrueMuestra el atajo de teclado de cada botón de la barra de herramientas en su información sobre herramientas ("Bold (Ctrl+B)", ⌘ en un Mac). El atajo solo se muestra en la información sobre herramientas: los títulos de los cuadros de diálogo y el nombre accesible del botón siguen siendo la etiqueta simple, y el botón lleva aria-keyshortcuts.
keyboardShortcutHints{ bold: "Ctrl+B", italic: "Ctrl+I", ... }El atajo que se muestra para cada comando, indexado por nombre de comando. Añade o sustituye entradas para que coincidan con los atajos que asignes tú. No pongas los atajos en las etiquetas text_*: una etiqueta también es el título de un cuadro de diálogo y un nombre accesible, y un paquete de idioma la sustituye.
commentMentions[]Las personas que se pueden mencionar en un comentario, como un array de { id, name }. Al escribir @ en el editor de comentarios aparecen en una lista; al elegir una se inserta "@Name" y se registra la mención en el comentario. Vacío significa que no hay lista de menciones (plugin de comentarios).
text_uilocalelo define cada paquete de idiomaLa configuración regional del paquete de idioma cargado (por ejemplo, zh-Hans, de). El editor la usa para nombrar los idiomas en el menú de idioma de fragmentos de texto y en la lista Translate de Ask AI, y para escribir las etiquetas de fecha, mediante la API Intl del navegador. Sin ningún paquete cargado, se usa el inglés.
controlSelectionClassrte-control-selectedEstablece la clase de la selección de controles del editor.
controlSelectionMargin7Establece el margen de la selección de controles del editor.
altTextHinttrueLas imágenes sin texto alternativo, o con uno vacío, reciben un contorno discontinuo ámbar en el área de edición para que los autores vean qué falta por describir. Solo en el editor; no se añade nada al HTML guardado. Establece false para ocultar el contorno.
autoHeadingAnchorstrueDa a cada encabezado un id formado a partir de su texto ("Hello World" se convierte en hello-world) poco después de cada cambio, para que los enlaces y una tabla de contenido puedan apuntar a él; un duplicado recibe -2, -3. Establece false para que el core deje de asignar ids. Con el bundle de plugins cargado, el plugin de esquema del documento mantiene entonces por sí mismo los ids de los encabezados únicos.
autoLinkOnTypetrueUna URL o una dirección de correo electrónico escrita en el texto se convierte en un enlace al escribir el espacio que la sigue. Establece false para dejar las direcciones escritas como texto simple.
backspaceOutdenttrueRetroceso justo al principio de un elemento de lista saca ese elemento de la lista como un párrafo en lugar de unirlo al elemento de arriba. Establece false para unirlo.
blockDragHandlestrueAl pasar el ratón por encima de un bloque (párrafo, encabezado, lista, tabla...) aparece un tirador junto a él; arrastra el tirador para mover el bloque. Establece false para ocultar los tiradores.
collabEnabledtruePermite que el plugin de colaboración (yjscollab) configure editor.collab. Establece false y el plugin no hace nada: no hay editor.collab. La colaboración solo empieza cuando llamas a editor.collab.attach(...); este valor predeterminado por sí solo no abre ninguna conexión. Consulta colaboración.
collabShowPresencetrueCuando hay una sesión de colaboración conectada, muestra el panel con las demás personas del documento. Establece false para ocultarlo.
collabShowRemoteCursorstrueCuando hay una sesión de colaboración conectada, muestra los cursores y las selecciones de las demás personas sobre el texto. Establece false para ocultarlos.
collabTextSyncfalseQué sincroniza una sesión de colaboración además de la presencia y del registro de revisión (plugin yjscollab): false: nada del texto del documento; true: instantáneas de todo el documento en un texto compartido de Yjs; "crdt": combinación a nivel de carácter mediante el motor CRDT (crdt-engine.min.js), que recurre a las instantáneas cuando el motor no está cargado.
collabRequireCrdtfalseCon collabTextSync: "crdt", si falta el motor CRDT, desactiva la sincronización del texto en lugar de recurrir a las instantáneas (la presencia y el registro de revisión siguen activos); la consola indica el motivo.
collabTextNamerichtextbox.bodyEl nombre del texto compartido de Yjs que usa la sincronización por instantáneas. Da a cada editor de un mismo documento de Yjs su propio nombre.
aiToolkitEnabledtrueEl plugin AI Toolkit. Establece false para desactivarlo: sin botones, menús ni cuadros de diálogo de IA. Consulta AI Toolkit.
aiToolkitResolvernullLa función a la que llama el AI Toolkit para acceder a tu servicio de IA (con tu propia clave o endpoint); editor.aiToolkit.setResolver(fn) la establece en tiempo de ejecución. Sin ella, el toolkit funciona en modo de demostración. La página del AI Toolkit describe la solicitud y la respuesta.
aiToolkitAgentnullLa función que usa editor.aiToolkit.runAgent(prompt) para planificar y aplicar ediciones de varios pasos; setAgent(fn) la establece en tiempo de ejecución. Sin ninguna, runAgent se rechaza con un mensaje que lo indica.
aiToolkitAutoToolbarButtonstrueAñade automáticamente los botones de IA a las barras de herramientas. Establece false para colocar los comandos de IA en tu propia cadena de barra de herramientas.
aiToolkitActions(lista integrada)Las acciones del menú de IA: un array de { id, section, icon, title, description }. Sustitúyelo para mostrar tu propio conjunto.
aiToolkitDialogModes(lista integrada)Los modos del cuadro de diálogo Ask AI (Proofread, Rewrite, Translate...): un array de { id, title, description }.
aiToolkitChatPrompts(lista integrada)Los prompts iniciales que ofrece AI Chat: un array de { id, label, prompt }.
aiToolkitTranslateLanguages(español, francés, alemán, italiano...)Los idiomas que ofrece Translate: un array de { value, label }.
aiToolkitOperationHandlersControladores para los tipos de operación que puede contener una respuesta de IA, por tipo: { myType: function (operation, context) { ... } }; devuelve true cuando el controlador aplicó la operación. editor.aiToolkit.registerOperationHandler() añade uno en tiempo de ejecución.
aiToolkitPersistenceKey(vacío)Una clave para este documento. Si la defines, el estado de la revisión de IA (sugerencias y decisiones) se guarda en el localStorage del navegador con la clave RTE.AIToolkit.<key>, así que sobrevive a una recarga; también identifica el documento ante aiToolkitSuggestionLedgerUrl. Vacío: no se guarda nada.
aiToolkitReviewLogUrl(vacío)Una URL de tu servidor que recibe cada decisión de revisión de IA como un POST con JSON, para un registro de auditoría. Vacío: no se envía nada.
aiToolkitSuggestionLedgerUrl(vacío)Una URL de tu servidor que recibe las sugerencias de IA del documento y sus estados como un POST con JSON, para poder compartirlos o restaurarlos; necesita aiToolkitPersistenceKey. Vacío: no se envía nada.
aiToolkitReviewSyncInterval15000Cada cuánto se sincroniza el estado de la revisión con tu servidor, en milisegundos (como mínimo 5000).
collabLedgerMapNamereviewLedgerEl nombre del mapa compartido de Yjs que transporta los comentarios, las sugerencias y las decisiones de revisión de IA entre los pares.
onCollabStatusnullSe llama con { attached, textSyncMode, requestedTextSync, fallbackReason, yjsBridge, peerCount } cuando empieza una sesión, para que puedas mostrar qué modo está en vigor (por ejemplo, el paso de CRDT a instantáneas). El mismo objeto lo devuelve editor.collab.getStatus().
imageHoverQuickBartrueAl pasar el ratón por encima de una imagen en el editor aparece sobre ella una pequeña barra de acciones de imagen. Establece false para ocultarla.
imageLazyLoadtrueLas imágenes que inserta el editor (desde una URL, una carga o al soltarlas) reciben loading="lazy" y decoding="async", para que un documento largo no cargue todas las imágenes a la vez. Establece false para insertar imágenes sin ellos.
indentUseMargintrueAumentar y reducir sangría en un párrafo o un encabezado cambia su margen, como hace Word (margin-left en texto de izquierda a derecha). Establece false para cambiar en su lugar su relleno. El incremento es indentation.
inlineMathtruePermite que editor.applyMathMarkup() envuelva los fragmentos $...$ en <span class="rte-math-inline" data-tex="...">, para que un renderizador matemático como KaTeX o MathJax las dibuje. No ocurre nada hasta que lo llamas. Establece false y la llamada no cambia nada.
placeholderShowOnlyWhenEditabletrueOculta el placeholder mientras el editor es de solo lectura (readOnly o setReadOnly(true)) o está en el modo de solo comentarios, y vuelve a mostrarlo cuando se permite editar. Establece false para mostrarlo también en un editor de solo lectura. (En 2.6.11 y anteriores, un editor de solo lectura lo seguía mostrando).
showFloatLinkUrlPreviewtrueCuando el cursor está en un enlace, la barra de herramientas flotante de enlaces empieza con la dirección del enlace, que se abre en una pestaña nueva al hacer clic. Establece false para mostrar solo los botones de la barra.
smartPasteToasttrueDespués de limpiar un pegado desde Word o Google Docs, un breve aviso lo indica. Establece false para limpiar sin avisar.
tableColumnResizetrueAl apuntar al borde entre dos columnas de una tabla aparece una indicación de redimensionamiento; arrástrala para cambiar el ancho de la columna. Establece false para desactivar el cambio de ancho de columnas arrastrando.
tableRowResizetrueAl apuntar al borde inferior de una fila de tabla aparece una indicación de redimensionamiento; arrástrala para cambiar el alto de la fila. Establece false para desactivar el cambio de alto de filas arrastrando.
aiContextMenutrueCon el AI Toolkit cargado, hacer clic con el botón derecho en un texto seleccionado (tres caracteres o más) abre un menú de acciones de IA sobre ese texto. Establece false para conservar el menú propio del navegador.
wordExportFileName(ninguno)Nombre base del archivo para editor.exportToWord() (un .doc compatible con Word) cuando no se pasa ningún nombre. Si no se define, se usa el texto del primer encabezado h1-h3, o "document".
wordExportFontFamilyCalibri, 'Segoe UI', Arial, sans-serifFuente del cuerpo de la exportación a .doc. Una opción pasada a exportToWord() tiene prioridad.
wordExportFontSize11ptTamaño de la fuente del cuerpo de la exportación a .doc.
wordExportPageSize8.5in 11inTamaño de página de la exportación a .doc, como un tamaño CSS de @page (US Letter de forma predeterminada; "21cm 29.7cm" para A4). Tiene prioridad la configuración de página que ya lleve el documento (vista de página).
wordExportMargin1inMárgenes de página de la exportación a .doc, como una longitud CSS o una forma abreviada. Tiene prioridad la configuración de página que lleve el documento.
wordExportLandscapefalsePáginas en horizontal en la exportación a .doc. Tiene prioridad la configuración de página que lleve el documento.
docxExportFileName(ninguno)Nombre base del archivo de la exportación a .docx cuando no se pasa ningún nombre. Si no se define, es Export- seguido de la fecha y la hora (YYMMDD-HHMMSS, p. ej., Export-261026-153045.docx).
docxExportTitle(ninguno)El título guardado en las propiedades del archivo .docx. Si no se define, el document.title de la página, o "Document".
docxExportAuthorRichTextEditorEl autor guardado en las propiedades del archivo .docx.
pdfExportFileName(ninguno)Nombre base del archivo de la exportación a PDF cuando no se pasa ningún nombre. Si no se define, es Export- seguido de la fecha y la hora (YYMMDD-HHMMSS).
pdfExportTitle(ninguno)El título guardado en los metadatos del PDF. Si no se define, el document.title de la página, o "Document".
pdfExportAuthor(vacío)El autor guardado en los metadatos del PDF.
pdfExportFonthelveticaLa fuente de la exportación a PDF vectorial (plugin pdfexport): "helvetica", "times" o "courier", las fuentes estándar de PDF, que no necesitan incrustarse. Solo cubren el alfabeto latino de Europa occidental; consulta pdfExportRasterFallback.
pdfExportBaseFontSize11El tamaño del texto del cuerpo del PDF vectorial, en puntos; los encabezados se escalan a partir de él.
pdfExportHeader(ninguno)Texto simple centrado en la parte superior de cada página del PDF vectorial; {page} y {total} se convierten en el número de página y el número total de páginas. Si no se define, el texto del encabezado de página del documento (vista de página), si lo hay.
pdfExportFooter(ninguno)Texto simple centrado en la parte inferior de cada página, con los mismos {page} y {total}.
pdfExportRasterFallbacktrueCuando un documento tiene caracteres que el PDF vectorial no puede codificar (cualquier cosa fuera del alfabeto latino de Europa occidental: chino, japonés, coreano, cirílico, griego, árabe...), exportToPdf() y el Export PDF de la barra de herramientas usan en su lugar la exportación rasterizada html2pdf, que dibuja cualquier sistema de escritura, y lo indican en la consola. editor.getPdfUnsupportedText() enumera esos caracteres. Establece false para escribir siempre el PDF vectorial; esos caracteres se imprimen entonces como "?". En 2.6.11 y anteriores siempre se imprimían como "?".
pdfExportUnicodeFont(ninguno)Los bytes de una fuente TrueType (.ttf, como ArrayBuffer o Uint8Array) para el texto que no pueden dibujar las fuentes estándar: chino, japonés, coreano, cirílico, griego... Con ella, el PDF vectorial incrusta los glifos que usa el documento (unos cientos de KB incluso con una fuente CJK grande) y ese texto sigue siendo seleccionable y se puede buscar; sin ella, consulta pdfExportRasterFallback. editor.loadPdfFont(url) descarga una fuente que sirves tú y la establece aquí; no se descarga nada a menos que lo llames. Los archivos CFF (.otf) y de colección (.ttc) se rechazan con un mensaje en la consola.
mentionTrigger@El carácter que abre la lista de menciones (plugin de menciones). La lista solo funciona cuando está definido mentionStaticList o mentionSource.
mentionStaticListnullUna lista fija de personas para el activador predeterminado: un array de { id, label (or name), subtitle (or email) }. Al escribir después del activador, se filtra por la etiqueta, el subtítulo y el id, sin distinguir mayúsculas y minúsculas; sin nada escrito se muestran los 50 primeros.
mentionSourcenullUna función que proporciona la lista para el activador predeterminado: (query, { trigger }) => un array de elementos, o una Promise de uno. Tiene prioridad sobre mentionStaticList. Para más activadores, usa mentionTriggers o editor.mentions.register().
mentionTriggersnullActivadores adicionales, cada uno { trigger, source (or search), insertClass, label, renderItem, renderInsert }, por ejemplo # para etiquetas. Se aceptan callbacks search(query, done) y funciones asíncronas. Un activador sin source ni search se omite con una advertencia en la consola.
mentionMaxItems8El número máximo de resultados que muestra la lista.
mentionDebounceMs150Cuánto tiempo, en milisegundos, debe pausarse la escritura antes de volver a consultar la fuente. Justo después del activador (sin nada escrito todavía), se consulta de inmediato.
mentionInsertClassrte-mentionLa clase del elemento de mención insertado. Un activador puede definir su propio insertClass.
slashCommandTrigger/La tecla que abre el menú de comandos de barra (plugin de comandos de barra), escrita al principio de una línea o después de un espacio, y nunca dentro de código ni de pre.
slashCommandMaxItems40El número máximo de comandos que muestra a la vez el menú de barra.
documentOutlineEnabledtrueEl panel de esquema del documento (plugin documentoutline): una lista de los encabezados del documento para saltar entre ellos. Establece false para no tener botón Outline en la barra de herramientas ni panel.
documentOutlineAutoOpenfalseAbre el panel de esquema cuando arranca el editor.
documentOutlineMinLevel1El nivel de encabezado más alto que incluye el esquema (de 1 a 6).
documentOutlineMaxLevel6El nivel de encabezado más bajo que incluye el esquema (de 1 a 6, no por encima de documentOutlineMinLevel).
documentOutlineTitle"Outline" (traducido)El título y el nombre accesible del panel. Si no se define, se usa el texto del paquete de idioma.
documentOutlineHint(texto traducido)La línea bajo el título del panel.
documentOutlineEmptyText(texto traducido)Lo que dice el panel cuando el documento no tiene encabezados.
contentMinimapEnabledtrueEl panel de minimapa (plugin contentminimap): una pequeña vista previa de todo el documento para hacer clic y saltar. Establece false para no tener botón Minimap en la barra de herramientas ni panel.
contentMinimapAutoOpenfalseAbre el panel de minimapa cuando arranca el editor.
contentMinimapWidth168El ancho del panel en píxeles (como mínimo 148).
contentMinimapScale0.14Lo pequeño que dibuja el documento la vista previa (0.14 = 14% de su tamaño).
contentMinimapTitle"Minimap" (traducido)El título y el nombre accesible del panel.
contentMinimapHint(texto traducido)La línea bajo el título del panel.
contentMinimapEmptyText(texto traducido)Lo que dice el panel mientras el documento está vacío.
accessibilityCheckerEnabledtrueEl panel del comprobador de accesibilidad (plugin accessibilitychecker), que enumera problemas como niveles de encabezado saltados, imágenes sin texto alternativo y tablas sin encabezados, con reparaciones. Establece false para no tener botón en la barra de herramientas ni panel.
accessibilityCheckerAutoOpenfalseAbre el panel del comprobador de accesibilidad cuando arranca el editor.
accessibilityCheckerTitle"Accessibility" (traducido)El título y el nombre accesible del panel.
accessibilityCheckerHint(texto traducido)La línea bajo el título del panel.
accessibilityCheckerEmptyText(texto traducido)Lo que dice el panel cuando no encuentra problemas.
contentAriaLabel(ninguno)El nombre accesible del área de edición y el título del marco del editor (plugin a11yenhance), seguido de la indicación de Escape, p. ej., "Article body Press Escape to leave the editing area.". Si no se define, el "Rich text editor. Editing area." del paquete de idioma. Da a cada editor de una página su propio nombre.
contentLabel(ninguno)Se usa como contentAriaLabel cuando ese no está definido.
a11yEditorLabel(ninguno)Se usa como nombre del área de edición cuando no están definidos ni contentAriaLabel ni contentLabel (plugin keyboarda11y). En 2.6.11 y anteriores no tenía efecto con el bundle de plugins cargado.
a11yEscapeHint"Press Escape to leave the editing area." (traducido)Las palabras que se añaden tras el nombre del área de edición e indican a los usuarios de teclado cómo salir del editor.
contentLang(el lang de la página)El lang del documento de edición, para la corrección ortográfica y la pronunciación de los lectores de pantalla. Si no se define, sigue el <html lang> de la página anfitriona, o en.
a11yReadOnlySuffix"Read only."Lo que se comunica a los lectores de pantalla cuando el editor pasa a solo lectura.
a11yEditableAgain"Editing enabled."Lo que se comunica a los lectores de pantalla cuando el editor deja el modo de solo lectura.
a11yRovingToolbartrueLa barra de herramientas es una sola parada de tabulación y las teclas de flecha se mueven entre sus botones (el patrón de barra de herramientas de ARIA). Establece false para que cada botón sea su propia parada de tabulación.
commentHighlightBg#fff9c4Color de fondo del texto comentado (plugin de comentarios).
commentHighlightBorder#f9a825Color de la línea bajo el texto comentado.
trackChangesInsertClassrte-tc rte-tc-insertClase del elemento que envuelve una inserción sugerida (modo de sugerencias). Cámbiala para dar a las sugerencias tu propio estilo.
trackChangesDeleteClassrte-tc rte-tc-deleteClase del elemento que envuelve una eliminación sugerida.
onReviewDecisionDeniednullSe llama con { entry, action, user } cuando reviewCanDecide rechaza el Accept o el Reject de alguien, para que puedas decirle por qué.
reviewCanDecidenullUna función (entry, action, user, editor) que decide si este usuario puede aceptar o rechazar una sugerencia; devuelve false para rechazarlo. Si lanza una excepción, la decisión se rechaza.
restrictedEditingModefalseBloquea el documento salvo las regiones marcadas con data-rte-editable="true" (plugin de edición restringida), como un formulario de Word con campos para rellenar. editor.restrictedEditing marca regiones, activa y desactiva el bloqueo y se mueve entre las regiones.
pageHeaderHtml(vacío)HTML que se repite en la parte superior de cada página en la vista de página (plugin pagination); {page} y {total} se convierten en el número de página y el número total de páginas. Tiene prioridad un encabezado definido en la configuración de página del documento.
pageFooterHtml(vacío)HTML que se repite en la parte inferior de cada página en la vista de página, con los mismos {page} y {total}.
readabilityWordsPerMinute200Velocidad de lectura que se usa para estimar el tiempo de lectura (plugin de estadísticas de legibilidad).
maxLength0El número máximo de caracteres que puede tener el documento (plugin de límite de caracteres); 0 significa sin límite.
maxWords0El número máximo de palabras que puede tener el documento; 0 significa sin límite.
charLimitEnforcetrueImpide escribir y pegar más allá de maxLength / maxWords. Establece false para solo contar e informar (editor.isOverLimit(), el evento charlimit).
charLimitShowCountertrueMuestra el contador flotante mientras haya un límite definido.
sanitizerAllowTags[]Nombres de elementos adicionales que conserva el saneador de contenido (plugin sanitizer): nombres exactos, comodines "x-*" o expresiones regulares, p. ej., ["custom-el", "x-*", /^ui-/]. Los scripts y otros elementos ejecutables nunca se conservan.
sanitizerAllowAttributes[]Nombres de atributos adicionales que conserva el saneador, con las mismas formas, p. ej., ["data-cms-*"]. Los atributos de controladores de eventos (on*) nunca se conservan.
sanitizerAllowStyleTagsfalseConserva los elementos <style> dentro del contenido. Desactivado de forma predeterminada: un bloque de estilo en un documento cambia el estilo de la página en la que se muestra.
sanitizerGuardLiveDomtrueVigila también la propia área de edición y vuelve a limpiarla cuando aparece en ella contenido ejecutable por cualquier vía (scripts, atributos on*, URL javascript:), no solo al pegar y con setHTMLCode(): contenido que llega por la sincronización de la colaboración, por otro script de la página o por una extensión del navegador. Establece false para limpiar solo lo que pasa por las vías propias del editor. El saneador se ejecuta en el navegador; comprueba también el contenido en tu servidor.
documentImportModereplaceQué hace importar un archivo (plugin de importación de documentos): "replace" sustituye el documento o "insert" inserta en la posición del cursor. Sustituir es un solo paso de deshacer.
documentImportAccept.md,.markdown,.html,.htm,.txt,.doc,.docxLos tipos de archivo que ofrece el cuadro de diálogo de importación.
documentImportImagestrueIncorpora las imágenes de un .docx importado como URI data. Establece false para omitirlas en archivos con muchas imágenes.
documentImportResolver(ninguno)Una función (file) => que devuelve HTML (o una Promise de él) para convertir tú mismo un archivo, por ejemplo en tu servidor. Devuelve una cadena para encargarte tú; cualquier otra cosa, o una Promise rechazada, recurre al lector integrado.
dictationEnabledfalseActiva el dictado (plugin de dictado): la voz se escribe en el documento mediante el reconocimiento de voz del navegador (Web Speech API). Desactivado de forma predeterminada. En algunos navegadores, como Chrome, el reconocimiento se ejecuta en los servidores del fabricante del navegador, así que el audio sale del dispositivo del usuario; comprueba que eso es aceptable antes de activarlo.
dictationLang(el idioma del navegador)El idioma que se reconoce, como una etiqueta BCP-47, por ejemplo en-US. Si no se define, navigator.language.
dictationContinuoustrueSigue escuchando a través de las pausas. Establece false para detenerse después de una sola frase.
dictationInterimResultstrueMuestra la transcripción parcial mientras el usuario sigue hablando.
dictationAutoPunctuationtruePone en mayúscula la primera letra de cada frase dictada y la termina con un punto cuando no tiene puntuación propia.
commentsEnabledtrueEl plugin de comentarios (comentarios en línea, respuestas, resolver). Establece false para desactivarlo.
trackChangesEnabledtrueEl plugin de control de cambios (modo de sugerencias, aceptar y rechazar). Establece false para desactivarlo.
currentUsernull{ id, name, color }: quién está editando. Los comentarios, las sugerencias, el historial de revisiones y la colaboración registran a esta persona como autor; defínelo siempre que conozcas al usuario.
mentionEnabledtrueEl plugin de menciones. Establece false para desactivarlo. Las menciones solo aparecen cuando hay una fuente definida (mentionStaticList, mentionSource o mentionTriggers).
slashCommandEnabledtrueEl menú de comandos de barra (plugin de comandos de barra). Establece false para desactivarlo.
slashCommandIncludeAitrueIncluye las acciones del AI Toolkit en el menú de barra cuando el AI Toolkit está cargado. Establece false para dejarlas fuera.
slashCommandsnullComandos adicionales para el menú de barra, registrados al arrancar: un array de { id, section, title, description, keywords, iconSvg, run }, como el que recibe editor.slashCommands.register().
galleryEndpoint(ninguno)Una URL a la que el cuadro de diálogo de la galería pide carpetas e imágenes (plugin insertgallery). Devuelve { currentFolder, currentFolderDisplay, parentFolder, folders: [{ folder, name }], images: [{ url, name, folder, size, source, alt }] }. Si no se define, la galería solo muestra galleryImages y no hace ninguna solicitud.
nodeTypesEnabledtrueEl registro de tipos de nodo personalizados (plugin nodetypes). Establece false para desactivarlo.
nodeTypes(ninguno)Tipos de nodo que se registran al arrancar, tal como los recibe editor.nodeTypes.register(): { name, match, inline, atomic, toJSON, fromJSON, toMarkdown }. Un elemento registrado conserva su marcado al pasar por el saneador y recibe la forma en Markdown que elijas en lugar de quedarse en su texto.
rubyAnnotationEnabledtrueAnotaciones ruby (plugin rubyannotation): guías de lectura sobre el texto de Asia oriental, escritas como <ruby> con <rt>. Establece false para desactivarlas.
rubyAnnotationParenthesestrueEscribe paréntesis <rp> alrededor de cada lectura, para que un lector sin compatibilidad con ruby muestre "base(reading)" en lugar de juntar las dos.
stateInspectorEnabledtrueEl inspector de estado (plugin stateinspector): un panel para desarrolladores que muestra la estructura del documento, los problemas estructurales y una instantánea que se puede copiar para los informes de errores. Establece false para desactivarlo.
stateInspectorToolbarButtonfalseAñade un botón a la barra de herramientas que abre el inspector de estado. Desactivado de forma predeterminada; ábrelo con editor.stateInspector.open().
stateInspectorAutoOpenfalseAbre el inspector de estado cuando arranca el editor.
stateInspectorLogLimit60Cuántos eventos recientes del editor conserva el inspector (de 10 a 500).
stateInspectorMaxDepth24Hasta qué profundidad recorre el inspector el árbol del documento (como mínimo 2).
stateInspectorTitleState inspectorEl título del panel.
stateInspectorHint(texto)La línea bajo el título del panel.
stateInspectorEmptyTextNo content to inspect yet.Lo que dice el panel mientras el documento está vacío.
NombrePredeterminadoDescripción
paragraphItemsNormal,H1,H2,H3,H4,H5,H6Un conjunto predefinido de bloques de formato.
fontSizeItems8,9,10,11,12,13,14,16,
18,24,36,48,60,72,96
Un conjunto predefinido de tamaños de fuente.
fontNameItemsArial,Arial Black,Comic Sans MS,
Courier New,Tahoma,Georgia,Helvetica,
Segoe UI,Sans-Serif,Impact,
Times New Roman,Verdana
Un conjunto predefinido de nombres de fuente.
lineHeightItems100%,150%,200%,250%,300%,
350%,400%,450%,500%,600%
Un conjunto predefinido de valores de interlineado.
inlineStyles[["Red", "color:red", "color:red"],
["Bold", "font-weight:bold", "font-weight:bold"],
["Mark", "my-cls-mark"],
["Warning", "my-cls-warning"]]
Estilos CSS predeterminados para la lista desplegable de estilos en línea.
[texto, estilo css, estilo de visualización]
paragraphStyles[["Red", "color:red"],
["Bold", "font-weight:bold"],
["Quote", "my-cls-quote"],
["Large Center", "my-cls-largecenter"]]
Estilos CSS predeterminados para la lista desplegable de estilos de párrafo.
[texto, estilo css, estilo de visualización]
imageStyles[["Border", "border:solid 1px gray"],
["Shadow", "box-shadow:0 0 8px gray"],
["Margin10", "margin:10px"],
["Padding:10", "padding:10px"]]
Estilos CSS predeterminados para la lista desplegable de estilos de imagen.
[texto, estilo css]
linkStyles[["Margin10", "margin:10px"],
["Padding:10", "padding:10px"],
["BigText", "font-size:36px"]]
Estilos CSS predeterminados para la lista desplegable de estilos de enlace.
[texto, estilo css]
galleryImages[]Imágenes predefinidas para el cuadro de diálogo de la galería: una URL, [url, text] o { url, name, alt }. Vacío de forma predeterminada (hasta 2.6.11 incluía seis imágenes de ejemplo de richtexteditor.com, que se descargaban de nuestro servidor cada vez que se abría la galería). Consulta galería de imágenes.
htmlTemplates[]Las plantillas que ofrece el cuadro de diálogo Insert Template: [title, html] o { title, html, description }. Vacío de forma predeterminada (hasta 2.6.11 incluía dos plantillas de demostración llamadas ambas "My Doc 1"); si no hay ninguna, el cuadro de diálogo lo indica.
characterItemsUn conjunto predefinido de caracteres.
foreColorItemsUn conjunto predefinido de colores de texto.
backColorItemsUn conjunto predefinido de colores de fondo.
linkItems[]Direcciones que sugiere el cuadro de diálogo Insert Link, p. ej., ["/about", "/contact"]. Vacío de forma predeterminada (hasta 2.6.11 sugería cinco sitios de grandes empresas); sin elementos, la flecha de sugerencias se oculta.
imageItems[]Direcciones que sugiere el cuadro de diálogo Insert Image (por URL). Vacío de forma predeterminada; sin elementos, la flecha se oculta.

Opciones de los plugins

Las opciones de arriba configuran el core del editor. Todo lo de abajo lo aportan los plugins incluidos en richtexteditor/plugins/. Se definen de la misma manera: en el objeto de opciones del constructor, o de forma global en RTE_DefaultConfig antes de crear un editor.

Vista previa de compilaciones desde el código fuente: opciones de plugins más recientes

Estas opciones existen en los plugins actuales del código fuente, pero no se incluyen en todos los bundles publicados ni en los recursos de demo actuales de este sitio. Usa una compilación de plugins probada que corresponda; definir una opción no añade una función que falta a un runtime más antiguo.

OpciónPredeterminadoDescripción
aiToolkitImageResolvernullCompilaciones con generación de imágenes: (prompt: string) => Promise<string>. Tu resolver devuelve una URL de imagen HTTPS o una URL data de imagen PNG/JPEG/WebP/GIF, de 6,000,000 caracteres como máximo. El plugin no llama por sí solo a ningún proveedor. Mantén las credenciales del proveedor en tu servidor; aplica tu política de carga y almacenamiento antes de guardar las imágenes generadas.
galleryAcceptedExtensionsnullCompilaciones con galería: un array como [".jpg", ".png"] que sustituye los formatos que indica y permite el cuadro de diálogo Insert Gallery. Establécelo en lo que acepte tu endpoint de carga.
commentMentions[]Compilaciones con menciones en comentarios: [{ id, name }] proporciona las personas que se sugieren después de @ en el editor de comentarios. El id y el nombre de la persona elegida se guardan con el comentario. Es una lista de sugerencias, no un servicio de autorización ni de notificaciones o correo electrónico; tu aplicación debe proporcionarlos por separado.
tableRowDragtrueCompilaciones con arrastre de filas: establécelo en false antes de crear el editor para ocultar los tiradores de arrastre de filas. Las filas de encabezado se quedan fijas. Las tablas con celdas combinadas o irregulares, el contenido de solo lectura o solo comentarios y el modo de sugerencias rechazan los movimientos no admitidos; mover una fila no se registra como sugerencia. Escape cancela un arrastre.
tableColumnDragtrueCompilaciones con arrastre de columnas: establécelo en false antes de crear el editor para ocultar los tiradores de arrastre de columnas. Mueve las celdas de todas las filas junto con el ancho de la columna; una columna de números de fila se queda la primera. Las tablas con celdas combinadas o irregulares y el modo de solo lectura, solo comentarios o sugerencias rechazan los movimientos no admitidos. Escape cancela un arrastre.

IA

Todas las interfaces de IA son BYOK: el editor llama a una función que proporcionas tú y nunca se comunica por sí mismo con un proveedor.

OpciónPredeterminadoDescripción
ghostTextfalseActiva el autocompletado en línea con texto gris. Tab acepta y Esc descarta.
ghostTextResolvernullasync ({ before }) => string. Es necesario para que ghostText haga algo.
aiToolkitReviewLegacyLayouttrueUsa el diseño anterior del panel AI Review.
aitoolkit_skip_auto_csstrueOmite la inyección automática de la hoja de estilos del AI Toolkit cuando distribuyes la tuya.

Ayudas para escribir y redactar

Comportamientos que actúan mientras el autor escribe. Todos se pueden desactivar por separado.

OpciónPredeterminadoDescripción
autocorrectEnabledtrueInterruptor general del plugin de autocorrección. No desactiva la tipografía inteligente del core del editor; consulta smartTypography.
autocorrectCapitalizetruePone en mayúscula la primera letra de una frase.
autocorrectSpellingtrueAplica la lista integrada de faltas de ortografía habituales.
autocorrectTypographytrueComillas tipográficas, rayas y puntos suspensivos del plugin de autocorrección. El core del editor hace por su cuenta las mismas sustituciones; para detenerlas, establece smartTypography en false.
autocorrectReplacementsnullTu propio mapa de sustituciones { from: to }, combinado con los integrados.
emojiAutocompleteEnabledtrueEscribe :shortcode: para insertar un emoji.
emojiShortcodes{ … }Sustituye o amplía el mapa de códigos cortos a emojis.
foldHeadingsEnabledtrueEncabezados plegables en la superficie de edición.
typewriterModeEnabledfalseMantiene anclada verticalmente la línea del cursor mientras se escribe.
typewriterAnchor0.5Dónde se sitúa la línea del cursor, de 0 (arriba) a 1 (abajo).
focusModeEnabledfalseAtenúa todos los bloques salvo el que contiene el cursor.
dragHandleEnabledtrueMuestra el tirador de arrastre de bloques en el margen.
dragHandleKeyboardtruePermite reordenar bloques con el teclado (Alt+Up / Alt+Down).
formattingMarkPilcrowtrueMuestra calderones cuando las marcas de formato están activadas.
formattingMarkBlockstrueMarca el contorno de los bloques cuando las marcas de formato están activadas.
formattingMarkInvisiblestrueMuestra los espacios, las tabulaciones y los espacios de no separación.
permanentPenClass"rte-pen"Clase que se aplica al texto del bolígrafo permanente.
permanentPenStyle{ … }Objeto de estilo en línea para el texto del bolígrafo permanente.
titleCaseSmallWords"a an and as at …"Palabras que Change Case → Title Case deja en minúscula.
formatPainterProperties[ … ]Qué propiedades CSS copia la herramienta de copiar formato.
readabilityStatstrueMuestra estadísticas de facilidad de lectura en la barra de estado.
localDraftfalseGuarda un borrador local para que el contenido sobreviva a una recarga accidental.

Bloques, estructura y referencias

Contenido estructural: recuadros destacados, columnas, listas numeradas, notas al pie, referencias cruzadas y una tabla de contenido.

OpciónPredeterminadoDescripción
text_inlinecode"Inline code"Etiqueta de la barra de herramientas e información sobre herramientas del botón de código en línea (comando "inlinecode", emite un elemento <code> simple).
calloutTypes[ … ]Tipos de recuadro destacado disponibles (info, warning, …).
calloutDefaultType"info"Tipo de recuadro destacado que se inserta cuando no se elige ninguno.
columnsDefaultCount2Columnas que crea el bloque de columnas.
legalListClass"rte-legal-list"Clase que se aplica a las listas de estilo legal de varios niveles.
legalListSeparator"."Separador entre los números de nivel (1.1.1).
legalListSuffix"."Carácter final después del último nivel.
lineNumberStart1Primer número de línea.
lineNumberInterval1Muestra el número de línea cada N líneas.
lineNumberRestart"continuous""continuous" o reinicio en cada página.
lineNumberGutter38Ancho del margen en píxeles.
footnotesTitle"Footnotes"Encabezado que se muestra sobre la lista de notas al pie.
footnotesNumbering"decimal"Estilo de marca para la numeración de las notas al pie.
footnotesMarkerPrefix""Texto antes de cada marca de nota al pie.
footnotesMarkerSuffix""Texto después de cada marca de nota al pie.
crossRefFigureLabel"Figure"Etiqueta que se usa al hacer referencia a una figura.
crossRefTableLabel"Table"Etiqueta que se usa al hacer referencia a una tabla.
crossRefMissingText"[reference not found]"Se muestra cuando el destino de una referencia cruzada ya no existe.
tocTitle"Contents"Encabezado de la tabla de contenido generada.
tocMinLevel1Nivel de encabezado más superficial que se incluye.
tocMaxLevel3Nivel de encabezado más profundo que se incluye.
tocPageNumbers"auto"Muestra los números de página en la tabla de contenido.
mathDialogSamples[ … ]Ecuaciones iniciales que se ofrecen en el cuadro de diálogo de ecuaciones.
tableNumberSeries"numeric"Serie de numeración de los números de fila de las tablas.
tableNumberHeader"#"Texto del encabezado de la columna de números de fila.

Diseño de página, exportación e importación

Todo lo que convierte el documento en un archivo o en una página impresa. La exportación se ejecuta en el navegador; no se sube nada.

OpciónPredeterminadoDescripción
paginationEnabledfalseMuestra el documento en páginas separadas.
pageFormat"A4"Tamaño de página que usan la paginación y la exportación.
pageOrientation"portrait""portrait" o "landscape".
pageMargins{ top: 1, right: 1, bottom: 1, left: 1 }Márgenes en pulgadas.
paginationShowPageNumberstrueMuestra los números de página en la vista de página.
paginationShowPageCounttrueMuestra "of N" junto a los números de página.
docxExporttrueActiva la exportación a .docx (generada en el navegador, sin servidor).
wordExporttrueActiva la exportación a HTML compatible con Word.
documentImporttrueActiva la importación de .docx.
pdfExporttrueActiva la exportación a PDF vectorial y etiquetado.
html2pdfScriptUrlnullRuta de html2pdf para el PDF rasterizado; omítela para quedarte solo con el vectorial.
markdownExportEnabledtrueActiva Copiar / Descargar como Markdown.
emailWrapWidth640Ancho de tabla que usa la exportación a HTML para correo electrónico.
emailInlineProperties[ … ]Propiedades CSS que se incrustan en línea en los elementos para los clientes de correo electrónico.
watermarkText"DRAFT"Texto de la marca de agua.
watermarkImagenullMarca de agua de imagen; sustituye la marca de agua de texto.
watermarkMode"tile""tile" o una sola marca centrada.
watermarkOpacity0.18Opacidad de la marca de agua, de 0 a 1.
watermarkAngle-30Rotación en grados.
watermarkColor"#94a3b8"Color de la marca de agua.
watermarkFontSize48Tamaño de fuente de la marca de agua en píxeles.
watermarkPrintfalseIncluye la marca de agua al imprimir.

Los resolvers te permiten proporcionar tu propia fuente de datos. Cada uno es una función simple, así que tu endpoint y tus credenciales siguen siendo tuyos.

OpciónPredeterminadoDescripción
autoEmbedEnabledtrueConvierte una URL pegada de YouTube o Vimeo en un contenido incrustado adaptable.
autoEmbedResolvernull(url) => URL de inserción https, o null para rechazarla. Añade tus propios proveedores.
bookmarkResolvernull(url) => metadatos para las tarjetas de vista previa de enlaces.
bookmarkFaviconService"/favicon-proxy?domain="Endpoint de favicons para las tarjetas de marcadores. Apúntalo a tu propio proxy.
diagramResolvernullProporciona un renderizador de Mermaid; no se incluye ninguno.
diagramSamples[ … ]Diagramas iniciales que se ofrecen en el cuadro de diálogo de inserción.
drawingWidth640Plugin de dibujo (drawing.js, próxima versión): ancho del lienzo en píxeles CSS.
drawingHeight360Plugin de dibujo (próxima versión): alto del lienzo en píxeles CSS.
drawingColors[6 colours]Plugin de dibujo (próxima versión): las muestras de color que se ofrecen para el bolígrafo y el marcador.
text_insertdrawing"Drawing"Plugin de dibujo (próxima versión): etiqueta del botón insertdrawing en la barra de herramientas.
chipResolvernull(query) => elementos de etiquetas inteligentes.
chipDateFormatnullCadena de formato para las etiquetas de fecha.
mergeFields[ … ]Campos de combinación disponibles.
mergeFieldPrefix"{{"Delimitador de apertura.
mergeFieldSuffix"}}"Delimitador de cierre.
mergeFieldMissing"placeholder"Qué mostrar cuando un campo no tiene valor.

Idioma, dirección y accesibilidad

El editor incluye 67 idiomas. Además, se pueden configurar la dirección y el comportamiento de accesibilidad.

OpciónPredeterminadoDescripción
defaultTextDirectionnull"ltr", "rtl" o null para heredar.
textDirectionAutoDetectfalseDetecta la dirección a partir del texto que se escribe.
textDirectionSwapAligntrueRefleja la alineación cuando se invierte la dirección.
rtlUserInterface"auto"Refleja la barra de herramientas y los cuadros de diálogo para las configuraciones regionales RTL.
a11yEnhancetrueNombres y roles accesibles en la interfaz del editor.
dialogA11ytrueRetención del foco y etiquetado dentro de los cuadros de diálogo.
keyboardA11ytrueTabindex itinerante en las barras de herramientas para que Tab salga del editor.
readAloudRate1.0Velocidad de la voz para la lectura en voz alta.
readAloudHighlighttrueResalta el texto a medida que se lee.
textPartLanguages24 languagesIdiomas que ofrece la lista desplegable Language: [{ code, label, dir }]. WCAG 3.1.2.
textPartLanguageHighlighttrueSubrayado de puntos en las frases marcadas mientras se edita. Solo en el editor; nunca se serializa.

Superficie de edición y regiones

Llegar a posiciones que no tienen ningún nodo que pueda contener el cursor, y controlar varias regiones editables desde una sola barra de herramientas.

OpciónPredeterminadoDescripción
gapCursorKeystrueLas flechas, Home y End salen de una tabla u otro bloque que retiene el cursor en un borde del documento.
gapCursorClicktrueHaz clic en el espacio en blanco alrededor del contenido para insertar ahí un párrafo.
gapCursorHinttrueMuestra una indicación de inserción en un límite de altura cero entre dos bloques.
multiRootGroupnullLas instancias que comparten este nombre de grupo funcionan como un solo editor con una única barra de herramientas visible.
multiRootNamecontainer idEl nombre de esta región en la API del grupo (getHTML, focusRoot, …).
multiRootToolbarHostnullElemento (o su id) al que se mueve la barra de herramientas activa. null la deja donde está.
layoutTableOutlinetrueContorno discontinuo alrededor de las tablas de diseño mientras se edita. Una tabla marcada con role="presentation" es invisible por diseño; esta es la única forma de ver lo que estás editando. Solo en el editor.
shadowStyleAdoptiontrueCopia las hojas de estilos del editor en el shadow root que lo contiene. Sin esto, el editor edita correctamente pero se muestra totalmente sin estilos ahí, porque ninguna hoja de estilos del documento cruza el límite de un shadow DOM. No cuesta nada fuera de un shadow root.
shadowStyleSourcesnullURL de hojas de estilos adicionales que también se copian a través del límite del shadow DOM: las sustituciones de tu propio skin. Cadena o array.

Estilos de tu propio CSS

Rellena las listas desplegables de Quick Styles con las clases que ya hay en las hojas de estilos de la página, en lugar de volver a escribirlas en la configuración.

OpciónPredeterminadoDescripción
importStylesfalseInterruptor general. Hay que activarlo explícitamente, porque en una página con CSS de utilidades la lista de clases es enorme.
importStylesSheetsnullQué hojas leer: una cadena o RegExp que se compara con el href, o una función. null = todas las que se puedan leer.
importStylesExclude/^(rte|ck|mce|…)/Lista de nombres de clase bloqueados que se aplica además de la exclusión automática del CSS del editor.
importStylesFilternull(className, selector, bucket) => false para omitir, o una cadena para cambiar la etiqueta.
importStylesReplacefalseSustituye los estilos configurados en lugar de añadirlos a ellos.
importStylesLimit100Límite por lista desplegable. Lo que se descarta se informa; nunca se recorta sin avisar.

Seguridad y comprobación del contenido

Filtrado y validación. Estas son las opciones por las que preguntará una revisión de seguridad.

OpciónPredeterminadoDescripción
contentSanitizertrueFiltro de lista de permitidos en la entrada, la salida y el DOM real. Déjalo activado.
spellCheckEnabledtrueMarca el área editable con spellcheck="true" para el corrector del navegador.
spellCheckResolvernull(text) => [{ word, offset, length, suggestions }] de cualquier servicio con el que tengas licencia.
linkCheckResolvernull(urls) => resultados de accesibilidad de las URL para el comprobador de enlaces.
linkCheckMixedContenttrueSeñala los enlaces http:// en una página https://.
linkCheckUnsafeSchemes["javascript:", "data:", …]Esquemas que se señalan como inseguros.

Historial de revisiones

Versiones con nombre del documento, guardadas en el navegador y, opcionalmente, enviadas a tu servidor.

OpciónPredeterminadoDescripción
revisionHistoryEnabledtrueEstablécelo en false para desactivar el plugin de historial de revisiones.
revisionHistoryKey(page path + query)Desde core 2.6.10: la clave con la que se guardan las versiones de ESTE documento. Establécela en el id del registro en un CMS, sobre todo cuando la URL no identifica el documento. Las compilaciones anteriores compartían una sola lista en todo el sitio.
revisionHistoryMaxEntries50Versiones que se conservan; las más antiguas se descartan primero.
revisionHistoryAutoSnapshotMs0Guarda una versión automáticamente cada N ms cuando el contenido ha cambiado; 0 = solo cuando se pide.
revisionHistorySnapshotBeforeRestoretrueDesde core 2.6.10: Restore conserva primero el contenido actual como una versión "Before restoring …", para que se pueda deshacer una restauración por error. false = el comportamiento anterior, que descartaba el trabajo sin guardar.
revisionHistoryUrl""Envía cada versión por POST a esta URL como JSON.
revisionHistoryRequestHeadersnullEncabezados para ese POST, como un objeto o una función que devuelve uno (p. ej., un token de autenticación).
onRevisionHistorySyncErrornull(detail) => se llama cuando falla un POST; la versión se sigue conservando en local.