Introducción a Polymer. Mi primer componente web

Hola de nuevo a todos,

Hoy os traigo un tutorial sobre una de las nuevas librerías de Javascript que comienza a utilizarse cada vez más en los proyectos web: Polymer.

Con Polymer, vamos a poder extender nuestro HTML por medio de la creación de Componentes Web de una forma sencilla y rápida. Estos Componentes Web podrán estar formados por código HTML, CSS y Javascript, lo que nos permitirá encapsular determinadas funcionalidades de nuestros proyectos, que podrán ir desde un botón hasta una aplicación completa.

La posibilidad de encapsular estos Componentes Web, nos va a permitir, como es evidente, reutilizar nuestro código en distintos proyectos, lo que nos da una interesante oportunidad y hace esta librería, una herramienta a tener en cuenta para nuestros desarrollos.

Hoy voy a mostraros un ejemplo muy básico de cómo utilizar esta librería, donde intentaré mostraros algunas de las interesantes oportunidades que nos ofrece. Vamos entonces con el ejemplo/tutorial, en el que veremos cómo crear un Componente Web y como usarlo posteriormente.

Estructura de nuestro proyecto usando Polymer

En primer lugar os muestro la estructura básica de la carpeta del proyecto web donde he creado el ejemplo.

Captura de pantalla 2015-01-12 a las 23.11.10

 

Como podéis ver la estructura básica es muy simple. Tenemos una carpeta con el núcleo de la librería “bower_components”. A continuación una carpeta “elements” en donde se almacenarán los distintos Componentes Webs y por último tenemos el fichero index.html, que será la página inicial de nuestro ejemplo.

Creando el Componente Web

Para explicar cómo debemos de crear nuestro componente, voy primero a poner todo el código del mismo y después explicaré los aspecto más relevantes. El código de nuestro Componente Web lo añadiremos a un fichero dentro de la carpeta “elements”, en nuestro caso el fichero “examploElement.html”

<link rel="import" href="../bower_components/polymer/polymer.html"/>

<polymer-element name="example-polymer" attributes="attr1 attr2"/>
	<template>
		<h1>Esto es un ejemplo de uso de Polymer</h1>
		<p>{{attr1}}</p>
		<input type="text" value="{{attr2}}" />

		<h2>Usando el binding</h2>
		<p>Ejemplo de binding {{attr2}}</p>
	</template>
	<script>
		Polymer({
			attr2Changed: function(){
				if(this.attr2.length == 11)
					console.log('Esta es una cadena de 11 caracteres');
			}
		});
	</script>
</polymer-element>
  • Lo primero que tenemos que hacer es cargar el núcleo de Polymer, eso lo hacemos con la línea 1 del ejemplo, cargando el archivo “polymer.html”
  • Para definir nuestro nuevo componente, utilizamos el tag polymer-element y después indicaremos el nombre de este nuevo componente por medio del atributo name. Es importante hacer referencia a que el nombre que se le da al componente web debe tener al menos un “-“, como el que he usado en este caso “example-polymer”
  • Como cualquier tag de HTML, podemos añadir atributos para nuestro componente web. Esto lo haremos dentro de la línea de definición, línea 3, usando el atributo attributes y indicando los atributos que queremos que tenga nuestro componente, separados por espacios
  • Otra parte importante en la definición del componente web, es el tag template, donde incluiremos el código HTML y CSS que formará nuestro componente. Para este primer componente solo he incluido HTML, en próximos ejemplos veremos lo que se puede hacer usando CSS también. Dentro del tag template podemos escribir todo el código HTML que deseemos.

Uno de los aspectos más interesantes que nos trae Polymer es el concepto de Data Binding. Polymer soporta data binding en dos caminos. De esta manera, se extiende el HTML y las APIs del DOM para soportar la separación entre la interfaz de una aplicación y su modelo. Las actualizaciones del modelo se reflejan en el DOM y las entradas de usuario son inmediatamente asignadas al modelo. En el ejemplo, podemos ver un sencillo modo de uso del data binding en Polymer.

  • Una propiedad que se puede usar en el data binding de Polymer se define, como podemos ver en las líneas 6, 7 y 10, de la siguiente forma {{nombredelavariable}}
  • En nuestro ejemplo, hemos creado dos propiedades que coinciden además con los atributos que definimos previamente. De manera que, lo que queremos lograr en este caso, es que en el componente se carguen, dentro del mismo, los valores que indicamos en cada uno de los atributos
  • Además, al usar la misma propiedad dentro del atributo value del input, como se ve en la línea 10 con la propiedad attr2, estamos indicándole a Polymer que se actualice dicha propiedad en todo el componente, cuando actualicemos el valor del input

Otro aspecto importante que se puede destacar es el constructor de Polymer, que se define dentro del tag script en la línea 12. El constructor de Polymer, actúa como un wrapper para document.registerElement(), aunque también dota a Polymer de algunas características como el data binding y el mapeo de eventos. El constructor de Polymer toma como elemento un objeto que define el prototipo del elemento.

En el constructor, se hace referencia al evento attr2Changed. Esto es lo que se conoce como “Changed Watcher”. En Polymer, cada una de las propiedades definidas pueden ser seguidas por medio de un manejador nombrado como “nombredelapropiedadChanged”, de manera que, dicho manejador se invocará automáticamente cuando se actualice la propiedad correspondiente. En el caso del ejemplo, para ver como funciona, simplemente se escribe una entrada en el log, cuando el texto de la propiedad tiene una longitud de 11 caracteres.

Usando el Componente en nuestra página web

Una vez que ya tenemos definido nuestro componente web, vamos a ver cómo tendríamos que hacer para usarlo dentro de las páginas de nuestro sitio web. En este caso, lo vamos a hacer dentro del archivo index.html. Como antes, os dejo el código para que lo veáis y después os explicaré los aspectos más importantes del mismo.

<html>
<head>
    <script src="bower_components/webcomponentsjs/webcomponents.js"></script>
    <link rel="import" href="elements/exampleElement.html" />
</head>
<body>
	<example-polymer attr1="Ejemplo" attr2="Otro ejemplo">
	</example-polymer>
</body>
</html>

En este archivo, donde vamos a usar el componente web que creamos en el paso anterior, solo hay que destacar tres aspectos importantes.

  • Por un lado, se carga el soporte de Polymer para cualquier plataforma, en la línea 3 del código.
  • El siguiente paso, es cargar el componente web que hemos definido, como vemos que se hace en la línea 4 del código
  • Y por último, ya podemos hacer referencia a nuestro componente web, donde como se puede ver, se hace uso de los atributos que habíamos indicado cuando definimos el componente.

El resultado del ejemplo que hemos desarrollado a lo largo del tutorial lo podemos ver a continuación.

Captura de pantalla 2015-01-12 a las 23.48.53

Bajo mi punto de vista, con este pequeño ejemplo, ya se pueden apreciar claramente algunas de las ventajas a la hora de hacer código reutilizable y encapsulado con Polymer. En los próximos días, veremos otro ejemplo donde se siguen usando aspectos de Polymer que no hemos visto hoy.

Os dejo el enlace a la página principal del proyecto Polymer donde podéis encontrar muchas más información sobre el mismo

https://www.polymer-project.org/

Espero que lo hayáis encontrado interesante.

Saludos.

Anuncios

Introducción al uso de Display Templates en SharePoint OnLine

Muy buenas de nuevo a todos,

En mis anteriores entradas he estado hablando sobre como podríamos usar los Content Search Web Part para hacer personalizaciones de nuestros sitios sin escribir ninguna línea de código. Habíamos conseguido una página que nos mostraba un catálogo de elementos y enlaces a la página donde podíamos ver el detalle de los elementos de dicho catálogo.

Primeros Pasos con SharePoint OnLine: Search Driven Development

Search Driven Development en SharePoint (II): Catálogos y Elementos de Catálogo

En ambas entradas os hablaba de la posibilidad de personalizar el diseño de esos resultados para hacerlos más atractivos e integrarlos con el branding de nuestro sitios. Para los que hayáis trabajado con la personalización de los resultados de búsqueda en SharePoint 2010, os habréis topado seguro con las plantillas XSL que nos obligaban a saber manejar XSLT para la creación de las mismas. Con SharePoint OnLine y 2013 todo este approach ha cambiado, dentro de toda la renovación de la plataforma para hacerla más ligera y cercana a las nuevas tecnologías. Ahora vamos a poder trabajar directamente con HTML y Javascript, lo que seguro que nos va a resultar muy interesante. Todo esto es lo que vamos a ver al hablar de los Display Templates. Nuestro objetivo va a ser, pasar de esto:

Captura de pantalla 2014-12-12 a las 19.58.55
Captura de pantalla 2014-12-13 a las 23.25.54

A una visualización de los resultados de nuestro Content Search Web Part como estos:

Captura de pantalla 2014-12-20 a las 15.28.29
Captura de pantalla 2014-12-20 a las 15.28.43

Aunque no se trata de un diseño muy elaborado, si que nos va a servir para ver que de una forma muy sencilla vamos a poder modificar la visualización de los resultados de búsqueda. Antes de nada, os voy a mostrar algunos enlaces que he utilizado para saber como usar los Display Templates.

http://blogs.technet.com/b/tothesharepoint/archive/2013/05/28/stage-11-upload-and-apply-display-templates-to-the-content-search-web-part.aspx

http://www.compartimoss.com/revistas/numero-17/introduccion-plantillas-elementos-contenido-display-templates

La información de nuestros Display Templates la vamos a encontrar en dos sitios. Si queremos editar las propiedades de las plantillas ya subidas, iremos al administrador de diseños al que podemos acceder de la siguiente manera, donde en el apartado de “Editar plantillas para mostrar”, encontraremos las plantillas ya cargadas:

Captura de pantalla 2014-12-20 a las 15.49.54

Si por el contrario queremos añadir nuevas plantillas lo haremos a través de Configuración del sitio->Páginas maestras y diseños de página->Display Templates->Content Web Parts

Captura de pantalla 2014-12-20 a las 15.53.45

Cuando accedemos al lugar que nos permitirá añadir nuevas plantillas, vemos que cada una de las plantillas ya subidas tiene dos archivos, uno .html y otro .js. Nosotros solo tendremos que crear el .html con la plantilla, el archivo con extensión .js se crea automáticamente al subir el anterior y es transparente para nosotros, este archivo contiene la sustitución que hace SharePoint de una serie de etiquetas especiales que se usan en las plantillas, por las correspondientes que haya que usar.

En nuestro caso, para lograr el objetivo que os he mostrado, vamos a crear dos plantillas, una para los elementos cuando están dentro del catálogo y otra para la página que muestra el detalle de uno de los elementos del catálogo

¿Como creamos una plantilla personalizada?

Como hemos dicho antes, una plantilla es un archivo .html con una serie de etiquetas especiales. Voy a mostraros como es una plantilla y después os explicaré algunos aspectos que hay que tener en cuenta.

<html xmlns:mso="urn:schemas-microsoft-com:office:office" xmlns:msdt="uuid:C2F41010-65B3-11d1-A29F-00AA00C14882">
<head>
    <title>Plantilla de Ejemplo</title>
  
    <!--[if gte mso 9]><xml>
    <mso:CustomDocumentProperties>
    <mso:TemplateHidden msdt:dt="string">0</mso:TemplateHidden>
    <mso:ManagedPropertyMapping msdt:dt="string">
        'Title'{Título}:'Title',
        'Skills'{Capacidades}:'CapacidadesOWSTEXT',
        'SecondaryFileExtension',
        'ContentTypeId'
    </mso:ManagedPropertyMapping>
    <mso:MasterPageDescription msdt:dt="string">Este es el ejemplo de una plantilla para resultados de elementos de busqueda</mso:MasterPageDescription>
    <mso:ContentTypeId msdt:dt="string">0x01006BCAA0AD8F40D041AD8D1579799074B6</mso:ContentTypeId>
    <mso:TargetControlType msdt:dt="string">;#Content Web Parts;#SearchResults;#</mso:TargetControlType>
    <mso:HtmlDesignAssociated msdt:dt="string">1</mso:HtmlDesignAssociated>
    </mso:CustomDocumentProperties></xml><![endif]-->
</head>
  
<body>
  
    <div id="ExampleSearchDrivenSolution">
  
<!--#_
    var encodedId = $htmlEncode(ctx.ClientControl.get_nextUniqueId() + "_exampleTemplate_");
  
    var linkURL = $getItemValue(ctx, "Link URL");
    linkURL.overrideValueRenderer($urlHtmlEncode);
  
    var title = $getItemValue(ctx, "Title");

  
    var skills = $getItemValue(ctx, "Skills");
  
    var containerId = encodedId + "container";
  
 _#-->
  
        <div id="_#= containerId =#_" style="float:left;width:25%;margin-left:0.5em;border:1px solid #CCC; min-height:25em;background-color:#EEE;cursor:pointer;position:relative;" onclick="window.location.href = '/sites/organizer/autores/_#= title =#_'">
            <span style="color:red;">_#= title =#_</span>
            <p style="text-decoration:underline;position:absolute;bottom:0.5em;">_#= skills =#_</p>
        </div>
  
    </div>
</body>
</html>
  • El primer aspecto importante se encuentra entre las líneas 5 y 18. Aquí se define un XML donde se definirán los parámetros de la plantilla. Lo más importante tiene que ver con lo que se define en la etiqueta “mso:ManagedPropertyMapping”, que es donde se definen las propiedades administradas que serán mapeadas en la plantilla y que usaremos después en la misma para mostrar los distintos campos del elemento devuelto por la búsqueda.
  • Con las etiquetas “<!–#_” y “_#–>” podremos escribir todo el código Javascript que queramos dentro de nuestra plantilla.
  • Haciendo uso de las etiquetas “_#=” y “=#_” podremos hacer uso de variables de Javascript que hayamos definido previamente
  • Es importante tener en cuenta que solo el contenido que aparezca en el primer ”
    <div>” será visible dentro de nuestra plantilla.

Este es el código que he usado para la plantilla de los elementos que forman parte del catálogo. A continuación os muestro la que he usado para el detalle de los elementos. La diferencia, a parte del diseño, se encuentra en las propiedades administradas que se mapearán en cada caso.

<html xmlns:mso="urn:schemas-microsoft-com:office:office" xmlns:msdt="uuid:C2F41010-65B3-11d1-A29F-00AA00C14882">
<head>
    <title>Plantilla de Ejemplo para elementos</title>
  
    <!--[if gte mso 9]><xml>
    <mso:CustomDocumentProperties>
    <mso:TemplateHidden msdt:dt="string">0</mso:TemplateHidden>
    <mso:ManagedPropertyMapping msdt:dt="string">
        'Link URL'{Dirección URL del vínculo}:'Path',
        'Title'{Título}:'Title',
        'Skills'{Capacidades}:'CapacidadesOWSTEXT',
        'Email'{Email}:'EmailOWSTEXT;,
        'WebSite'{Sitio personal}:'PersonalWebsiteOWSURLH;,
        'SecondaryFileExtension',
        'ContentTypeId'
    </mso:ManagedPropertyMapping><mso:MasterPageDescription msdt:dt="string">Este ejemplo se utiliza para el elemento de la lista</mso:MasterPageDescription>
    <mso:ContentTypeId msdt:dt="string">0x01006BCAA0AD8F40D041AD8D1579799074B6</mso:ContentTypeId>
    <mso:TargetControlType msdt:dt="string">;#Content Web Parts;#SearchResults;#</mso:TargetControlType>
    <mso:HtmlDesignAssociated msdt:dt="string">1</mso:HtmlDesignAssociated>
    <mso:HtmlDesignConversionSucceeded msdt:dt="string">True</mso:HtmlDesignConversionSucceeded>
    </mso:CustomDocumentProperties></xml><![endif]-->
</head>
  
<body>
  
    <div id="ExampleSearchDrivenSolution">
  
<!--#_
    var encodedId = $htmlEncode(ctx.ClientControl.get_nextUniqueId() + "_exampleTemplate_");
  
    var title = $getItemValue(ctx, "Title");
  
    var skills = $getItemValue(ctx, "Skills");

    var mail = $getItemValue(ctx, "Email");
  
    var website = $getItemValue(ctx, "WebSite");
  
    var containerId = encodedId + "container";
  
 _#-->
        <h2>Nombre: _#= title =#_</h2>

        <span style="display:block;margin-top:1em;font-weight:bold;font-size:1.2em;">Descripción de las habilidades</span>
        <p>_#= skills =#_</p>

        <span style="display:block;margin-top:1em;font-weight:bold;font-size:1.2em;">¿Deseas ir a su web para conocer más sobre este autor?</span>
        <a href="_#= website =#_">_#= website =#_</a>

        <span style="display:block;margin-top:1em;font-weight:bold;font-size:1.2em;">¿Quieres ponerte en contacto con este autor?</span>
        <a href="mailto:_#= mail =#_">_#= mail =#_</a>
  
    </div>
</body>
</html>

¿Cómo subimos una plantilla personalizada?

Una vez que ya hemos definido nuestras plantillas, vamos a añadirlas a nuestro sitio de SharePoint para poder usarlas. Para ello, seguimos la ruta que ya indicamos antes, para entrar al sitio donde podremos subirla. En nuestra Ribbon, desplegamos la opción de “Nuevo Documento” y hacemos click en “Plantillas para mostrar de elementos”:

Captura de pantalla 2014-12-20 a las 16.30.50

A continuación seleccionamos la plantilla a subir,

Captura de pantalla 2014-12-20 a las 16.31.12

Por último se carga la pantalla de propiedades de la plantilla, donde vemos precargadas las propiedades que ya definimos en el código de la misma. Si no lo hemos hecho en el código de la plantilla, aquí deberemos indicar el Tipo de Contenido asociado, el título de plantilla, el tipo de control de destino y el Archivo Asociado.

Captura de pantalla 2014-12-20 a las 16.31.30

Una vez hecho esto, veremos que la plantilla se ha añadido correctamente a nuestra lista de plantillas y que efectivamente se ha creado asociado al .html el .js . Para que esté disponible para ser usada, tenemos que ir al administrador de diseños y aprobar la plantilla que acabamos de subir que estará en estado “Borrador” en ese momento.

Captura de pantalla 2014-12-20 a las 16.49.46

Tras esto la plantilla ya estará disponible para usarla en nuestro Content Search WebPart. El proceso para subir una nueva plantilla lo repetiremos para las dos plantillas de nuestro sitio.

Usando la plantilla en el Content Search WebPart

El último paso que nos queda es cargar las plantillas en cada uno de los Content Search WebPart, por un lado el que se encuentra en la página que muestra el catálogo y por otro el de la página que nos muestra los elementos del catálogo, usando en cada caso la plantilla deseada

Para ello, editamos el web part de la página correspondiente, seleccionando la plantilla que queremos usar como vamos a ver a continuación.

Captura de pantalla 2014-12-20 a las 17.01.34

En el apartado de plantillas para mostrar de las propiedades del webpart, marcamos Usar una plantilla única para mostrar elementos y ahí seleccionamos nuestra plantilla

Captura de pantalla 2014-12-20 a las 17.01.58

Una vez hagamos esto con las dos plantillas, ya tendremos las mismas funcionando y podremos ver los resultados de búsqueda con el diseño que queríamos.

Espero que os resulte interesante la información. Un saludo a todos