Compartir a través de

Procedimiento para personalizar las páginas de vista de lista móvil y formulario

  • Artículo

En este tema se proporciona una introducción al procedimiento básico para personalizar las páginas de vista de lista y de formulario de Windows SharePoint Services 3.0 a las que obtienen acceso los dispositivos móviles. Para ver un procedimiento detallado, consulte Tutorial: Personalización de una página de vista de lista móvil. Para obtener una introducción al procedimiento para personalizar las páginas principales móviles, consulte Procedimiento para personalizar las páginas principales móviles.

Como se describe en detalle en Sistema de representación de páginas móviles, los controles de las áreas de encabezado (Title), contenido (Contents) y pie de página (Navigation) de una página principal móvil inician una cadena de llamadas que da como resultado llamadas a los siguientes tres controles de selección de plantillas respectivamente.

Un objeto de una de estas clases selecciona un objeto RenderingTemplate según el tipo de lista actual (por ejemplo, anuncios o algún tipo de lista personalizada) y el tipo de página.

Estos controles buscan un identificador RenderingTemplate que tenga el formato siguiente:

Mobile_ identificadorDeTipoDeLista _ tipoDePágina _ áreaDePágina

Donde identificadorDeTipoDeLista es el número del identificador del tipo de lista actual (como 105) o uno de los valores de la enumeración SPListTemplateType (como Contacts). Hay dos maneras de definir un identificador de tipo de lista:

  • Si la lista se especifica como parte del tipo de sitio en el archivo Onet.xml de la definición del sitio, identificadorDeTipoDeLista es el valor del atributo Type del elemento List en Onet.xml. Este archivo está ubicado en el siguiente directorio: unidad_local:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\SITETEMPLATES\tipo_de_sitio\xml. (Para obtener una lista de los números de identificadores de todos los tipos de listas que se incluyen con Windows SharePoint Services 3.0, consulte Sistema de representación de páginas móviles.)

  • Si la lista se ha agregado al sitio en la interfaz de usuario; es decir, la página Nuevo (lista), identificadorDeTipoDeLista es el identificador del tipo de lista que se ha usado como la base del tipo de lista nuevo. Esto está determinado por el vínculo en el que el usuario ha hecho clic en la página Crear (create.aspx) para obtener acceso a la página Nuevo.

tipoDePágina es View, NewForm, EditForm, DispForm o DeletePage.

áreaDePágina es Title, Contents o Navigation. (Para obtener más información acerca de las secciones de una página móvil, consulte Diseño y paginación de las páginas móviles.)

Si no existe un elemento RenderingTemplate con un identificador que especifica el tipo de lista actual, se usa un elemento RenderingTemplate con un identificador en el patrón **Mobile_Default_tipoDePágina_**áreaDePágina.

Para crear un área de encabezado (Title), contenido (Contents) o pie de página (Navigation) personalizada en una página de vista de lista móvil o una página de formulario sólo es necesario crear un elemento RenderingTemplate con el identificador que busca el control de selección de plantillas del área de la página. (Consulte el siguiente procedimiento para obtener más detalles.)

Plantillas de representación existentes

En la siguiente lista se identifican los elementos RenderingTemplate para las páginas de vista de lista móvil y formulario que se incluyen en el archivo MobileDefaultTemplates.ascx que se instala con Windows SharePoint Services.

  • Mobile_Comments_DeletePage_Navigation

  • Mobile_Comments_View_Navigation

  • Mobile_DiscussionBoard_DispForm_Contents

  • Mobile_DiscussionBoard_EditForm_Contents

  • Mobile_DiscussionBoard_EditForm_Navigation

  • Mobile_DiscussionBoard_NewForm_Navigation

  • Mobile_DocumentLibrary_View_Navigation

  • Mobile_Events_DispForm_Navigation

  • Mobile_Events_EditForm_Navigation

  • Mobile_Events_NewForm_Navigation

  • Mobile_Events_View_Contents

  • Mobile_Posts_DeletePage_Navigation

  • Mobile_WebPageLibrary_DispForm_Contents

  • Mobile_WebPageLibrary_DispForm_Navigation

No se puede modificar el archivo MobileDefaultTemplates.ascx. Puede crear un nuevo elemento RenderingTemplate (en su propio archivo .ascx) con el mismo nombre que uno de los elementos existentes, pero si lo hace, correrá el riesgo de interrumpir otras soluciones implementadas en Windows SharePoint Services que dependen del elemento RenderingTemplate original que tiene el mismo nombre.

Nota

Los elementos RenderingTemplate que se incluyen en Windows SharePoint Services 3.0 se cargan antes que las plantillas personalizadas, por ello, cuando se carga una plantilla personalizada con el mismo nombre que una de las plantillas de representación existentes, la plantilla personalizada reemplaza a la plantilla original. Si varios objetos RenderingTemplate personalizados tienen el mismo nombre, el objeto con el último nombre por orden alfabético reemplazará al resto. Si un archivo específico tiene dos o más plantillas de representación con el mismo nombre, no se carga ninguna de ellas.

Además, los siguientes elementos RenderingTemplate personalizados se definen en el mismo archivo. El motor en tiempo de ejecución los usa siempre que no se haya definido un elemento RenderingTemplate para el tipo de lista actual. Existe el mismo riesgo si se crean objetos RenderingTemplate nuevos con cualquiera de estos nombres:

  • Mobile_Default_DeletePage_Contents

  • Mobile_Default_DeletePage_Navigation

  • Mobile_Default_DeletePage_Title

  • Mobile_Default_DispForm_Contents

  • Mobile_Default_DispForm_Navigation

  • Mobile_Default_DispForm_Title

  • Mobile_Default_EditForm_Contents

  • Mobile_Default_EditForm_Navigation

  • Mobile_Default_EditForm_Title

  • Mobile_Default_NewForm_Contents

  • Mobile_Default_NewForm_Navigation

  • Mobile_Default_NewForm_Title

  • Mobile_Default_View_Contents

  • Mobile_Default_View_Navigation

  • Mobile_Default_View_Title

Se pueden anidar objetos RenderingTemplate. Consulte el ejemplo siguiente.

Para personalizar una sección de una página de formulario o vista de lista móvil

  1. En Microsoft Visual Studio, el Bloc de notas o una aplicación de edición de texto, cree un archivo de control de usuario (.ascx) en la ruta de acceso \Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES.

  2. Para registrar o importar los espacios de nombres adecuados, agregue las directivas de página necesarias al archivo .ascx.

  3. Agregue una plantilla de representación al archivo .ascx y asígnele un identificador con el siguiente formato: **Mobile_identificadorDeTipoDeLista_tipoDePágina_**áreaDePágina.

    • El identificadorDeTipoDeLista es el número del identificador de un tipo de la lista actual (como 105) o uno de los valores de la enumeración SPListTemplateType (como Contacts).

    • El tipoDePágina puede ser View, NewForm, EditForm, DispForm o DeletePage.

    • El áreaDePágina puede ser Title, Contents o Navigation.

  4. Guarde el archivo .ascx y reinicie Internet Information Services (IIS) para que los cambios surtan efecto.

Ejemplo

En el siguiente ejemplo de una definición de RenderingTemplate se muestra cómo se pueden anidar objetos RenderingTemplate. Para ver un ejemplo acerca de cómo personalizar una página de vista de lista, consulte Tutorial: Personalización de una página de vista de lista móvil.

<SharePoint:RenderingTemplate RunAt="Server" ID="Mobile_104_View_Navigation">
  <Template>
    <mobile:Link RunAt="Server" Text="ASP.NET Website" NavigateUrl="https://www.asp.net" />
    <mobile:Label RunAt="Server" Text="" BreakAfter="True" />
    <SPMobile:SPMobileComponent RunAt="Server" TemplateName="Mobile_Default_View_Navigation" />
  </Template>
</SharePoint:RenderingTemplate>

Vea también

Otros recursos

Tutorial: Personalización de una página de vista de lista móvil
Procedimiento para personalizar las páginas principales móviles
Diseño y paginación de las páginas móviles
Cómo: Personalizar la página principal móvil mediante redireccionamiento
Sistema de representación de páginas móviles