mirror of
https://github.com/ionic-team/ionic-framework.git
synced 2025-08-22 13:32:54 +08:00
docs(virtual-scroll): custom components within virtual scroll
Closes #6881
This commit is contained in:
@ -101,7 +101,6 @@ import { VirtualFooter, VirtualHeader, VirtualItem } from './virtual-item';
|
||||
* slightly different heights between platforms, which is perfectly fine.
|
||||
*
|
||||
*
|
||||
*
|
||||
* ### Images Within Virtual Scroll
|
||||
*
|
||||
* 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
|
||||
*
|
||||
* - Use `<ion-img>` rather than `<img>` so images are lazy loaded
|
||||
|
Reference in New Issue
Block a user