pwix:tabular

What is it ?

A Meteor package which encapsulates aldeed:tabular to force the homogeneity of tabular presentations inside of our applications.

In particular, this package let the caller add (or not) three Information, Edit and Delete buttons at the end right of each row.

Installation

This Meteor package is installable with the usual command:

    meteor add pwix:tabular

Usage

In your .html template, use tabular_ext template instead of tabular, with just the same parameters.

Provides

`Tabular`

The exported Tabular global object provides following items:

Functions

`Tabular.configure( o<Object> )`

See below

`Tabular.i18n.namespace()`

Returns the i18n namespace used by the package. Used to add translations at runtime.

Available both on the client and the server.

Classes

`Tabular.Table`

This package Tabular.Table class extends the aldeed:tabular Tabular.Table class.

The constructor accepts all aldeed:tabular Tabular.Table own options, plus following additional parameters inside of a tabular object:

tabular.buttons

An object which describes additional buttons to be set before or after standard info, edit, delete buttons.

This is an array of objects, where each object has following keys:
- where: whether to insert before or after the standard buttons, with values:
  - Tabular.C.Where.BEFORE
  - Tabular.C.Where.AFTER
- buttons: an array of Blaze template names to be added at the place.
tabular.deleteConfirmationText

The text to be displayed when requiring the user confirmation, as a HTML string.

Defaults to 'You are about to delete the "%s" object. Are you sure ?'.
tabular.deleteConfirmationTitle

The title of the confirmation modal dialog.

Defaults to 'Deleting an object'.
tabular.deleteButtonEnabled

Whether the 'Delete' button must be enabled, with a truethy or falsy value.

Defaults to true (enabled).
tabular.deleteButtonTitle

The title of the 'Delete' button.

Defaults to 'Delete the "%s" object'.
tabular.deleteItem

The object to be deleted.

Defaults to the row data object.
tabular.dialogClasses

The classes to be added to the displayed dialogs, as a string.

Defaults to nothing.
tabular.editButtonEnabled

Whether the 'Edit' button must be enabled, with a truethy or falsy value.

Defaults to true (enabled).
tabular.editButtonTitle

The title of the 'Edit' button.

Defaults to 'Edit the "%s" object'.
tabular.editItem

The object to be edited.

Defaults to the row data object.
tabular.infoButtonEnabled

Whether the 'Information' button must be enabled, with a truethy or falsy value.

Defaults to true (enabled).
tabular.infoButtonTitle

The title of the 'Information' button.

Defaults to 'Informations about the "%s" object'.
tabular.infoItem

The object to be used when displaying informations.

Defaults to the row data object.
tabular.infoModalTitle

The title of the 'Information' modal.

Defaults to 'Informations'.
tabular.wantDeleteConfirmation

Whether the tabular-delete-event event must be triggered after a user confirmation (if true) or as soon as the user has clicked on the Delete button (if false).

Defaults to true (after user confirmation).
tabular.withDeleteButton

Whether to display a 'Delete' button on the right, defaulting to true
tabular.withEditButton

Whether to display an 'Edition' button on the right, defaulting to true
tabular.withInfoButton

Whether to display an 'Information' button on the right, defaulting to true

All parameters can be provided as values, or as async functions. The provided function will be called with the row object, and must return the desired value.

Please note that buttons are managed inside of autorun functions. So the package will be reactive to the changes if you provide here reactive data sources.

As its aldeed:tabular ancestor, this package requires that the Table constructor be called in same terms, both in client and server side.

Configuration

The package's behavior can be configured through a call to the Tabular.configure() method, with just a single javascript object argument, which itself should only contains the options you want override.

Known configuration options are:

hideDisabled

Whether to hide disabled buttons instead of displaying the disabled state.

Defaults to true: disabled buttons are hidden.
verbosity

Define the expected verbosity level.

The accepted value can be any or-ed combination of following:
- Tabular.C.Verbose.NONE
  
  Do not display any trace log to the console
- Tabular.C.Verbose.CONFIGURE
  
  Trace Tabular.configure() calls and their result

Please note that Tabular.configure() method should be called in the same terms both in client and server sides.

Remind too that Meteor packages are instanciated at application level. They are so only configurable once, or, in other words, only one instance has to be or can be configured. Addtionnal calls to Tabular.configure() will just override the previous one. You have been warned: only the application should configure a package.

Tabular.configure() is a reactive data source.

NPM peer dependencies

Starting with v 1.0.0, and in accordance with advices from the Meteor Guide, we no more hardcode NPM dependencies in the Npm.depends clause of the package.js.

Instead we check npm versions of installed packages at runtime, on server startup, in development environment.

Dependencies as of v 1.5.0:

1    'datatables.net-bs5': '^2.0.8',
2    'datatables.net-buttons-bs5': '^3.0.2',
3    'datatables.net-colreorder-bs5': '^2.0.3',
4    'datatables.net-fixedheader-bs5': '^4.0.1',
5    'datatables.net-responsive-bs5': '^3.0.2',
6    'datatables.net-rowgroup-bs5': '^1.5.0',
7    'datatables.net-scroller-bs5': '^2.4.3',
8    'lodash': '^4.17.0',

Each of these dependencies should be installed at application level:

    meteor npm install <package> --save

Translations

New and updated translations are willingly accepted, and more than welcome. Just be kind enough to submit a PR on the Github repository.

Cookies and comparable technologies

None at the moment.

Issues & help

In case of support or error, please report your issue request to our Issues tracker.

P. Wieser

Last updated on 2024, Oct. 4th