Módulo:Listas/doc

Este módulo devuelve varias clases de listas.

Uso

{{#invoke:listas|función|primer elemento|segundo elemento|...|último elemento|parámetros opcionales}}

Funciones

Las funciones son:

lista

Devuelve una lista de elementos separados por comas. Por ejemplo:

{{#Invoke:listas|lista|elemento1|elemento2|elemento3}} produce:

elemento1, elemento2 Plantilla:Y-e elemento3

listahtml

Devuelve una lista html. En el ejemplo anterior, cambiando la función:

{{#Invoke:listas|listahtml|elemento1|elemento2|elemento3}} produce:

• elemento1
• elemento2
• elemento3

primero

Devuelve el primer elemento de la lista ordenada alfabéticamente. Por ejemplo:

{{#Invoke:listas|primero|gato|perro|conejo}} produce:

conejo

Parámetros opcionales

• enlazar: Si se informa con "sí" se genera un enlace a cada elemento de la lista.
  • La plantilla automáticamente añade a cada elemento el espacio de nombres donde se utiliza la plantilla. Por ejemplo, {{#Invoke:listas|lista|enlazar=sí|listas|math}} añade el espacio de nombre "Módulo" por haberse utilizado en Módulo:Listas/doc:

  listas Plantilla:Y-e math

  Para evitarlo puede utilizarse el parámetro espacio de nombres sin informar. Por ejemplo, {{#Invoke:listas|lista|enlazar=sí|espacio de nombres=|listas|math}} produce:

  listas Plantilla:Y-e math

  • La plantilla automáticamente desambigua. Así si un elemento incluye texto entre paréntesis no lo muestra aunque en caso de enlazar se enlaza al nombre completo del elemento. Por ejemplo, {{#Invoke:listas|lista|enlazar=sí|espacio de nombres=|Bill Morrison (director)|elemento2|elemento3}} muestra "Bill Morrison" pero enlaza a Bill Morrison (director):

    Bill Morrison, elemento2 Plantilla:Y-e elemento3

  • Si uno de los elementos ya está enlazado se muestra correctamente. Por ejemplo {{#Invoke:listas|lista|enlazar=sí|espacio de nombres=|[[Bill Morrison]]|elemento2|elemento3}} muestra Bill Morrison en vez de [[Bill Morrison]]:

    Bill Morrison, elemento2 Plantilla:Y-e elemento3

• separador: Cadena que separa los elementos de la lista. Si no se utiliza se toma por defecto como separador ", ". Por ejemplo {{#Invoke:listas|lista|separador=<br/>|elemento1|elemento2|elemento3}} muestra:

  elemento1
  elemento2
  elemento3

• conjunción: Cadena que separa el último elemento de la lista. Si no se utiliza se toma por defecto el separador. Por ejemplo {{#Invoke:listas|lista|conjunción=o|elemento1|elemento2|elemento3}} muestra:

  elemento1, elemento2 o elemento3

• delimitador: Se utiliza para mostrar los elementos entre delimitadores. Por ejemplo para mostrar los elementos entre cursivas se puede hacer: {{#Invoke:listas|lista|enlazar=no|delimitador=''|El gran robo del tren (novela)|Caída libre (novela)||Jumper (novela)|}}

  El gran robo del tren (novela), Caída libre (novela) Plantilla:Y-e Jumper (novela)

• clase: Si se utiliza la función listahtml, clase CSS de la lista. Los valores normales son "plainlist" para listas sin viñetas y "hlist" para listas horizontales. Por ejemplo, {{#Invoke:listas|listahtml|enlazar=sí|clase=hlist|elemento1|elemento2}} produce:

  • elemento1
  • elemento2

• categoría:. Incluye la página donde se invoca al módulo en la categoría correspondiente si existe. Por ejemplo {{#Invoke:listas|lista|enlazar=sí|espacio de nombres=|categoría=Películas dirigidas por $1|Aleksandar Petrović (director de cine)}} incluirá la página en la categoría Categoría:Películas dirigidas por Aleksandar Petrović (director de cine) si existe. Si no es así la incluirá en la categoría Categoría:Películas dirigidas por Aleksandar Petrović si existe. Si no existe no se incluirá en ninguna de las categorías.
  • Puede usarse opcionalmente un parámetro llamado ordenar.

Plantillas que usan el módulo

• Plantilla:Ejemplo plantilla
• Plantilla:Ejemplo plantilla
• Plantilla:Ejemplo plantilla
• Plantilla:Ejemplo plantilla