xhl-tui-image-editor

    3.7.8 • Public • Published

    Toast UI ImageEditor

    Full featured image editor using HTML5 Canvas. It's easy to use and provides powerful filters.

    github version npm version bower version license PRs welcomecode with hearth by NHN

    版本说明

    3.7.7

    • 服务器环境变更,更新版本
    • 1、package.json更新版本
    • 2、执行npm run bundle

    3.7.6

    • 服务器环境变更,更新版本

    3.7.5

    • 1、去掉插件"toast UI"标识
    • 2、画笔brush有bug,目前改成可以正常绘制,但绘制后再旋转会有bug,(当前支持先旋转照片 再用画笔绘制)
    • 3、执行npm run bundle

    3.7.4

    • 执行npm run bundle

    3.7.3

    • 文字变为中文

    3.7.2

    • 执行npm run bundle

    3.7.1

    • 更新源码中的字号

    Wrappers

    6 -20-2018 17-45-54

    🚩 Table of Contents

    Collect statistics on the use of open source

    TOAST UI ImageEditor applies Google Analytics (GA) to collect statistics on the use of open source, in order to identify how widely TOAST UI ImageEditor is used throughout the world. It also serves as important index to determine the future course of projects. location.hostname (e.g. > “ui.toast.com") is to be collected and the sole purpose is nothing but to measure statistics on the usage. To disable GA, use the following usageStatistics option when creating the instance.

    var options = {
        //...
        usageStatistics: false
    }
     
    var imageEditor = new tui.ImageEditor('#tui-image-editor-container', options);

    Or, include tui-code-snippet(v1.4.0 or later) and then immediately write the options as follows:

    tui.usageStatistics = false;

    🌏 Browser Support

    Chrome Chrome IE Internet Explorer Edge Edge Safari Safari Firefox Firefox
    Yes 9+ Yes Yes Yes

    💪 Has full features that stick to the basic.

    Photo manipulation

    • Crop, Flip, Rotation, Drawing, Shape, Icon, Text, Mask Filter, Image Filter

    Integration function

    • Download, Image Load, Undo, Redo, Reset, Delete Object(Shape, Line, Mask Image...)
    Crop Flip Rotation Drawing Shape
    2018-06-04 4 33 16 2018-06-04 4 40 06 2018-06-04 4 43 02 2018-06-04 4 47 40 2018-06-04 4 51 45
    Icon Text Mask Filter
    2018-06-05 2 06 29 2018-06-05 2 14 36 2018-06-05 2 20 46 2018-06-05 2 27 10

    Powerful filter function

    • Grayscale, Invert, Sepia, Blur Sharpen, Emboss, RemoveWhite, Brightness, Noise, Pixelate, ColorFilter, Tint, Multiply, Blend
    Grayscale Noise Emboss Pixelate
    grayscale noise emboss pixelate
    Sepia Sepia2 Blend-righten Blend-diff Invert
    sepia sepia2 blend-righten blend-diff invert
    Multifly Tint Brightness Remove-white Sharpen
    multifly tint brightness remove-white sharpen

    Select only the desired function

    var imageEditor = new tui.ImageEditor('#tui-image-editor-container', {
         includeUI: {
             menu: ['shape', 'crop']
             ...
         },
     ...

    🙆 Easy to apply the size and design you want

    Can be used everywhere.

    • Widely supported in browsers including IE9, which is the minimum requirement to support canvas.

    • Option to support various display sizes. (allows you to use the editor features on your web pages at least over 550 * 450 sizes)

      2018-06-04 5 35 25

    Nice default & Fully customizable Themes

    • Has a white and black theme, and you can modify the theme file to customize it.
    • Has an API so that you can create your own instead of the built-in.
    black - top black - bottom white - left white - right
    2018-06-05 1 41 13 2018-06-05 1 40 24 2018-06-05 1 41 48 2018-06-05 1 42 27

    🎨 Features

    • Load image to canvas
    • Undo/Redo (With shortcut)
    • Crop
    • Flip
    • Rotation
    • Free drawing
    • Line drawing
    • Shape
    • Icon
    • Text
    • Mask Filter
    • Image Filter

    💾 Install

    The TOAST UI products can be installed by using the package manager or downloading the source directly. However, we highly recommend using the package manager.

    Via Package Manager

    You can find TOAST UI producs via npm and bower package managers. Install by using the commands provided by each package manager. When using npm, be sure Node.js is installed in the environment.

    npm

    1. ImageEditor installation

    $ npm install --save tui-image-editor # Latest version 
    $ npm install --save tui-image-editor@<version> # Specific version 
    2. fabric.js installation

    And you should add postInstall script to your package.json. This process will be removed when fabric.js updated to v2.7.0 and bundled with TOAST UI ImageEditor together.

    {
        // ...
        "scripts": {
            // ...
            "postInstall": "npm install --no-save --no-optional fabric@^1.6.7"
        }
        // ...
    }

    Or you can add fabric as dependency. But there is some steps to be installed well.

    bower

    $ bower install tui-image-editor # Latest version 
    $ bower install tui-image-editor#<tag> # Specific version 

    Via Contents Delivery Network (CDN)

    TOAST UI products are available over the CDN powered by TOAST Cloud.

    You can use the CDN as below.

    <link rel="stylesheet" href="https://uicdn.toast.com/tui-image-editor/latest/tui-image-editor.css">
    <script src="https://uicdn.toast.com/tui-image-editor/latest/tui-image-editor.js"></script>

    If you want to use a specific version, use the tag name instead of latest in the URL.

    The CDN directory has the following structure.

    tui-image-editor/
    ├─ latest/
    │  ├─ tui-image-editor.js
    │  ├─ tui-image-editor.min.js
    │  └─ tui-image-editor.css
    ├─ v3.1.0/
    │  ├─ ...
    

    Download Source Files

    🔨 Usage

    HTML

    Add the container element where TOAST UI ImageEditor will be created.

    <body>
    ...
    <div id="tui-image-editor"></div>
    ...
    </body>

    javascript

    Add dependencies & initialize ImageEditor class with given element to make an image editor.

    var ImageEditor = require('tui-image-editor');
    var blackTheme = require('./js/theme/black-theme.js');
    var locale_ru_RU = { // override default English locale to your custom
        'Crop': 'Обзрезать',
        'Delete-all': 'Удалить всё'
        // etc...
    };
    var instance = new ImageEditor(document.querySelector('#tui-image-editor'), {
         includeUI: {
             loadImage: {
                 path: 'img/sampleImage.jpg',
                 name: 'SampleImage'
             },
             locale: locale_ru_RU,
             theme: blackTheme, // or whiteTheme
             initMenu: 'filter',
             menuBarPosition: 'bottom'
         },
        cssMaxWidth: 700,
        cssMaxHeight: 500,
        selectionStyle: {
            cornerSize: 20,
            rotatingPointOffset: 70
        }
    });

    Or ~ UI

    var ImageEditor = require('tui-image-editor');
    var instance = new ImageEditor(document.querySelector('#tui-image-editor'), {
        cssMaxWidth: 700,
        cssMaxHeight: 500,
        selectionStyle: {
            cornerSize: 20,
            rotatingPointOffset: 70
        }
    });

    TypeScript

    If you using TypeScript, You must import module = require('module') on importing. export = and import = require()

    import ImageEditor = require('tui-image-editor');
     
    const instance = new ImageEditor(document.querySelector('#tui-image-editor'), {
        cssMaxWidth: 700,
        cssMaxHeight: 500,
        selectionStyle: {
            cornerSize: 20,
            rotatingPointOffset: 70
        }
    });

    See details for additional informations.

    🔧 Development

    The TOAST UI products are open-source. After fixing issues, create a pull request(PR). Run npm scripts and develop with the following process.

    Setup

    Fork master branch into your personal repository. Clone to local computer. Install node modules. Before starting development, check for any errors.

    $ git clone https://github.com/{username}/tui.image-editor.git
    cd tui.image-editor
    $ npm install
    $ npm run test

    Run webpack-dev-server

    $ npm run serve

    📙 Documents

    💬 Contributing

    🔩 Dependency

    🍞 TOAST UI Family

    🚀 Used By

    📜 License

    MIT LICENSE

    Install

    npm i xhl-tui-image-editor

    DownloadsWeekly Downloads

    1

    Version

    3.7.8

    License

    MIT

    Unpacked Size

    1.72 MB

    Total Files

    288

    Last publish

    Collaborators

    • xhlnpm