Scrollbar
Se utiliza para reemplazar la barra de desplazamiento nativa del navegador.
Uso básico
Use la propiedad height
para establecer la altura de la barra de desplazamiento, o si no se establece, se adapta de acuerdo a la altura del contenedor padre.
Desplazamiento horizontal
Cuando el ancho del elemento es mayor que el ancho de la barra de desplazamiento, se muestra la barra de desplazamiento horizontal.
Altura máxima
La barra de desplazamiento sólo se muestra cuando la altura del elemento excede la altura máxima.
Desplazamiento manual
Use los métodos setScrollTop
y setScrollLeft
para controlar manualmente la barra de desplazamiento.
API
Atributos
Nombre | Descripción | Tipo | Por defecto |
---|---|---|---|
height | altura de la barra de desplazamiento | string / number | — |
max-height | altura máxima de la barra de desplazamiento | string / number | — |
native | si usar el estilo nativo de la barra de desplazamiento | boolean | false |
wrap-style | estilo del contenedor envoltorio | string / object | — |
wrap-class | clase del contenedor envoltorio | string | — |
view-style | estilo de la vista | string / object | — |
view-class | clase de la vista | string | — |
noresize | no responder a los cambios de tamaño del contenedor, si el tamaño del contenedor no cambia, es mejor configurarlo para optimizar el rendimiento | boolean | false |
tag | etiqueta de elemento de la vista | string | div |
always | si mostrar siempre la barra de desplazamiento | boolean | false |
min-size | tamaño mínimo de la barra de desplazamiento | number | 20 |
id 2.4.0 | id of view | string | — |
role 2.4.0 a11y | role of view | string | — |
aria-label 2.4.0 a11y | aria-label of view | string | — |
aria-orientation 2.4.0 a11y | aria-orientation of view | enum | — |
tabindex 2.8.3 | tabindex of wrap container | number / string | — |
Eventos
Nombre | Descripción | Tipo |
---|---|---|
scroll | se activa cuando se desplaza, regresa la distancia de desplazamiento | Function |
Slots
Nombre | Descripción |
---|---|
default | personaliza el contenido por defecto |
Expuesto
Nombre | Descripción | Tipo |
---|---|---|
handleScroll | maneja evento de desplazamiento | Function |
scrollTo | desplaza a un conjunto particular de coordenadas | Function |
setScrollTop | Establece distancia hacia la parte superior | Function |
setScrollLeft | Establece distancia hacia la izquierda | Function |
update | actualiza el estado de la barra de desplazamiento manualmente | Function |
wrapRef | referencia de la barra de desplazamiento | object |
Fuente
Componentes • Style • Documentación