From ae87717263c33b0e3e8c09a9f7f3693f1b6f31fe Mon Sep 17 00:00:00 2001 From: appleguy Date: Sun, 26 Jun 2016 17:12:59 -0700 Subject: [PATCH] Revert "Remove old website folder from master branch" (#1818) --- docs/CNAME | 2 + docs/LICENSE.md | 420 ++++++++++++++++++++++++ docs/README.md | 9 + docs/_config.yml | 13 + docs/_includes/footer.html | 18 + docs/_includes/head.html | 24 ++ docs/_includes/header.html | 25 ++ docs/_layouts/default.html | 20 ++ docs/_layouts/docs.html | 27 ++ docs/_layouts/page.html | 16 + docs/_layouts/post.html | 15 + docs/_sass/_base.scss | 205 ++++++++++++ docs/_sass/_layout.scss | 265 +++++++++++++++ docs/_sass/_syntax-highlighting.scss | 76 +++++ docs/assets/guide/1-shuffle-crop.png | Bin 0 -> 1016 bytes docs/assets/guide/1-shuffle.png | Bin 0 -> 19288 bytes docs/assets/logo-square.png | Bin 0 -> 66422 bytes docs/assets/logo.png | Bin 0 -> 105684 bytes docs/assets/node-view-layer.png | Bin 0 -> 12961 bytes docs/build.sh | 33 ++ docs/css/main.scss | 49 +++ docs/guide/1-introduction.md | 150 +++++++++ docs/guide/2-custom-nodes.md | 211 ++++++++++++ docs/guide/3-asynchronous-display.md | 102 ++++++ docs/guide/4-making-the-most-of-asdk.md | 139 ++++++++ docs/guide/5-under-the-hood.md | 89 +++++ docs/index.md | 86 +++++ 27 files changed, 1994 insertions(+) create mode 100644 docs/CNAME create mode 100644 docs/LICENSE.md create mode 100644 docs/README.md create mode 100644 docs/_config.yml create mode 100644 docs/_includes/footer.html create mode 100644 docs/_includes/head.html create mode 100644 docs/_includes/header.html create mode 100644 docs/_layouts/default.html create mode 100644 docs/_layouts/docs.html create mode 100644 docs/_layouts/page.html create mode 100644 docs/_layouts/post.html create mode 100644 docs/_sass/_base.scss create mode 100644 docs/_sass/_layout.scss create mode 100644 docs/_sass/_syntax-highlighting.scss create mode 100644 docs/assets/guide/1-shuffle-crop.png create mode 100644 docs/assets/guide/1-shuffle.png create mode 100755 docs/assets/logo-square.png create mode 100755 docs/assets/logo.png create mode 100755 docs/assets/node-view-layer.png create mode 100755 docs/build.sh create mode 100755 docs/css/main.scss create mode 100644 docs/guide/1-introduction.md create mode 100644 docs/guide/2-custom-nodes.md create mode 100644 docs/guide/3-asynchronous-display.md create mode 100644 docs/guide/4-making-the-most-of-asdk.md create mode 100644 docs/guide/5-under-the-hood.md create mode 100644 docs/index.md diff --git a/docs/CNAME b/docs/CNAME new file mode 100644 index 0000000000..a295f461e5 --- /dev/null +++ b/docs/CNAME @@ -0,0 +1,2 @@ +asyncdisplaykit.org + diff --git a/docs/LICENSE.md b/docs/LICENSE.md new file mode 100644 index 0000000000..4bb498ec63 --- /dev/null +++ b/docs/LICENSE.md @@ -0,0 +1,420 @@ +--- +layout: page +title: License +permalink: /license/ +--- + +AsyncDisplayKit is free software under the BSD +license. + +Code examples and sample +projects are licensed as follows: + + This file provided by Facebook is for non-commercial testing and evaluation + purposes only. Facebook reserves all rights not expressly granted. + + 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 + FACEBOOK 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. + +All other AsyncDisplayKit documentation is licensed CC-BY-4.0. + + Attribution 4.0 International + + ======================================================================= + + Creative Commons Corporation ("Creative Commons") is not a law firm and + does not provide legal services or legal advice. Distribution of + Creative Commons public licenses does not create a lawyer-client or + other relationship. Creative Commons makes its licenses and related + information available on an "as-is" basis. Creative Commons gives no + warranties regarding its licenses, any material licensed under their + terms and conditions, or any related information. Creative Commons + disclaims all liability for damages resulting from their use to the + fullest extent possible. + + Using Creative Commons Public Licenses + + Creative Commons public licenses provide a standard set of terms and + conditions that creators and other rights holders may use to share + original works of authorship and other material subject to copyright + and certain other rights specified in the public license below. The + following considerations are for informational purposes only, are not + exhaustive, and do not form part of our licenses. + + Considerations for licensors: Our public licenses are + intended for use by those authorized to give the public + permission to use material in ways otherwise restricted by + copyright and certain other rights. Our licenses are + irrevocable. Licensors should read and understand the terms + and conditions of the license they choose before applying it. + Licensors should also secure all rights necessary before + applying our licenses so that the public can reuse the + material as expected. Licensors should clearly mark any + material not subject to the license. This includes other CC- + licensed material, or material used under an exception or + limitation to copyright. More considerations for licensors: + wiki.creativecommons.org/Considerations_for_licensors + + Considerations for the public: By using one of our public + licenses, a licensor grants the public permission to use the + licensed material under specified terms and conditions. If + the licensor's permission is not necessary for any reason--for + example, because of any applicable exception or limitation to + copyright--then that use is not regulated by the license. Our + licenses grant only permissions under copyright and certain + other rights that a licensor has authority to grant. Use of + the licensed material may still be restricted for other + reasons, including because others have copyright or other + rights in the material. A licensor may make special requests, + such as asking that all changes be marked or described. + Although not required by our licenses, you are encouraged to + respect those requests where reasonable. More_considerations + for the public: + wiki.creativecommons.org/Considerations_for_licensees + + ======================================================================= + + Creative Commons Attribution 4.0 International Public License + + By exercising the Licensed Rights (defined below), You accept and agree + to be bound by the terms and conditions of this Creative Commons + Attribution 4.0 International Public License ("Public License"). To the + extent this Public License may be interpreted as a contract, You are + granted the Licensed Rights in consideration of Your acceptance of + these terms and conditions, and the Licensor grants You such rights in + consideration of benefits the Licensor receives from making the + Licensed Material available under these terms and conditions. + + + Section 1 -- Definitions. + + a. Adapted Material means material subject to Copyright and Similar + Rights that is derived from or based upon the Licensed Material + and in which the Licensed Material is translated, altered, + arranged, transformed, or otherwise modified in a manner requiring + permission under the Copyright and Similar Rights held by the + Licensor. For purposes of this Public License, where the Licensed + Material is a musical work, performance, or sound recording, + Adapted Material is always produced where the Licensed Material is + synched in timed relation with a moving image. + + b. Adapter's License means the license You apply to Your Copyright + and Similar Rights in Your contributions to Adapted Material in + accordance with the terms and conditions of this Public License. + + c. Copyright and Similar Rights means copyright and/or similar rights + closely related to copyright including, without limitation, + performance, broadcast, sound recording, and Sui Generis Database + Rights, without regard to how the rights are labeled or + categorized. For purposes of this Public License, the rights + specified in Section 2(b)(1)-(2) are not Copyright and Similar + Rights. + + d. Effective Technological Measures means those measures that, in the + absence of proper authority, may not be circumvented under laws + fulfilling obligations under Article 11 of the WIPO Copyright + Treaty adopted on December 20, 1996, and/or similar international + agreements. + + e. Exceptions and Limitations means fair use, fair dealing, and/or + any other exception or limitation to Copyright and Similar Rights + that applies to Your use of the Licensed Material. + + f. Licensed Material means the artistic or literary work, database, + or other material to which the Licensor applied this Public + License. + + g. Licensed Rights means the rights granted to You subject to the + terms and conditions of this Public License, which are limited to + all Copyright and Similar Rights that apply to Your use of the + Licensed Material and that the Licensor has authority to license. + + h. Licensor means the individual(s) or entity(ies) granting rights + under this Public License. + + i. Share means to provide material to the public by any means or + process that requires permission under the Licensed Rights, such + as reproduction, public display, public performance, distribution, + dissemination, communication, or importation, and to make material + available to the public including in ways that members of the + public may access the material from a place and at a time + individually chosen by them. + + j. Sui Generis Database Rights means rights other than copyright + resulting from Directive 96/9/EC of the European Parliament and of + the Council of 11 March 1996 on the legal protection of databases, + as amended and/or succeeded, as well as other essentially + equivalent rights anywhere in the world. + + k. You means the individual or entity exercising the Licensed Rights + under this Public License. Your has a corresponding meaning. + + + Section 2 -- Scope. + + a. License grant. + + 1. Subject to the terms and conditions of this Public License, + the Licensor hereby grants You a worldwide, royalty-free, + non-sublicensable, non-exclusive, irrevocable license to + exercise the Licensed Rights in the Licensed Material to: + + a. reproduce and Share the Licensed Material, in whole or + in part; and + + b. produce, reproduce, and Share Adapted Material. + + 2. Exceptions and Limitations. For the avoidance of doubt, where + Exceptions and Limitations apply to Your use, this Public + License does not apply, and You do not need to comply with + its terms and conditions. + + 3. Term. The term of this Public License is specified in Section + 6(a). + + 4. Media and formats; technical modifications allowed. The + Licensor authorizes You to exercise the Licensed Rights in + all media and formats whether now known or hereafter created, + and to make technical modifications necessary to do so. The + Licensor waives and/or agrees not to assert any right or + authority to forbid You from making technical modifications + necessary to exercise the Licensed Rights, including + technical modifications necessary to circumvent Effective + Technological Measures. For purposes of this Public License, + simply making modifications authorized by this Section 2(a) + (4) never produces Adapted Material. + + 5. Downstream recipients. + + a. Offer from the Licensor -- Licensed Material. Every + recipient of the Licensed Material automatically + receives an offer from the Licensor to exercise the + Licensed Rights under the terms and conditions of this + Public License. + + b. No downstream restrictions. You may not offer or impose + any additional or different terms or conditions on, or + apply any Effective Technological Measures to, the + Licensed Material if doing so restricts exercise of the + Licensed Rights by any recipient of the Licensed + Material. + + 6. No endorsement. Nothing in this Public License constitutes or + may be construed as permission to assert or imply that You + are, or that Your use of the Licensed Material is, connected + with, or sponsored, endorsed, or granted official status by, + the Licensor or others designated to receive attribution as + provided in Section 3(a)(1)(A)(i). + + b. Other rights. + + 1. Moral rights, such as the right of integrity, are not + licensed under this Public License, nor are publicity, + privacy, and/or other similar personality rights; however, to + the extent possible, the Licensor waives and/or agrees not to + assert any such rights held by the Licensor to the limited + extent necessary to allow You to exercise the Licensed + Rights, but not otherwise. + + 2. Patent and trademark rights are not licensed under this + Public License. + + 3. To the extent possible, the Licensor waives any right to + collect royalties from You for the exercise of the Licensed + Rights, whether directly or through a collecting society + under any voluntary or waivable statutory or compulsory + licensing scheme. In all other cases the Licensor expressly + reserves any right to collect such royalties. + + + Section 3 -- License Conditions. + + Your exercise of the Licensed Rights is expressly made subject to the + following conditions. + + a. Attribution. + + 1. If You Share the Licensed Material (including in modified + form), You must: + + a. retain the following if it is supplied by the Licensor + with the Licensed Material: + + i. identification of the creator(s) of the Licensed + Material and any others designated to receive + attribution, in any reasonable manner requested by + the Licensor (including by pseudonym if + designated); + + ii. a copyright notice; + + iii. a notice that refers to this Public License; + + iv. a notice that refers to the disclaimer of + warranties; + + v. a URI or hyperlink to the Licensed Material to the + extent reasonably practicable; + + b. indicate if You modified the Licensed Material and + retain an indication of any previous modifications; and + + c. indicate the Licensed Material is licensed under this + Public License, and include the text of, or the URI or + hyperlink to, this Public License. + + 2. You may satisfy the conditions in Section 3(a)(1) in any + reasonable manner based on the medium, means, and context in + which You Share the Licensed Material. For example, it may be + reasonable to satisfy the conditions by providing a URI or + hyperlink to a resource that includes the required + information. + + 3. If requested by the Licensor, You must remove any of the + information required by Section 3(a)(1)(A) to the extent + reasonably practicable. + + 4. If You Share Adapted Material You produce, the Adapter's + License You apply must not prevent recipients of the Adapted + Material from complying with this Public License. + + + Section 4 -- Sui Generis Database Rights. + + Where the Licensed Rights include Sui Generis Database Rights that + apply to Your use of the Licensed Material: + + a. for the avoidance of doubt, Section 2(a)(1) grants You the right + to extract, reuse, reproduce, and Share all or a substantial + portion of the contents of the database; + + b. if You include all or a substantial portion of the database + contents in a database in which You have Sui Generis Database + Rights, then the database in which You have Sui Generis Database + Rights (but not its individual contents) is Adapted Material; and + + c. You must comply with the conditions in Section 3(a) if You Share + all or a substantial portion of the contents of the database. + + For the avoidance of doubt, this Section 4 supplements and does not + replace Your obligations under this Public License where the Licensed + Rights include other Copyright and Similar Rights. + + + Section 5 -- Disclaimer of Warranties and Limitation of Liability. + + a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE + EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS + AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF + ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, + IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, + WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR + PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, + ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT + KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT + ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU. + + b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE + TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, + NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, + INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, + COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR + USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN + ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR + DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR + IN PART, THIS LIMITATION MAY NOT APPLY TO YOU. + + c. The disclaimer of warranties and limitation of liability provided + above shall be interpreted in a manner that, to the extent + possible, most closely approximates an absolute disclaimer and + waiver of all liability. + + + Section 6 -- Term and Termination. + + a. This Public License applies for the term of the Copyright and + Similar Rights licensed here. However, if You fail to comply with + this Public License, then Your rights under this Public License + terminate automatically. + + b. Where Your right to use the Licensed Material has terminated under + Section 6(a), it reinstates: + + 1. automatically as of the date the violation is cured, provided + it is cured within 30 days of Your discovery of the + violation; or + + 2. upon express reinstatement by the Licensor. + + For the avoidance of doubt, this Section 6(b) does not affect any + right the Licensor may have to seek remedies for Your violations + of this Public License. + + c. For the avoidance of doubt, the Licensor may also offer the + Licensed Material under separate terms or conditions or stop + distributing the Licensed Material at any time; however, doing so + will not terminate this Public License. + + d. Sections 1, 5, 6, 7, and 8 survive termination of this Public + License. + + + Section 7 -- Other Terms and Conditions. + + a. The Licensor shall not be bound by any additional or different + terms or conditions communicated by You unless expressly agreed. + + b. Any arrangements, understandings, or agreements regarding the + Licensed Material not stated herein are separate from and + independent of the terms and conditions of this Public License. + + + Section 8 -- Interpretation. + + a. For the avoidance of doubt, this Public License does not, and + shall not be interpreted to, reduce, limit, restrict, or impose + conditions on any use of the Licensed Material that could lawfully + be made without permission under this Public License. + + b. To the extent possible, if any provision of this Public License is + deemed unenforceable, it shall be automatically reformed to the + minimum extent necessary to make it enforceable. If the provision + cannot be reformed, it shall be severed from this Public License + without affecting the enforceability of the remaining terms and + conditions. + + c. No term or condition of this Public License will be waived and no + failure to comply consented to unless expressly agreed to by the + Licensor. + + d. Nothing in this Public License constitutes or may be interpreted + as a limitation upon, or waiver of, any privileges and immunities + that apply to the Licensor or You, including from the legal + processes of any jurisdiction or authority. + + + ======================================================================= + + Creative Commons is not a party to its public licenses. + Notwithstanding, Creative Commons may elect to apply one of its public + licenses to material it publishes and in those instances will be + considered the "Licensor." Except for the limited purpose of indicating + that material is shared under a Creative Commons public license or as + otherwise permitted by the Creative Commons policies published at + creativecommons.org/policies, Creative Commons does not authorize the + use of the trademark "Creative Commons" or any other trademark or logo + of Creative Commons without its prior written consent including, + without limitation, in connection with any unauthorized modifications + to any of its public licenses or any other arrangements, + understandings, or agreements concerning use of licensed material. For + the avoidance of doubt, this paragraph does not form part of the public + licenses. + + Creative Commons may be contacted at creativecommons.org. diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000000..05980d3818 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,9 @@ +# Documentation + +## Building + +You need Jekyll and appledoc. See `build.sh`. + +## License + +See LICENSE.md. diff --git a/docs/_config.yml b/docs/_config.yml new file mode 100644 index 0000000000..0d5f309f67 --- /dev/null +++ b/docs/_config.yml @@ -0,0 +1,13 @@ +# Site settings +title: AsyncDisplayKit +description: Smooth asynchronous user interfaces for iOS apps. +baseurl: "" +url: "http://asyncdisplaykit.org" + +# Build settings +highlighter: pygments +markdown: redcarpet + +exclude: +- README.md +- build.sh diff --git a/docs/_includes/footer.html b/docs/_includes/footer.html new file mode 100644 index 0000000000..2714963def --- /dev/null +++ b/docs/_includes/footer.html @@ -0,0 +1,18 @@ + diff --git a/docs/_includes/head.html b/docs/_includes/head.html new file mode 100644 index 0000000000..a9e7efbdea --- /dev/null +++ b/docs/_includes/head.html @@ -0,0 +1,24 @@ + + + + + + + + + + + + {% if page.title %}{{ page.title }} — {% endif %}AsyncDisplayKit + + + + + + + diff --git a/docs/_includes/header.html b/docs/_includes/header.html new file mode 100644 index 0000000000..aebb67cdf1 --- /dev/null +++ b/docs/_includes/header.html @@ -0,0 +1,25 @@ +
+ +
+ + {{ site.title }} + + + +
+ +
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html new file mode 100644 index 0000000000..bdf5a388da --- /dev/null +++ b/docs/_layouts/default.html @@ -0,0 +1,20 @@ + + + + {% include head.html %} + + + + {% include header.html %} + +
+
+ {{ content }} +
+
+ + {% include footer.html %} + + + + diff --git a/docs/_layouts/docs.html b/docs/_layouts/docs.html new file mode 100644 index 0000000000..65c07040aa --- /dev/null +++ b/docs/_layouts/docs.html @@ -0,0 +1,27 @@ +--- +layout: default +sectionid: docs +--- +
+ +
+

+ {{ page.title }} + [edit] +

+
+ +
+ {{ content }} +
+ +
+ {% if page.prev %} + ← prev + {% endif %} + {% if page.next %} + next → + {% endif %} +
+ +
diff --git a/docs/_layouts/page.html b/docs/_layouts/page.html new file mode 100644 index 0000000000..8e7ccf7a15 --- /dev/null +++ b/docs/_layouts/page.html @@ -0,0 +1,16 @@ +--- +layout: default +--- +
+ + {% if page.shouldDisplayTitle %} +
+

{{ page.title }}

+
+ {% endif %} + +
+ {{ content }} +
+ +
diff --git a/docs/_layouts/post.html b/docs/_layouts/post.html new file mode 100644 index 0000000000..675596fb1c --- /dev/null +++ b/docs/_layouts/post.html @@ -0,0 +1,15 @@ +--- +layout: default +--- +
+ +
+

{{ page.title }}

+

{{ page.date | date: "%b %-d, %Y" }}{% if page.author %} • {{ page.author }}{% endif %}{% if page.meta %} • {{ page.meta }}{% endif %}

+
+ +
+ {{ content }} +
+ +
diff --git a/docs/_sass/_base.scss b/docs/_sass/_base.scss new file mode 100644 index 0000000000..7d353be258 --- /dev/null +++ b/docs/_sass/_base.scss @@ -0,0 +1,205 @@ +/** + * Reset some basic elements + */ +body, h1, h2, h3, h4, h5, h6, +p, blockquote, pre, hr, +dl, dd, ol, ul, figure { + margin: 0; + padding: 0; +} + + + +/** + * Basic styling + */ +body { + font-family: $base-font-family; + font-size: $base-font-size; + line-height: $base-line-height; + font-weight: 300; + color: $text-color; + background-color: $background-color; + -webkit-text-size-adjust: 100%; +} + + + +/** + * Set `margin-bottom` to maintain vertical rhythm + */ +h1, h2, h3, h4, h5, h6, +p, blockquote, pre, +ul, ol, dl, figure, +%vertical-rhythm { + margin-bottom: $spacing-unit / 2; +} + + + +/** + * Images + */ +img { + max-width: 100%; + vertical-align: middle; +} + + + +/** + * Figures + */ +figure > img { + display: block; +} + +figcaption { + font-size: $small-font-size; +} + + + +/** + * Lists + */ +ul, ol { + margin-left: $spacing-unit; +} + +li { + > ul, + > ol { + margin-bottom: 0; + } +} + + + +/** + * Headings + */ +h1, h2, h3, h4, h5, h6 { + font-weight: 300; +} + + + +/** + * Links + */ +a { + color: $brand-color; + text-decoration: none; + + &:visited { + color: darken($brand-color, 15%); + } + + &:hover { + color: $text-color; + text-decoration: underline; + } +} + + + +/** + * Blockquotes + */ +blockquote { + color: $grey-color; + border-left: 4px solid $grey-color-light; + padding-left: $spacing-unit / 2; + font-size: 18px; + letter-spacing: -1px; + font-style: italic; + + > :last-child { + margin-bottom: 0; + } +} + + + +/** + * Code formatting + */ +pre, +code { + font-family: Monaco, monospace; + font-size: 14px; + border: 1px solid #afe4ff; + border-radius: 3px; + background-color: #fafdff; +} + +code { + padding: 1px 5px; +} + +pre { + padding: 8px 12px; + overflow-x: scroll; + + > code { + border: 0; + padding-right: 0; + padding-left: 0; + } +} + + + +/** + * Wrapper + */ +.wrapper { + max-width: -webkit-calc(800px - (#{$spacing-unit} * 2)); + max-width: calc(800px - (#{$spacing-unit} * 2)); + margin-right: auto; + margin-left: auto; + padding-right: $spacing-unit; + padding-left: $spacing-unit; + @extend %clearfix; + + @include media-query($on-laptop) { + max-width: -webkit-calc(800px - (#{$spacing-unit})); + max-width: calc(800px - (#{$spacing-unit})); + padding-right: $spacing-unit / 2; + padding-left: $spacing-unit / 2; + } +} + + + +/** + * Clearfix + */ +%clearfix { + + &:after { + content: ""; + display: table; + clear: both; + } +} + + + +/** + * Icons + */ +.icon { + + > svg { + display: inline-block; + width: 16px; + height: 16px; + vertical-align: middle; + + path { + fill: $grey-color; + } + } +} diff --git a/docs/_sass/_layout.scss b/docs/_sass/_layout.scss new file mode 100644 index 0000000000..2eb740fa67 --- /dev/null +++ b/docs/_sass/_layout.scss @@ -0,0 +1,265 @@ +/** + * Site header + */ +.site-header { + border-top: 5px solid $grey-color-dark; + border-bottom: 1px solid $grey-color-light; + min-height: 56px; + background-color: #f8f8f8; + + // Positioning context for the mobile navigation icon + position: relative; +} + +.site-title { + font-size: 26px; + line-height: 56px; + letter-spacing: -1px; + margin-bottom: 0; + float: left; + + &, + &:visited { + color: $grey-color-dark; + } + &:hover { + text-decoration: none; + } +} + +.site-nav { + float: right; + line-height: 56px; + + .menu-icon { + display: none; + } + + .page-link { + color: $grey-color; + line-height: $base-line-height; + + // Gaps between nav items, but not on the first one + &:not(:first-child) { + margin-left: 20px; + } + + &:hover { + color: $text-color; + } + } + + .page-link-active { + color: $text-color; + } + + @include media-query($on-palm) { + position: absolute; + top: 9px; + right: 30px; + background-color: $background-color; + border: 1px solid $grey-color-light; + border-radius: 5px; + text-align: right; + + .menu-icon { + display: block; + float: right; + width: 36px; + height: 26px; + line-height: 0; + padding-top: 10px; + text-align: center; + + > svg { + width: 18px; + height: 15px; + + path { + fill: $grey-color-dark; + } + } + } + + .trigger { + clear: both; + display: none; + } + + &:hover .trigger { + display: block; + padding-bottom: 5px; + } + + .page-link { + display: block; + padding: 5px 10px; + } + } +} + + + +/** + * Site footer + */ +.site-footer { + border-top: 1px solid $grey-color-light; + padding: $spacing-unit 0; +} + +.footer-heading { + font-size: 18px; + margin-bottom: $spacing-unit / 2; +} + +.contact-list, +.social-media-list { + list-style: none; + margin-left: 0; +} + +.footer-col-wrapper { + font-size: 11px; + color: $grey-color; + margin-left: -$spacing-unit / 2; + @extend %clearfix; +} + +.footer-col { + float: left; + margin-bottom: $spacing-unit / 2; + padding-left: $spacing-unit / 2; +} + +.footer-col-left { + width: -webkit-calc(50% - (#{$spacing-unit} / 2)); + width: calc(50% - (#{$spacing-unit} / 2)); +} + +.footer-col-right { + text-align: right; + width: -webkit-calc(50% - (#{$spacing-unit} / 2)); + width: calc(50% - (#{$spacing-unit} / 2)); +} + +@include media-query($on-laptop) { + .footer-col-left { + width: -webkit-calc(50% - (#{$spacing-unit} / 2)); + width: calc(50% - (#{$spacing-unit} / 2)); + } + + .footer-col-right { + width: -webkit-calc(100% - (#{$spacing-unit} / 2)); + width: calc(100% - (#{$spacing-unit} / 2)); + } +} + +@include media-query($on-palm) { + .footer-col { + float: none; + width: -webkit-calc(100% - (#{$spacing-unit} / 2)); + width: calc(100% - (#{$spacing-unit} / 2)); + } +} + + + +/** + * Page content + */ +.page-content { + padding: $spacing-unit 0; + background-color: white; +} + +.page-heading { + font-size: 20px; +} + +.post-list { + margin-left: 0; + list-style: none; + + > li { + margin-bottom: $spacing-unit; + } +} + +.post-meta { + font-size: $small-font-size; + color: $grey-color; +} + +.post-link { + display: block; + font-size: 24px; +} + + + +/** + * Posts + */ +.post-header { + margin-bottom: $spacing-unit; +} + +.post-title { + font-size: 42px; + letter-spacing: -1px; + line-height: 1; + + @include media-query($on-laptop) { + font-size: 36px; + } + + .edit-page-link { + font-size: 18px; + } +} + +.post-content { + margin-bottom: $spacing-unit; + + h2 { + font-size: 32px; + + @include media-query($on-laptop) { + font-size: 28px; + } + } + + h3 { + font-size: 26px; + + @include media-query($on-laptop) { + font-size: 22px; + } + } + + h4 { + font-size: 20px; + + @include media-query($on-laptop) { + font-size: 18px; + } + } +} + + + +/** + * Docs + */ +.docs-prevnext { + @extend %clearfix; +} + +.docs-prev { + float: left; +} + +.docs-next { + float: right; +} diff --git a/docs/_sass/_syntax-highlighting.scss b/docs/_sass/_syntax-highlighting.scss new file mode 100644 index 0000000000..3758fdb458 --- /dev/null +++ b/docs/_sass/_syntax-highlighting.scss @@ -0,0 +1,76 @@ +/** + * Syntax highlighting styles + */ + +/* not official Xcode colors, but looks better on the web */ +$xc-black: black; +$xc-green: #008d14; +$xc-red: #b72748; +$xc-blue: #103ffb; +$xc-turquoise: #3a95ba; + +.highlight { + background: #fff; + @extend %vertical-rhythm; + + .c { color: $xc-green; font-style: italic } // Comment + .err { color: #a61717; background-color: #e3d2d2 } // Error + .k { color: $xc-blue} // Keyword + .o { } // Operator + .cm { color: $xc-green; font-style: italic } // Comment.Multiline + .cp { color: $xc-red} // Comment.Preproc + .c1 { color: $xc-green; font-style: italic } // Comment.Single + .cs { color: $xc-green; font-weight: bold; font-style: italic } // Comment.Special + .gd { color: #000; background-color: #fdd } // Generic.Deleted + .gd .x { color: #000; background-color: #faa } // Generic.Deleted.Specific + .ge { font-style: italic } // Generic.Emph + .gr { color: #a00 } // Generic.Error + .gh { color: #999 } // Generic.Heading + .gi { color: #000; background-color: #dfd } // Generic.Inserted + .gi .x { color: #000; background-color: #afa } // Generic.Inserted.Specific + .go { color: #888 } // Generic.Output + .gp { color: #555 } // Generic.Prompt + .gs { font-weight: bold } // Generic.Strong + .gu { color: #aaa } // Generic.Subheading + .gt { color: #a00 } // Generic.Traceback + .kc { color: orange} // Keyword.Constant + .kd { color: orange} // Keyword.Declaration + .kp { color: $xc-green} // Keyword.Pseudo + .kr { color: $xc-green} // Keyword.Reserved + .kt { color: $xc-blue} // Keyword.Type + .m { color: orange } // Literal.Number + .s { color: $xc-red } // Literal.String + .na { color: orange } // Name.Attribute + .nb { color: $xc-blue } // Name.Builtin + .nc { color: $xc-turquoise } // Name.Class + .no { color: orange } // Name.Constant + .ni { color: orange } // Name.Entity + .ne { color: orange } // Name.Exception + .nf { } // Name.Function + .nn { color: orange } // Name.Namespace + .nt { color: orange } // Name.Tag + .nv { } // Name.Variable + .ow { } // Operator.Word + .w { color: #bbb } // Text.Whitespace + .mf {} // Literal.Number.Float + .mh { color: $xc-black } // Literal.Number.Hex + .mi { color: $xc-black } // Literal.Number.Integer + .mo { color: $xc-black } // Literal.Number.Oct + .il { color: $xc-black } // Literal.Number.Integer.Long + .sb { color: #d14 } // Literal.String.Backtick + .sc { color: #d14 } // Literal.String.Char + .sd { color: #d14 } // Literal.String.Doc + .s2 { color: #d14 } // Literal.String.Double + .se { color: #d14 } // Literal.String.Escape + .sh { color: #d14 } // Literal.String.Heredoc + .si { color: #d14 } // Literal.String.Interpol + .sx { color: #d14 } // Literal.String.Other + .sr { color: orange } // Literal.String.Regex + .s1 { color: $xc-red } // Literal.String.Single + .ss { color: $xc-red } // Literal.String.Symbol + .bp { color: $xc-turquoise } // Name.Builtin.Pseudo + .vc { color: $xc-turquoise } // Name.Variable.Class + .vg { color: $xc-black } // Name.Variable.Global + .vi { color: orange } // Name.Variable.Instance + .nl { color: $xc-turquoise } +} diff --git a/docs/assets/guide/1-shuffle-crop.png b/docs/assets/guide/1-shuffle-crop.png new file mode 100644 index 0000000000000000000000000000000000000000..d1e0a83b0c3c23ee7ae938f88dbc1bebd1f27246 GIT binary patch literal 1016 zcmeAS@N?(olHy`uVBq!ia0y~yVB7>`>u|6ENrnvD*+5dT#5JNMI6tkVJh3R1p&&0k zxu~=_!=cpkGXn$jB2O2`kcwMxZ~J!mRm&Xs_};iY&1Un1je<(9C!d&UW^G$>v%+)X zo+C?KIyKyq)KW7hi5zu0>2@efY{{~WBTj)zulO`CP2ug%G@ALSa$d2xeewC3&(F=h zy>n-2{J!~CbFV+Q{5oe@{_{Eiuc&(-O5tjCQr!KE{qwFfRb{JYC+uC9R=Mcq@-utN zcG_)@n}0LTx>xpd@g$X4k4ygp76!avtYg%2`1-qM(aJfN%jVpSo13uH>g1FwI_fiX zJ1OZfs&pZJ}bs zX11v4WL$hKC0e^h&GWAcX&igRove_L54T-D0R z?*7rcvtHiH`thIM-j6RfuH@X7|9uw7*u-Nz72ov^UAo4mA9rAi=7%?uXXbLd_Z=y$ z{&t{OdUAcZGqX-4Q)%gjlFS_KsR;*}W*Ddc**IPA;4qzs&OJFbe=P29D_D5l*(fE*@9$rO;gu28wiO2Vj*D^`)K>ARSQZ?3tte@vxtv$}(fnz@e!1 zavq)oD}y)W%>_B&Qv8OhQlH4r&wAzg;vVkME-0f`@ZX99t7%_)q5S zS)dRoIl>YeG&!QCJx^e&QGp3T(=JTt-{Lyf_xt`VW4m~78z@J6y85}Sb4q9e0NQ!% A6951J literal 0 HcmV?d00001 diff --git a/docs/assets/guide/1-shuffle.png b/docs/assets/guide/1-shuffle.png new file mode 100644 index 0000000000000000000000000000000000000000..9188eebf8ae9edd78fadd80b1a8f994e116c88e4 GIT binary patch literal 19288 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 literal 0 HcmV?d00001 diff --git a/docs/assets/logo-square.png b/docs/assets/logo-square.png new file mode 100755 index 0000000000000000000000000000000000000000..82ad66c69ecdd8626cdd380e5c536dbcaeb0a0fc GIT binary patch literal 66422 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

Axt>VUn+{%`lVxh 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 literal 0 HcmV?d00001 diff --git a/docs/assets/logo.png b/docs/assets/logo.png new file mode 100755 index 0000000000000000000000000000000000000000..dce1ebc95066e56bf72c591027b7776b767a5786 GIT binary patch literal 105684 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

AgH(i{EZ2lp^1>P->`lX~`! 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 literal 0 HcmV?d00001 diff --git a/docs/build.sh b/docs/build.sh new file mode 100755 index 0000000000..c532bb0d6b --- /dev/null +++ b/docs/build.sh @@ -0,0 +1,33 @@ +#!/bin/sh +set -e + +HEADERS=`ls ../AsyncDisplayKit/*.h ../AsyncDisplayKit/Details/ASRangeController.h ../AsyncDisplayKit/Layout/*.h` + +rm -rf htdocs appledoc + +jekyll build --destination htdocs + +appledoc \ + --no-create-docset \ + --create-html \ + --exit-threshold 2 \ + --no-repeat-first-par \ + --no-merge-categories \ + --explicit-crossref \ + --warn-missing-output-path \ + --warn-missing-company-id \ + --warn-undocumented-object \ + --warn-undocumented-member \ + --warn-empty-description \ + --warn-unknown-directive \ + --warn-invalid-crossref \ + --warn-missing-arg \ + --project-name AsyncDisplayKit \ + --project-company Facebook \ + --company-id "com.facebook" \ + --output appledoc \ + $HEADERS + +mv appledoc/html htdocs/appledoc + +rmdir appledoc diff --git a/docs/css/main.scss b/docs/css/main.scss new file mode 100755 index 0000000000..4417ff0713 --- /dev/null +++ b/docs/css/main.scss @@ -0,0 +1,49 @@ +--- +# Only the main Sass file needs front matter (the dashes are enough) +--- +@charset "utf-8"; + + + +// Our variables +$base-font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; +$base-font-size: 16px; +$small-font-size: $base-font-size * 0.875; +$base-line-height: 1.5; + +$spacing-unit: 30px; + +$text-color: #111; +$background-color: #f8f8f8; +$brand-color: #21b6ff; + +$grey-color: #828282; +$grey-color-light: lighten($grey-color, 40%); +$grey-color-dark: darken($grey-color, 25%); + +$on-palm: 600px; +$on-laptop: 800px; + + + +// Using media queries with like this: +// @include media-query($palm) { +// .wrapper { +// padding-right: $spacing-unit / 2; +// padding-left: $spacing-unit / 2; +// } +// } +@mixin media-query($device) { + @media screen and (max-width: $device) { + @content; + } +} + + + +// Import partials from `sass_dir` (defaults to `_sass`) +@import + "base", + "layout", + "syntax-highlighting" +; diff --git a/docs/guide/1-introduction.md b/docs/guide/1-introduction.md new file mode 100644 index 0000000000..d923c0a215 --- /dev/null +++ b/docs/guide/1-introduction.md @@ -0,0 +1,150 @@ +--- +layout: docs +title: Getting started +permalink: /guide/ +next: guide/2/ +--- + +## Concepts + +AsyncDisplayKit's basic unit is the *node*. ASDisplayNode is an abstraction +over UIView, which in turn is an abstraction over CALayer. Unlike views, which +can only be used on the main thread, nodes are thread-safe: you can +instantiate and configure entire hierarchies of them in parallel on background +threads. + +To keep its user interface smooth and responsive, your app should render at 60 +frames per second — the gold standard on iOS. This means the main thread +has one-sixtieth of a second to push each frame. That's 16 milliseconds to +execute all layout and drawing code! And because of system overhead, your code +usually has less than ten milliseconds to run before it causes a frame drop. + +AsyncDisplayKit lets you move image decoding, text sizing and rendering, and +other expensive UI operations off the main thread. It has other tricks up its +sleeve too... but we'll get to that later. :] + +## Nodes as drop-in view replacements + +If you're used to working with views, you already know how to use nodes. The +node API is similar to UIView's, with some additional conveniences — for +example, you can access common CALayer properties directly. To add a node to +an existing view or layer hierarchy, use its `node.view` or `node.layer`. + +AsyncDisplayKit's core components include: + +* *ASDisplayNode*. Counterpart to UIView — subclass to make custom nodes. +* *ASControlNode*. Analogous to UIControl — subclass to make buttons. +* *ASImageNode*. Like UIImageView — decodes images asynchronously. +* *ASTextNode*. Like UITextView — built on TextKit with full-featured + rich text support. +* *ASTableView* and *ASCollectionView*. UITableView and UICollectionView + subclasses that support nodes. + +You can use these as drop-in replacements for their UIKit counterparts. While +ASDK works most effectively with fully node-based hierarchies, even replacing +individual views with nodes can improve performance. + +Let's look at an example. + +We'll start out by using nodes synchronously on the main thread — the +same way you already use views. This code is a familiar sight in custom view +controller `-loadView` implementations: + +```objective-c +_imageView = [[UIImageView alloc] init]; +_imageView.image = [UIImage imageNamed:@"hello"]; +_imageView.frame = CGRectMake(10.0f, 10.0f, 40.0f, 40.0f); +[self.view addSubview:_imageView]; +``` + +We can replace it with the following node-based code: + +```objective-c +_imageNode = [[ASImageNode alloc] init]; +_imageNode.backgroundColor = [UIColor lightGrayColor]; +_imageNode.image = [UIImage imageNamed:@"hello"]; +_imageNode.frame = CGRectMake(10.0f, 10.0f, 40.0f, 40.0f); +[self.view addSubview:_imageNode.view]; +``` + +This doesn't take advantage of ASDK's asynchronous sizing and layout +functionality, but it's already an improvement. The first block of code +synchronously decodes `hello.png` on the main thread; the second starts +decoding the image on a background thread, possibly on a different CPU core. + +(Note that we're setting a placeholder background colour on the node, "holding +its place" onscreen until the real content appears. This works well with +images but less so with text — people expect text to appear instantly, +with images loading in after a slight delay. We'll discuss techniques to +improve this later on.) + +## Button nodes + +ASImageNode and ASTextNode both inherit from ASControlNode, so you can use them +as buttons. Let's say we're making a music player and we want to add a +(non-skeuomorphic, iOS 7-style) shuffle button: + +[![shuffle]({{ site.baseurl }}/assets/guide/1-shuffle-crop.png)]({{ site.baseurl }}/assets/guide/1-shuffle.png) + +Our view controller will look something like this: + +```objective-c +- (void)viewDidLoad +{ + [super viewDidLoad]; + + // attribute a string + NSDictionary *attrs = @{ + NSFontAttributeName: [UIFont systemFontOfSize:12.0f], + NSForegroundColorAttributeName: [UIColor redColor], + }; + NSAttributedString *string = [[NSAttributedString alloc] initWithString:@"shuffle" + attributes:attrs]; + + // create the node + _shuffleNode = [[ASTextNode alloc] init]; + _shuffleNode.attributedString = string; + + // configure the button + _shuffleNode.userInteractionEnabled = YES; // opt into touch handling + [_shuffleNode addTarget:self + action:@selector(buttonTapped:) + forControlEvents:ASControlNodeEventTouchUpInside]; + + // size all the things + CGRect b = self.view.bounds; // convenience + CGSize size = [_shuffleNode measure:CGSizeMake(b.size.width, FLT_MAX)]; + CGPoint origin = CGPointMake(roundf( (b.size.width - size.width) / 2.0f ), + roundf( (b.size.height - size.height) / 2.0f )); + _shuffleNode.frame = (CGRect){ origin, size }; + + // add to our view + [self.view addSubview:_shuffleNode.view]; +} + +- (void)buttonTapped:(id)sender +{ + NSLog(@"tapped!"); +} +``` + +This works as you would expect. Unfortunately, this button is only 14½ +points tall — nowhere near the standard 44×44 minimum tap target +size — and it's very difficult to tap. We could solve this by +subclassing the text node and overriding `-hitTest:withEvent:`. We could even +force the text view to have a minimum height during layout. But wouldn't it be +nice if there were a more elegant way? + +```objective-c + // size all the things + /* ... */ + + // make the tap target taller + CGFloat extendY = roundf( (44.0f - size.height) / 2.0f ); + _shuffleNode.hitTestSlop = UIEdgeInsetsMake(-extendY, 0.0f, -extendY, 0.0f); +``` + +Et voilà! *Hit-test slops* work on all nodes, and are a nice example of what +this new abstraction enables. + +Next up, making your own nodes! diff --git a/docs/guide/2-custom-nodes.md b/docs/guide/2-custom-nodes.md new file mode 100644 index 0000000000..6d67ed3a05 --- /dev/null +++ b/docs/guide/2-custom-nodes.md @@ -0,0 +1,211 @@ +--- +layout: docs +title: Custom nodes +permalink: /guide/2/ +prev: guide/ +next: guide/3/ +--- + +## View hierarchies + +Sizing and layout of custom view hierarchies are typically done all at once on +the main thread. For example, a custom UIView that minimally encloses a text +view and an image view might look like this: + +```objective-c +- (CGSize)sizeThatFits:(CGSize)size +{ + // size the image + CGSize imageSize = [_imageView sizeThatFits:size]; + + // size the text view + CGSize maxTextSize = CGSizeMake(size.width - imageSize.width, size.height); + CGSize textSize = [_textView sizeThatFits:maxTextSize]; + + // make sure everything fits + CGFloat minHeight = MAX(imageSize.height, textSize.height); + return CGSizeMake(size.width, minHeight); +} + +- (void)layoutSubviews +{ + CGSize size = self.bounds.size; // convenience + + // size and layout the image + CGSize imageSize = [_imageView sizeThatFits:size]; + _imageView.frame = CGRectMake(size.width - imageSize.width, 0.0f, + imageSize.width, imageSize.height); + + // size and layout the text view + CGSize maxTextSize = CGSizeMake(size.width - imageSize.width, size.height); + CGSize textSize = [_textView sizeThatFits:maxTextSize]; + _textView.frame = (CGRect){ CGPointZero, textSize }; +} +``` + +This isn't ideal. We're sizing our subviews twice — once to figure out +how big our view needs to be and once when laying it out — and while our +layout arithmetic is cheap and quick, we're also blocking the main thread on +expensive text sizing. + +We could improve the situation by manually cacheing our subviews' sizes, but +that solution comes with its own set of problems. Just adding `_imageSize` and +`_textSize` ivars wouldn't be enough: for example, if the text were to change, +we'd need to recompute its size. The boilerplate would quickly become +untenable. + +Further, even with a cache, we'll still be blocking the main thread on sizing +*sometimes*. We could try to shift sizing to a background thread with +`dispatch_async()`, but even if our own code is thread-safe, UIView methods are +documented to [only work on the main +thread](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIView_Class/index.html): + +> Manipulations to your application’s user interface must occur on the main +> thread. Thus, you should always call the methods of the UIView class from +> code running in the main thread of your application. The only time this may +> not be strictly necessary is when creating the view object itself but all +> other manipulations should occur on the main thread. + +This is a pretty deep rabbit hole. We could attempt to work around the fact +that UILabels and UITextViews cannot safely be sized on background threads by +manually creating a TextKit stack and sizing the text ourselves... but that's a +laborious duplication of work. Further, if UITextView's layout behaviour +changes in an iOS update, our sizing code will break. (And did we mention that +TextKit isn't thread-safe either?) + +## Node hierarchies + +Enter AsyncDisplayKit. Our custom node looks like this: + +```objective-c +#import + +... + +// perform expensive sizing operations on a background thread +- (CGSize)calculateSizeThatFits:(CGSize)constrainedSize +{ + // size the image + CGSize imageSize = [_imageNode measure:constrainedSize]; + + // size the text node + CGSize maxTextSize = CGSizeMake(constrainedSize.width - imageSize.width, + constrainedSize.height); + CGSize textSize = [_textNode measure:maxTextSize]; + + // make sure everything fits + CGFloat minHeight = MAX(imageSize.height, textSize.height); + return CGSizeMake(constrainedSize.width, minHeight); +} + +// do as little work as possible in main-thread layout +- (void)layout +{ + // layout the image using its cached size + CGSize imageSize = _imageNode.calculatedSize; + _imageNode.frame = CGRectMake(self.bounds.size.width - imageSize.width, 0.0f, + imageSize.width, imageSize.height); + + // layout the text view using its cached size + CGSize textSize = _textNode.calculatedSize; + _textNode.frame = (CGRect){ CGPointZero, textSize }; +} +``` + +ASImageNode and ASTextNode, like the rest of AsyncDisplayKit, are thread-safe, +so we can size them on background threads. The `-measure:` method is like +`-sizeThatFits:`, but with side effects: it caches both the argument +(`constrainedSizeForCalculatedSize`) and the result (`calculatedSize`) for +quick access later on — like in our now-snappy `-layout` implementation. + +As you can see, node hierarchies are sized and laid out in much the same way as +their view counterparts. Custom nodes do need to be written with a few things +in mind: + +* Nodes must recursively measure all of their subnodes in their + `-calculateSizeThatFits:` implementations. Note that the `-measure:` + machinery will only call `-calculateSizeThatFits:` if a new measurement pass + is needed (e.g., if the constrained size has changed). + +* Nodes should perform any other expensive pre-layout calculations in + `-calculateSizeThatFits:`, cacheing useful intermediate results in ivars as + appropriate. + +* Nodes should call `[self invalidateCalculatedSize]` when necessary. For + example, ASTextNode invalidates its calculated size when its + `attributedString` property is changed. + +For more examples of custom sizing and layout, along with a demo of +ASTextNode's features, check out `BlurbNode` and `KittenNode` in the +[Kittens](https://github.com/facebook/AsyncDisplayKit/tree/master/examples/Kittens) +sample project. + +## Custom drawing + +To guarantee thread safety in its highly-concurrent drawing system, the node +drawing API diverges substantially from UIView's. Instead of implementing +`-drawRect:`, you must: + +1. Define an internal "draw parameters" class for your custom node. This + class should be able to store any state your node needs to draw itself + — it can be a plain old NSObject or even a dictionary. + +2. Return a configured instance of your draw parameters class in + `-drawParametersForAsyncLayer:`. This method will always be called on the + main thread. + +3. Implement either `+drawRect:withParameters:isCancelled:isRasterizing:` or + `+displayWithParameters:isCancelled:`. Note that these are *class* methods + that will not have access to your node's state — only the draw + parameters object. They can be called on any thread and must be + thread-safe. + +For example, this node will draw a rainbow: + +```objective-c +@interface RainbowNode : ASDisplayNode +@end + +@implementation RainbowNode + ++ (void)drawRect:(CGRect)bounds + withParameters:(id)parameters + isCancelled:(asdisplaynode_iscancelled_block_t)isCancelledBlock + isRasterizing:(BOOL)isRasterizing +{ + // clear the backing store, but only if we're not rasterising into another layer + if (!isRasterizing) { + [[UIColor whiteColor] set]; + UIRectFill(bounds); + } + + // UIColor sadly lacks +indigoColor and +violetColor methods + NSArray *colors = @[ [UIColor redColor], + [UIColor orangeColor], + [UIColor yellowColor], + [UIColor greenColor], + [UIColor blueColor], + [UIColor purpleColor] ]; + CGFloat stripeHeight = roundf(bounds.size.height / (float)colors.count); + + // draw the stripes + for (UIColor *color in colors) { + CGRect stripe = CGRectZero; + CGRectDivide(bounds, &stripe, &bounds, stripeHeight, CGRectMinYEdge); + [color set]; + UIRectFill(stripe); + } +} + +@end +``` + +This could easily be extended to support vertical rainbows too, by adding a +`vertical` property to the node, exporting it in +`-drawParametersForAsyncLayer:`, and referencing it in +`+drawRect:withParameters:isCancelled:isRasterizing:`. More-complex nodes can +be supported in much the same way. + +For more on custom nodes, check out the [subclassing +header](https://github.com/facebook/AsyncDisplayKit/blob/master/AsyncDisplayKit/ASDisplayNode%2BSubclasses.h) +or read on! diff --git a/docs/guide/3-asynchronous-display.md b/docs/guide/3-asynchronous-display.md new file mode 100644 index 0000000000..acc9f37911 --- /dev/null +++ b/docs/guide/3-asynchronous-display.md @@ -0,0 +1,102 @@ +--- +layout: docs +title: Asynchronous display +permalink: /guide/3/ +prev: guide/2/ +next: guide/4/ +--- + +## Realistic placeholders + +Nodes need to complete both a *measurement pass* and a *display pass* before +they're fully rendered. It's possible to force either step to happen +synchronously: call `-measure:` in `-layoutSubviews` to perform sizing on the +main thread, or set a node's `displaysAsynchronously` flag to NO to disable +ASDK's async display machinery. (AsyncDisplayKit can still improve your app's +performance even when rendering fully synchronously — more on that +later!) + +The recommended way to use ASDK is to only add nodes to your view hierarchy +once they've been sized. This avoids unsightly layout changes as the +measurement pass completes, but if you enable asynchronous display, it will +always be possible for a node to appear onscreen before its content has fully +rendered. We'll discuss techniques to minimise this shortly, but you should +take it into account and include *realistic placeholders* in your app designs. + +Once its measurement pass has completed, a node can accurately place all of its +subnodes onscreen — they'll just be blank. The easiest way to make a +realistic placeholder is to set static background colours on your subnodes. +This effect looks better than generic placeholder images because it varies +based on the content being loaded, and it works particularly well for opaque +images. You can also create visually-appealing placeholder nodes, like the +shimmery lines representing text in Paper as its stories are loaded, and swap +them out with your content nodes once they've finished displaying. + +## Working range + +So far, we've only discussed asynchronous sizing: toss a "create a node +hierarchy and measure it" block onto a background thread, then trampoline to +the main thread to add it to the view hierarchy when that's done. Ideally, as +much content as possible should be fully-rendered and ready to go as soon as +the user scrolls to it. This requires triggering display passes in advance. + +If your app's content is in a scroll view or can be paged through, like +Instagram's main feed or Paper's story strip, the solution is a *working +range*. A working range controller tracks the *visible range*, the subset of +content that's currently visible onscreen, and enqueues asynchronous rendering +for the next few screenfuls of content. As the user scrolls, a screenful or +two of previous content is preserved; the rest is cleared to conserve memory. +If she starts scrolling in the other direction, the working range trashes its +render queue and starts pre-rendering in the new direction of scroll — +and because of the buffer of previous content, this entire process will +typically be invisible. + +AsyncDisplayKit includes a generic working range controller, +`ASRangeController`. Its working range size can be tuned depending on your +app: if your nodes are simple, even an iPhone 4 can maintain a substantial +working range, but heavyweight nodes like Facebook stories are expensive and +need to be pruned quickly. + +```objective-c +ASRangeController *rangeController = [[ASRangeController alloc] init]; +rangeController.tuningParameters = (ASRangeTuningParameters){ + .leadingBufferScreenfuls = 2.0f; // two screenfuls in the direction of scroll + .trailingBufferScreenfuls = 0.5f; // one-half screenful in the other direction +}; +``` + +If you use a working range, you should profile your app and consider tuning it +differently on a per-device basis. iPhone 4 has 512MB of RAM and a single-core +A4 chipset, while iPhone 6 has 1GB of RAM and the orders-of-magnitude-faster +multicore A8 — and if your app supports iOS 7, it will be used on both. + +## ASTableView + +ASRangeController manages working ranges, but doesn't actually display content. +If your content is currently rendered in a UITableView, you can convert it to +use `ASTableView` and custom nodes — just subclass `ASCellNode` instead +of ASDisplayNode. ASTableView is a UITableView subclass that integrates +node-based cells and a working range. + +ASTableView doesn't let cells onscreen until their underlying nodes have been +sized, and as such can fully benefit from realistic placeholders. Its API is +very similar to UITableView (see the +[Kittens](https://github.com/facebook/AsyncDisplayKit/tree/master/examples/Kittens) +sample project for an example), with some key changes: + +* Rather than setting the table view's `.delegate` and `.dataSource`, you set + its `.asyncDelegate` and `.asyncDataSource`. See + [ASTableView.h](https://github.com/facebook/AsyncDisplayKit/blob/master/AsyncDisplayKit/ASTableView.h) + for how its delegate and data source protocols differ from UITableView's. + +* Instead of implementing `-tableView:cellForRowAtIndexPath:`, your data + source must implement `-tableView:nodeForRowAtIndexPath:`. This method must + be thread-safe and should not implement reuse. Unlike the UITableView + version, it won't be called when the row is about to display. + +* `-tableView:heightForRowAtIndexPath:` has been removed — ASTableView + lets your cell nodes size themselves. This means you no longer have to + manually duplicate or factor out layout and sizing logic for + dynamically-sized UITableViewCells! + +Next up, how to get the most out of ASDK in your app. diff --git a/docs/guide/4-making-the-most-of-asdk.md b/docs/guide/4-making-the-most-of-asdk.md new file mode 100644 index 0000000000..f35ad900b4 --- /dev/null +++ b/docs/guide/4-making-the-most-of-asdk.md @@ -0,0 +1,139 @@ +--- +layout: docs +title: Making the most of AsyncDisplayKit +permalink: /guide/4/ +prev: guide/3/ +next: guide/5/ +--- + +## A note on optimisation + +AsyncDisplayKit is powerful and flexible, but it is not a panacea. If your app +has a complex image- or text-heavy user interface, ASDK can definitely help +improve its performance — but if you're blocking the main thread on +network requests, you should consider rearchitecting a few things first. :] + +So why is it worthwhile to change the way we do view layout and rendering, +given that UIKit has always been locked to the main thread and performant iOS +apps have been shipping since iPhone's launch? + +### Modern animations + +Until iOS 7, static animations (à la `+[UIView +animateWithDuration:animations:]`) were the standard. The post-skeuomorphism +redesign brought with it highly-interactive, physics-based animations, with +springs joining the ranks of constant animation functions like +`UIViewAnimationOptionCurveEaseInOut`. + +Classic animations aren't actually executed in your app. They're executed +out-of-process, in the high-priority Core Animation render server. Thanks to +pre-emptive multitasking, an app can block its main thread continuously without +causing the animation to drop a single frame. + +Critically, dynamic animations can't be offloaded the same way, and both +[pop](https://github.com/facebook/pop) and UIKit Dynamics execute physics +simulations on your app's main thread. This is because executing arbitrary +code in the render server would introduce unacceptable latency, even if it +could be done securely. + +Physics-based animations are often interactive, letting you start an animation +and interrupt it before it completes. Paper lets you fling objects across the +screen and catch them before they land, or grab a view that's being pulled by a +spring and tear it off. This requires processing touch events and updating +animation targets in realtime — even short delays for inter-process +communication would shatter the illusion. + +(Fun fact: Inertial scrolling is also a physics animation! UIScrollView has +always implemented its animations on the main thread, which is why stuttery +scrolling is the hallmark of a slow app.) + +### The main-thread bottleneck + +Physics animations aren't the only thing that need to happen on the main +thread. The main thread's [run +loop](https://developer.apple.com/library/ios/documentation/cocoa/conceptual/multithreading/runloopmanagement/runloopmanagement.html) +is responsible for handling touch events and initiating drawing operations +— and with UIKit in the mix, it also has to render text, decode images, +and do any other custom drawing (e.g., using Core Graphics). + +If an iteration of the main thread's run loop takes too long, it will drop an +animation frame and may fail to handle touch events in time. Each iteration of +the run loop must complete within 16ms in order to drive 60fps animations, and +your own code typically has less than 10ms to execute. This means that the +best way to keep your app smooth and responsive is to do as little work on the +main thread as possible. + +What's more, the main thread only executes on one core! Single-threaded view +hierarchies can't take advantage of the multicore CPUs in all modern iOS +devices. This is important for more than just performance reasons — it's +also critical for battery life. Running the CPU on all cores for a short time +is preferable to running one core for an extended amount of time: if the +processor can *race to sleep* by finishing its work and idling faster, it can +spend more time in a low-power mode, improving battery life. + +## When to go asynchronous + +AsyncDisplayKit really shines when used fully asynchronously, shifting both +measurement and rendering passes off the main thread and onto multiple cores. +This requires a completely node-based hierarchy. Just as degrading from +UIViews to CALayers disables view-specific functionality like touch handling +from that point on, degrading from nodes to views disables async behaviour. + +You don't, however, need to convert your app's entire view hierarchy to nodes. +In fact, you shouldn't! Asynchronously bringing up your app's core UI, like +navigation elements or tab bars, would be a very confusing experience. Those +elements of your apps can still be nodes, but should be fully synchronous to +guarantee a fully-usable interface as quickly as possible. (This is why +UIWindow has no node equivalent.) + +There are two key situations where asynchronous hierarchies excel: + +1. *Parallelisation*. Measuring and rendering UITableViewCells (or your app's + equivalent, e.g., story cards in Paper) are embarrassingly parallel + problems. Table cells typically have a fixed width and variable height + determined by their contents — the argument to `-measure:` for one + cell doesn't depend on any other cells' calculations, so we can enqueue an + arbitrary number of cell measurement passes at once. + +2. *Preloading*. An app with five tabs should synchronously load the first + one so content is ready to go as quickly as possible. Once this is + complete and the CPU is idle, why not asynchronously prepare the other tabs + so the user doesn't have to wait? This is inconvenient with views, but + very easy with nodes. + +Paper's asynchronous rendering starts at the story strip. You should profile +your app and watch how people use it in the wild to decide what combination of +synchrony and asynchrony yields the best user experience. + +## Additional optimisations + +Complex hierarchies — even when rendered asynchronously — can +impose a cost because of the sheer number of views involved. Working around +this can be painful, but AsyncDisplayKit makes it easy! + +* *Layer-backing*. In some cases, you can substantially improve your app's + performance by using layers instead of views. Manually converting + view-based code to layers is laborious due to the difference in APIs. + Worse, if at some point you need to enable touch handling or other + view-specific functionality, you have to manually convert everything back + (and risk regressions!). + + With nodes, converting an entire subtree from views to layers is as simple + as... + + rootNode.layerBacked = YES; + + ...and if you need to go back, it's as simple as deleting one line. We + recommend enabling layer-backing as a matter of course in any custom node + that doesn't need touch handling. + +* *Precompositing*. Flattening an entire view hierarchy into a single layer + also improves performance, but comes with a hit to maintainability and + hierarchy-based reasoning. Nodes can do this for you too! + + rootNode.shouldRasterizeDescendants = YES; + + ...will cause the entire node hierarchy from that point on to be rendered + into one layer. + +Next up: AsyncDisplayKit, under the hood. diff --git a/docs/guide/5-under-the-hood.md b/docs/guide/5-under-the-hood.md new file mode 100644 index 0000000000..01229ec3ff --- /dev/null +++ b/docs/guide/5-under-the-hood.md @@ -0,0 +1,89 @@ +--- +layout: docs +title: Under the hood +permalink: /guide/5/ +prev: guide/4/ +--- + +## Node architecture + +*(Skip to the next section if you're not interested in AsyncDisplayKit implementation details.)* + +We've described nodes as an abstraction over views and layers, and shown how to +interact with the underlying UIViews and CALayers when necessary. Nodes don't +wrap or vend their UIKit counterparts, though — an ASImageNode's `.view` +is not a UIImageView! So how do nodes work? + +**NOTE:** Classes whose names begin with `_` are private. Don't use them +directly! + +Creating a node doesn't create its underlying view-layer pair. This is why you +can create nodes cheaply and on background threads. When you use a UIView or +CALayer property on a node, you're actually interacting with a proxy object, +[`_ASPendingState`](https://github.com/facebook/AsyncDisplayKit/blob/master/AsyncDisplayKit/Private/_ASPendingState.h), +that's preconfigured to match UIView and CALayer defaults. + +The first access to a node's `.view` or `.layer` property causes both to be +initialised and configured with the node's current state. If it has subnodes, +they are recursively loaded as well. Once a node has been loaded, the proxy +object is destroyed and the node becomes main-thread-affined — its +properties will update the underlying view directly. (Layer-backed nodes do +the same, not loading views.) + +Nodes are powered by +[`_ASDisplayLayer`](https://github.com/facebook/AsyncDisplayKit/blob/master/AsyncDisplayKit/Details/_ASDisplayLayer.h) +and +[`_ASDisplayView`](https://github.com/facebook/AsyncDisplayKit/blob/master/AsyncDisplayKit/Details/_ASDisplayView.h). +These are lightweight to create and add to their respective hierarchies, and +provide integration points that allow nodes to act as full-fledged views or +layers. It's possible to create nodes that are backed by custom view or layer +classes, but doing so is strongly discouraged as it disables the majority of +ASDK's functionality. + +When Core Animation asks an `_ASDisplayLayer` to draw itself, the request is +forwarded to its node. Unless asynchronous display has been disabled, the +actual draw call won't happen immediately or on the main thread. Instead, a +display block will be added to a background queue. These blocks are executed +in parallel, but you can enable `ASDISPLAYNODE_DELAY_DISPLAY` in +[`ASDisplayNode(AsyncDisplay)`](https://github.com/facebook/AsyncDisplayKit/blob/master/AsyncDisplayKit/Private/ASDisplayNode%2BAsyncDisplay.mm) +to serialise the render system for debugging. + +Common UIView subclass hooks are forwarded from `_ASDisplayView` to its +underlying node, including touch handling, hit-testing, and gesture recogniser +delegate calls. Because an `_ASDisplayView`'s layer is an `_ASDisplayLayer`, +view-backed nodes also participate in asynchronous display. + +## In practice + +What does this mean for your custom nodes? + +You can implement methods like `-touchesBegan:withEvent:` / +`touchesMoved:withEvent:` / `touchesEnded:withEvent:` / +`touchesCancelled:withEvent:` in your nodes exactly as you would in a UIView +subclass. If you find you need a subclass hook that hasn't already been +provided, please file an issue on GitHub — or add it yourself and submit a +pull request! + +If you need to interact or configure your node's underlying view or layer, +don't do so in `-init`. Instead, override `-didLoad` and check if you're +layer-backed: + +```objective-c +- (void)didLoad +{ + [super didLoad]; + + // add a gesture recogniser, if we have a view to add it to + if (!self.layerBacked) { + _gestureRecogniser = [[UITapGestureRecognizer alloc] initWithTarget:self + action:@selector(_tap:)]; + [self.view addGestureRecognizer:_gestureRecogniser]; + } +} +``` + +## *fin.* + +Thanks for reading! If you have any questions, please file a GitHub issue or +post in the [Facebook group](https://www.facebook.com/groups/551597518288687). +We'd love to hear from you. diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000000..ff8065921a --- /dev/null +++ b/docs/index.md @@ -0,0 +1,86 @@ +--- +layout: page +title: Smooth asynchronous user interfaces for iOS apps +--- + +![logo]({{ site.baseurl }}/assets/logo.png) + +AsyncDisplayKit is an iOS framework that keeps even the most complex user +interfaces smooth and responsive. It was originally built to make Facebook's +[Paper](https://facebook.com/paper) possible, and goes hand-in-hand with +[pop](https://github.com/facebook/pop)'s physics-based animations — but +it's just as powerful with UIKit Dynamics and conventional app designs. + + +
+### Quick start + +ASDK is available on [CocoaPods](http://cocoapods.org). Add the following to your Podfile: + +```ruby +pod 'AsyncDisplayKit' +``` + +(ASDK can also be used as a regular static library: Copy the project to your +codebase manually, adding `AsyncDisplayKit.xcodeproj` to your workspace. Add +`libAsyncDisplayKit.a`, AssetsLibrary, and Photos to the "Link Binary With +Libraries" build phase. Include `-lc++ -ObjC` in your project linker flags.) + +Import the framework header, or create an [Objective-C bridging +header](https://developer.apple.com/library/ios/documentation/swift/conceptual/buildingcocoaapps/MixandMatch.html) +if you're using Swift: + +```objective-c +#import +``` + +AsyncDisplayKit Nodes are a thread-safe abstraction layer over UIViews and +CALayers: + +![logo]({{ site.baseurl }}/assets/node-view-layer.png) + +You can construct entire node hierarchies in parallel, or instantiate and size +a single node on a background thread — for example, you could do +something like this in a UIViewController: + +```objective-c +dispatch_async(_backgroundQueue, ^{ + ASTextNode *node = [[ASTextNode alloc] init]; + node.attributedString = [[NSAttributedString alloc] initWithString:@"hello!" + attributes:nil]; + [node measure:CGSizeMake(screenWidth, FLT_MAX)]; + node.frame = (CGRect){ CGPointZero, node.calculatedSize }; + + // self.view isn't a node, so we can only use it on the main thread + dispatch_async(dispatch_get_main_queue(), ^{ + [self.view addSubview:node.view]; + }); +}); +``` + +AsyncDisplayKit at a glance: + +* `ASImageNode` and `ASTextNode` are drop-in replacements for UIImageView and + UITextView. +* `ASMultiplexImageNode` can load and display progressively higher-quality + variants of an image over a slow cell network, letting you quickly show a + low-resolution photo while the full size downloads. +* `ASNetworkImageNode` is a simpler, single-image counterpart to the Multiplex + node. +* `ASTableView` and `ASCollectionView` are a node-aware UITableView and + UICollectionView, respectively, that can asynchronously preload cell nodes + — from loading network data to rendering — all without blocking + the main thread. + +You can also easily [create your own +nodes](https://github.com/facebook/AsyncDisplayKit/blob/master/AsyncDisplayKit/ASDisplayNode%2BSubclasses.h) +to implement node hierarchies or custom drawing. + + +
+### Learn more + +* Read the [Getting Started guide]({{ site.baseurl }}/guide) +* Get the [sample projects](https://github.com/facebook/AsyncDisplayKit/tree/master/examples) +* Browse the [API reference]({{ site.baseurl }}/appledoc) +* Watch the [NSLondon talk](http://vimeo.com/103589245) or the [NSSpain talk](https://www.youtube.com/watch?v=RY_X7l1g79Q)