IonPhaser CE WebComponent

IonPhaser CE WebComponent

A web component to integrate Phaser Framework CE Community Edition with Angular, React, Vue, etc

$0.00

Juan David Nicholls

Juan David Nicholls

Member since 2014

Details

Version:
1.0
Ionic:
4.x  
Platforms:
iOS, Android  
Released:
2 years ago
Updated:
2 years ago
Category:
Plugins
Tags:
,

Built With StencilMaintenanceNPM versionDownloadsTotalDownloadsTwitter Follow

IonPhaser CE (Community Edition)

Web Component built with Stencil.js to integrate Phaser CE (Community Edition) with any other framework.

IonPhaser

Inspired by the old IonPhaser directive

Demo

Do you want to see this web component in action? Visit https://codepen.io/jdnichollsc/full/NWWxezM yay! 🎉

IonPhaser 3

Looking for Phaser Framework 3? Check here!

Getting Started

Packages

ProjectPackageVersionLinks
**Core**[`@ion-phaser-ce/core`](https://www.npmjs.com/package/@ion-phaser-ce/core)[![version](https://img.shields.io/npm/v/@ion-phaser-ce/core/latest.svg)](https://www.npmjs.com/package/@ion-phaser-ce/core)[`README.md`](./README.md)
**React**[`@ion-phaser-ce/react`](https://www.npmjs.com/package/@ion-phaser-ce/react)[![version](https://img.shields.io/npm/v/@ion-phaser-ce/react/latest.svg)](https://www.npmjs.com/package/@ion-phaser-ce/react)[`README.md`](react/README.md)

Script tag

  • Put a script tag similar to this <script src='https://unpkg.com/@ion-phaser-ce/[email protected]/dist/ionphaser.js'></script> 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-ce/core --save
  • Put a script tag similar to this <script src='node_modules/@ion-phaser-ce/core/dist/ion-phaser-ce.js'></script> 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-ce/core --save
  • Add an import to the npm packages import @ion-phaser-ce/core;
  • Then you can use the element anywhere in your template, JSX, html etc

Usage

Simply add this tag wherever you want in your project:

html <ion-phaser-ce [game]="game"></ion-phaser-ce>

These properties are available on the component:

  • game (required)
  • initialize (optional)

Framework integrations

Angular

Using ion-phaser-ce 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 { CUSTOMELEMENTSSCHEMA, NgModule } from '@angular/core'; import { AppComponent } from './app.component';

@NgModule({ declarations: [AppComponent], imports: [BrowserModule], bootstrap: [AppComponent], schemas: [CUSTOMELEMENTSSCHEMA] }) 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-ce/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 <ion-phaser-ce [game]="game" [initialize]="initialize"

```

```ts public game = { alignH?: boolean; alignV?: boolean; antialias?: boolean; backgroundColor?: number | string; canvas?: HTMLCanvasElement; canvasId?: string; canvasStyle?: string; crisp?: boolean; disableVisibilityChange?: boolean; disableStart?: boolean; enableDebug?: boolean; failIfMajorPerformanceCaveat?: boolean; forceSetTimeOut?: boolean; fullScreenScaleMode?: number; fullScreenTarget?: HTMLElement; height?: number | string; keyboard?: boolean; maxPointers?: number; mouse?: boolean; mouseWheel?: boolean; mspointer?: boolean; multiTexture?: boolean; parent?: HTMLElement | string; physicsConfig?: any; pointerLock?: boolean; preserveDrawingBuffer?: boolean; renderer?: number; resolution?: number; roundPixels?: boolean; scaleH?: number; scaleMode?: number; scaleV?: number seed?: number; state?: any; touch?: boolean; transparent?: boolean; trimH?: number; trimV?: number; width?: number | string; 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%", renderer: Phaser.AUTO, state: {} } this.initialize = true }

getInstance(){ return this.game.instance } ```

from stencil documentation

React

Specific Wrapper

When using a wrapper component, It's not necessary to access the reference directly to configure the game. More details here.

```tsx import React, { Component } from 'react' import Phaser from 'phaser-ce' import { IonPhaser } from '@ion-phaser-ce/react'

class App extends Component { state = { initialize: false, game: { width: "100%", height: "100%", renderer: Phaser.AUTO, state: {} } } 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-ce/core/loader' import Phaser from 'phaser-ce'

const game = { width: "100%", height: "100%", renderer: Phaser.AUTO, state: {} }

ReactDOM.render( el.game = game} />, document.getElementById('root'));

defineIonPhaser(window); ```

from stencil documentation

Vue

In order to use the ion-phaser-ce 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-ce/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

```

from stencil documentation

Supporting 🍻

I believe in Unicorns 🦄 Support me, if you do too.

Security contact information 🚨

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.

Happy coding 💯

Made with ❤️