TinyBase logoTinyBase β

resolveRelationships

The resolveRelationships function is used to get a reference to a Relationships object from a Provider context, or have it passed directly.

resolveRelationships(relationshipsOrRelationshipsId?: MaybeGetter<undefined | RelationshipsOrRelationshipsId>): () => Relationships | undefined
TypeDescription
relationshipsOrRelationshipsId?MaybeGetter<undefined | RelationshipsOrRelationshipsId>

The Relationships object, its Id, or a getter returning either.

returns() => Relationships | undefined

A getter function returning the Relationships object, or undefined.

Example

This example reads a TinyBase object from Svelte context inside a child component.

Child.svelte
<svelte:options runes={true} />

<script>
  import {resolveRelationships, getRelationshipsIds}
from 'tinybase/ui-svelte';
</script>

{resolveRelationships('petRelationships')()
?.getRemoteRowId('petSpecies', 'fido')}
App.svelte
<svelte:options runes={true} />

<script>
  import {Provider} from 'tinybase/ui-svelte';
  import Child from './Child.svelte';

  let {relationships} = $props();
</script>

<Provider relationshipsById={{petRelationships: relationships}}>
  <Child />
</Provider>

import {flushSync, mount} from 'svelte';
import {createRelationships, createStore} from 'tinybase';
import App from './App.svelte';

const store = createStore().setCell('pets', 'fido', 'species', 'dog');
const relationships = createRelationships(store).setRelationshipDefinition(
  'petSpecies',
  'pets',
  'pets',
  'species',
);
const app = document.body.appendChild(document.createElement('div'));
flushSync(() => mount(App, {target: app, props: {relationships}}));
console.log(app.textContent);
// -> 'dog'

Since

v8.1.0