diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 00000000..60ed8a6e
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,33 @@
+# Change Log
+
+Below you will find all the different changes that have been added since the first introduction of versioning for the bbUI toolkit.
+
+## Version 0.9.1
+
+* First version number provided for the toolkit
+* Modified menus to require both a caption and an image for PlayBook 2.x and BlackBerry 10 to follow UX guidelines
+* Image List item text will now add an Ellipsis "..." to the end of text that is too long for the list item on devices that support it
+* Merged the Inbox style list into the Image List control
+* Removed the tall list layout... This will be merging into a feature of the Image List in a upcoming release
+* Added sub title text to the image list control
+* JS and CSS files now renamed to match the toolkit version
+* Updated all the samples to show how to handle BB10 color themes while supporting non-BB10 devices at the same time
+* New **manditory bb.int(options)** function to initialize the toolkit allowing for overrides of properties and events
+* bb.onscreenready has now been removed and added as an option for the bb.init() function
+* New header item support for the image list
+* New grid view for BlackBerry 10
+* New action bar for BlackBerry 10 with dark and light themes. Support for back button, highlight tabs, and action buttons
+* New highlight and accent colors for BlackBerry 10
+* New BlackBerry 10 button & pill button styling with dark and light themes
+* New BlackBerry 10 swipe down menu styling
+* New BlackBerry 10 Context Menu
+* New BlackBerry 10 Press and hold Context Menu integration into Image Lists
+* New BlackBerry 10 styled inputs with "delete" button and styled placeholder text
+* Added screen and list coloring for BB10 with dark and light themes
+* New **ondomready** event which fires after your screen has been loaded into the DOM
+* Changed all of the isBB5/isBB6/etc functions to boolean properties. This avoids a scenario where these may evaluate to true simply because the function was assigned
+* Sample: Added a fun random color changer for highlight and accent colors on BlackBerry 10
+* Sample: Added BlackBerry 10 grid
+* Sample: Added BlackBerry 10 action bar
+* Sample: Grouped items on main menu screen
+
\ No newline at end of file
diff --git a/Jakefile b/Jakefile
index a7b71bfb..cbf67efe 100644
--- a/Jakefile
+++ b/Jakefile
@@ -52,12 +52,12 @@ task('build', ['clean'], function () {
});
output += "bb.assignBackHandler(bb.popScreen);";
- fs.writeFileSync(__dirname + "/pkg/bbUI.js", output);
- fs.writeFileSync(__dirname + "/samples/bbUI.js", output);
+ fs.writeFileSync(__dirname + "/pkg/bbui-0.9.1.js", output);
+ fs.writeFileSync(__dirname + "/samples/bbui-0.9.1.js", output);
css += include("src/bbUI.css");
- fs.writeFileSync(__dirname + "/pkg/bbUI.css", css);
- fs.writeFileSync(__dirname + "/samples/bbUI.css", css);
+ fs.writeFileSync(__dirname + "/pkg/bbui-0.9.1.css", css);
+ fs.writeFileSync(__dirname + "/samples/bbui-0.9.1.css", css);
console.log("Prepare ship for ludicrous speed!");
});
diff --git a/LICENSE b/LICENSE
index 7b57bab2..6a6b0d43 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,15 +1,307 @@
-/*
-* Copyright 2010-2012 Research In Motion Limited.
-*
-* Licensed under the Apache License, Version 2.0 (the "License");
-* you may not use this file except in compliance with the License.
-* You may obtain a copy of the License at
-*
-* http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
-* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
-*/
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+ ==========================================================
+ IScroll.js
+ ==========================================================
+
+ Copyright (c) 2009-2010 Matteo Spinelli, http://cubiq.org/
+
+ Permission is hereby granted, free of charge, to any person
+ obtaining a copy of this software and associated documentation
+ files (the "Software"), to deal in the Software without
+ restriction, including without limitation the rights to use,
+ copy, modify, merge, publish, distribute, sublicense, and/or sell
+ copies of the Software, and to permit persons to whom the
+ Software is furnished to do so, subject to the following
+ conditions:
+
+ The above copyright notice and this permission notice shall be
+ included in all copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+ OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+ WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ OTHER DEALINGS IN THE SOFTWARE.
+
+ ==========================================================
+ Plastique Icons
+ ==========================================================
+
+ Plastique Icon Set by Iconify.it, LLC is licensed under a Creative Commons Attribution-Share Alike 3.0 Unported License.
+
+ By downloading and using these files, you are agreeing to be bound by the
+ terms of the license corresponding to each package. If you do not agree to the terms of any of the enclosed licenses you must delete all copies of these files from your computer or computers.
+
+ Additionally, please provide a credit line and link back to my site at:
+
+ http://iconify.it
+
+ I hope you find the files useful. If you would like to help support my work, you
+ can make a donation to my PayPal account - scott.catalyst@gmail.com
+
+ Thank You,
+ Scott Lewis
+ Iconify.it, LLC
+
+
+ Creative Commons Attribution 3.0 Unported
+ http://creativecommons.org/licenses/by/3.0/legalcode
+
+ THE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS CREATIVE COMMONS PUBLIC LICENSE ("CCPL" OR "LICENSE"). THE WORK IS PROTECTED BY COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.
+
+ BY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS LICENSE. TO THE EXTENT THIS LICENSE MAY BE CONSIDERED TO BE A CONTRACT, THE LICENSOR GRANTS YOU THE RIGHTS CONTAINED HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.
+
+ 1. Definitions
+
+ "Adaptation" means a work based upon the Work, or upon the Work and other pre-existing works, such as a translation, adaptation, derivative work, arrangement of music or other alterations of a literary or artistic work, or phonogram or performance and includes cinematographic adaptations or any other form in which the Work may be recast, transformed, or adapted including in any form recognizably derived from the original, except that a work that constitutes a Collection will not be considered an Adaptation for the purpose of this License. For the avoidance of doubt, where the Work is a musical work, performance or phonogram, the synchronization of the Work in timed-relation with a moving image ("synching") will be considered an Adaptation for the purpose of this License.
+ "Collection" means a collection of literary or artistic works, such as encyclopedias and anthologies, or performances, phonograms or broadcasts, or other works or subject matter other than works listed in Section 1(f) below, which, by reason of the selection and arrangement of their contents, constitute intellectual creations, in which the Work is included in its entirety in unmodified form along with one or more other contributions, each constituting separate and independent works in themselves, which together are assembled into a collective whole. A work that constitutes a Collection will not be considered an Adaptation (as defined above) for the purposes of this License.
+ "Distribute" means to make available to the public the original and copies of the Work or Adaptation, as appropriate, through sale or other transfer of ownership.
+ "Licensor" means the individual, individuals, entity or entities that offer(s) the Work under the terms of this License.
+ "Original Author" means, in the case of a literary or artistic work, the individual, individuals, entity or entities who created the Work or if no individual or entity can be identified, the publisher; and in addition (i) in the case of a performance the actors, singers, musicians, dancers, and other persons who act, sing, deliver, declaim, play in, interpret or otherwise perform literary or artistic works or expressions of folklore; (ii) in the case of a phonogram the producer being the person or legal entity who first fixes the sounds of a performance or other sounds; and, (iii) in the case of broadcasts, the organization that transmits the broadcast.
+ "Work" means the literary and/or artistic work offered under the terms of this License including without limitation any production in the literary, scientific and artistic domain, whatever may be the mode or form of its expression including digital form, such as a book, pamphlet and other writing; a lecture, address, sermon or other work of the same nature; a dramatic or dramatico-musical work; a choreographic work or entertainment in dumb show; a musical composition with or without words; a cinematographic work to which are assimilated works expressed by a process analogous to cinematography; a work of drawing, painting, architecture, sculpture, engraving or lithography; a photographic work to which are assimilated works expressed by a process analogous to photography; a work of applied art; an illustration, map, plan, sketch or three-dimensional work relative to geography, topography, architecture or science; a performance; a broadcast; a phonogram; a compilation of data to the extent it is protected as a copyrightable work; or a work performed by a variety or circus performer to the extent it is not otherwise considered a literary or artistic work.
+ "You" means an individual or entity exercising rights under this License who has not previously violated the terms of this License with respect to the Work, or who has received express permission from the Licensor to exercise rights under this License despite a previous violation.
+ "Publicly Perform" means to perform public recitations of the Work and to communicate to the public those public recitations, by any means or process, including by wire or wireless means or public digital performances; to make available to the public Works in such a way that members of the public may access these Works from a place and at a place individually chosen by them; to perform the Work to the public by any means or process and the communication to the public of the performances of the Work, including by public digital performance; to broadcast and rebroadcast the Work by any means including signs, sounds or images.
+ "Reproduce" means to make copies of the Work by any means including without limitation by sound or visual recordings and the right of fixation and reproducing fixations of the Work, including storage of a protected performance or phonogram in digital form or other electronic medium.
+ 2. Fair Dealing Rights. Nothing in this License is intended to reduce, limit, or restrict any uses free from copyright or rights arising from limitations or exceptions that are provided for in connection with the copyright protection under copyright law or other applicable laws.
+
+ 3. License Grant. Subject to the terms and conditions of this License, Licensor hereby grants You a worldwide, royalty-free, non-exclusive, perpetual (for the duration of the applicable copyright) license to exercise the rights in the Work as stated below:
+
+ to Reproduce the Work, to incorporate the Work into one or more Collections, and to Reproduce the Work as incorporated in the Collections;
+ to create and Reproduce Adaptations provided that any such Adaptation, including any translation in any medium, takes reasonable steps to clearly label, demarcate or otherwise identify that changes were made to the original Work. For example, a translation could be marked "The original work was translated from English to Spanish," or a modification could indicate "The original work has been modified.";
+ to Distribute and Publicly Perform the Work including as incorporated in Collections; and,
+ to Distribute and Publicly Perform Adaptations.
+ For the avoidance of doubt:
+
+ Non-waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme cannot be waived, the Licensor reserves the exclusive right to collect such royalties for any exercise by You of the rights granted under this License;
+ Waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme can be waived, the Licensor waives the exclusive right to collect such royalties for any exercise by You of the rights granted under this License; and,
+ Voluntary License Schemes. The Licensor waives the right to collect royalties, whether individually or, in the event that the Licensor is a member of a collecting society that administers voluntary licensing schemes, via that society, from any exercise by You of the rights granted under this License.
+ The above rights may be exercised in all media and formats whether now known or hereafter devised. The above rights include the right to make such modifications as are technically necessary to exercise the rights in other media and formats. Subject to Section 8(f), all rights not expressly granted by Licensor are hereby reserved.
+
+ 4. Restrictions. The license granted in Section 3 above is expressly made subject to and limited by the following restrictions:
+
+ You may Distribute or Publicly Perform the Work only under the terms of this License. You must include a copy of, or the Uniform Resource Identifier (URI) for, this License with every copy of the Work You Distribute or Publicly Perform. You may not offer or impose any terms on the Work that restrict the terms of this License or the ability of the recipient of the Work to exercise the rights granted to that recipient under the terms of the License. You may not sublicense the Work. You must keep intact all notices that refer to this License and to the disclaimer of warranties with every copy of the Work You Distribute or Publicly Perform. When You Distribute or Publicly Perform the Work, You may not impose any effective technological measures on the Work that restrict the ability of a recipient of the Work from You to exercise the rights granted to that recipient under the terms of the License. This Section 4(a) applies to the Work as incorporated in a Collection, but this does not require the Collection apart from the Work itself to be made subject to the terms of this License. If You create a Collection, upon notice from any Licensor You must, to the extent practicable, remove from the Collection any credit as required by Section 4(b), as requested. If You create an Adaptation, upon notice from any Licensor You must, to the extent practicable, remove from the Adaptation any credit as required by Section 4(b), as requested.
+ If You Distribute, or Publicly Perform the Work or any Adaptations or Collections, You must, unless a request has been made pursuant to Section 4(a), keep intact all copyright notices for the Work and provide, reasonable to the medium or means You are utilizing: (i) the name of the Original Author (or pseudonym, if applicable) if supplied, and/or if the Original Author and/or Licensor designate another party or parties (e.g., a sponsor institute, publishing entity, journal) for attribution ("Attribution Parties") in Licensor's copyright notice, terms of service or by other reasonable means, the name of such party or parties; (ii) the title of the Work if supplied; (iii) to the extent reasonably practicable, the URI, if any, that Licensor specifies to be associated with the Work, unless such URI does not refer to the copyright notice or licensing information for the Work; and (iv) , consistent with Section 3(b), in the case of an Adaptation, a credit identifying the use of the Work in the Adaptation (e.g., "French translation of the Work by Original Author," or "Screenplay based on original Work by Original Author"). The credit required by this Section 4 (b) may be implemented in any reasonable manner; provided, however, that in the case of a Adaptation or Collection, at a minimum such credit will appear, if a credit for all contributing authors of the Adaptation or Collection appears, then as part of these credits and in a manner at least as prominent as the credits for the other contributing authors. For the avoidance of doubt, You may only use the credit required by this Section for the purpose of attribution in the manner set out above and, by exercising Your rights under this License, You may not implicitly or explicitly assert or imply any connection with, sponsorship or endorsement by the Original Author, Licensor and/or Attribution Parties, as appropriate, of You or Your use of the Work, without the separate, express prior written permission of the Original Author, Licensor and/or Attribution Parties.
+ Except as otherwise agreed in writing by the Licensor or as may be otherwise permitted by applicable law, if You Reproduce, Distribute or Publicly Perform the Work either by itself or as part of any Adaptations or Collections, You must not distort, mutilate, modify or take other derogatory action in relation to the Work which would be prejudicial to the Original Author's honor or reputation. Licensor agrees that in those jurisdictions (e.g. Japan), in which any exercise of the right granted in Section 3(b) of this License (the right to make Adaptations) would be deemed to be a distortion, mutilation, modification or other derogatory action prejudicial to the Original Author's honor and reputation, the Licensor will waive or not assert, as appropriate, this Section, to the fullest extent permitted by the applicable national law, to enable You to reasonably exercise Your right under Section 3(b) of this License (right to make Adaptations) but not otherwise.
+ 5. Representations, Warranties and Disclaimer
+
+ UNLESS OTHERWISE MUTUALLY AGREED TO BY THE PARTIES IN WRITING, LICENSOR OFFERS THE WORK AS-IS AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND CONCERNING THE WORK, EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING, WITHOUT LIMITATION, WARRANTIES OF TITLE, MERCHANTIBILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, OR THE ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OF ABSENCE OF ERRORS, WHETHER OR NOT DISCOVERABLE. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO SUCH EXCLUSION MAY NOT APPLY TO YOU.
+
+ 6. Limitation on Liability. EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, IN NO EVENT WILL LICENSOR BE LIABLE TO YOU ON ANY LEGAL THEORY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES ARISING OUT OF THIS LICENSE OR THE USE OF THE WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+ 7. Termination
+
+ This License and the rights granted hereunder will terminate automatically upon any breach by You of the terms of this License. Individuals or entities who have received Adaptations or Collections from You under this License, however, will not have their licenses terminated provided such individuals or entities remain in full compliance with those licenses. Sections 1, 2, 5, 6, 7, and 8 will survive any termination of this License.
+ Subject to the above terms and conditions, the license granted here is perpetual (for the duration of the applicable copyright in the Work). Notwithstanding the above, Licensor reserves the right to release the Work under different license terms or to stop distributing the Work at any time; provided, however that any such election will not serve to withdraw this License (or any other license that has been, or is required to be, granted under the terms of this License), and this License will continue in full force and effect unless terminated as stated above.
+ 8. Miscellaneous
+
+ Each time You Distribute or Publicly Perform the Work or a Collection, the Licensor offers to the recipient a license to the Work on the same terms and conditions as the license granted to You under this License.
+ Each time You Distribute or Publicly Perform an Adaptation, Licensor offers to the recipient a license to the original Work on the same terms and conditions as the license granted to You under this License.
+ If any provision of this License is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this License, and without further action by the parties to this agreement, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.
+ No term or provision of this License shall be deemed waived and no breach consented to unless such waiver or consent shall be in writing and signed by the party to be charged with such waiver or consent.
+ This License constitutes the entire agreement between the parties with respect to the Work licensed here. There are no understandings, agreements or representations with respect to the Work not specified here. Licensor shall not be bound by any additional provisions that may appear in any communication from You. This License may not be modified without the mutual written agreement of the Licensor and You.
+ The rights granted under, and the subject matter referenced, in this License were drafted utilizing the terminology of the Berne Convention for the Protection of Literary and Artistic Works (as amended on September 28, 1979), the Rome Convention of 1961, the WIPO Copyright Treaty of 1996, the WIPO Performances and Phonograms Treaty of 1996 and the Universal Copyright Convention (as revised on July 24, 1971). These rights and subject matter take effect in the relevant jurisdiction in which the License terms are sought to be enforced according to the corresponding provisions of the implementation of those treaty provisions in the applicable national law. If the standard suite of rights granted under applicable copyright law includes additional rights not granted under this License, such additional rights are deemed to be included in the License; this License is not intended to restrict the license of any rights under applicable law.
+
\ No newline at end of file
diff --git a/README.md b/README.md
index 705dc510..aab27cb8 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,17 @@
-![Image List](bbUI.js/raw/master/logos/bbUI_100x403.png)
+![logo](bbUI.js/raw/master/logos/bbUI_100x403.png)
+
+_**Current version: 0.9.1 BETA**_
The goal of the bbUI toolkit is to provide a BlackBerry® look and feel for HTML5 applications using the
[BlackBerry WebWorks](http://developer.blackberry.com/html5) framework. It provides common UI constructs that
are found on the BlackBerry operating system so that you can create an application that follows the UI guidelines
and looks at home on a BlackBerry with very little effort.
-All changes can be found in the [Commit History](https://github.com/blackberry/bbUI.js/commits/master) for this repo.
+All changes can be found in the [Commit History](https://github.com/blackberry/bbUI.js/commits/master) for this repo or in the [Change Log](bbUI.js/blob/master/CHANGELOG.md).
_**NOTE: bbUI DropDowns on BB5/BB6/B7 require BlackBerry WebWorks SDK v2.3 for Smartphones or higher**_
-This toolkit is currently in an incubation stage and we're working on getting things up and going. Focus is on BB6/BB7 and then back-port for BB5. We'll also be adding some PlayBook look and feel
+This toolkit is currently in an incubation stage and we're working on getting things up and going. Focus is on BB6/BB7/PlayBook/BB10 and then back-port for BB5.
**Author(s)**
@@ -19,8 +21,12 @@ This toolkit is currently in an incubation stage and we're working on getting th
* [David Sosby](https://github.com/dsosby) follow me on Twitter [@ramdump](https://twitter.com/#!/ramdump)
* [Rory Craig-Barnes](https://github.com/glasspear) follow me on Twitter [@roryboy](https://twitter.com/#!/roryboy)
+Icons in "samples/images/icons" are [Plastique Icons by Scott Lewis](http://iconify.it/) under the [Creative Commons Attribution-Share Alike 3.0 Unported License](http://creativecommons.org/licenses/by-sa/3.0/legalcode) as
+[specified here](http://www.iconfinder.com/browse/iconset/plastique-icons/#readme).
+
## Tested On
+* BlackBerry Dev Alpha
* BlackBerry Torch 9860 v7.0.0.x
* BlackBerry Curve 9360 v7.0.0.x
* BlackBerry Bold 9700 v6.0.0.546
@@ -67,7 +73,7 @@ To properly use the functionality of bbUI in your application, you will need at
-Additionally, if you use dropdowns in your application, you will need to include the additional feature:
+Additionally, if you use dropdowns in your application, you will need to include the additional feature:
@@ -75,66 +81,97 @@ For menus to work on Smartphones you will need to include the feature:
-For menus to work on PlayBook you will need to include the feature:
+For menus to work on PlayBook and BlackBerry 10 you will need to include the feature:
-## Managing Screens
+## Toolkit Initialization
-the bbUI toolkit builds the application's UI in the most optimized fashion for the target operating system. It follows a methodology of
-a single web page that has screens loaded into it as HTML fragments. Each screen is its own HTML fragment file. The toolkit then
-uses AJAX to **push** and **pop** screens off of the stack. The toolkilt manages the screen stack and loading the content. This ensures
-the best use of device memory.
+To initialize bbUI you need to call the **bb.init()** function before you start loading UI elements into your application. **THIS IS MANDITORY** The bb.int() function takes one parameter which is a JSON
+structure containing any of the options you wish to override. If you want to simply use the default configuration call the initialization function with no parameters _bb.init()_.
-To open a new screen in an appliction using bbUI you simply call **bb.pushScreen('mypage.htm', 'mypagename')**. To close the top screen
-you simply call **bb.popScreen()**. The toolkit is designed to use the [Application Event](http://developer.blackberry.com/html5/apis/blackberry.app.event.html)
-WebWorks API so that it can trap the "back" hardware key and automatically handle popping the last screen off of the stack.
+The default values of the options which can be overriden are:
-If you want to override the back button handling, and substitute it with your own handler, you can simply call **bb.assignBackHandler(callback)** and your **callback** function will now
-be invoked when the back button is clicked. It is then up to you to handle all back button navigation.
+ {
+ onbackkey: null, // Custom handler for back key on BlackBerry 5/6/7 smartphones
+ onscreenready: null, // Manipulate your screen before it's inserted into the DOM
+ ondomready: null, // Manipulate your screen after it's inserted into the DOM
+ bb10ActionBarDark: true, // If set to true, the action bar will use the dark theme
+ bb10ControlsDark: true, // If set to true, the controls will use the dark theme
+ bb10ListsDark: false, // If set to true, lists will use the dark theme (you need a dark background)
+ bb10ForPlayBook: false, // If set to true, PlayBook will be considered a BB10 device
+ bb10AccentColor: '#2D566F', // An accent color to be used for headers and other areas
+ bb10HighlightColor: '#00A8DF' // A highlight color to use when a user selects an item
+ }
+
+You can be notified when your screen, and all associated <script> tags, are loaded and ready for manipulation before styling is applied using the **onscreenready** event. The screen is still not
+contained in the DOM of the page at this point, but can be manipulated to modify its contents before the bbUI styling is applied. This allows you to perform your data manipulation **before** the screen has
+been displayed to the user and minimizes rendering engine layouts which are very expensive.
+
+You can also be notified when your screen, and all associated <script> tags, have been inserted into the DOM using the **ondomready** event. This allows you to perform your data manipulation **after**
+the screen has been displayed to the user.
+
+To subscribe to this event simply assign a function to the **onscreenready** parameter of the init function. The function will be called with the DOM element of your screen, and
+the id you have specified for that screen so that you can apply any screen specific changes.
+
+Since all of the script files for the specific screen are loaded before the **onscreenready** or **ondomready* events are fired, you can place all your screen specific logic in those files
+and only have one **onscreenready** and **ondomready** global handler to act as the "traffic cop".
+
+The **getElementById()** function has been added to the element object that is passed into **onscreenready** and **ondomready* events so that you can manipulate the DOM of the element passed into the event.
-
-
+
+
+
-You can also be notified when your screen, and all associated <script>> tags, are loaded and ready for manipulation. The screen is still not contained in the DOM of the page
-at this point, but can be manipulated to modify its contents before the bbUI styling is applied. This minimizes layouts which are very expensive.
-To subscribe to this event simply assign a function to the **bb.onscreenready** event. You should make this subscription globally in your application and assign it only once. The
-function will be called with the DOM element of your screen, and the id you have specified for that screen so that you can apply any screen specific changes.
+
+
+
+
+## Managing Screens
+
+the bbUI toolkit builds the application's UI in the most optimized fashion for the target operating system. It follows a methodology of
+a single web page that has screens loaded into it as HTML fragments. Each screen is its own HTML fragment file. The toolkit then
+uses AJAX to **push** and **pop** screens off of the stack. The toolkilt manages the screen stack and loading the content. This ensures
+the best use of device memory.
+
+To open a new screen in an appliction using bbUI you simply call **bb.pushScreen('mypage.htm', 'mypagename')**. To close the top screen
+you simply call **bb.popScreen()**. The toolkit is designed to use the [Application Event](http://developer.blackberry.com/html5/apis/blackberry.app.event.html)
+WebWorks API so that it can trap the "back" hardware key and automatically handle popping the last screen off of the stack.
+
+If you want to override the back button handling, and substitute it with your own handler, you can simply call **bb.assignBackHandler(callback)** and your **callback** function will now
+be invoked when the back button is clicked. It is then up to you to handle all back button navigation.
-
-
-
+
+
-Since all of the script files for the specific screen are loaded before the **onscreenready** event is fired, you can place all your screen specific logic in those files
-and only have one **onscreenready** global handler to act as the "traffic cop".
-
-The **getElementById()** function has been added to the element object that is passed into **onscreenready** so that you can manipulate the DOM of the element before it is inserted
-into the document.
## Defining a Screen
@@ -142,24 +179,26 @@ Creating a screen to be used with bbUI is as simple as creating an HTML file and
is simply a <div> with an attribute **data-bb-type="screen"**. You then place all the contents for your screen inside this <div>.
A display effect can also be declared on your screen. Currently only **data-bb-effect="fade"** is supported. This will fade in your screen when it displays. This is
-supported both on BB6 & BB7. However, if your screen has <input> controls on it and you declare the "fade" effect, BB6 will not fade in the page. This
-has been disabled on purpose in bbUI because the fade effect doesn't perform well on BB6 when input controls are on the screen.
+supported both on BB7 and up. This has been disabled on purpose in bbUI because the fade effect doesn't perform well on devices below BB7.
You can also create a nested **data-bb-type="title"** <div> in your screen to declare a title bar. If defined, a standard black screen title bar will appear showing the declared text.
The **data-bb-caption** attribute defines the text to show in this title area.
+_NOTE: Title bars are not available for BlackBerry 10 yet for bbUI_
+
You can also add a **back** button to your title bar that will **ONLY** appear when you display your content on a PlayBook. To define a back button in your title bar, add the caption of your back button to the
-**data-bb-back-caption** attribute.
+**data-bb-back-caption** attribute. When running on BlackBerry 10, if you provide a back button in your title bar it will automatically create an action bar with a back button on it "if" there are no tabs on your action
+bar.
This will appear as the standard back button in your UI as seen below:
-![Image List](bbUI.js/raw/master/screenshots/backBtn.png)
+![Back Button](bbUI.js/raw/master/screenshots/backBtn.png)
## Screen Scrolling Effects
@@ -229,53 +268,213 @@ You can also use in-line script tags with your screen. The bbUI framework will l
+
+## BlackBerry 10 Grid Layouts
+
+Grid layouts allow you to present your information in a graphical and cinematic way. **Grid layouts are currently only supported on PlayBook and BB10 devices**.
+
+![Grid Layout](bbUI.js/raw/master/screenshots/grid.png)
+
+If you have multiple images to show you can arrange them in groups and rows. A grouping of information can have a header title which will be the color provided by the **bb10AccentColor** property
+used in the **bb.init()** function. Highlights of items will use the **bb10HighlightColor**.
+
+Each group has one or more rows. Each row can have up to 3 items. Currently the layout assumes that images are a 16:9 aspect ratio. For example if a row has only one item in it, it's width will be the full width of
+the size of the grid. A row with 2 items will be 1/6, and 3 items will be 1/9 the height of the screen. All images are currently set to be stretched to the size of their container.
+
+Every item in the grid has an image, a title and a sub-title which is provided as the contents of the <div>. Each item can also provide an **onclick** handler for when the user
+selects the item.
+
+
+
+
+
World
+
+
+
World
+
World
+
+
+
+
+
World
+
World
+
World
+
+
+
+
+
+## BlackBerry 10 Action Bar
+
+The BlackBerry 10 action bar allow for a combination of buttons and tabs. **Action Bars are currently only supported on PlayBook and BB10 devices**. It is essentially a toolbar that appears at the bottom of the screen
+allowing for scrolling content above it.
+
+![Action Bar](bbUI.js/raw/master/screenshots/actionBar.png)
+
+If you have a title bar with a back button specified for PlayBook, and an action bar is not already specified for your screen, an action bar will be created with a back button as long as you don't already have an
+action bar defined with tabs. Action bars allow you to both navigate back to the previous screen but also provide tabs and/or buttons for your user.
+
+_NOTE: Combining a back button and tabs on an action bar is not allowed_
+
+If you provide a **data-bb-back-caption** attribute on the action bar, a back button will automatically be created. If
+you are using tabs on your screen, you can specify their tab styles using the **data-bb-tab-style** attribute. Currently only "highlight" is supported. Each item on the bar is defined as a **data-bb-type="action"** and its
+type is defined by the **data-bb-style** attribute which can either be a "tab" or a "button". Tabs automatically handle the highlighting of the selected tab. it is recommended that you group your tabs and buttons together
+to provide a clean user interface.
+
+You can handle the selection of the action by assigning an **onclick** event handler.
+
+The color style of the action bar is either a dark or light theme. This is applied using the **bb10ActionBarDark** property in the **bb.int()** function. Simply set bb10ActionBarDark to true/false to have the dark or light theme. This
+theme will be carried over for the entire application to ensure a consistent look and feel.
+
+
+
Library
+
Smart
+
Find
+
+
+### Action Item Image Sizes
+
+Images used for Actions will be scaled to the following resolutions and centered on the action bar items.
+
+* BlackBerry PlayBook - 40 x 40 pixels
+* BlackBerry 10 - 80 x 80 pixels
+
+### Action Overflow Menu
+
+If there are more than 5 total actions that are added to the action bar (including the back button) an overflow action menu will be created on the far right of the action bar. This button will trigger a slide in overflow menu
+that will contain the remaining items that were defined on the action bar.
+
## Loading Screen Specific Menus
-bbUI handles loading of screen specific menus on both PlayBook and Smartphones with the same code. Each screen must have a menu defined if you want it displayed. Clean-up occurs on bb.popScreen and bb.pushScreen.
-
-**Smartphone**
-
-![Image List](bbUI.js/raw/master/screenshots/menuBar-phone.png)
-
-**PlayBook**
-
-![Image List](bbUI.js/raw/master/screenshots/menuBar-playbook.png)
-
-
-Creating a menu is straight forward. Start by creating a <div> that has the attribute **data-bb-type=“menu”**. Each item in the menu is another <div> that has the attribute **data-bb-type=“menu-item”**. For a menu item to appear on the PlayBook it must have at least one of: an image (data-bb-img) or a caption (data-bb-caption). The on a Smartphone it must have a caption (data-bb-caption). For an icon only menu item that will be used on both Smartphone and PlayBook add **data-bb-icon-only="true"** to all menu items to have the caption left off on the PlayBook. In both cases the *onclick()* event is the function that will fire when the menu item is selected.
+bbUI handles loading of screen specific menus on both PlayBook, BlackBerry 10 and Smartphones with the same code. Each screen must have a menu defined if you want it displayed. Clean-up occurs on bb.popScreen and bb.pushScreen.
+
+**Smartphone**
+
+![Menu Phone](bbUI.js/raw/master/screenshots/menuBar-phone.png)
+
+**PlayBook**
+
+![Menu PlayBook](bbUI.js/raw/master/screenshots/menuBar-playbook.png)
+
+Creating a menu is straight forward. Start by creating a <div> that has the attribute **data-bb-type="menu"**. Each item in the menu is another <div> that has the attribute **data-bb-type="menu-item"**. For a menu item
+to appear on PlayBook 2.x or BlackBerry 10 it must have **both** an image (data-bb-img) and a caption (data-bb-caption) or it will be ignored. The on a Smartphone it must have a caption (data-bb-caption). In both cases the _onclick()_ event is the function
+that will fire when the menu item is selected. On BlackBerry 5/6/7 smartphones you can add the attribute **data-bb-selected="true"** which makes that the default item when the menu is displayed.
+
+There is an additional type of item you can use **data-bb-type="menu-separator"** which creates a menu separator on PlayBook 2.x and BlackBerry 5/6/7 smartphones.
+
+_NOTE: BlackBerry 10 will ignore separators and will only allow a maximum of 5 menu items_
-
-
-
+
Foo
+
Bar
+
FooBar
-
+
BarFoo
-There is an additional type of item you can use **data-bb-type="menu-separator"** which creates a menu separator.
+### PlayBook and BlackBerry 10 menu image sizes
+
+When styling is applied to menus on **BlackBerry 10** the images used for menus will be scaled to the following resolutions and centered on the menu items.
+
+* BlackBerry PlayBook - 40 x 40 pixels
+* BlackBerry 10 - 80 x 80 pixels
+
+When styling is applied to menus on PlayBook 2.x with BlackBerry 10 styling turned off images will be scaled to the following resolutions and centered on the menu items.
+
+* BlackBerry PlayBook 2.x - 65 x 65 pixels
+
+
+## BlackBerry 10 Context Menu
+
+BlackBerry 10 allows for a press and hold context menu that is very similar to the action bar overflow menu. If you add one of these menus to your screen you can also automatically
+wire up your image lists to the control. _**NOTE: You can only have one context menu on a screen**_
+
+When wired to an image list, pressing and holding on the image list item will "peek" the context menu and passing it the selected element. Peeking the
+context menu will show the row of action icons that can be clicked and part of the context information in the header of the menu.
+
+When the user swipes from right to left it will pull the full menu into view if they want to see the text labels for all the items.
+
+Markup for the context menu looks a lot like the action bar markup. You are able to create a **data-bb-type="context-menu"** that has a series of **data-bb-type="action"** elements. An action item consists
+of an image and text. To react to the clicking of an action simply assign an **onclick** handler to the action element.
+
+
+
Email Work
+
Invite to Meeting
+
Call Work
+
View details
+
Delete
+
+
+
+### Interacting with the context menu from JavaScript
+
+![Context Menu](bbUI.js/raw/master/screenshots/contextMenu.png)
+
+Each context menu has the ability to be both **peeked** and **shown** using JavaScript. These methods are called with a parameter that contains a title, description and selected DOM element.
+
+To **peek** the icons on the context menu use the following code:
+
+ var context = document.getElementById('mycontextmenu');
+ context.menu.peek({title:'My Title', description: 'My Description', selected: mySelectedDOMElement});
+
+To **show** the full context menu use the following code:
+
+ var context = document.getElementById('mycontextmenu');
+ context.menu.show({title:'My Title', description: 'My Description', selected: mySelectedDOMElement});
+
+To grab the item that was selected from within your **onclick** of an action item. This selected object is the one that was passed into the peek or show functions. You can refer to the **selected** property of the menu like in the following code:
+
+ function myclick() {
+ var selectedItem,
+ context = document.getElementById('mycontextmenu');
+ selectedItem = context.menu.selected;
+ if (selectedItem) {
+ //... do something
+ }
+ }
+
+
+### Image Sizes
+
+Images for actions on the context menu will be scaled the same as the action bar.
+
+* BlackBerry PlayBook - 40 x 40 pixels
+* BlackBerry 10 - 80 x 80 pixels
-Also on Smartphones you can add the attribute **data-bb-selected="true"** which makes that the default item when the menu is displayed.
## Image Lists
Image lists give the user different options that they can choose. This user interface can seen in the BlackBerry options area.
-![Image List](bbUI.js/raw/master/screenshots/imageList.png)
+![Image List](bbUI.js/raw/master/screenshots/imageList.png) ![Image List](bbUI.js/raw/master/screenshots/inboxList.png)
Creating an image list is really simple and begins with creating a <div> that has the attribute **data-bb-type="image-list"**. Each item in the list is another
-<div> that has the attribute **data-bb-type="item"**. Each item has an image (**data-bb-img**), a title (**data-bb-title**), and a description which is the inner contents
-of the <div>.
+<div> that has the attribute **data-bb-type="item"**. Each item has an image (**data-bb-img**), a title (**data-bb-title**), accent text that floats in the top right (**data-bb-accent-text**), and a description which is the inner contents
+of the <div>. An image list can have both headers and line items. A header is declared by creating a <div> with a **data-bb-type="header"** attribute and the contents of the header are displayed as the label.
+Headers have their text centered by default. To left justify your header text add the **data-bb-justify="left"** or to right justify your text add the **data-bb-justify="right"**attribute to your header.
+
+### Image Sizes
+
+* BlackBerry 5 & 6 - 60 x 60 pixels
+* BlackBerry PlayBook & BlackBerry 7 - 70 x 70 pixels
+* BlackBerry PlayBook with BB10 styling - 64 x 64 pixels
+* BlackBerry 10 - 119 x 119 pixels
+
+
+If you want to attach a BlackBerry 10 context menu to your image list you can add the **data-bb-context="true"** attribute. This will automatically hook up your image list to the
+press and hold context menu that you have declared for the screen. When the image list item is pressed and held for 667ms it will **peek** the screen's context menu passing the
+title and description of the list item along with a handle to the item element. See the Context Menu area for mor details of interacting with the menu.
-On High-Resolution screens, the image size is 48x48 pixels. On a low resolution screen it is sized down to 32x32 pixels. So it is best to create your image artwork at
-the 48x48 pixel size since downscaling typically looks better than stretching.
+**NOTE: The context menu integration with the image list only works on BlackBerry 10**
-
+
+
My sample header
Use native looking input controls
Style your list like the BlackBerry Inbox
Create native looking options screens
-
Add some height to your list items
+
Look at me
Generate a chat window like BBM
Use pill buttons to organize your data
Add charts to your application
@@ -380,6 +579,8 @@ selected item when the control first shows you can can use the **selected="true"
+
+BlackBerry 10 has an additional feature where you can specify a **data-bb-label="my label"** to have the label text appear in the dropdown control.
To select an item in a dropdown from JavaScript you can use the **setSelectedItem()** function that has been added to the <select> object. In many browsers, the **onchange** event
is not fired on a <select> if the value is set from JavaScript. Only if it is set from the interaction with the UI. Because of this bbUI cannot listen to the change made
@@ -419,31 +620,6 @@ Much like the Image List, the Arrow list is a <div> that has the attribute
-## Inbox Style Lists
-
-The Inbox Sytle List is pretty self explainatory. It provides the ability to create a list much like that of the email application
-found on a BlackBerry Smartphone.
-
-![Control Panel](bbUI.js/raw/master/screenshots/inboxList.png)
-
-The inbox list is again a <div> with an **data-bb-type="inbox-list"** attribute. An inbox list can have both headers and line items. A header
-is declared by creating a <div> with a **data-bb-type="header"** attribute and the contents of the header are displayed as the label.
-
-Each line item is created with a **data-bb-type="item"** attribute and has values for an image to be displayed (**data-bb-img**), a title (**data-bb-title**), a
-time (**data-bb-time**) and the inner contents of the <div> are displayed as the description.
-
-The line item image is displayed as a 32x32 pixel image on a High-Resolution screen.
-
-
-
-
Thu 27 May 2010
-
My car just broke down
-
Need to pick up Milk
-
Thu 28 May 2010
-
Where do I find the new Document
-
-
-
## BBM Bubbles
The BBM Bubbles UI format allows you to create chat bubbles that look like the ones in BBM. This is a great option for any BBM connected application.
@@ -471,32 +647,6 @@ image to appear beside the line item by using the **data-bb-img** attribute. The
-
-## Tall Lists
-
-Tall lists are similar to those that you would find in the BlackBerry Twitter® and Facebook® applications.
-
-![Control Panel](bbUI.js/raw/master/screenshots/tallList.png)
-
-Tall lists are a <div> with a **data-bb-type="tall-list"** attribute. Each line item is a <div> with an **data-bb-type="item"** attribute which allows for
-a display image (**data-bb-img**), a title (**data-bb-title**), a time (**data-bb-time**) and the inner contents of the <div> are the description that appears.
-
-
-
-
-
My car just broke down and I have one million things to do!!
-
Need to pick up Milk. Add one more thing to the "Honey Do" list!
-
Time for some BBQ Ribs!!
-
Has anyone seen a good movie lately? We're looking for something to do this weekend and I figured a movie would be good
-
Yes, I do Love BlackBerry! Check out BlackBerry App World