quasar/ui/src/components/infinite-scroll/QInfiniteScroll.json at v1 · hipertracker/quasar · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
{
  "meta": {
    "docsUrl": "https://v1.quasar.dev/vue-components/infinite-scroll"
  },

  "behavior": {
    "$listeners": true
  },

  "props": {
    "offset": {
      "type": "Number",
      "desc": "Offset (pixels) to bottom of Infinite Scroll container from which the component should start loading more content in advance",
      "default": 500,
      "examples": [ ":offset=\"250\"" ],
      "category": "behavior"
    },

    "debounce": {
      "type": [ "String", "Number" ],
      "desc": "Debounce amount (in milliseconds)",
      "default": 100,
      "examples": [ "0", "530" ],
      "category": "behavior",
      "addedIn": "v1.1.0"
    },

    "initial-index": {
      "type": "Number",
      "desc": "Initialize the pagination index (used for the @load event)",
      "default": 0,
      "examples": [ 2, 3 ],
      "category": "behavior",
      "addedIn": "v1.13.0"
    },

    "scroll-target": {
      "extends": "scroll-target"
    },

    "disable": {
      "extends": "disable"
    },

    "reverse": {
      "type": "Boolean",
      "desc": "Scroll area should behave like a messenger - starting scrolled to bottom and loading when reaching the top",
      "category": "behavior"
    }
  },

  "slots": {
    "default": {
      "extends": "default"
    },

    "loading": {
      "desc": "Slot displaying something while loading content; Example: QSpinner"
    }
  },

  "events": {
    "load": {
      "desc": "Emitted when Infinite Scroll needs to load more data",
      "params": {
        "index": {
          "type": "Number",
          "desc": "The index parameter can be used to make some sort of pagination on the content you load. It takes numeric values starting with 1 and incrementing with each call",
          "examples": [ 12 ]
        },
        "done": {
          "type": "Function",
          "desc": "Function to call when you made all necessary updates. DO NOT forget to call it otherwise your loading message will continue to be displayed",
          "params": {
            "stop": {
              "type": "Boolean",
              "desc": "Stops QInfiniteScroll if it's Boolean 'true'; Specify it in case there's nothing more to load"
            }
          },
          "returns": null
        }
      }
    }
  },

  "methods": {
    "poll": {
      "desc": "Checks scroll position and loads more content if necessary"
    },

    "trigger": {
      "desc": "Tells Infinite Scroll to load more content, regardless of the scroll position"
    },

    "reset": {
      "desc": "Resets calling index to 0"
    },

    "stop": {
      "desc": "Stops working, regardless of scroll position"
    },

    "resume": {
      "desc": "Starts working. Checks scroll position upon call and if trigger is hit, it loads more content"
    },

    "setIndex": {
      "desc": "Overwrite the current pagination index",
      "addedIn": "v1.13.0"
    },

    "updateScrollTarget": {
      "desc": "Updates the scroll target; Useful when the parent elements change so that the scrolling target also changes"
    }
  }
}