quasar/src/components/ajax-bar/QAjaxBar.json

Build high-performance VueJS user interfaces (SPA, PWA, SSR, Mobile and Desktop) in record time

{
  "meta": {
    "docsUrl": "https://v2.quasar.dev/vue-components/ajax-bar"
  },

  "props": {
    "position": {
      "type": "String",
      "desc": "Position within window of where QAjaxBar should be displayed",
      "default": "top",
      "values": [ "top", "right", "bottom", "left" ],
      "category": "style"
    },

    "size": {
      "extends": "size",
      "default": "2px"
    },

    "color": {
      "extends": "color"
    },

    "reverse": {
      "type": "Boolean",
      "desc": "Reverse direction of progress",
      "category": "behavior"
    },

    "skip-hijack": {
      "type": "Boolean",
      "desc": "Skip Ajax hijacking (not a reactive prop)",
      "category": "behavior"
    },

    "hijack-filter": {
      "type": "Function",
      "desc": "Filter which URL should trigger start() + stop()",
      "params": {
        "url": {
          "type": "String",
          "desc": "The URL being triggered",
          "examples": [ "https://some.url/path" ]
        }
      },
      "returns": {
        "type": "Boolean",
        "desc": "Should the URL received as param trigger start() + stop()?"
      },
      "category": "behavior",
      "addedIn": "v2.4.5"
    }
  },

  "events": {
    "start": {
      "desc": "Emitted when bar is triggered to appear"
    },

    "stop": {
      "desc": "Emitted when bar has finished its job"
    }
  },

  "methods": {
    "start": {
      "desc": "Notify bar you are waiting for a new process to finish",
      "params": {
        "speed": {
          "type": "Number",
          "default": 300,
          "desc": "Delay (in milliseconds) between progress auto-increments; If delay is 0 then it disables auto-incrementing"
        }
      },
      "returns": {
        "type": "Number",
        "desc": "Number of active simultaneous sessions"
      }
    },

    "increment": {
      "desc": "Manually trigger a bar progress increment",
      "params": {
        "amount": {
          "type": "Number",
          "desc": "Amount (0 < x <= 100) to increment with"
        }
      },
      "returns": {
        "type": "Number",
        "desc": "Number of active simultaneous sessions"
      }
    },

    "stop": {
      "desc": "Notify bar that one process you were waiting has finished",
      "returns": {
        "type": "Number",
        "desc": "Number of active simultaneous sessions"
      }
    }
  }
}