A lightweight, mobile-ready, data-driven, modular widget designed for lists and grids
The dgrid project provides widgets for lists of data, including simple sets of scrolling rows, grids of data, on-demand lazy-loaded data, and various mixins for additional functionality.
dgrid is available under the "New" BSD License.
dgrid and its dependencies can be installed via Bower using the following command:
bower install dgrid
Note that by default, Bower installs to a bower_components subdirectory. If you'd
like to install to the current directory instead (which tends to be more appropriate
for AMD projects), add a .bowerrc with the following:
{
"directory": "."
}
By default, Bower will automatically find the highest tagged version of dgrid and install it along with its dependencies. Alternatively, the latest development version of dgrid can be installed by instructing Bower to install from the master branch:
bower install dgrid#master
Note that while dgrid lists the dojo package as a dependency, it will not automatically
install dijit, as it is not a hard requirement. Dijit can be additionally installed by
running:
bower install dijit#<target>
...where <target> corresponds to the version of Dojo you have installed.
Alternatively, dgrid and its dependencies can be downloaded individually:
It is recommended to arrange all dependencies as siblings, resulting in a directory structure like the following:
dgriddijit (optional, dependency of some dgrid tests/components)dojodojox (optional, dependency of some dgrid tests)dstoreutil (optional, e.g. if pursuing a custom build)As of version 1.1.0, dgrid can also be retrieved via npm, but using Bower is recommended as it is more straightforward.
RawGit now offers CDN hosting of raw tagged git URLs. It can serve any version of dgrid and dstore via MaxCDN.
For example, here's a packages configuration for dgrid 1.1.0 and dstore 1.1.1:
packages: [
{
name: 'dgrid',
location: '//cdn.rawgit.com/SitePen/dgrid/v1.1.0'
},
{
name: 'dstore',
location: '//cdn.rawgit.com/SitePen/dstore/v1.1.1'
}
]
dgrid works with Dojo 1.8.2 or higher, and supports the following browsers:
dgrid does not support quirks mode. You are heavily encouraged to
include the HTML5 DOCTYPE (<!DOCTYPE html>) at the beginning of your pages.
Documentation for dgrid components is available in the doc folder. In addition, the website hosts a number of tutorials.
If upgrading from a previous dgrid release, please be sure to read the release notes on GitHub.
Bugs or enhancements can be filed by opening an issue in the issue tracker on GitHub.
When reporting a bug, please provide the following information:
If you would like to suggest a fix for a particular issue, you are welcome to fork dgrid, create a branch, and submit a pull request. Please note that a Dojo CLA is required for any non-trivial modifications.
Questions about dgrid usage can be asked in the following places:
Web interfaces for IRC and the mailing list are available from the Dojo Toolkit Community page.
SitePen also offers commercial support for dgrid, as well as Dojo and a number of other JavaScript libraries.
dgrid uses Intern as its test runner. Tests can either be run using the browser, or using a cloud provider such as BrowserStack or Sauce Labs. More information on writing your own tests with Intern can be found in the Intern user guide.
Note that installing dgrid via Bower will not include the test folder; if you wish to run dgrid's unit tests, download the package directly.
Note: Commands listed in this section are all written assuming they are
run inside the dgrid directory.
Run npm install to install Intern:
npm install
Make sure the proper credentials are set in the environment:
# for BrowserStack:
export BROWSERSTACK_USERNAME=<your_browserstack_username>
export BROWSERSTACK_ACCESS_KEY=<your_browserstack_access_key>
# for Sauce Labs:
export SAUCE_USERNAME=<your_sauce_username>
export SAUCE_ACCESS_KEY=<your_sauce_access_key>
Then kick off the runner with the following command:
# for BrowserStack:
grunt intern:browserstack
# for Sauce Labs:
grunt intern:saucelabs
Obtain the latest version of the Selenium server and the IE driver server from Selenium's Download page. (The IE driver server needs to be placed in a folder on your PATH.)
The Selenium server can be started by executing:
java -jar path\to\selenium-server-standalone-<version>.jar
The easiest way to obtain the Selenium standalone server for Mac OS X is by using Homebrew. Once Homebrew is installed, run the following commands:
brew update # ensure you have the latest formulae
brew install selenium-server-standalone
brew install chromedriver # for automating tests in Chrome
selenium-server-standalone installs a selenium-server script
which can be used to start up the server. For additional information
(e.g. how to start the server at login), see the output of
brew info selenium-server-standalone.
Once the Selenium server is running, kick off the Intern test runner with the following command:
grunt test
This runs the intern:local Grunt task, which uses the configuration in intern-local.js.
This configuration overrides intern.js to use NullTunnel, and to test in Chrome by default
(this can be customized as desired according to the browsers you have installed).
FAQs
A lightweight, mobile-ready, data-driven, modular widget designed for lists and grids
The npm package dgrid receives a total of 1,163 weekly downloads. As such, dgrid popularity was classified as popular.
We found that dgrid demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
Socket researchers have discovered malicious npm packages targeting crypto developers, stealing credentials and wallet data using spyware delivered through typosquats of popular cryptographic libraries.
Security News
Socket's package search now displays weekly downloads for npm packages, helping developers quickly assess popularity and make more informed decisions.
Security News
A Stanford study reveals 9.5% of engineers contribute almost nothing, costing tech $90B annually, with remote work fueling the rise of "ghost engineers."