Hybrids: Mutation Factory
Use the mutation factory to add a GraphQL mutation to you hybrids element.
import { mutation, define, html } from '@apollo-elements/hybrids';
import { AddUserMutation } from './AddUser.mutation.graphql.js';
const onSubmitForm = (host, e) => {
e.preventDefault();
host.addUser.mutate({
variables: {
name: host.shadowRoot.getElementById('name').value,
},
});
}
define('add-user', {
addUser: mutation(AddUserMutation),
render: ({ users, addUser }) => html`
%3Clink rel="stylesheet" href="add-user.css">
<form onsubmit=${onSubmitForm}>
<label>Name <input id="name" disabled="${addUser.loading}"></label>
<button disabled="${addUser.loading}">Submit</button>
<output hidden="${!addUser.data}">
<p>${addUser.data?.addUser?.name} added!</p>
</output>
</form>
`,
});
:host {
display: block;
counter-reset: item;
}
form {
display: grid;
grid-template-columns: auto min-content;
}
label {
display: contents;
}
output {
grid-column: 1 / -1;
}
import type { User } from './client';
import type { TypedDocumentNode } from '@apollo/client/core';
import { gql } from '@apollo/client/core';
export const AddUserMutation: TypedDocumentNode<{ addUser: User }, { name: String }> = gql`
mutation AddUserMutation($name: String) {
addUser(name: $name) {
id
name
}
}
`;
<script type="module" src="client.js"></script>
<script type="module" src="add-user.js"></script>
<add-user></add-user>
import type { InMemoryCacheConfig, NormalizedCacheObject } from '@apollo/client/core';
import { SchemaLink } from '@apollo/client/link/schema';
import { makeExecutableSchema } from '@graphql-tools/schema';
import { addMocksToSchema } from '@graphql-tools/mock';
import { ApolloClient, InMemoryCache, HttpLink } from '@apollo/client/core';
export interface User {
id: string;
name: string;
status?: 'DELETED';
};
const typeDefs = `
type User {
name: String
id: ID
}
type Query {
users: [User]
}
type Mutation {
addUser(name: String): User
removeUser(id: ID): User
}
`;
const USERS = [
{ id: 1, name: 'Neil' }
];
const randomDelay = () => new Promise(r => setTimeout(r, Math.random() * 500));
export const client = new ApolloClient({
cache: new InMemoryCache(),
link: new SchemaLink({
schema: makeExecutableSchema({
typeDefs,
resolvers: {
Query: {
users() {
return USERS.filter(x => x.status !== 'DELETED');
}
},
Mutation: {
async addUser(_, { name }) {
const user = { name, id: Math.max(...USERS.map(x => x.id)) + 1 };
USERS.push(user);
await randomDelay()
return user;
},
async removeUser(_, { id }) {
const user = USERS.find(x => x.id == parseInt(id));
user.status = 'DELETED';
await randomDelay();
return user;
}
}
}
}),
}),
});
window.__APOLLO_CLIENT__ = client;
mutation
Hybrids property descriptor factory for GraphQL mutations.
Parameters
mutationDocument
DocumentNode | null
The mutation document.
options
ApolloMutationControllerOptions<D, V>
Options to control the mutation.
| Option | Type | Description |
|---|---|---|
| variables | Variables<D, V> |
Operation variables. See variables. |
| optimisticResponse | OptimisticResponseType<D, V> |
See optimisticResponse |
| fetchPolicy | ErrorPolicy |
See fetchPolicy |
| refetchQueries | RefetchQueriesType<D> | null |
See refetchQueries |
| awaitRefetchQueries | boolean |
See awaitRefetchQueries |
| update | MutationUpdaterFn<Data<D>> |
Function used to update the client cache following the mutation. See updater. |
Inherits from ApolloControllerOptions
Returns
mutation
Parameters
mutationDocument
D | null
options
ApolloMutationControllerOptions<D>
| Option | Type | Description |
|---|---|---|
| variables | Variables<D, V> |
Operation variables. See variables. |
| optimisticResponse | OptimisticResponseType<D, V> |
See optimisticResponse |
| fetchPolicy | ErrorPolicy |
See fetchPolicy |
| refetchQueries | RefetchQueriesType<D> | null |
See refetchQueries |
| awaitRefetchQueries | boolean |
See awaitRefetchQueries |
| update | MutationUpdaterFn<Data<D>> |
Function used to update the client cache following the mutation. See updater. |
Inherits from ApolloControllerOptions
Returns
Descriptor<E, ApolloMutationController<D>>
Exports
import { mutation, mutation } from '@apollo-elements/hybrids/factories/mutation';