docs(virtual-scroll): custom components within virtual scroll

Closes #6881
This commit is contained in:
Adam Bradley
2016-11-19 18:41:26 -06:00
parent 288df86477
commit 8248666f7a

View File

@ -101,7 +101,6 @@ import { VirtualFooter, VirtualHeader, VirtualItem } from './virtual-item';
* slightly different heights between platforms, which is perfectly fine. * slightly different heights between platforms, which is perfectly fine.
* *
* *
*
* ### Images Within Virtual Scroll * ### Images Within Virtual Scroll
* *
* Ionic provides `<ion-img>` to manage HTTP requests and image rendering. * Ionic provides `<ion-img>` to manage HTTP requests and image rendering.
@ -135,6 +134,27 @@ import { VirtualFooter, VirtualHeader, VirtualItem } from './virtual-item';
* ``` * ```
* *
* *
* ### Custom Components
*
* If a custom component is going to be used within Virtual Scroll, it's best
* to wrap it with a good old `<div>` to ensure the component is rendered
* correctly. Since each custom component's implementation and internals can be
* quite different, wrapping within a `<div>` is a safe way to make sure
* dimensions are measured correctly.
*
* ```html
* <ion-list [virtualScroll]="items">
*
* <div *virtualItem="let item">
* <my-custom-item [item]="item">
* {% raw %} {{ item }}{% endraw %}
* </my-custom-item>
* </div>
*
* </ion-list>
* ```
*
*
* ### Performance Tips * ### Performance Tips
* *
* - Use `<ion-img>` rather than `<img>` so images are lazy loaded * - Use `<ion-img>` rather than `<img>` so images are lazy loaded