npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@nxus/base-ui

v2.4.0-6

Published

Basic UI pages for Nxus apps, like 404 and 500 pages

Downloads

19

Readme

@nxus/base-ui

Build Status

Base UI pages including 404 and error page handlers.

Installation

> npm install @nxus/base-ui --save

Usage

The module registers two handlers:

  1. 404: If no other handler responds the route, the module will render the 404 template and return the rendered content.
  2. /error: On a 50x error, the router will redirecto to /error and the module will render the 500 template and return the rendered content.

Model View helpers

The module provides a helper for generating list/detail views from a model:

app.get('base-ui').viewModel('user', {base: '/users', titleField: 'email'})

You may pass in an options object, as in this example, or subclass of ViewBase, or a string path to a subclass of ViewBase.

import {ViewBase} from '@nxus/base-ui'

class UserView extends ViewBase {
  model() {
    return 'user'
  }
  base() {
    return '/users'
  }
  titleField() {
    return 'email
  }
}

app.get('base-ui').viewModel(UserView)

Customizing

If you want to provide your own 404 or 500 page, define the relevant new template. Base-ui will use these to handle the routes above.

404 Page Template

app.get('templater').template('404', 'ejs', 'path/to/my/404template.ejs')

500 Page Template

app.get('templater').template('500', 'ejs', 'path/to/my/500template.ejs')

List and Detail View

You can specify your own list view template to use instead of the default. The base-ui module looks for a template matching the following pattern: view-<model>-list and view-<model>-detail.

Each template will be passed either a model instance (for detail view) or an array of models (for list view), using the model name.

So using the examples above:

app.get('templater').template('view-user-list', 'ejs', () => {
  return "<% users.forEach(function(user){ .... }) %>"
})

app.get('templater').template('view-user-detail', 'ejs', () => {
  return "<%= user.email %>"
})

API


ViewBase

The ViewBase class provides a helper module for defining Base-UI based pages.

Examples

class TodoView extends ViewBase {
 base () {
    return '/todo'
  }
 model () {
    return 'todo'
  }
 templateDir () {
    return __dirname+'/views'
  }
}

base

The base url for the UI pages.

Returns string Defaults to /<models>

display

Fields in the model to show

Returns array

displayName

The display name for the model to use in the UI

Returns string Defaults to <model>

ignore

Fields in the model to ignore in the UI

Returns array

model

Define the primary model for this view module

Returns string

modelPopulate

Define any populated relationships for the model

Returns array

templateDir

The directory to find the templates.

Returns string Defaults to null.

templatePrefix

The prefix to use for the templates. Defaults to view-<model>-

Returns string

titleField

Fields in the model to use for the instance title

Returns string

BaseUI

The base-ui module class.

getViewModel

Returns a viewModel, if it has been regsitered

Parameters

  • model string the name of the model to return

Returns ViewBase An instance of the viewModel

getViewModels

Returns all the registered viewModel instances

Returns array An array of the viewModel/viewBase instances.

viewModel

Creates a List and Detail UI for the specified model, including all routes and views. You can pass in the following combinations:

  1. a model name and opts hash.
  2. a path to a file which is a subclass of ViewBase
  3. a class which is a subclass of ViewBase

Routes created are:

  • /<base>: list page
  • /<base>/:id: detail page

Views which can be overriden are:

  • view-<model>-list: the list page view
  • view-<model>-detail: the detail page view

Options available are:

  • base: the url at which the paths are created. For example, '/users'.
  • templatePrefix: a custom prefix for generated templates. Defaults to view-<model>.
  • ignore: an array of model fields to ignore in the UI. Defaults to ['id', 'createdAt', 'updatedAt']
  • templateDir: a directory containing the list/form templates for the model. Defaults to none.
  • displayName: an alternate name to use for the display in the UI. Defaults to model.
  • instanceTitle: attribute of instance to use for title and link

Parameters

  • model (string|class) Can either be a model name, a path to a file or an ViewBase Subclass.
  • opts Object=(default {}) An options hash, wich is used to configure the UI.