# Fill plugin

Use the Fill plugin to fill the background of transparent images with colors or images

| Property                    | Default value | Description                                         |
| --------------------------- | ------------- | --------------------------------------------------- |
| [fillOptions](#filloptions) | undefined     | A list of colors and images to use as fill options. |

## fillOptions

An array of colors and images to render below the image.

* [ ![](/pintura/static/assets/technologies-mono/javascript.svg)JavaScript](#javascript-panel-1)
* [ ![](/pintura/static/assets/technologies-mono/react.svg)React](#react-panel-1)
* [ ![](/pintura/static/assets/technologies-mono/vue.svg)Vue](#vue-panel-1)
* [ ![](/pintura/static/assets/technologies-mono/svelte.svg)Svelte](#svelte-panel-1)
* [ ![](/pintura/static/assets/technologies-mono/angular.svg)Angular](#angular-panel-1)
* [ ![](/pintura/static/assets/technologies-mono/jquery.svg)jQuery](#jquery-panel-1)

* [index.html](#index-html-panel-1)

`<!DOCTYPE html>

<head>
    <link rel="stylesheet" href="./pintura.css" />
</head>

<style>
    .pintura-editor {
        height: 600px;
    }
</style>

<div id="editor"></div>

<script type="module">
    import {
        appendDefaultEditor,
        createDefaultColorOptions,
        colorStringToColorArray,
    } from './pintura.js';

    const editor = appendDefaultEditor('#editor', {
        src: 'image.jpeg',
        fillOptions: [
            // Transparent default value
            [0, 0, 0, 0],

            // Red
            [1, 0, 0, 1],

            // Using the default markup editor colors
            ...Object.values(createDefaultColorOptions()),

            // Transparent Purple as CSS color using colorStringToColorArray
            colorStringToColorArray('rgba(0, 0, 255, .5)'),

            // Using a PNG as background image
            'mesh-gradient-01.png',
        ],
    });
</script>
`

* [App.jsx](#App-jsx-panel-1)
* [App.css](#App-css-panel-1)

`import '@pqina/pintura/pintura.css';
import './App.css';
import { PinturaEditor } from '@pqina/react-pintura';
import {
    getEditorDefaults,
    createDefaultColorOptions,
    colorStringToColorArray,
} from '@pqina/pintura';

const editorDefaults = getEditorDefaults();

function App() {
    return (
        <div className="App">
            <PinturaEditor
                {...editorDefaults}
                src={'image.jpeg'}
                fillOptions={[
                    // Transparent default value
                    [0, 0, 0, 0],

                    // Red
                    [1, 0, 0, 1],

                    // Using the default markup editor colors
                    ...Object.values(createDefaultColorOptions()),

                    // Transparent Purple as CSS color using colorStringToColorArray
                    colorStringToColorArray('rgba(0, 0, 255, .5)'),

                    // Using a PNG as background image
                    'mesh-gradient-01.png',
                ]}
            />
        </div>
    );
}

export default App;
`

```css
.pintura-editor {
    height: 600px;
}

```

* [App.vue](#App-vue-panel-1)

`<template>
    <div>
        <PinturaEditor
            v-bind="editorDefaults"
            src="image.jpeg"
            :fillOptions="fillOptions"
        />
    </div>
</template>
<script>
import { PinturaEditor } from '@pqina/vue-pintura';
import {
    getEditorDefaults,
    createDefaultColorOptions,
    colorStringToColorArray,
} from '@pqina/pintura';

export default {
    name: 'App',

    components: {
        PinturaEditor,
    },

    data() {
        return {
            editorDefaults: getEditorDefaults(),

            fillOptions: [
                // Transparent default value
                [0, 0, 0, 0],

                // Red
                [1, 0, 0, 1],

                // Using the default markup editor colors
                ...Object.values(createDefaultColorOptions()),

                // Transparent Purple as CSS color using colorStringToColorArray
                colorStringToColorArray('rgba(0, 0, 255, .5)'),

                // Using a PNG as background image
                'mesh-gradient-01.png',
            ],
        };
    },

    methods: {},
};
</script>
<style>
@import '@pqina/pintura/pintura.css';

.pintura-editor {
    height: 600px;
}
</style>
`

* [App.svelte](#App-svelte-panel-1)

`<script>
    import { PinturaEditor } from '@pqina/svelte-pintura';
    import {
        getEditorDefaults,
        createDefaultColorOptions,
        colorStringToColorArray,
    } from '@pqina/pintura';
    import '@pqina/pintura/pintura.css';

    let editorDefaults = getEditorDefaults();
</script>

<div>
    <PinturaEditor
        {...editorDefaults}
        src={'image.jpeg'}
        fillOptions={[
            // Transparent default value
            [0, 0, 0, 0],

            // Red
            [1, 0, 0, 1],

            // Using the default markup editor colors
            ...Object.values(createDefaultColorOptions()),

            // Transparent Purple as CSS color using colorStringToColorArray
            colorStringToColorArray('rgba(0, 0, 255, .5)'),

            // Using a PNG as background image
            'mesh-gradient-01.png',
        ]}
    />
</div>

<style>
    div :global(.pintura-editor) {
        height: 600px;
    }
</style>
`

* [app.component.ts](#app-component-ts-panel-1)
* [app.component.html](#app-component-html-panel-1)
* [app.component.css](#app-component-css-panel-1)
* [app.module.ts](#app-module-ts-panel-1)

`import { Component } from '@angular/core';

import {
    getEditorDefaults,
    createDefaultColorOptions,
    colorStringToColorArray,
} from '@pqina/pintura';

@Component({
    selector: 'app-root',
    templateUrl: './app.component.html',
    styleUrls: ['./app.component.css'],
})
export class AppComponent {
    editorDefaults: any = getEditorDefaults();

    fillOptions: any = [
        // Transparent default value
        [0, 0, 0, 0],

        // Red
        [1, 0, 0, 1],

        // Using the default markup editor colors
        ...Object.values(createDefaultColorOptions()),

        // Transparent Purple as CSS color using colorStringToColorArray
        colorStringToColorArray('rgba(0, 0, 255, .5)'),

        // Using a PNG as background image
        'mesh-gradient-01.png',
    ];
}
`

`<pintura-editor
    [options]="editorDefaults"
    src="image.jpeg"
    [fillOptions]="fillOptions"
></pintura-editor>
`

```css
::ng-deep .pintura-editor {
    height: 600px;
}

```

```javascript
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { AngularPinturaModule } from '@pqina/angular-pintura';

@NgModule({
    declarations: [AppComponent],
    imports: [BrowserModule, AngularPinturaModule],
    exports: [AppComponent],
    providers: [],
    bootstrap: [AppComponent],
})
export class AppModule {}

```

* [index.html](#index-html-panel-1)

`<!DOCTYPE html>
<head>
    <link rel="stylesheet" href="./pintura/pintura.css" />
</head>

<script src="./jquery.js"></script>
<script src="./jquery-pintura/useEditorWithJQuery-iife.js"></script>
<script src="./pintura/pintura-iife.js"></script>

<style>
    .pintura-editor {
        height: 600px;
    }
</style>

<div id="editor"></div>

<script>
    useEditorWithJQuery(jQuery, pintura);

    $(function () {
        var { createDefaultColorOptions, colorStringToColorArray } =
            $.fn.pintura;

        var editor = $('#editor').pinturaDefault({
            src: 'image.jpeg',
            fillOptions: [
                // Transparent default value
                [0, 0, 0, 0],

                // Red
                [1, 0, 0, 1],

                // Using the default markup editor colors
                ...Object.values(createDefaultColorOptions()),

                // Transparent Purple as CSS color using colorStringToColorArray
                colorStringToColorArray('rgba(0, 0, 255, .5)'),

                // Using a PNG as background image
                'mesh-gradient-01.png',
            ],
        });
    });
</script>
`

### Fill plugin exports

The core editor module exports the following Fill plugin objects.

| Export                       | Description            |
| ---------------------------- | ---------------------- |
| plugin\_fill                 | The fill util view.    |
| plugin\_fill\_locale\_en\_gb | The fill util locales. |