Appendix C. Programmer's Reference

Chia sẻ: Thanh Cong | Ngày: | Loại File: PDF | Số trang:11

Thêm vào BST

Báo xấu

75
lượt xem 3
download

Download Vui lòng tải xuống để xem tài liệu đầy đủ

Phụ lục này là một tham chiếu dễ sử dụng có chứa thông tin về các yếu tố XUL, XBL yếu tố, và các thuộc tính sự kiện. Thông tin chi tiết về mỗi yếu tố và các công trình sự kiện trong một ứng dụng Mozilla được bảo hiểm trong phần còn lại của cuốn sách; để tìm hiểu làm thế nào để sử dụng XUL hoặc XBL, đọc Chương 3 và Chương 7. Một khi bạn biết làm thế nào để sử dụng XUL và XBL, tin này cho phép bạn tìm kiếm tất cả các thẻ có...

Chủ đề:

Bình luận(0) Đăng nhập để gửi bình luận!

Lưu

Nội dung Text: Appendix C. Programmer's Reference

Appendix C. Programmer's Reference This appendix is an easy-to-use reference that contains information about XUL elements, XBL elements, and event attributes. Details about how each element and event works within a Mozilla application are covered in the rest of the book; to learn how to use XUL or XBL, read Chapter 3 and Chapter 7. Once you know how to use XUL and XBL, this reference allows you to look up all available tags and elements quickly. Each entry listed below includes a brief description of the element or event, its purpose, what attributes the element or event has, and what other related elements or events you can look at to get more information. C.1. XUL Element Set Table of Contents action -- Child element in a XUL template structure that draws content for matched data arrowscrollbox -- Container box for scrolling contents autorepeatbutton -- Provides arrows for a scrolling area binding -- Child element in a XUL template that optionally matches in the data bindings -- Substructure in a XUL template that collects the optional binding rules box -- Generic container and layout element broadcaster -- Notifies elements when a change occurs in the UI broadcasterset -- Container for broadcaster elements
browser -- Web-content container button -- A widget that activates some functionality when pressed caption -- Provides heading for a groupbox element checkbox -- Indicates a specified feature's on/off state colorpicker -- Widget used to choose a color column -- A column in a grid columns -- Container for the number of columns in a grid command -- Defines functionality that can be called from multiple sources commands -- Container for a group of command sets commandset -- A container for multiple command elements conditions -- Defines the conditions within a template rule content -- Binds variables in a template deck -- Box container that displays one child element at a time description -- Holder for block of text that can wrap to multiple lines dialog -- Root element for secondary XUL window dialogheader -- Styled text heading for UI panel editor -- Content area for editable web content grid -- Widget for laying out content in a structured tabular fashion grippy -- Visible widget used on a grippy bar to expand or collapse a UI region groupbox -- Box with frame surrounding it hbox -- Box container whose children are laid out horizontally
iframe -- Web content area image -- Display of a supported type image key -- Definition for a keyboard shortcut keybinding -- Container for a keyset or group of keysets keyset -- Container for one or more key elements label -- Simple text display element and label for a control element listbox -- Used for display of a flat list of items listcell -- Single cell of a listbox listcol -- Listbox column definition listcols -- Container for listbox columns (listcol) listhead -- Container for column header in list boxes (listheader) listheader -- Text header for listbox column listitem -- Listbox row definition member -- Matches container relationships in which the parent element is given by a container element and the child by a child element menu -- A menu element for containing menu items menubar -- Containing element for one or more menus menuitem -- Single selectable choice in a menu menulist -- Drop-down list of selectable items menupopup -- Pop-up container for menu items menuseparator -- Line separating menu items observes -- Broadcast event and attribute listener
overlay -- Root element in a separate file that contains reusable XUL content page -- Root element of XUL file loaded in a content frame popup -- Box container as child window popupset -- Container for popup elements progressmeter -- Visual progress indicator of a time-consuming operation radio -- Single on/off choice represented as selectable circle radiogroup -- Framed box for containing radio elements resizer -- Window-resizing element row -- Container for grid cells laid out consecutively rows -- Definition for grid rows rule -- Defines rules for rendering data as XUL script -- Declaration of script used in XUL file scrollbar -- Widget for scrolling in a container scrollbarbutton -- Button used to move position of scrollbar thumb scrollbox -- Box for scrolling content separator -- Bar between elements slider -- A scrollbar without buttons spacer -- Blank space separating element splitter -- Element for dragging and resizing associated elements stack -- Shows children one on top of one another, all at the same time statusbar -- Box container for status elements
statusbarpanel -- Single unit of a statusbar stringbundle -- Holder of localized properties for use in script stringbundleset -- Container for stringbundle elements tab -- A single selectable tab of a tabbox tabbox -- Box container for tab panels tabbrowser -- Tabbed holder for a set of web content views tabpanel -- A single panel of a tabbox tabpanels -- Container for tabpanel elements tabs -- Container for tab elements template -- A high-level widget used to build content dynamically from data textbox -- Accepts text input from user thumb -- Object used to move content in scrollable area toolbar -- Holder of buttons for quick-access UI functionality toolbarbutton -- Specially adapted button for use in a toolbar toolbarseparator -- Visible separator for elements contained in a toolbar toolbox -- Optional container for menu bars and toolbars tooltip -- Pop-up window for context-sensitive help tree -- Hierarchical holder of information represented as rows treecell -- A single cell in a tree treechildren -- The main body of a tree; a container for treeitems treecol -- A single column of a tree
treecols -- Container for tree columns treeitem -- A treerow container treerow -- A single row of a tree triple -- Substructure of a template that matches RDF statements in the data vbox -- Box container with vertically laid out children window -- Root element of a top-level XUL window document wizard -- Window used to step though a task wizardpage -- A single panel (step) of a wizard XUL isn't yet identified as a specification, and the language is still changing. The elements and attributes given here represent a stable subset of the XUL widget set. XML allows you to define new elements and attributes arbitrarily (which is partly what makes a powerful extension like XBL possible) in your markup. Although it's discouraged in practice, Mozilla application developers -- even those working on the Mozilla source itself -- often use this flexibility to manage data in one-off attributes. For example, you may find XUL buttons in the source with attributes like "loading," which is not part of the XUL specification. In fact, XBL's presence, XML's flexibility, and DOM interfaces blur the distinction between valid XUL and other XML markup. This reference tries to document all widgets in the XUL 1.0 release, any additional attributes these elements have, and their use in Mozilla application development. All XUL elements have the attributes shown in Table C-1. Table C-1. Common XUL element attributes
Attribute Description Specifies how child elements are align aligned: baseline, center, end, start, or stretch (Boolean) Specifies whether events allowevents should be passed to the child elements The element class of the ; often used class for class-based style rules (Boolean) Specifies whether the collapsed element is collapsed or displayed; defaults to false (Boolean) Specifies whether the container element can have child elements Used in templates; points to RDF containment property represented by this XUL element Points to the context menu that this context element should use datasources Used in templates; points to the RDF
Attribute Description data that gets processed Used for debugging XUL; adds debug borders to make the element and its layout easily visible Specifies the direction of the dir children: normal or reverse (Boolean) Used for template; empty specifies that the container has no children Specifies whether the children should equalsize be of the same size: always or never Provides an integer or percent value that specifies the flexibility of an flex element relative to its siblings within a container Provides an integer that can group flexgroup elements and give them the same degree of flexibility height Specifies an element's height
Attribute Description (Boolean) Specifies whether the hidden element is displayed; defaults to false id A unique identifier for the element Names the ID of the element after which this element should be insertafter overlaid; this attribute works only in overlays Names the ID of the element which this element should be overlaid insertbefore before; this attribute works only in overlays Specifies an element's position within left a container in pixels to the left Specifies an element's maximum maxheight height Specifies an element's maximum maxwidth width minheight Specifies an element's minimum
Attribute Description height Specifies an element's minimum minwidth width Points to a broadcasting element observes whose state this element observes (Integer) Specifies the element's order ordinal within the parent Shows the element's orientation: orient vertical or horizontal Shows how children should be pack distributed within this container: center, end, or start Shows which of the element's persist attributes should be persisted/stored for reuse Shows the element's position within a position list (e.g., menuitems in a menu) Specifies the RDF data root to begin ref processing (used in templates)
Attribute Description Provides style rules for the current style element Specifies an existing template to use template for this content (used in templates) Specifies a pop up or tooltip ID to be tooltip used for this element Specifies text to be displayed in the tooltiptext element's tooltip (doesn't require a separate tooltip attribute) Shows the current element's position top within a container in pixels from the top Specifies the root in the XUL where uri content processing begins (used in templates) width Specifies an element's width