Edit

Introduction¶

Create an input text object above a text object to edit string content.

Author: Rex
Behavior of text object

Live demos¶

Usage¶

Sample code

Install plugin¶

Load minify file¶

Enable dom element in configuration of game

var config = {
    parent: divId,
    // fullscreenTarget: divId, // For fullscreen
    dom: {
        createContainer: true
    },
    input: {
        mouse: {
            target: divId
        },
        touch: {
            target: divId
        },
    },
    // ...
};
var game = new Phaser.Game(config);

Set parent to divId
Set dom.createContainer to true.

Load plugin (minify file) in preload stage

scene.load.plugin('rextexteditplugin', 'https://raw.githubusercontent.com/rexrainbow/phaser3-rex-notes/master/dist/rextexteditplugin.min.js', true);

Open editor

Add text-edit behavior, will open editor under 'pointerdown' event.

var editor = scene.plugins.get('rextexteditplugin').add(textGameObject, config);

Open editor directly

var editor = scene.plugins.get('rextexteditplugin').edit(textGameObject, config);

Import plugin¶

Install rex plugins from npm
```
npm i phaser3-rex-plugins
```

Install plugin in configuration of game

import TextEditPlugin from 'phaser3-rex-plugins/plugins/textedit-plugin.js';
var config = {
    parent: divId,
    // fullscreenTarget: divId, // For fullscreen
    dom: {
        createContainer: true
    },
    input: {
        mouse: {
            target: divId
        },
        touch: {
            target: divId
        },
    },
    // ...
    plugins: {
        global: [{
            key: 'rexTextEdit',
            plugin: TextEditPlugin,
            start: true
        },
        // ...
        ]
    }
    // ...
};
var game = new Phaser.Game(config);

Open editor

Add text-edit behavior, will open editor under 'pointerdown' event.

var editor = scene.plugins.get('rexTextEdit').add(textGameObject, config);

Open editor directly

var editor = scene.plugins.get('rexTextEdit').edit(textGameObject, config);

Import class¶

Install rex plugins from npm
```
npm i phaser3-rex-plugins
```

Enable dom element in configuration of game

var config = {
    parent: divId,
    // fullscreenTarget: divId, // For fullscreen
    dom: {
        createContainer: true
    },
    input: {
        mouse: {
            target: divId
        },
        touch: {
            target: divId
        },
    },
    // ...
};
var game = new Phaser.Game(config);

Set parent to divId
Set dom.createContainer to true.

Import class

import { TextEdit, Edit } from 'phaser3-rex-plugins/plugins/textedit.js';

Open editor

Add text-edit behavior, will open editor under 'pointerdown' event.
```
var editor = new TextEdit(textGameObject, config);
```

Open editor directly

var editor = Edit(textGameObject, config);

Open text editor¶

Open editor directly.

var editor = scene.plugins.get('rexTextEdit').edit(textObject, {
    // inputType: 'text',   // 'text'|'password'|'textarea'|...
    // type: 'text',    // 'text'|'password'|'textarea'|...

    // enterClose: true,
    // selectAll: false,

    // onOpen: undefined,
    // onTextChanged: undefined,
    // onClose: undefined,

    // text: '',
});
// var editor = scene.plugins.get('rexTextEdit').edit(textObject, config, onClose);

textObject : Text object, bbcode text object, or tag text object.
config :
- config.inputType, or config.type :
  - 'text' (default), or
  - 'password'
  - 'number'
- config.onOpen : Callback invoked when input text is created.
```
function (textObject) {
}
```
- config.onTextChanged : Callback invoked when input text changed.
```
function (textObject, text) {
    textObject.text = text;
}
```
- config.onClose : Callback invoked when input text is closed. This parameter is valid only when onClose parameter is not given.
```
function (textObject) {
}
```
- enterClose :
  - true : Close input text when enter-key was pressed. Default value is true if inputType is not 'textarea'.
  - false : If inputType is set to 'textarea', default value will be false.
- config.selectAll : Set true to select all text.
- config.text : Initial string content. Default is the string content of textObject.
- More configuration parameters...
onClose : Callback invoked when input text is closed.
```
var callback = function(textObject) {
}
```

Create a text editor (input element) above text object.

Size, font size, font family, font color, background color of text editor will be equal to text object.
Text object will be invisible when text editor is opened.
Store reference of text editor at textObject._editor.
Text editor will be closed when
- Press enter key and enterClose is set, or
- Touch outside of editor, or
- Open another text editor, or
- Call editor.close()

Limitation of text game object

Don't assign height property of text game object.
Because that text input element does not have vertical align setting, text will always align to middle/center.

Create instance¶

Add text-edit behavior, will open editor under 'pointerdown' event.

var editor = scene.plugins.get('rexTextEdit').add(textGameObject, {
    // type: 'text',   //'text','password','number'
    // enterClose: true,
    // selectAll: false,

    // onOpen: undefined,
    // onTextChanged: undefined,
    // onClose: undefined,

    // text: '',
});

Open editor¶

editor.open(config);
// editor.open(config, onClose);

config
- config.type :
  - text (default), or
  - password
- config.text : Initial string content.
- config.onTextChanged : Callback invoked when input text changed.
```
function (textObject, text) {
    textObject.text = text;
}
```
- More configuration parameters...
onClose : Callback invoked when text editor is closed.
```
var callback = function(textObject) {
}
```

Create a text editor (input element) above text object.

Size, font size, font family, font color, background color of text editor will be equal to text object.
Text object will be invisible when text editor is opened.

Is opened¶

var isOpened = editor.isOpened;

Close editor¶

editor.close();

Text editor will be closed when

Press enter key, or
Touch outside of editor, or
Open another text editor, or
Call editor.close()

Get DOM¶

var inputText = editor.inputText.node;

Bypass key input¶

See InputText/Bypass key input

Interactive with other game objects¶

See dom-element's Interactive with other game objects