knockout-contrib

:metal: KnockoutJS Goodies Monorepo

View the Project on GitHub Profiscience/knockout-contrib

model.mixins.query

This package is intended to be consumed via the @profiscience/knockout-contrib metapackage

Adds a .query property using the query package for persistent, stateless data model params.

In other words, initializes data model params via the querystring, and mirrors changes so that the same query will be applied if the page is reloaded. Useful for making bookmark-able pages.

See the query package for more details.

Usage

import {
  DataModelConstructorBuilder,
  QueryMixin,
} from '@profiscience/knockout-contrib'

class MyDataModel extends DataModelConstructorBuilder.Mixin(
  QueryMixin(
    { someQuerystringParameter: '' } /* Query options (see query package) */,
    'my-data-model' /* (optionally) supply a query group */
  )
)<any> {}

const model = new MyDataModel()

// if querystring contains `?someQuerystringParameter=foo`
model.query.someQuerystringParameter() === 'foo'

// update querystring to `?someQuerystringParameter=bar`
model.query.someQuerystringParameter('bar')

// query params are mirrored on `.params`, so it plays well will mixins
// that follow the correct conventions w/o additional buy in
model.params.someQuerystringParameter()