Page - 图1

Page Vue Component

Page in Framework7 has the same meaning as when you think about web pages. Page is the main component to display and operate content.

Page Vue component represents Framework7’s Page.

Page Components

There are following components included:

  • f7-page - main page element
  • f7-page-content - additional inner page content element

Page Properties

Prop Type Default Description
<f7-page> properties
--- --- --- ---
name string Page name
stacked boolean Enable for not currently active page if you use stackedPages Router parameter that keeps all pages in DOM
messages-content boolean Enable if you use Messages component inside to add required extra styling
page-content boolean true When enabled it automatically adds page-content element inside. Usefule to disable when you need to use few page-content elements for tabs
tabs boolean Enable if you use Page as Tabs wrapper
login-screen boolean Enable if you use Login Screen inside of the page to add required extra styling
no-swipeback boolean Disables swipeback feature for the current page (affects iOS theme only)
with-subnavbar boolean Enable if you have Sub Navbar inside of the page
no-navbar boolean Enable if you use common Navbar layout and need to hide common Navbar (or use another one) for this page (affects iOS theme only)
no-toolbar boolean Enable if you use common Toolbar/Tabbar layout and need to hide Toolbar (or use another one) for this page
hide-bars-on-scroll boolean Hide Navbar & Toolbar on page scroll
hide-navbar-on-scroll boolean Hide Navbar on page scroll
hide-toolbar-on-scroll boolean Hide Toolbar on page scroll
ptr boolean Enables Pull To Refresh
ptr-distance number Custom pull to refresh trigger distance. By default (if not specified) it is 44px.
ptr-preloader boolean true Disable if you want to use custom pull to refresh preloader element
ptr-bottom boolean false Enables pull to refresh from bottom
ptr-mousewheel boolean false Enables pull to refresh with mousewheel (for desktop apps). Works only for PTR top
infinite boolean Enables Infinite Scroll
infinite-top boolean Enables infinite scroll on top of the page
infinite-distance boolean true Distance from the bottom of page (in px) to trigger infinite scroll event. By default (if not specified), it is 50 (px)
infinite-preloader boolean true Disable if you want to use custom infinite-scroll preloader
<f7-page-content> properties
tab boolean Enable if you use page-content as Tab
tab-active boolean Enable if the current tab is active
ptr ptr-distance ptr-preloader ptr-bottom ptr-mousewheel infinite infinite-top infinite-distance infinite-preloader hide-bars-on-scroll hide-navbar-on-scroll hide-toolbar-on-scroll messages-content login-screen Same as <f7-page> properties

Page Events

Event Description
<f7-page> events
--- ---
page:mounted Event will be triggered when page with keepAlive route is mounted/attached to DOM
page:init Event will be triggered after Framework7 initialize required page’s components and navbar
page:reinit This event will be triggered in case of navigating to the page that was already initialized
page:beforein Event will be triggered when everything initialized and page is ready to be transitioned into view (into active/current position)
page:afterin Event will be triggered after page transitioned into view
page:beforeout Event will be triggered right before page is going to be transitioned out of view
page:afterout Event will be triggered after page transitioned out of view
page:beforeunmount Event will be triggered when page with keepAlive route is going to be unmounted/detached from DOM
page:beforeremove Event will be triggered right before Page will be removed from DOM. This event could be very useful if you need to detach some events / destroy some plugins to free memory. This event won’t be triggered for keepAlive routes.
page:tabshow Event will be triggered when page’s parent View as Tab becomes visible
page:tabhide Event will be triggered when page’s parent View as Tab becomes hidden
ptr:pullstart Event will be triggered when you start to move pull to refresh content
ptr:pullmove Event will be triggered during you move pull to refresh content
ptr:pullend Event will be triggered when you release pull to refresh content
ptr:refresh Event will be triggered when pull to refresh enters in “refreshing” state
ptr:done Event will be triggered after pull to refresh is done and it is back to initial state (after calling pullToRefreshDone method)
infinite Event will be triggered when page scroll reaches specified (in data-distance attribute) distance to the bottom.
<f7-page-content> events
tab:show Event will be triggered when Tab becomes visible/active
tab:hide Event will be triggered when Tab becomes hidden/inactive
ptr:pullstart ptr:pullmove ptr:pullend ptr:refresh ptr:done infinite Same as <f7-page> events

Page Slots

Page Vue component (<f7-page>) has additional slots for custom elements:

  • default - element will be inserted as a child of “page-content”, if page-content prop is enabled (by default)
  • fixed - element will be inserted as a direct child of “page” right before “page-content”
1. <f7-page>
2. <div slot="fixed">Fixed element</div>
3. <p>Page content goes here</p>
4. </f7-page>

6. <!-- Renders to: -->

8. <div class="page">
9. <div>Fixed element</div>
10. <div class="page-content">
11. <p>Page content goes here</p>
12. </div>
13. </div>

Examples

Infinite Scroll

1. <template>
2. <f7-page
3. infinite
4. :infinite-distance="50"
5. :infinite-preloader="showPreloader"
6. @infinite="loadMore"
7. >
8. <f7-navbar title="Infinite Scroll"></f7-navbar>
9. <f7-block-title>Scroll bottom</f7-block-title>
10. <f7-list>
11. <f7-list-item v-for="(item, index) in items" :title="`Item ${item}`" :key="index"></f7-list-item>
12. </f7-list>
13. </f7-page>
14. </template>
15. <script>
16. export default {
17. data() {
18. return {
19. items: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20],
20. allowInfinite: true,
21. showPreloader: true,
22. };
23. },
24. methods: {
25. loadMore() {
26. const self = this;
27. if (!self.allowInfinite) return;
28. self.allowInfinite = false;

30. setTimeout(() => {
31. if (self.items.length >= 200) {
32. self.showPreloader = false;
33. return;
34. }

36. const itemsLength = self.items.length;

38. for (let i = 1; i <= 20; i += 1) {
39. self.items.push(itemsLength + i);
40. }

42. self.allowInfinite = true;
43. }, 1000);
44. },
45. },
46. };
47. </script>

Pull To Refresh

1. <template>
2. <f7-page ptr @ptr:refresh="loadMore">
3. <f7-navbar title="Pull To Refresh"></f7-navbar>
4. <f7-list media-list>
5. <f7-list-item
6. v-for="(item, index) in items"
7. :key="index"
8. :title="item.title"
9. :subtitle="item.author">
10. <img slot="media" :src="item.cover" width="44" />
11. </f7-list-item>

13. <f7-block-footer>
14. <p>Just pull page down to let the magic happen.<br>Note that pull-to-refresh feature is optimised for touch and native scrolling so it may not work on desktop browser.</p>
15. </f7-block-footer>
16. </f7-list>
17. </f7-page>
18. </template>
19. <script>
20. export default {
21. data() {
22. return {
23. items: [
24. {
25. title: 'Yellow Submarine',
26. author: 'Beatles',
27. cover: 'https://cdn.framework7.io/placeholder/abstract-88x88-1.jpg',
28. },
29. {
30. title: 'Don\'t Stop Me Now',
31. author: 'Queen',
32. cover: 'https://cdn.framework7.io/placeholder/abstract-88x88-2.jpg',
33. },
34. {
35. title: 'Billie Jean',
36. author: 'Michael Jackson',
37. cover: 'https://cdn.framework7.io/placeholder/abstract-88x88-3.jpg',
38. },
39. ],
40. songs: ['Yellow Submarine', 'Don\'t Stop Me Now', 'Billie Jean', 'Californication'],
41. authors: ['Beatles', 'Queen', 'Michael Jackson', 'Red Hot Chili Peppers'],
42. };
43. },
44. methods: {
45. loadMore(done) {
46. const self = this;

48. setTimeout(() => {
49. const picURL = `https://cdn.framework7.io/placeholder/abstract-88x88-${(Math.floor(Math.random() * 10) + 1)}.jpg`;
50. const song = self.songs[Math.floor(Math.random() * self.songs.length)];
51. const author = self.authors[Math.floor(Math.random() * self.authors.length)];

53. self.items.push({
54. title: song,
55. author,
56. cover: picURL,
57. });

59. done();
60. }, 1000);
61. },
62. },
63. };
64. </script>

← Navbar

Panel / Side Panels →