Estructuras de datos
class	TagsData
Namespaces
namespace	Helpers
	Copyright (c) 2005-2012 KumbiaPHP Team (http://www.kumbiaphp.com) http://wiki.kumbiaphp.com/Licencia New BSD License
Funciones
	xhtml_start_tag ($tag, $attrs=null)
	Construye el inicio del tag xhtml.
	xhtml_end_tag ($tag)
	Construye el cierre de un tag xhtml.
	xhtml_tag ($tag, $attrs=null)
	Construye un tag xhtml.
	link_to ($action, $text='')
	Crea un enlace en una Aplicacion respetando las convenciones de Kumbia.
	link_to_action ($action, $text='')
	Crea un enlace a una accion dentro del controlador Actual.
	link_to_remote ($action)
	Permite ejecutar una acci�n en la vista actual dentro de un contenedor HTML usando AJAX.
	javascript_include_tag ($src='')
	Genera una etiqueta script que apunta a un archivo JavaScript respetando las rutas y convenciones de Kumbia.
	javascript_library_tag ($src)
	Agrega una etiqueta script que apunta a un archivo en public/javascript/kumbia.
	stylesheet_link_tag ($name)
	Agrega una etiqueta link para incluir un archivo CSS respetando las rutas y convenciones de Kumbia.
	img_tag ($img)
	Permite incluir una imagen dentro de una vista respetando las convenciones de directorios y rutas en Kumbia.
	form_remote_tag ($data)
	Permite generar un formulario remoto.
	form_tag ($action)
	Crea una etiqueta de formulario.
	end_form_tag ()
	Etiqueta para cerrar un formulario.
	submit_tag ($caption)
	Crea un boton de submit para el formulario actual.
	submit_remote_tag ($caption)
	Crea un boton de submit para el formulario remoto actual.
	submit_image_tag ($caption, $src='')
	Crea un boton de submit tipo imagen para el formulario actual.
	button_tag ($caption='')
	Crea un boton HTML.
	get_value_from_action ($name)
	Obtiene el valor de un componente tomado del mismo valor del nombre del campo en el modelo del mismo nombre del controlador o el indice en $_REQUEST.
	get_id_and_name ($value)
	Obtiene el id and name apartir del argumento, con la sintaxis "model.field" o solo "field".
	input_field_tag ($name)
	Crea un campo input.
	text_field_tag ($name)
	Crea una caja de Texto.
	checkbox_field_tag ($name)
	Crea un CheckBox.
	numeric_field_tag ($name)
	Caja de texto que admite solo numeros.
	textupper_field_tag ($name)
	Crea una caja de texto que acepta solo texto en Mayuscula.
	date_field_tag ($name)
	Crea un componente para seleccionar la fechas.
	file_field_tag ($name)
	Crea un Input tipo Text.
	radio_field_tag ($name)
	Crea un input tipo Radio.
	textarea_tag ($name, $value=null)
	Crea un TextArea.
	password_field_tag ($name)
	Crea un componente para capturar Passwords.
	hidden_field_tag ($name)
	Crea un Componente Oculto.
	select_tag ($name, $data=array())
	Crea una lista SELECT.
	option_tag ($value, $text='')
	Crea una opcion de un SELECT.
	upload_image_tag ($name)
	Crea un componente para Subir Imagenes.
	set_droppable ($obj, $action='')
	Hace que un objeto se pueda arrastrar en la pantalla.
	tr_break ($x='')
	br_break ($x='')
	tr_color ()
	Crea de colores pasando como parametro los colores.
	tr_color_class ()
	Crea un pasando como parametro las class.
	button_to_action ($caption, $action='', $classCSS='')
	Crea un Button que al hacer click carga un controlador y una accion determinada.
	button_to_remote_action ($caption, $action='', $classCSS='')
	Crea un Button que al hacer click carga con AJAX un controlador y una acci�n determinada.
	updater_select ($name, $data=array())
	Crea un select que actualiza un container usando una accion ajax que cambia dependiendo del id selecionado en el select.
	text_field_with_autocomplete ($name)
	Caja de texto con autocompletacion.
	xhtml_template ($template='template')
	Inserta un documento XHTML antes de una salida en buffer.
	tab_tag ($tabs, $color='green', $width=800)
	js_execute ($s)
	Ejecuta un script de javascript.
	js_alert ($s)
	Genera un alert de javascript.
	time_field_tag ($name='')
	Campo para tipo hora.
	month_field_tag ($name)
	Select tag para mes.
	swf_tag ($data)
	Permite incluir un objeto flash dentro de una vista respetando las convenciones de directorios y rutas en Kumbia.
	get_kumbia_url ($url)
	Devuelve una URL adecuada de Kumbia.
	stylesheet_link_tags ()
	Imprime los CSS cargados mediante stylesheet_link_tag en el <head>

Documentación de las funciones

br_break ( $ x = '' )

Definición en la línea 1210 del archivo tags.php.

button_tag ( $ caption = '' )

Crea un boton HTML.

Parámetros:

string $caption caption: texto del boton

Devuelve:: string

Definición en la línea 635 del archivo tags.php.

Hace referencia a Util::getParams() y xhtml_tag().

Gráfico de llamadas para esta función:

button_to_action	(	$	caption,
		$	action = `''`,
		$	classCSS = `''`
	)

Crea un Button que al hacer click carga un controlador y una accion determinada.

Parámetros:

string	$caption
string	$action
string	$classCSS	caption: texto del boton action: accion a ejecutar

Devuelve:: HTML del Boton

Definición en la línea 1293 del archivo tags.php.

Hace referencia a Util::getParams() y xhtml_tag().

Gráfico de llamadas para esta función:

button_to_remote_action	(	$	caption,
		$	action = `''`,
		$	classCSS = `''`
	)

Crea un Button que al hacer click carga con AJAX un controlador y una acci�n determinada.

Parámetros:

string	$caption
string	$action
string	$classCSS

Devuelve:: HTML del Bot�n

Definición en la línea 1334 del archivo tags.php.

Hace referencia a Util::getParams().

Gráfico de llamadas para esta función:

checkbox_field_tag ( $ name )

Crea un CheckBox.

Parámetros:

string $name

Devuelve:: string

Definición en la línea 739 del archivo tags.php.

Hace referencia a Util::getParams() y input_field_tag().

Gráfico de llamadas para esta función:

date_field_tag ( $ name )

Crea un componente para seleccionar la fechas.

Parámetros:

string	$name
string	$format	d-m-Y, Y-m-d, m-d-Y
string	$language

Devuelve:: string

Definición en la línea 786 del archivo tags.php.

Hace referencia a get_id_and_name(), Util::getParams(), javascript_include_tag(), stylesheet_link_tag() y text_field_tag().

Gráfico de llamadas para esta función:

end_form_tag ( )

Etiqueta para cerrar un formulario.

Devuelve:: $string_code

Definición en la línea 528 del archivo tags.php.

file_field_tag ( $ name )

Crea un Input tipo Text.

Parámetros:

string $name

Devuelve:: string

Definición en la línea 836 del archivo tags.php.

Hace referencia a Util::getParams() y input_field_tag().

Gráfico de llamadas para esta función:

form_remote_tag ( $ data )

Permite generar un formulario remoto.

Parámetros:

string $data update: contenedor html a actualizar success: Codigo JavaScript a ejecutar cuando termine la peticion AJAX before: Codigo JavaScript a ejecutar antes de la peticion AJAX complete: Codigo JavaScript que se ejecuta al terminar la peticion AJAX

Devuelve:: string

Definición en la línea 443 del archivo tags.php.

Hace referencia a Util::encomillar(), Router::get(), get_kumbia_url(), Util::getParams() y xhtml_start_tag().

Gráfico de llamadas para esta función:

form_tag ( $ action )

Crea una etiqueta de formulario.

Parámetros:

string $action confirm: confirmacion antes de enviar datos

Devuelve:: string

Definición en la línea 499 del archivo tags.php.

Hace referencia a get_kumbia_url(), Util::getParams() y xhtml_start_tag().

Gráfico de llamadas para esta función:

get_id_and_name ( $ value )

Obtiene el id and name apartir del argumento, con la sintaxis "model.field" o solo "field".

Parámetros:

string $value

Devuelve:: array

Definición en la línea 683 del archivo tags.php.

Referenciado por date_field_tag(), input_field_tag(), select_tag(), text_field_with_autocomplete(), textarea_tag(), time_field_tag() y updater_select().

Gráfico de llamadas a esta función:

get_kumbia_url ( $ url )

Devuelve una URL adecuada de Kumbia.

Parámetros:

string $url

Devuelve:: string

Definición en la línea 1811 del archivo tags.php.

Referenciado por form_remote_tag(), form_tag(), link_to(), link_to_action() y text_field_with_autocomplete().

Gráfico de llamadas a esta función:

get_value_from_action ( $ name )

Obtiene el valor de un componente tomado del mismo valor del nombre del campo en el modelo del mismo nombre del controlador o el indice en $_REQUEST.

Parámetros:

string $name

Devuelve:: mixed

Definición en la línea 655 del archivo tags.php.

Hace referencia a $controller y Dispatcher::get_controller().

Referenciado por input_field_tag(), select_tag(), text_field_with_autocomplete(), textarea_tag(), time_field_tag() y updater_select().

Gráfico de llamadas para esta función:

Gráfico de llamadas a esta función:

hidden_field_tag ( $ name )

Crea un Componente Oculto.

Parámetros:

string $name

Devuelve:: string

Definición en la línea 907 del archivo tags.php.

Hace referencia a Util::getParams() y input_field_tag().

Referenciado por time_field_tag().

Gráfico de llamadas para esta función:

Gráfico de llamadas a esta función:

img_tag ( $ img )

Permite incluir una imagen dentro de una vista respetando las convenciones de directorios y rutas en Kumbia.

Parámetros:

string $img drag: capacidad de arrastrar la imagen reflect: adicionar reflejo

Devuelve:: string

Definición en la línea 397 del archivo tags.php.

Hace referencia a Util::getParams() y xhtml_tag().

Gráfico de llamadas para esta función:

input_field_tag ( $ name )

Crea un campo input.

Parámetros:

string $name

Devuelve:: string

Obtengo id, name y value

Definición en la línea 700 del archivo tags.php.

Hace referencia a get_id_and_name(), get_value_from_action(), Util::getParams() y xhtml_tag().

Referenciado por checkbox_field_tag(), file_field_tag(), hidden_field_tag(), password_field_tag(), radio_field_tag() y text_field_tag().

Gráfico de llamadas para esta función:

Gráfico de llamadas a esta función:

javascript_include_tag ( $ src = '' )

Genera una etiqueta script que apunta a un archivo JavaScript respetando las rutas y convenciones de Kumbia.

Parámetros:

string $src cache: indica si usa cache (true, false), por defecto se utiliza la cache

Devuelve:: string

Definición en la línea 311 del archivo tags.php.

Hace referencia a Router::get(), Util::getParams() y xhtml_tag().

Referenciado por date_field_tag().

Gráfico de llamadas para esta función:

Gráfico de llamadas a esta función:

javascript_library_tag ( $ src )

Agrega una etiqueta script que apunta a un archivo en public/javascript/kumbia.

Parámetros:

string $src

Devuelve:: string

Definición en la línea 344 del archivo tags.php.

Hace referencia a Util::getParams() y xhtml_tag().

Gráfico de llamadas para esta función:

js_alert ( $ s )

Genera un alert de javascript.

Parámetros:

string $s

Definición en la línea 1624 del archivo tags.php.

Hace referencia a js_execute().

Gráfico de llamadas para esta función:

js_execute ( $ s )

Ejecuta un script de javascript.

Parámetros:

string $s

Definición en la línea 1616 del archivo tags.php.

Hace referencia a xhtml_tag().

Referenciado por js_alert().

Gráfico de llamadas para esta función:

Gráfico de llamadas a esta función:

link_to	(	$	action,
		$	text = `''`
	)

Crea un enlace en una Aplicacion respetando las convenciones de Kumbia.

Parámetros:

string	$action
string	$text	confirm: confirmacion antes de ejecutar

Devuelve:: string

Definición en la línea 152 del archivo tags.php.

Hace referencia a get_kumbia_url(), Util::getParams() y xhtml_tag().

Gráfico de llamadas para esta función:

link_to_action	(	$	action,
		$	text = `''`
	)

Crea un enlace a una accion dentro del controlador Actual.

Parámetros:

string	$action
string	$text	confirm: confirmacion antes de ejecutar

Devuelve:: string

Definición en la línea 189 del archivo tags.php.

Hace referencia a Router::get(), get_kumbia_url(), Util::getParams() y xhtml_tag().

Gráfico de llamadas para esta función:

link_to_remote ( $ action )

Permite ejecutar una acci�n en la vista actual dentro de un contenedor HTML usando AJAX.

confirm: Texto de Confirmaci�n success: Codigo JavaScript a ejecutar cuando termine la petici�n AJAX before: Codigo JavaScript a ejecutar antes de la petici�n AJAX oncomplete: Codigo JavaScript que se ejecuta al terminar la petici�n AJAX update: Que contenedor HTML ser� actualizado action: Accion que ejecutar� la petici�n AJAX text: Texto del Enlace

Devuelve:: string

Definición en la línea 237 del archivo tags.php.

Hace referencia a Util::getParams() y xhtml_tag().

Gráfico de llamadas para esta función:

month_field_tag ( $ name )

Select tag para mes.

Parámetros:

string $name nombre del campo

use_month_numbers: usar meses como numeros (true, si, yes)

Definición en la línea 1750 del archivo tags.php.

Hace referencia a Util::getParams() y select_tag().

Gráfico de llamadas para esta función:

numeric_field_tag ( $ name )

Caja de texto que admite solo numeros.

Parámetros:

string $name

Devuelve:: string

Definición en la línea 751 del archivo tags.php.

Hace referencia a Util::getParams() y text_field_tag().

Gráfico de llamadas para esta función:

option_tag	(	$	value,
		$	text = `''`
	)

Crea una opcion de un SELECT.

Parámetros:

string	$value
string	$text

Devuelve:: string

Definición en la línea 1103 del archivo tags.php.

Hace referencia a Util::getParams() y xhtml_tag().

Referenciado por select_tag().

Gráfico de llamadas para esta función:

Gráfico de llamadas a esta función:

password_field_tag ( $ name )

Crea un componente para capturar Passwords.

Parámetros:

string $name

Devuelve:: string

Definición en la línea 895 del archivo tags.php.

Hace referencia a Util::getParams() y input_field_tag().

Gráfico de llamadas para esta función:

radio_field_tag ( $ name )

Crea un input tipo Radio.

Parámetros:

string $name

Devuelve:: string

Definición en la línea 848 del archivo tags.php.

Hace referencia a Util::getParams() y input_field_tag().

Gráfico de llamadas para esta función:

select_tag	(	$	name,
		$	data = `array()`
	)

Crea una lista SELECT.

Parámetros:

string	$name
string	array,$data	selected: opcion seleccionada include_blank: incluir opcion con valor nulo, se muestra en la opcion el texto aqui indicado

Para el select basado en activerecord: option: lista de campos separados por coma para colocar en la opcion (por defecto es el id) separator: separador de valores para los campos de la opcion value: indica el campo que servira de valor para la opcion (por defecto es el id) conditions: condiciones de busqueda

Devuelve:: string

Ejemplos: select_tag('marca_id', 'Marca', 'conditions: tipo="2"', 'option: nombre') select_tag('marca_id', 'Marca', 'SELECT * FROM marca WHERE tipo="2"', 'option: nombre') select_tag('sexo', array('M' => 'Masculino', 'F' => 'Femenino'), 'include_blank: Seleccione uno...')

Obtengo id, name y value

combo creado a partir de un modelo

Arreglo que contiene los argumentos para el find

Asignando parametros de busqueda

Definición en la línea 935 del archivo tags.php.

Hace referencia a KumbiaActiveRecord::get(), get_id_and_name(), get_value_from_action(), Util::getParams(), option_tag(), xhtml_start_tag() y xhtml_tag().

Referenciado por month_field_tag(), time_field_tag() y updater_select().

Gráfico de llamadas para esta función:

Gráfico de llamadas a esta función:

set_droppable	(	$	obj,
		$	action = `''`
	)

Hace que un objeto se pueda arrastrar en la pantalla.

Parámetros:

string	$obj	id del objeto
string	$action	accion a ejecutar al soltar

Devuelve:: string

name: id del objeto action: accion a ejecutar al soltar

Definición en la línea 1183 del archivo tags.php.

Hace referencia a Util::getParams() y xhtml_tag().

Gráfico de llamadas para esta función:

stylesheet_link_tag ( $ name )

Agrega una etiqueta link para incluir un archivo CSS respetando las rutas y convenciones de Kumbia.

Parámetros:

string $name nombre de hoja de estilo

use_variables: utilizar variables de Kumbia en el css

Devuelve:: string

Definición en la línea 364 del archivo tags.php.

Hace referencia a TagsData::$data, Util::getParams() y xhtml_tag().

Referenciado por date_field_tag() y xhtml_template().

Gráfico de llamadas para esta función:

Gráfico de llamadas a esta función:

stylesheet_link_tags ( )

Imprime los CSS cargados mediante stylesheet_link_tag en el <head>

Definición en la línea 1836 del archivo tags.php.

Hace referencia a TagsData::$data.

Referenciado por xhtml_template().

Gráfico de llamadas a esta función:

submit_image_tag	(	$	caption,
		$	src = `''`
	)

Crea un boton de submit tipo imagen para el formulario actual.

Parámetros:

string $caption caption: texto del boton

Devuelve:: html code

Definición en la línea 613 del archivo tags.php.

Hace referencia a Util::getParams() y xhtml_tag().

Gráfico de llamadas para esta función:

submit_remote_tag ( $ caption )

Crea un boton de submit para el formulario remoto actual.

Parámetros:

string $caption caption: texto del boton update: contenedor html a actualizar success: Codigo JavaScript a ejecutar cuando termine la peticion AJAX before: Codigo JavaScript a ejecutar antes de la peticion AJAX complete: Codigo JavaScript que se ejecuta al terminar la peticion AJAX

Devuelve:: html code

Definición en la línea 563 del archivo tags.php.

Hace referencia a Util::getParams() y xhtml_tag().

Gráfico de llamadas para esta función:

submit_tag ( $ caption )

Crea un boton de submit para el formulario actual.

Parámetros:

string $caption

Devuelve:: html code

Definición en la línea 539 del archivo tags.php.

Hace referencia a Util::getParams() y xhtml_tag().

Gráfico de llamadas para esta función:

swf_tag ( $ data )

Permite incluir un objeto flash dentro de una vista respetando las convenciones de directorios y rutas en Kumbia.

Parámetros:

string $data url del archivo flash con o sin extension .swf
height: Alto del flash
width: Ancho del flash
wmode: Modo en que se muestra el flash

Devuelve:: string

Definición en la línea 1775 del archivo tags.php.

Hace referencia a Util::getParams(), xhtml_end_tag() y xhtml_start_tag().

Gráfico de llamadas para esta función:

tab_tag	(	$	tabs,
		$	color = `'green'`,
		$	width = `800`
	)

Definición en la línea 1542 del archivo tags.php.

Hace referencia a KumbiaView::partial().

Gráfico de llamadas para esta función:

text_field_tag ( $ name )

Crea una caja de Texto.

Parámetros:

string $name

Devuelve:: string

Definición en la línea 727 del archivo tags.php.

Hace referencia a Util::getParams() y input_field_tag().

Referenciado por date_field_tag(), numeric_field_tag(), text_field_with_autocomplete() y textupper_field_tag().

Gráfico de llamadas para esta función:

Gráfico de llamadas a esta función:

text_field_with_autocomplete ( $ name )

Caja de texto con autocompletacion.

Parámetros:

string $name id de la caja de texto

action: accion a ejecutar after_update: despues de actualizar message: mensaje mientras se carga

Devuelve:: string

Obtengo id, name y value

Definición en la línea 1469 del archivo tags.php.

Hace referencia a get_id_and_name(), get_kumbia_url(), get_value_from_action(), Util::getParams() y text_field_tag().

Gráfico de llamadas para esta función:

textarea_tag	(	$	name,
		$	value = `null`
	)

Crea un TextArea.

Parámetros:

string	$name	id del textarea
string	$value	valor

Devuelve:: string

Obtengo id, name y value

Definición en la línea 861 del archivo tags.php.

Hace referencia a get_id_and_name(), get_value_from_action(), Util::getParams(), xhtml_end_tag() y xhtml_start_tag().

Gráfico de llamadas para esta función:

textupper_field_tag ( $ name )

Crea una caja de texto que acepta solo texto en Mayuscula.

Parámetros:

string $name

Devuelve:: string

Definición en la línea 767 del archivo tags.php.

Hace referencia a Util::getParams() y text_field_tag().

Gráfico de llamadas para esta función:

time_field_tag ( $ name = '' )

Campo para tipo hora.

Parámetros:

string $name id del campo

format: h:m:s (h=hora, m=minutos, s=segundos)

Devuelve:: string

Definición en la línea 1636 del archivo tags.php.

Hace referencia a get_id_and_name(), get_value_from_action(), Util::getParams(), hidden_field_tag() y select_tag().

Gráfico de llamadas para esta función:

tr_break ( $ x = '' )

Definición en la línea 1194 del archivo tags.php.

tr_color ( )

Crea de colores pasando como parametro los colores.

Obsoleto:

Definición en la línea 1229 del archivo tags.php.

Hace referencia a Util::getParams().

Gráfico de llamadas para esta función:

tr_color_class ( )

Crea un pasando como parametro las class.

tr_color_class('browse_primary', 'browse_secondary')

Devuelve:: string

Definición en la línea 1260 del archivo tags.php.

Hace referencia a Util::getParams().

Gráfico de llamadas para esta función:

updater_select	(	$	name,
		$	data = `array()`
	)

Crea un select que actualiza un container usando una accion ajax que cambia dependiendo del id selecionado en el select.

Parámetros:

string	$id
array	$data	update: contenedor html a actualizar container: contenedor html a actualizar action: accion que recibe el parametro

Nota: soporta todas las funciones del select_tag

Devuelve:: code

Obtengo id, name y value

Definición en la línea 1393 del archivo tags.php.

Hace referencia a get_id_and_name(), get_value_from_action(), Util::getParams() y select_tag().

Gráfico de llamadas para esta función:

upload_image_tag ( $ name )

Crea un componente para Subir Imagenes.

Parámetros:

string $name id del tag

Devuelve:: string

Definición en la línea 1122 del archivo tags.php.

Hace referencia a Util::getParams().

Gráfico de llamadas para esta función:

xhtml_end_tag ( $ tag )

Construye el cierre de un tag xhtml.

Parámetros:

string $tag nombre de etiqueta

Devuelve:: string

Definición en la línea 65 del archivo tags.php.

Hace referencia a Util::getParams().

Referenciado por swf_tag() y textarea_tag().

Gráfico de llamadas para esta función:

Gráfico de llamadas a esta función:

xhtml_start_tag	(	$	tag,
		$	attrs = `null`
	)

Construye el inicio del tag xhtml.

Parámetros:

string	$tag	nombre de etiqueta
array	$attrs	atributos para la etiqueta

Devuelve:: string

Definición en la línea 32 del archivo tags.php.

Hace referencia a Util::getParams().

Referenciado por form_remote_tag(), form_tag(), select_tag(), swf_tag() y textarea_tag().

Gráfico de llamadas para esta función:

Gráfico de llamadas a esta función:

xhtml_tag	(	$	tag,
		$	attrs = `null`
	)

Construye un tag xhtml.

Parámetros:

string	$tag	nombre de etiqueta
array	$attrs	atributos para la etiqueta

content: contenido, este parametro con nombre es incluido debido a que el argumento $content puede ser confundido con un parametro con nombre, si este llegase a poseer la sintaxis de los parametros con nombre.

Nota: el parametro con nombre content nunca es utilizado como un atributo para el tag, a menos de que este se pase en el array de atributos.