pixi-multistyle-text

pixi-multistyle-text

Add a MultiStyleText object inside pixi.js to easily create text using different styles.

Example

In the example below, we are defining 4 text styles. default is the default style for the text, and the others matches the tags inside the text.

let text = new MultiStyleText("Let's make some <ml>multiline</ml>\nand <ms>multistyle</ms> text for\n<pixi>Pixi.js!</pixi>",
{
	"default": {
		fontFamily: "Arial",
		fontSize: "24px",
		fill: "#cccccc",
		align: "center"
	},
	"ml": {
		fontStyle: "italic",
		fill: "#ff8888"
	},
	"ms": {
		fontStyle: "italic",
		fill: "#4488ff"
	},
	"pixi": {
		fontSize: "64px",
		fill: "#efefef"
	}
});

Usage

text = new MultiStyleText(text, textStyles)

Creates a new MultiStyleText with the given text and styles.

textStyles

Type: { [key: string]: ExtendedTextStyle }

Each key of this dictionary should match with a tag in the text. Use the key default for the default style.

Each ExtendedTextStyle object can have any of the properties of a standard PIXI text style, in addition to a valign property that allows you to specify where text is rendered relative to larger text on the same line ("top", "middle", or "bottom").

The align, wordWrap, wordWrapWidth, and breakWord properties are ignored on all styles except for the default style, which controls those properties for the entire text object.

If text is rendered without any value assigned to a given parameter, Pixi's defaults are used.

Demo

Open demo/index.html in a browser for several helpful examples.

License

MIT, see LICENSE.md for details.

Changelog

0.5.0 (2017-01-16)

Bug Fixes

• Add offset for stroke after checking alignment (#24) (5d63a3a), closes #22
• Fix build errors (#14) (4fee646), closes #10
• Fix drop shadows (2cc378c), closes #26
• Fix exported module (#18) (cf527eb), closes #12
• Fix line y-position computation bug (#17) (6aa7636), closes #11
• Override wordWrap method to ignore tags (#20) (662d1e6), closes #9 #16
• Right-alignment-pad first word only (#25) (65eb1f3), closes #23

Features

• Add setTagStyle() and deleteTagStyle() (588f21b), closes #34