This is the repository for the core X-Tag library.
Based on the current W3 Web Components draft, X-Tag enables the custom element portion of the proposal. Custom elements let you register new tags/elements with the parser, so they are recognized and inflated with special abilities you define.
You can find out more about what X-Tag does, where it works, and how to use it, on the project page: http://x-tags.org.
X-Tag (excluding third-party icons or images) is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
To get started hacking on X-Tag core:
git clone https://github.com/x-tag/core x-tag-core --recursive
cd x-tag-core
npm install # installs all the required dependencies using package.json
grunt polyfill # rebuilds polyfill file
grunt build # outputs x-tag-core.js and x-tag-core.min.js to ./distIf you are interested in building your own custom elements, you can use our web-component-stub as a starting point.
If you already have cloned the library and want to update to the latest changes, do:
cd x-tag-core
git pull origin master
git submodule update
npm install
grunt polyfill
grunt buildThis assumes you just cloned the library and its remote repository is labelled origin. Suppose you had your own fork where your own remote is origin; you should add another remote origin and label it as upstream. Then your git pull line would need to be git pull upstream master instead.
Jasmine tests via grunt are not working yet, please open test/index.html in your browser to see if everything passes.
In the interest of not reinventing the wheel, X-Tag core uses a few existing libraries which get pulled into the project. But distributing a bunch of separate files is not efficient, so we need to generate a single file that contains all this code.
If you make changes on the library and want to regenerate the build, just run
grunt buildand both x-tag-core.js and x-tag-core.min.js will be rebuilt and placed in the ./dist directory.
To learn more about X-Tags visit x-tags.org.
To create your own component, use our web-component-stub.
Share your components by adding them to the Custom Elements Registry or Bower.