Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zephraph/vue-graphql-loader

Custom block support for GraphQL operations in Vue's single file components
https://github.com/zephraph/vue-graphql-loader

Last synced: 1 day ago
JSON representation

Custom block support for GraphQL operations in Vue's single file components

Awesome Lists containing this project

README

        

# vue-graphql-loader

[![Build Status](https://travis-ci.org/zephraph/vue-graphql-loader.svg?branch=master)](https://travis-ci.org/zephraph/vue-graphql-loader)
[![Greenkeeper badge](https://badges.greenkeeper.io/zephraph/vue-graphql-loader.svg)](https://greenkeeper.io/)
[![npm](https://img.shields.io/npm/dt/vue-graphql-loader.svg)](https://img.shields.io/npm/v/vue-graphql-loader.svg)

Adds support for build time compilation of `` blocks within Vue single file components.

## Installation

Configure this package as a custom loader for the `graphql` block in vue-loader

```javascript
module.exports = {
// ...probably more stuff here
module: {
rules: [
{
test: /\.vue$/,
loader: 'vue-loader'
},
{
resourceQuery: /blockType=graphql/,
use: [
{
loader: require.resolve('vue-graphql-loader'),
options: {
// Allow or disallow anonymous queries, mutations, etc. Defaults to true.
noAnonymousOperations: true
}
}
]
}
]
}
};
```

## Usage

**Anonymous Operations**

Anonymous queries, mutations, and subscriptions are stored on this.$query, this.$mutation, and this.$subscription respectively.

```vue

{
greetings
}
mutation {
doSomething(test: true) {
blah
}
}
subscription {
someFeed() {
name
}
}

export default {
created() {
console.log(
this.$options.query,
this.$options.mutation,
this.$options.subscription
);
}
};

```

When an anonymous operation is present, it's the only operation of that type allowed for the component. That means if there's an anonymous query present, that's the only query that can be included in the component.

**Named Operations**

Named operations are stored as an object the type's Vue namespace.

```vue

query TestQuery {
test
}

export default {
created() {
console.log(this.$options.query.TestQuery);
}
};

```

It's highly recommended that you only use named operations.