XUL Programmer's Reference Manual

<scrollbar>

Attributes Common Children
id <scrollbarbutton />
class <slider>
curpos  
pageIncrement  
flex  
align  
orient  
autostretch  
 

<scrollbarbutton>

Attributes Common Children
id  * * *
class  
type  
orient  
autostretch  

 

<slider>

Attributes Common Children
id <thumb />
class  
curpos  
maxpos  
increment  
pageIncrement  
flex  
align  
orient  
autostretch  

 

<grippy>

Attributes Common Children
accesskey * * *
id  
class  
src  
 
The term "handles" refers, in this case, to XUL widgets that are used to manipulate the user interface by grabbing, sliding, or scrolling. Grippies (see <grippy) provide handles for toolbars and sidebars, scrollbars and their widgets (scrollbarbuttons, sliders) provide scrollbars when the size of the content exceeds that of the containing box.

The scrollbar is a widget that displays the progress of an operation as it executes. The scrollbarbutton is the actual button in the scrollbar. The slider is a widget that represents the scrollable area in a scrollbar; it inherits from box. The following example shows a simple XUL scrollbar with all of its children:

 
<scrollbar align="vertical" 
    curpos="50" 
    pageIncrement="20" 
    increment="5" 
    flex="100%">
  <scrollbarbutton class="decrement"/>
  <slider flex="100%">
     <thumb value="this is it" flex="0%"/>
  </slider>
  <scrollbarbutton class="increment"/>
</scrollbar>
This structure is typical of the standard win32 scrollbar widgetry: inside a scrollbar, there is a button at the top for decrementing the scroll, or scrolling back up the page, there is a "thumb" button within the slider area of the scrollbar, and there is another scrollbarbutton at the bottom for incrementing the scroll.
 

 
 

Last updated: 3/20/00 Ian Oeschger