Etiqueta b:includable de Blogger

b:includable Blogger

Las etiquetas b:includable conforman la estructura de los gadgets. Son obligatorias dentro de la estructura y requieren obligatoriamente una etiqueta b:widget.


Nota: Para comprender mejor los terminos que utilizo en las entradas de la categoria enciclopedia puedes consultar la tabla de terminos.


Etiqueta b:includable

Nos permiten crear datos que podemos incluir en cualquier parte dentro del widget donde son creadas, sin embargo obligatoriamente el primer includable deber contener la id "main". Su sintaxis es la siguiente:


<b:includable id='main'>
   <b:include name='[Identificador]'/>
</b:includable>
<b:includable id='[Identificador]'>
   <!-- datos -->
</b:includable>

La etiqueta b:includable puede llevar algunos atributos. En la siguiente tabla se encuentran los disponibles:


id [string] Obligatorio. Identificador único del includable.
var [string] Variable que recoge el conjunto de datos que se utilizarán dentro del includable y sus hijos.
data [string] Puede contener el nombre de una variable que recoge los datos de un conjunto de datos, o directamente puede ser el nombre de un objeto.

Etiqueta b:include

Sirve para llamar e incluir los datos que contiene una etiqueta b:includable y tambien puede llevar algunos atributos. En la siguiente tabla se encuentran los disponibles:


name [string] Obligatorio. el valor debe corresponder al Identificador del includable solicitado.
data [string] Puede contener el nombre de una variable que recoge los datos de un conjunto de datos, o directamente puede ser el nombre de un objeto.

En el siguiente ejemplo creamos un widget del tipo HTML y agregamos el includable obligatorio "main", pero aparte creamos otro con el id "mitexto", posteriormente solicitamos los datos dentro del includable mediante un include.


<b:widget id='HTML1' type='HTML'>
   <b:includable id='main'>
      <b:include name='mitexto'><!-- Este devuelve el contenido de "mitexto" -->
   </b:includable>
   <b:includable id='mitexto'>
      <p>Texto para mi bloque de texto</p>
   </b:includable>
</b:widget>

En este otro ejemplo creamos un bucle de entradas en un widget del tipo "Blog" y declaramos que los datos de la variable "post", se van a usar dentro del include y sus hijos:


<b:widget id='Blog1' type='Blog'>
   <b:includable id='main'>
      <b:loop values='data:posts' var='post'>
         <b:include name='entradas' data='post'>
      </b:loop>
   </b:includable>
   <b:includable id='entradas' var='post'>
      <h1><data:post.title/></h1>
      <div expr:id='data:post.id'><data:post.body/></div>
   </b:includable>
</b:widget>

Condiciones

Solo disponible en b:include, es decir, la etiqueta que llama el contenido del b:includable. En el siguiente ejemplo incluimos un texto sólo si nos encontramos en la pagina de busqueda:


<b:widget id='Blog1' type='Blog'>
   <b:includable id='main'>
      <b:include cond='data:view.isSearch' name='info'><!-- Se incluye solo en busquedas -->
   </b:includable>
   <b:includable id='info'>
      <p>Estas en la pagina de busqueda</p>
   </b:includable>
</b:widget>

Super inclusiones

Contienen los datos originales del includable que se guardan por parte de Blogger y se llaman mediante el prefijo "super". En el siguiente ejemplo solicitamos el contenido original del include "main" del widget Blog:


<b:widget id='Blog1' type='Blog'>
   <b:includable id='main'>
      <b:include name='super.main'/>
   </b:includable>
</b:widget>

Includes Globales

Se trata de los includes que no necesitan ser llamados dentro de un includable ni de un widget. Los siguientes includes cumplen con esta cualidad:


<!-- all-head-content (Inserta meta datos de la cabecera) -->
<b:include data='blog' name='all-head-content'/>

<!-- google-analytics (Inserta el código de Analytics) -->
<b:include data='blog' name='google-analytics'/>

<!-- openGraphMetaData (Inserta meta datos de Open graph) -->
<b:include data='blog' name='openGraphMetaData'/>

Si te ha servido toda esta informacion no olvides compartir la entrada, ayudaras a mas personas y eso me ayudaria mucho. Muchas gracias por leer.