Skip to content

Repository files navigation

@legumeinfo/web-components

This repository contains a Web Component library developed for the Legume Information System and other AgBio databases. The Web Components are built using Lit and the UIkit CSS framework. UIkit, however, is only listed as a development dependency and must be installed independently when using this library.

This readme is intended for developers. For user documentation, see the NPM readme and our documentation site.

Setup

Install dependencies:

npm i

Build

This project uses the TypeScript compiler to produce JavaScript that runs in modern browsers.

To build the JavaScript version of the library:

npm run build

To watch files and rebuild when the files are modified, run the following command in a separate shell:

npm run build:watch

All built files will be placed in the lib/ directory.

Testing

This project uses modern-web.dev's @web/test-runner for testing. See the modern-web.dev testing documentation for more information.

Tests can be run with the test script, which will run tests against Lit's development mode (with more verbose errors) as well as against Lit's production mode:

npm test

For local testing during development, the test:dev:watch command will run tests in Lit's development mode (with verbose errors) on every change to the source files:

npm test:watch

Alternatively the test:prod and test:prod:watch commands will run tests in Lit's production mode.

Dev Server

This project uses modern-web.dev's @web/dev-server for previewing the project without additional build steps. Web Dev Server handles resolving Node-style "bare" import specifiers, which aren't supported in browsers. It also automatically transpiles JavaScript and adds polyfills to support older browsers. See modern-web.dev's Web Dev Server documentation for more information.

To run the dev server and open the project in a new browser tab:

npm run serve

There is a development HTML file located at /dev/index.html that can be viewed at http://localhost:8000/dev/index.html. Note that this command will serve the code using Lit's development mode (with more verbose errors). To serve the code against Lit's production mode, use npm run serve:prod.

Editing

If you use VS Code, we highly recommend the lit-plugin extension, which enables some extremely useful features for lit-html templates:

  • Syntax highlighting
  • Type-checking
  • Code completion
  • Hover-over docs
  • Jump to definition
  • Linting
  • Quick Fixes

The project is setup to recommend lit-plugin to VS Code users if they don't already have it installed.

Linting

Linting of TypeScript files is provided by ESLint and TypeScript ESLint. In addition, lit-analyzer is used to type-check and lint lit-html templates with the same engine and rules as lit-plugin.

The rules are mostly the recommended rules from each project, but some have been turned off to make LitElement usage easier.

To lint the project run:

npm run lint

Formatting

Prettier is used for code formatting. It has been pre-configured according to the Lit's style.

Prettier has not been configured to run when committing files so be sure to run it before pushing any changes.

Static Site

This project includes a website generated with the TypeDoc documentation generator. The site is generated to the /docs directory and intended to be checked in so that GitHub pages can serve the site from /docs on the main branch.

To enable the site, go to the GitHub settings and change the GitHub Pages "Source" setting to "main branch /docs folder".

To build the site, run:

npm run docs

To serve the site locally, run:

npm run docs:serve

The site will usually be served at http://localhost:8000.

Bundling and minification

Bundling and minification is performed in a single step using Rollup. The follow commands will bundle and minify whatever code is already in the lib/ directory and place the bundled code in the file dist/web-components.min.js.

To bundle and minify the code, run:

npm run bundle

To automatically re-bundle when the code in the lib/ directory changes, run:

npm run bundle:watch

About

A collection of Web Components for interacting with and visualizing biological data.

Topics

Resources

Code of conduct

Stars

5 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
GitHub - legumeinfo/web-components: A collection of Web Components for interacting with and visualizing biological data. · GitHub
Skip to content

Repository files navigation

@legumeinfo/web-components

This repository contains a Web Component library developed for the Legume Information System and other AgBio databases. The Web Components are built using Lit and the UIkit CSS framework. UIkit, however, is only listed as a development dependency and must be installed independently when using this library.

This readme is intended for developers. For user documentation, see the NPM readme and our documentation site.

Setup

Install dependencies:

npm i

Build

This project uses the TypeScript compiler to produce JavaScript that runs in modern browsers.

To build the JavaScript version of the library:

npm run build

To watch files and rebuild when the files are modified, run the following command in a separate shell:

npm run build:watch

All built files will be placed in the lib/ directory.

Testing

This project uses modern-web.dev's @web/test-runner for testing. See the modern-web.dev testing documentation for more information.

Tests can be run with the test script, which will run tests against Lit's development mode (with more verbose errors) as well as against Lit's production mode:

npm test

For local testing during development, the test:dev:watch command will run tests in Lit's development mode (with verbose errors) on every change to the source files:

npm test:watch

Alternatively the test:prod and test:prod:watch commands will run tests in Lit's production mode.

Dev Server

This project uses modern-web.dev's @web/dev-server for previewing the project without additional build steps. Web Dev Server handles resolving Node-style "bare" import specifiers, which aren't supported in browsers. It also automatically transpiles JavaScript and adds polyfills to support older browsers. See modern-web.dev's Web Dev Server documentation for more information.

To run the dev server and open the project in a new browser tab:

npm run serve

There is a development HTML file located at /dev/index.html that can be viewed at http://localhost:8000/dev/index.html. Note that this command will serve the code using Lit's development mode (with more verbose errors). To serve the code against Lit's production mode, use npm run serve:prod.

Editing

If you use VS Code, we highly recommend the lit-plugin extension, which enables some extremely useful features for lit-html templates:

  • Syntax highlighting
  • Type-checking
  • Code completion
  • Hover-over docs
  • Jump to definition
  • Linting
  • Quick Fixes

The project is setup to recommend lit-plugin to VS Code users if they don't already have it installed.

Linting

Linting of TypeScript files is provided by ESLint and TypeScript ESLint. In addition, lit-analyzer is used to type-check and lint lit-html templates with the same engine and rules as lit-plugin.

The rules are mostly the recommended rules from each project, but some have been turned off to make LitElement usage easier.

To lint the project run:

npm run lint

Formatting

Prettier is used for code formatting. It has been pre-configured according to the Lit's style.

Prettier has not been configured to run when committing files so be sure to run it before pushing any changes.

Static Site

This project includes a website generated with the TypeDoc documentation generator. The site is generated to the /docs directory and intended to be checked in so that GitHub pages can serve the site from /docs on the main branch.

To enable the site, go to the GitHub settings and change the GitHub Pages "Source" setting to "main branch /docs folder".

To build the site, run:

npm run docs

To serve the site locally, run:

npm run docs:serve

The site will usually be served at http://localhost:8000.

Bundling and minification

Bundling and minification is performed in a single step using Rollup. The follow commands will bundle and minify whatever code is already in the lib/ directory and place the bundled code in the file dist/web-components.min.js.

To bundle and minify the code, run:

npm run bundle

To automatically re-bundle when the code in the lib/ directory changes, run:

npm run bundle:watch

About

A collection of Web Components for interacting with and visualizing biological data.

Topics

Resources

Code of conduct

Stars

5 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' GitHub - legumeinfo/web-components: A collection of Web Components for interacting with and visualizing biological data. · GitHub
Skip to content

Repository files navigation

@legumeinfo/web-components

This repository contains a Web Component library developed for the Legume Information System and other AgBio databases. The Web Components are built using Lit and the UIkit CSS framework. UIkit, however, is only listed as a development dependency and must be installed independently when using this library.

This readme is intended for developers. For user documentation, see the NPM readme and our documentation site.

Setup

Install dependencies:

npm i

Build

This project uses the TypeScript compiler to produce JavaScript that runs in modern browsers.

To build the JavaScript version of the library:

npm run build

To watch files and rebuild when the files are modified, run the following command in a separate shell:

npm run build:watch

All built files will be placed in the lib/ directory.

Testing

This project uses modern-web.dev's @web/test-runner for testing. See the modern-web.dev testing documentation for more information.

Tests can be run with the test script, which will run tests against Lit's development mode (with more verbose errors) as well as against Lit's production mode:

npm test

For local testing during development, the test:dev:watch command will run tests in Lit's development mode (with verbose errors) on every change to the source files:

npm test:watch

Alternatively the test:prod and test:prod:watch commands will run tests in Lit's production mode.

Dev Server

This project uses modern-web.dev's @web/dev-server for previewing the project without additional build steps. Web Dev Server handles resolving Node-style "bare" import specifiers, which aren't supported in browsers. It also automatically transpiles JavaScript and adds polyfills to support older browsers. See modern-web.dev's Web Dev Server documentation for more information.

To run the dev server and open the project in a new browser tab:

npm run serve

There is a development HTML file located at /dev/index.html that can be viewed at http://localhost:8000/dev/index.html. Note that this command will serve the code using Lit's development mode (with more verbose errors). To serve the code against Lit's production mode, use npm run serve:prod.

Editing

If you use VS Code, we highly recommend the lit-plugin extension, which enables some extremely useful features for lit-html templates:

  • Syntax highlighting
  • Type-checking
  • Code completion
  • Hover-over docs
  • Jump to definition
  • Linting
  • Quick Fixes

The project is setup to recommend lit-plugin to VS Code users if they don't already have it installed.

Linting

Linting of TypeScript files is provided by ESLint and TypeScript ESLint. In addition, lit-analyzer is used to type-check and lint lit-html templates with the same engine and rules as lit-plugin.

The rules are mostly the recommended rules from each project, but some have been turned off to make LitElement usage easier.

To lint the project run:

npm run lint

Formatting

Prettier is used for code formatting. It has been pre-configured according to the Lit's style.

Prettier has not been configured to run when committing files so be sure to run it before pushing any changes.

Static Site

This project includes a website generated with the TypeDoc documentation generator. The site is generated to the /docs directory and intended to be checked in so that GitHub pages can serve the site from /docs on the main branch.

To enable the site, go to the GitHub settings and change the GitHub Pages "Source" setting to "main branch /docs folder".

To build the site, run:

npm run docs

To serve the site locally, run:

npm run docs:serve

The site will usually be served at http://localhost:8000.

Bundling and minification

Bundling and minification is performed in a single step using Rollup. The follow commands will bundle and minify whatever code is already in the lib/ directory and place the bundled code in the file dist/web-components.min.js.

To bundle and minify the code, run:

npm run bundle

To automatically re-bundle when the code in the lib/ directory changes, run:

npm run bundle:watch

About

A collection of Web Components for interacting with and visualizing biological data.

Topics

Resources

Code of conduct

Stars

5 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' GitHub - legumeinfo/web-components: A collection of Web Components for interacting with and visualizing biological data. · GitHub
Skip to content

Repository files navigation

@legumeinfo/web-components

This repository contains a Web Component library developed for the Legume Information System and other AgBio databases. The Web Components are built using Lit and the UIkit CSS framework. UIkit, however, is only listed as a development dependency and must be installed independently when using this library.

This readme is intended for developers. For user documentation, see the NPM readme and our documentation site.

Setup

Install dependencies:

npm i

Build

This project uses the TypeScript compiler to produce JavaScript that runs in modern browsers.

To build the JavaScript version of the library:

npm run build

To watch files and rebuild when the files are modified, run the following command in a separate shell:

npm run build:watch

All built files will be placed in the lib/ directory.

Testing

This project uses modern-web.dev's @web/test-runner for testing. See the modern-web.dev testing documentation for more information.

Tests can be run with the test script, which will run tests against Lit's development mode (with more verbose errors) as well as against Lit's production mode:

npm test

For local testing during development, the test:dev:watch command will run tests in Lit's development mode (with verbose errors) on every change to the source files:

npm test:watch

Alternatively the test:prod and test:prod:watch commands will run tests in Lit's production mode.

Dev Server

This project uses modern-web.dev's @web/dev-server for previewing the project without additional build steps. Web Dev Server handles resolving Node-style "bare" import specifiers, which aren't supported in browsers. It also automatically transpiles JavaScript and adds polyfills to support older browsers. See modern-web.dev's Web Dev Server documentation for more information.

To run the dev server and open the project in a new browser tab:

npm run serve

There is a development HTML file located at /dev/index.html that can be viewed at http://localhost:8000/dev/index.html. Note that this command will serve the code using Lit's development mode (with more verbose errors). To serve the code against Lit's production mode, use npm run serve:prod.

Editing

If you use VS Code, we highly recommend the lit-plugin extension, which enables some extremely useful features for lit-html templates:

  • Syntax highlighting
  • Type-checking
  • Code completion
  • Hover-over docs
  • Jump to definition
  • Linting
  • Quick Fixes

The project is setup to recommend lit-plugin to VS Code users if they don't already have it installed.

Linting

Linting of TypeScript files is provided by ESLint and TypeScript ESLint. In addition, lit-analyzer is used to type-check and lint lit-html templates with the same engine and rules as lit-plugin.

The rules are mostly the recommended rules from each project, but some have been turned off to make LitElement usage easier.

To lint the project run:

npm run lint

Formatting

Prettier is used for code formatting. It has been pre-configured according to the Lit's style.

Prettier has not been configured to run when committing files so be sure to run it before pushing any changes.

Static Site

This project includes a website generated with the TypeDoc documentation generator. The site is generated to the /docs directory and intended to be checked in so that GitHub pages can serve the site from /docs on the main branch.

To enable the site, go to the GitHub settings and change the GitHub Pages "Source" setting to "main branch /docs folder".

To build the site, run:

npm run docs

To serve the site locally, run:

npm run docs:serve

The site will usually be served at http://localhost:8000.

Bundling and minification

Bundling and minification is performed in a single step using Rollup. The follow commands will bundle and minify whatever code is already in the lib/ directory and place the bundled code in the file dist/web-components.min.js.

To bundle and minify the code, run:

npm run bundle

To automatically re-bundle when the code in the lib/ directory changes, run:

npm run bundle:watch

About

A collection of Web Components for interacting with and visualizing biological data.

Topics

Resources

Code of conduct

Stars

5 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' GitHub - legumeinfo/web-components: A collection of Web Components for interacting with and visualizing biological data. · GitHub
Skip to content

Repository files navigation

@legumeinfo/web-components

This repository contains a Web Component library developed for the Legume Information System and other AgBio databases. The Web Components are built using Lit and the UIkit CSS framework. UIkit, however, is only listed as a development dependency and must be installed independently when using this library.

This readme is intended for developers. For user documentation, see the NPM readme and our documentation site.

Setup

Install dependencies:

npm i

Build

This project uses the TypeScript compiler to produce JavaScript that runs in modern browsers.

To build the JavaScript version of the library:

npm run build

To watch files and rebuild when the files are modified, run the following command in a separate shell:

npm run build:watch

All built files will be placed in the lib/ directory.

Testing

This project uses modern-web.dev's @web/test-runner for testing. See the modern-web.dev testing documentation for more information.

Tests can be run with the test script, which will run tests against Lit's development mode (with more verbose errors) as well as against Lit's production mode:

npm test

For local testing during development, the test:dev:watch command will run tests in Lit's development mode (with verbose errors) on every change to the source files:

npm test:watch

Alternatively the test:prod and test:prod:watch commands will run tests in Lit's production mode.

Dev Server

This project uses modern-web.dev's @web/dev-server for previewing the project without additional build steps. Web Dev Server handles resolving Node-style "bare" import specifiers, which aren't supported in browsers. It also automatically transpiles JavaScript and adds polyfills to support older browsers. See modern-web.dev's Web Dev Server documentation for more information.

To run the dev server and open the project in a new browser tab:

npm run serve

There is a development HTML file located at /dev/index.html that can be viewed at http://localhost:8000/dev/index.html. Note that this command will serve the code using Lit's development mode (with more verbose errors). To serve the code against Lit's production mode, use npm run serve:prod.

Editing

If you use VS Code, we highly recommend the lit-plugin extension, which enables some extremely useful features for lit-html templates:

  • Syntax highlighting
  • Type-checking
  • Code completion
  • Hover-over docs
  • Jump to definition
  • Linting
  • Quick Fixes

The project is setup to recommend lit-plugin to VS Code users if they don't already have it installed.

Linting

Linting of TypeScript files is provided by ESLint and TypeScript ESLint. In addition, lit-analyzer is used to type-check and lint lit-html templates with the same engine and rules as lit-plugin.

The rules are mostly the recommended rules from each project, but some have been turned off to make LitElement usage easier.

To lint the project run:

npm run lint

Formatting

Prettier is used for code formatting. It has been pre-configured according to the Lit's style.

Prettier has not been configured to run when committing files so be sure to run it before pushing any changes.

Static Site

This project includes a website generated with the TypeDoc documentation generator. The site is generated to the /docs directory and intended to be checked in so that GitHub pages can serve the site from /docs on the main branch.

To enable the site, go to the GitHub settings and change the GitHub Pages "Source" setting to "main branch /docs folder".

To build the site, run:

npm run docs

To serve the site locally, run:

npm run docs:serve

The site will usually be served at http://localhost:8000.

Bundling and minification

Bundling and minification is performed in a single step using Rollup. The follow commands will bundle and minify whatever code is already in the lib/ directory and place the bundled code in the file dist/web-components.min.js.

To bundle and minify the code, run:

npm run bundle

To automatically re-bundle when the code in the lib/ directory changes, run:

npm run bundle:watch

About

A collection of Web Components for interacting with and visualizing biological data.

Topics

Resources

Code of conduct

Stars

5 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' GitHub - legumeinfo/web-components: A collection of Web Components for interacting with and visualizing biological data. · GitHub
Skip to content

Repository files navigation

@legumeinfo/web-components

This repository contains a Web Component library developed for the Legume Information System and other AgBio databases. The Web Components are built using Lit and the UIkit CSS framework. UIkit, however, is only listed as a development dependency and must be installed independently when using this library.

This readme is intended for developers. For user documentation, see the NPM readme and our documentation site.

Setup

Install dependencies:

npm i

Build

This project uses the TypeScript compiler to produce JavaScript that runs in modern browsers.

To build the JavaScript version of the library:

npm run build

To watch files and rebuild when the files are modified, run the following command in a separate shell:

npm run build:watch

All built files will be placed in the lib/ directory.

Testing

This project uses modern-web.dev's @web/test-runner for testing. See the modern-web.dev testing documentation for more information.

Tests can be run with the test script, which will run tests against Lit's development mode (with more verbose errors) as well as against Lit's production mode:

npm test

For local testing during development, the test:dev:watch command will run tests in Lit's development mode (with verbose errors) on every change to the source files:

npm test:watch

Alternatively the test:prod and test:prod:watch commands will run tests in Lit's production mode.

Dev Server

This project uses modern-web.dev's @web/dev-server for previewing the project without additional build steps. Web Dev Server handles resolving Node-style "bare" import specifiers, which aren't supported in browsers. It also automatically transpiles JavaScript and adds polyfills to support older browsers. See modern-web.dev's Web Dev Server documentation for more information.

To run the dev server and open the project in a new browser tab:

npm run serve

There is a development HTML file located at /dev/index.html that can be viewed at http://localhost:8000/dev/index.html. Note that this command will serve the code using Lit's development mode (with more verbose errors). To serve the code against Lit's production mode, use npm run serve:prod.

Editing

If you use VS Code, we highly recommend the lit-plugin extension, which enables some extremely useful features for lit-html templates:

  • Syntax highlighting
  • Type-checking
  • Code completion
  • Hover-over docs
  • Jump to definition
  • Linting
  • Quick Fixes

The project is setup to recommend lit-plugin to VS Code users if they don't already have it installed.

Linting

Linting of TypeScript files is provided by ESLint and TypeScript ESLint. In addition, lit-analyzer is used to type-check and lint lit-html templates with the same engine and rules as lit-plugin.

The rules are mostly the recommended rules from each project, but some have been turned off to make LitElement usage easier.

To lint the project run:

npm run lint

Formatting

Prettier is used for code formatting. It has been pre-configured according to the Lit's style.

Prettier has not been configured to run when committing files so be sure to run it before pushing any changes.

Static Site

This project includes a website generated with the TypeDoc documentation generator. The site is generated to the /docs directory and intended to be checked in so that GitHub pages can serve the site from /docs on the main branch.

To enable the site, go to the GitHub settings and change the GitHub Pages "Source" setting to "main branch /docs folder".

To build the site, run:

npm run docs

To serve the site locally, run:

npm run docs:serve

The site will usually be served at http://localhost:8000.

Bundling and minification

Bundling and minification is performed in a single step using Rollup. The follow commands will bundle and minify whatever code is already in the lib/ directory and place the bundled code in the file dist/web-components.min.js.

To bundle and minify the code, run:

npm run bundle

To automatically re-bundle when the code in the lib/ directory changes, run:

npm run bundle:watch

About

A collection of Web Components for interacting with and visualizing biological data.

Topics

Resources

Code of conduct

Stars

5 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' GitHub - legumeinfo/web-components: A collection of Web Components for interacting with and visualizing biological data. · GitHub
Skip to content

Repository files navigation

@legumeinfo/web-components

This repository contains a Web Component library developed for the Legume Information System and other AgBio databases. The Web Components are built using Lit and the UIkit CSS framework. UIkit, however, is only listed as a development dependency and must be installed independently when using this library.

This readme is intended for developers. For user documentation, see the NPM readme and our documentation site.

Setup

Install dependencies:

npm i

Build

This project uses the TypeScript compiler to produce JavaScript that runs in modern browsers.

To build the JavaScript version of the library:

npm run build

To watch files and rebuild when the files are modified, run the following command in a separate shell:

npm run build:watch

All built files will be placed in the lib/ directory.

Testing

This project uses modern-web.dev's @web/test-runner for testing. See the modern-web.dev testing documentation for more information.

Tests can be run with the test script, which will run tests against Lit's development mode (with more verbose errors) as well as against Lit's production mode:

npm test

For local testing during development, the test:dev:watch command will run tests in Lit's development mode (with verbose errors) on every change to the source files:

npm test:watch

Alternatively the test:prod and test:prod:watch commands will run tests in Lit's production mode.

Dev Server

This project uses modern-web.dev's @web/dev-server for previewing the project without additional build steps. Web Dev Server handles resolving Node-style "bare" import specifiers, which aren't supported in browsers. It also automatically transpiles JavaScript and adds polyfills to support older browsers. See modern-web.dev's Web Dev Server documentation for more information.

To run the dev server and open the project in a new browser tab:

npm run serve

There is a development HTML file located at /dev/index.html that can be viewed at http://localhost:8000/dev/index.html. Note that this command will serve the code using Lit's development mode (with more verbose errors). To serve the code against Lit's production mode, use npm run serve:prod.

Editing

If you use VS Code, we highly recommend the lit-plugin extension, which enables some extremely useful features for lit-html templates:

  • Syntax highlighting
  • Type-checking
  • Code completion
  • Hover-over docs
  • Jump to definition
  • Linting
  • Quick Fixes

The project is setup to recommend lit-plugin to VS Code users if they don't already have it installed.

Linting

Linting of TypeScript files is provided by ESLint and TypeScript ESLint. In addition, lit-analyzer is used to type-check and lint lit-html templates with the same engine and rules as lit-plugin.

The rules are mostly the recommended rules from each project, but some have been turned off to make LitElement usage easier.

To lint the project run:

npm run lint

Formatting

Prettier is used for code formatting. It has been pre-configured according to the Lit's style.

Prettier has not been configured to run when committing files so be sure to run it before pushing any changes.

Static Site

This project includes a website generated with the TypeDoc documentation generator. The site is generated to the /docs directory and intended to be checked in so that GitHub pages can serve the site from /docs on the main branch.

To enable the site, go to the GitHub settings and change the GitHub Pages "Source" setting to "main branch /docs folder".

To build the site, run:

npm run docs

To serve the site locally, run:

npm run docs:serve

The site will usually be served at http://localhost:8000.

Bundling and minification

Bundling and minification is performed in a single step using Rollup. The follow commands will bundle and minify whatever code is already in the lib/ directory and place the bundled code in the file dist/web-components.min.js.

To bundle and minify the code, run:

npm run bundle

To automatically re-bundle when the code in the lib/ directory changes, run:

npm run bundle:watch

About

A collection of Web Components for interacting with and visualizing biological data.

Topics

Resources

Code of conduct

Stars

5 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })(); GitHub - legumeinfo/web-components: A collection of Web Components for interacting with and visualizing biological data. · GitHub
Skip to content

Repository files navigation

@legumeinfo/web-components

This repository contains a Web Component library developed for the Legume Information System and other AgBio databases. The Web Components are built using Lit and the UIkit CSS framework. UIkit, however, is only listed as a development dependency and must be installed independently when using this library.

This readme is intended for developers. For user documentation, see the NPM readme and our documentation site.

Setup

Install dependencies:

npm i

Build

This project uses the TypeScript compiler to produce JavaScript that runs in modern browsers.

To build the JavaScript version of the library:

npm run build

To watch files and rebuild when the files are modified, run the following command in a separate shell:

npm run build:watch

All built files will be placed in the lib/ directory.

Testing

This project uses modern-web.dev's @web/test-runner for testing. See the modern-web.dev testing documentation for more information.

Tests can be run with the test script, which will run tests against Lit's development mode (with more verbose errors) as well as against Lit's production mode:

npm test

For local testing during development, the test:dev:watch command will run tests in Lit's development mode (with verbose errors) on every change to the source files:

npm test:watch

Alternatively the test:prod and test:prod:watch commands will run tests in Lit's production mode.

Dev Server

This project uses modern-web.dev's @web/dev-server for previewing the project without additional build steps. Web Dev Server handles resolving Node-style "bare" import specifiers, which aren't supported in browsers. It also automatically transpiles JavaScript and adds polyfills to support older browsers. See modern-web.dev's Web Dev Server documentation for more information.

To run the dev server and open the project in a new browser tab:

npm run serve

There is a development HTML file located at /dev/index.html that can be viewed at http://localhost:8000/dev/index.html. Note that this command will serve the code using Lit's development mode (with more verbose errors). To serve the code against Lit's production mode, use npm run serve:prod.

Editing

If you use VS Code, we highly recommend the lit-plugin extension, which enables some extremely useful features for lit-html templates:

  • Syntax highlighting
  • Type-checking
  • Code completion
  • Hover-over docs
  • Jump to definition
  • Linting
  • Quick Fixes

The project is setup to recommend lit-plugin to VS Code users if they don't already have it installed.

Linting

Linting of TypeScript files is provided by ESLint and TypeScript ESLint. In addition, lit-analyzer is used to type-check and lint lit-html templates with the same engine and rules as lit-plugin.

The rules are mostly the recommended rules from each project, but some have been turned off to make LitElement usage easier.

To lint the project run:

npm run lint

Formatting

Prettier is used for code formatting. It has been pre-configured according to the Lit's style.

Prettier has not been configured to run when committing files so be sure to run it before pushing any changes.

Static Site

This project includes a website generated with the TypeDoc documentation generator. The site is generated to the /docs directory and intended to be checked in so that GitHub pages can serve the site from /docs on the main branch.

To enable the site, go to the GitHub settings and change the GitHub Pages "Source" setting to "main branch /docs folder".

To build the site, run:

npm run docs

To serve the site locally, run:

npm run docs:serve

The site will usually be served at http://localhost:8000.

Bundling and minification

Bundling and minification is performed in a single step using Rollup. The follow commands will bundle and minify whatever code is already in the lib/ directory and place the bundled code in the file dist/web-components.min.js.

To bundle and minify the code, run:

npm run bundle

To automatically re-bundle when the code in the lib/ directory changes, run:

npm run bundle:watch

About

A collection of Web Components for interacting with and visualizing biological data.

Topics

Resources

Code of conduct

Stars

5 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages