The web-js in connection with web component twig extension gives you simple and efficient way to handle your javascript components over twig.
NPM
# NPM:
npm install @sulu/web
# Yarn
yarn add @sulu/web
# pnpm
pnpm add @sulu/web
A component can be created using different JS patterns:
- JS Class
- JS Function
- Revealing pattern
- Prototype pattern
- and more which works with multiple instances
Class Component
// js/components/test-class.js
export default class Test {
constructor(el, options) {
this.text = options.text;
el.onclick = this.say;
}
say() {
alert(this.text);
}
}
Function Component
// js/components/test-function.js
export default function(el, options) {
el.onclick = function() {
alert(options.text);
};
}
Sometimes you want just run js code which is not binded to a dom element for this services where created. Typically usages are running tracking code functions.
// js/services/log.js
module.exports = {
log: function(text) {
console.log(text);
}
};
import web from '@sulu/web';
import Test from './components/test-class'
import more from './components/test-function'
import Log from './services/log';
// components
web.registerComponent('test', Test);
web.registerComponent('more', more, { defaultOption: 'defaultValue' });
// services
web.registerService('logger', Log);
For efficient handling it's recommended to use it with a template engine like twig.
For twig embedding see the web component twig extension.
<button id="{{ prepare_component('test') }}">
Say Hello
</button>
<button id="{{ prepare_component('test') }}">
Say Bye
</button>
{% do prepare_service('logger', 'log', ['Hello']) %}
<script src="js/main.js"></script>
<script>
web.startComponents({{ get_components() }});
web.callServices({{ get_services() }});
</script>
You can also use without a template engine and by calling the startComponents and callServices.
<button id="test-1">
Say Hello
</button>
<button id="test-2">
Say Bye
</button>
<script src="js/main.js"></script>
<script>
web.startComponents([
{name: 'test', id: 'test-1', { text: 'Hello' }},
{name: 'test', id: 'test-2', { text: 'Bye' }},
]);
web.callServices([
{name: 'logger', func: 'log', args: ['Hello']},
]);
</script>
The @sulu/web-js
provides some components
and services
which can be registered in your container and be used.
If you want to work with CSP and avoid inline scripts you can just write the components into a data attribute and read it from there. E.g.:
<script id="app" data-components="[
{name: 'test', id: 'test-1', { text: 'Hello' }},
{name: 'test', id: 'test-2', { text: 'Bye' }},
]"
data-services="[
{name: 'logger', func: 'log', args: ['Hello']},
]"
src="js/main.js"></script>
Then the data attribute can be read in the main.js and the components started there.
Beside the js
the @sulu/web-js
is also shipped with some scss
tools to make also creating css
easier. They can be found in the scss
directory.
Update package.json version on master branch:
git checkout master
git pull origin master
npm version [ major | minor | patch ] --no-git-tag-version
# update version in changelog
git add .
git commit -m "Release <version>"
git push origin master
Generate changelog:
github_changelog_generator --future-release <version>
Copy the text of the last release into github release description and create new release.
git fetch --tags
git checkout <version>
# Test which files get packed by npm
npm pack --dry-run
# Publish package
npm publish