Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/proyecto26/ion-phaser
A web component to use Phaser Framework with Angular, React, Vue, etc 🎮
https://github.com/proyecto26/ion-phaser
angular custom-component custom-components custom-elements ionic ionic-framework phaser phaser-framework phaser3 phaserjs react react-component stencil-components stencil-js stenciljs stenciljs-components vue vuejs web-component web-components
Last synced: 6 days ago
JSON representation
A web component to use Phaser Framework with Angular, React, Vue, etc 🎮
- Host: GitHub
- URL: https://github.com/proyecto26/ion-phaser
- Owner: proyecto26
- License: mit
- Created: 2019-06-02T18:11:54.000Z (over 5 years ago)
- Default Branch: develop
- Last Pushed: 2024-10-27T16:06:37.000Z (about 2 months ago)
- Last Synced: 2024-11-30T07:06:36.315Z (13 days ago)
- Topics: angular, custom-component, custom-components, custom-elements, ionic, ionic-framework, phaser, phaser-framework, phaser3, phaserjs, react, react-component, stencil-components, stencil-js, stenciljs, stenciljs-components, vue, vuejs, web-component, web-components
- Language: TypeScript
- Homepage: https://market.ionicframework.com/plugins/ionphaser
- Size: 1.03 MB
- Stars: 252
- Watchers: 8
- Forks: 38
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-stenciljs - IonPhaser
- awesome-jsgames - IonPhaser - A web component to use Phaser Framework with Angular, React, Vue, etc 🎮 (Uncategorized / Uncategorized)
README
[](https://github.com/proyecto26/ion-phaser/graphs/commit-activity)
[![NPM version][npm-image]][npm-url]
[![Downloads][downloads-image]][npm-url]
[![TotalDownloads][total-downloads-image]][npm-url]
[![Twitter Follow][twitter-image]][twitter-url]
[npm-image]:http://img.shields.io/npm/v/@ion-phaser/core.svg
[npm-url]:https://npmjs.org/package/@ion-phaser/core
[downloads-image]:http://img.shields.io/npm/dm/@ion-phaser/core.svg
[total-downloads-image]:http://img.shields.io/npm/dt/@ion-phaser/core.svg?label=total%20downloads
[twitter-image]:https://img.shields.io/twitter/follow/jdnichollsc.svg?style=social&label=Follow%20me
[twitter-url]:https://twitter.com/jdnichollsc
# IonPhaser
Web Component built with **[Stencil.js](https://github.com/ionic-team/stencil)** to integrate **[Phaser](https://github.com/photonstorm/phaser)** with any other framework.
Inspired by the old IonPhaser directive
## Demo
Do you want to see this web component in action? Visit https://codepen.io/jdnichollsc/full/oRrwKM yay! 🎉
- Web Camera: https://codepen.io/jdnichollsc/full/YzQWEwz
## IonPhaser CE
Looking for [Phaser Framework CE (Community Edition)](https://github.com/photonstorm/phaser-ce)? Check [here](https://github.com/proyecto26/ion-phaser-ce)!
## Usage
Simply add this tag wherever you want in your project:
- [ion-phaser](./src/components/ion-phaser/readme.md)
```html
```
## Getting Started
### Packages
| Project | Package | Version | Links |
| ------- | ------- | ------- |:-----:|
| **Core** | [`@ion-phaser/core`](https://www.npmjs.com/package/@ion-phaser/core) | [](https://www.npmjs.com/package/@ion-phaser/core) | [`README.md`](./README.md)
| **React** | [`@ion-phaser/react`](https://www.npmjs.com/package/@ion-phaser/react) | [](https://www.npmjs.com/package/@ion-phaser/react) | [`README.md`](react/README.md)
### Script tag
- Put a script tag similar to this `` in the head of your index.html
- Then you can use the element anywhere in your template, JSX, html etc
### Node Modules
- Run `npm install @ion-phaser/core --save`
- Put a script tag similar to this `` in the head of your index.html
- Then you can use the element anywhere in your template, JSX, html etc
### In a stencil-starter app
- Run `npm install @ion-phaser/core --save`
- Add an import to the npm packages `import @ion-phaser/core;`
- Then you can use the element anywhere in your template, JSX, html etc
# Framework integrations
## Angular
Using `ion-phaser` component within an Angular project:
### Including the Custom Elements Schema
Including the `CUSTOM_ELEMENTS_SCHEMA` in the module allows the use of Web Components in the HTML files. Here is an example of adding it to `AppModule`:
```ts
import { BrowserModule } from '@angular/platform-browser';
import { CUSTOM_ELEMENTS_SCHEMA, NgModule } from '@angular/core';
import { AppComponent } from './app.component';
@NgModule({
declarations: [AppComponent],
imports: [BrowserModule],
bootstrap: [AppComponent],
schemas: [CUSTOM_ELEMENTS_SCHEMA]
})
export class AppModule {}
```
The `CUSTOM_ELEMENTS_SCHEMA` needs to be included in any module that uses **IonPhaser**.
### Calling defineCustomElements
**IonPhaser** component includes a function used to load itself in the application window object. That function is called `defineCustomElements()` and needs to be executed once during the bootstrapping of your application. One convenient place to add it is in the `main.ts` file as follows:
```tsx
import { enableProdMode } from '@angular/core';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { defineCustomElements as defineIonPhaser } from '@ion-phaser/core/loader';
import { AppModule } from './app/app.module';
import { environment } from './environments/environment';
if (environment.production) {
enableProdMode();
}
platformBrowserDynamic().bootstrapModule(AppModule)
.catch(err => console.log(err));
defineIonPhaser(window);
```
### Using IonPhaser in an Angular component
```html
```
```ts
public game = {
width?: integer | string;
height?: integer | string;
zoom?: number;
resolution?: number;
type?: number;
parent: HTMLElement | string;
canvas?: HTMLCanvasElement;
canvasStyle?: string;
context?: CanvasRenderingContext2D;
scene?: object;
seed?: string[];
title?: string;
url?: string;
version?: string;
autoFocus?: boolean;
input?: boolean | InputConfig;
disableContextMenu?: boolean;
banner?: boolean | BannerConfig;
dom?: DOMContainerConfig;
fps?: FPSConfig;
render?: RenderConfig;
backgroundColor?: string | number;
callbacks?: CallbacksConfig;
loader?: LoaderConfig;
images?: ImagesConfig;
physics?: object;
plugins?: PluginObject | PluginObjectItem[];
scale?: ScaleConfig;,
instance: Game // It's created internally when the game is initialized
};
public initialize: boolean;
constructor(private api : ApiService){}
initializeGame() {
this.game = {
width: "100%",
height: "100%",
type: Phaser.AUTO,
scene: {}
}
this.initialize = true
}
getInstance(){
return this.game.instance
}
```
[_from stencil documentation_](https://github.com/ionic-team/stencil-site/blob/master/src/docs/framework-integration/angular.md)
## React
### Specific Wrapper
When using a wrapper component, It's not necessary to access the reference directly to configure the game. More details [here](./react/README.md).
```tsx
import React, { Component } from 'react'
import Phaser from 'phaser'
import { IonPhaser } from '@ion-phaser/react'
class App extends Component {
state = {
initialize: false,
game: {
width: "100%",
height: "100%",
type: Phaser.AUTO,
scene: {}
}
}
render() {
const { initialize, game } = this.state
return (
)
}
}
```
### Web Component
Other option is using the web component directly:
```tsx
import React from 'react'
import ReactDOM from 'react-dom'
import { defineCustomElements as defineIonPhaser } from '@ion-phaser/core/loader'
import Phaser from 'phaser'
const game = {
width: "100%",
height: "100%",
type: Phaser.AUTO,
scene: {}
}
ReactDOM.render( el.game = game} />, document.getElementById('root'));
defineIonPhaser(window);
```
[_from stencil documentation_](https://github.com/ionic-team/stencil-site/blob/master/src/docs/framework-integration/react.md)
## Vue
In order to use the `ion-phaser` Web Component inside of a Vue application, it should be modified to define the custom elements and to inform the Vue compiler which elements to ignore during compilation. This can all be done within the `main.js` file as follows:
```tsx
import Vue from 'vue';
import { defineCustomElements as defineIonPhaser } from '@ion-phaser/core/loader'
import App from './App.vue';
Vue.config.productionTip = false;
Vue.config.ignoredElements = [/ion-\w*/];
// Bind the IonPhaser custom element to the window object
defineIonPhaser(window);
new Vue({
render: h => h(App)
}).$mount('#app');
```
### Using IonPhaser in a Vue component
```vue
import Phaser from 'phaser'
export default {
name: 'HelloWorld',
data() {
return {
initialize: false,
game: {
width: "100%",
height: "100%",
type: Phaser.AUTO,
scene: {
init: function() {
this.cameras.main.setBackgroundColor('#24252A')
},
create: function() {
this.helloWorld = this.add.text(
this.cameras.main.centerX,
this.cameras.main.centerY,
"Hello World", {
font: "40px Arial",
fill: "#ffffff"
}
);
this.helloWorld.setOrigin(0.5);
},
update: function() {
this.helloWorld.angle += 1;
}
}
}
}
}
}
```
[_from stencil documentation_](https://github.com/ionic-team/stencil-site/blob/master/src/docs/framework-integration/vue.md)
## Contributing ✨
When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated** ❤️.
You can learn more about how you can contribute to this project in the [contribution guide](https://github.com/proyecto26/ion-phaser/blob/develop/CONTRIBUTING.md).
## Supporting 🍻
I believe in Unicorns 🦄
Support [me](http://www.paypal.me/jdnichollsc/2), if you do too.
Donate **Ethereum**, **ADA**, **BNB**, **SHIBA**, **USDT/USDC**, **DOGE**, etc:
> Wallet address: jdnichollsc.eth
Please let us know your contributions! 🙏
## Enterprise 💼
Available as part of the Tidelift Subscription.
The maintainers of IonPhaser and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. [Learn more.](https://tidelift.com/subscription/pkg/npm-ion-phaser-core?utm_source=npm-ion-phaser-core&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)
## Security contact information 🚨
To report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security). Tidelift will coordinate the fix and disclosure.
## License ⚖️
This repository is available under the [MIT License](https://github.com/proyecto26/ion-phaser/blob/develop/LICENSE).
## Happy coding 💯
Made with ❤️
