Procedimiento para personalizar el control de campo del editor HTML

Última modificación: lunes, 27 de septiembre de 2010

Hace referencia a: SharePoint Server 2010

En este artículo
Restricciones
Formatos de tabla predefinidos
Corrector ortográfico

Puede usar el control de campo Editor HTML para insertar contenido HTML en una página de publicación. Las plantillas de página que incluyen un tipo de columna HTML para publicación también incluyen el control de campo Editor HTML. Este editor tiene funcionalidades especiales, como estilos personalizados, restricciones de edición, compatibilidad con contenido reutilizable, un corrector ortográfico y el uso de selectores de activos para seleccionar documentos e imágenes para insertarlos en el contenido de la página. En este tema se describe el procedimiento para modificar algunas características y atributos del control de campo Editor HTML.

Restricciones

Si el tipo de contenido de un diseño de página admite la columna Contenido de la página, puede agregar un control de campo HTML enriquecido al diseño de página mediante un marcado como el siguiente.

<PublishingWebControls:RichHtmlField id="ArticleAbstract" FieldName="ArticleAbstract" 
          AllowExternalUrls="false" 
          AllowFonts="true" 
          AllowReusableContent="false" 
          AllowHeadings="false"
          AllowHyperlinks="false"
          AllowImages="false"
          AllowLists="false"
          AllowTables="false"
          AllowTextMarkup="false" 
          AllowHTMLSourceEditing="false"
          DisalbeBasicFormattingButtons="false"
          runat="server"/>

En el ejemplo anterior, RichHTMLField es el nombre del control de campo que proporciona una mejor experiencia de edición de HTML. Los atributos como AllowFonts y AllowTables especifican delimitaciones en el campo.

El control de campo HTML permite etiquetas de fuente, pero el control no permite direcciones URL externas a la colección de sitios actual, contenido reutilizable almacenado en una lista centralizada, etiquetas de título HTML estándar, hipervínculos, imágenes, listas numeradas o con viñetas, tablas ni formato de texto.

Tabla 1. Propiedades del control de campo Editor HTML

Formatos de tabla predefinidos

El Editor HTML incluye un conjunto de formatos de tabla predefinidos, pero se puede personalizar para ajustarse al estilo de una página individual. Cada formato de tabla es una colección de clases de hojas de estilos en cascada (CSS) para cada etiqueta de tabla. Puede definir el estilo de la primera y última filas, de las filas pares y las impares, de la primera y última columnas, y así sucesivamente.

El Editor HTML aplica de forma dinámica ciertos estilos de las hojas de estilos de referencia en la página y las pone a disposición de los usuarios cuando dan formato a la tabla. Para que un estilo personalizado esté disponible al dar formato a una tabla, los nombres de clase relevantes deben seguir el formato PREFIXTableXXX-NNN, donde:

• PREFIX es ms-rte de manera predeterminada, pero se puede invalidar el valor predeterminado mediante la propiedad PrefixStyleSheet() del control de campo RichHTML.

• XXX es la sección de tabla específica, como EvenRow u OddRow.

• NNN es el nombre para identificar el estilo de la tabla.

El siguiente ejemplo presenta un conjunto completo de clases para un formato de estilo de tabla.

.ms-rteTable-1 {border-collapse:collapse;border-top:gray 1.5pt;
    border-left:gray 1.5pt;border-bottom:gray 1.5pt;
    border-right:gray 1.5pt;border-style:solid;}
.ms-rteTableHeaderRow-1 {color:Green;background:yellow;text-align:left}
.ms-rteTableHeaderFirstCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableHeaderLastCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableHeaderOddCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableHeaderEvenCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableOddRow-1 {color:black;background:#FFFFDD;}
.ms-rteTableEvenRow-1 {color:black;background:#FFB4B4;}
.ms-rteTableFirstCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableLastCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableOddCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableEvenCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableFooterRow-1 {color:blue;font-style:bold;
    font-weight:bold;background:white;border-top:solid gray 1.0pt;
    border-bottom:solid gray 1.0pt;border-right:solid silver 1.0pt; 
    border-style:solid;}
.ms-rteTableFooterFirstCol-1 {padding:0in 5.4pt 0in 5.4pt;
    border-top:solid gray 1.0pt;text-align:left}
.ms-rteTableFooterLastCol-1 {padding:0in 5.4pt 0in 5.4pt;
    border-top:solid gray 1.0pt;text-align:left}
.ms-rteTableFooterOddCol-1 {padding:0in 5.4pt 0in 5.4pt;
    text-align:left;border-top:solid gray 1.0pt;}
.ms-rteTableFooterEvenCol-1 {padding:0in 5.4pt 0in 5.4pt;
    text-align:left;border-top:solid gray 1.0pt;}

Microsoft SharePoint Server 2010 incluye un conjunto de estilos de tabla predeterminados. Sin embargo, si el sistema detecta estilos nuevos que no se originaron en el archivo .css predeterminado, eliminará el conjunto predeterminado y solo presentará los estilos recién definidos en el cuadro de diálogo del Editor HTML.

Corrector ortográfico

En SharePoint Server 2010, el Editor HTML incluye un corrector ortográfico, que pueden personalizar los desarrolladores mediante el control web SpellCheckV4Action y el control web SpellCheckToolbarButton. La acción del corrector ortográfico registra los datos y archivos de cliente durante una revisión ortográfica. También incluye un método para obtener la ficha de la consola y llama a los permisos del usuario para comprobar si el usuario actual tiene derechos para realizar una operación de revisión ortográfica en el elemento seleccionado. La acción del corrector ortográfico llama al código de ECMAScript (JavaScript, JScript) adecuado y envía información al cliente acerca de las revisiones ortográficas disponibles y el idioma predeterminado que se usará para la solicitud.

Vea también

Conceptos

Procedimiento para personalizar estilos

Procedimiento para personalizar el selector de activos