Visit Mozilla.org

Tutorial de XUL:Barras de desplazamiento

De MDC

Imagen:traduccion-pendiente.png Esta página está traduciéndose a partir del artículo XUL_Tutorial:Scroll_Bars, razón por la cual puede haber algunos errores sintácticos o partes sin traducir. Puedes colaborar continuando con la traducción

Ahora, Aprenderemos a añadir barras de desplazamiento en una ventana

[editar] Añadiendo barras de desplazamiento

Una barra de desplazamiento sirve para que un usuario pueda moverse en un documento grande. También puedes usarla cuando tienes que buscar un valor que está dentro de un cierto rango. Las barras de desplazamiento pueden ser creadas de varias formas. En XUL, puede ser creada usando la etiqueta Plantilla:XULElem. Algunos elementos, como cajas de texto, también añadirán barras de desplazamiento cuando el contenido de dentro es demasiado grande

En esta sección, hablaremos de la creación de una barra de desplazamiento independiente. El usuario pondrá el valor ajustando la barra de desplazamiento. Probablemente no usarás esto a menudo. Una barra de desplazamiento está compuesta de varias partes: el deslizador, que es la parte principal de la barra de desplazamiento con la caja ajustable, y los dos botones de flecha. Una barra de desplazamiento crea todos estos elementos automáticamente.

Imagen:BarraDesplazamiento.jpg

La síntaxis de una barra de desplazamiento es:

<scrollbar
    id="identifier"
    orient="horizontal"
    curpos="20"
    maxpos="100"
    increment="1"
    pageincrement="10"/>

Los atributos son los siguientes:

Plantilla:XULAttr id
El único identificador de la barra de desplazamiento
Plantilla:XULAttr orient
Especifica la dirección de la barra de desplazamiento. Por defecto es horizontal, que crea una barra de desplazamiento que se extiende de la izquierda a la derecha. También puedes especificar vertical que crea una barra de desplazamiento que se extiende de arriba abajo.
Plantilla:XULAttr curpos
Indica la posición actual de la barra de desplazamiento (la caja que usted puede deslizar hacia adelante y hacia atrás.) el rango de valores se extiende de 0 al valor de maxpos. Este valor no es necesario. El valor por defecto es 0.
Plantilla:XULAttr maxpos
Indica la posición máxima de la barra de desplazamiento. Es un valor numérico. El valor por defecto es 100.
Plantilla:XULAttr increment
Este valor especifica cuánto cambia el valor de curpos cuando el usuario pulsa sobre una de las flechas de barra de desplazamiento. El valor por defecto es 1.
Plantilla:XULAttr pageincrement
Este valor especifica cuánto cambia el valor curpos cuando el usuario pasa páginas con la barra de desplazamiento, que puede hacerse pulsando entre la caja y las flechas. El valor por defecto es 10.

El ejemplo dado en la sintaxis superior creará una barra de desplazamiento que puede extenderse de un valor de 0 a 100. El valor 100 podría ser el número de líneas en una lista, pero podría ser lo que quieras. El valor inicial en este ejemplo es 20. Pulsando sobre una de las flechas de barra de desplazamiento, el valor se cambiaría por 1 encima de o abajo. Pero paginando por la barra de desplazamiento, el valor se cambiará por 10.

Cuando el usuario pulsa las flechas de la barra de desplazamiento, se moverá la cantidad especificada por el valor increment. El aumento del valor de este atributo hará que la barra de desplazamiento se mueva más lejos con cada click. La posición izquierda o más alta de la barra de desplazamiento tiene el valor 0 y la posición de derecha o más baja de la barra de desplazamiento tiene el valor dado por maxpos.

Ajustando los valores de la barra de desplazamiento, puedes tener el thumb posicionado donde quieras y el cambiarlo cuando pulsas las flechas tal como quieras.

Después, Aprenderemos a crear barras de herramientas.