cloudinary-react

React components that utilize Cloudinary functionality

Cloudinary React Library

Cloudinary is a cloud service that offers a solution to a web application's entire image management pipeline.

Easily upload images to the cloud. Automatically perform smart image resizing, cropping and conversion without installing any complex software. Integrate Facebook or Twitter profile image extraction in a snap, in any dimension and style to match your website’s graphics requirements. Images are seamlessly delivered through a fast CDN, and much much more.

Cloudinary offers comprehensive APIs and administration capabilities and is easy to integrate with any web application, existing or new.

Cloudinary provides URL and HTTP based APIs that can be easily integrated with any Web development framework.

Installation

NPM

  1. Install the files using the following command. Use the optional --save parameter if you wish to save the dependency in your bower.json file.

    npm install cloudinary-react --save
    
  2. Include the javascript files in your code. For Example:

    import {Image} from 'cloudinary-react';
    

Setup

In order to properly use this library you have to provide it with a few configuration parameters. All configuration parameters can be applied directly to the element or using a CloudinaryContext element.

ReactDOM.render(
            <div>
                <h1>Hello, world!</h1>
                <Image cloudName="demo" publicId="sample" width="300" crop="scale"/>
                // Or for more advanced usage:
                // import {CloudinaryContext, Transformation} from 'cloudinary-react';
                <CloudinaryContext cloudName="demo">
                    <Image publicId="sample">
                        <Transformation width="200" crop="scale" angle="10"/>
                    </Image>
                </CloudinaryContext>
            </div>,
            document.getElementById('example')
    );

Required:

  • cloudName - The cloudinary cloud name associated with your Cloudinary account.

Optional:

  • privateCdn, secureDistribution, cname, cdnSubdomain - Please refer to Cloudinary Documentation for information on these parameters.

Usage

The library includes 4 Elements:

  • CloudinaryContext
  • Image
  • Video
  • Transformation

CloudinaryContext

CloudinaryContext allows you to define shared parameters that are applied to all children elements.

Image

The Image element defines a Cloudinary Image tag.

Video

The Video element defines a Cloudinary Video tag.

Transformation

The Transformation element allows you to defined additional transformations on the parent element.

For example:

<Image cloudName="demo" publicId="sample">
    <Transformation angle="-45"/>
    <Transformation effect="trim" angle="45" crop="scale" width="600">
      <Transformation overlay="text:Arial_100:Hello" />
    </Transformation>
</Image>

The Cloudinary Documentation can be found at:
http://cloudinary.com/documentation

Additional resources

Additional resources are available at:

Support

You can open an issue through GitHub.

Contact us at http://cloudinary.com/contact.

Stay tuned for updates, tips and tutorials: Blog, Twitter, Facebook.

Join the Community

Impact the product, hear updates, test drive new features and more! Join here.

License

Released under the MIT license.

主要指标

概览
名称与所有者cloudinary/cloudinary-react
主编程语言JavaScript
编程语言JavaScript (语言数: 4)
平台
许可证MIT License
所有者活动
创建于2016-08-30 10:56:20
推送于2023-10-05 11:37:52
最后一次提交2023-02-09 11:55:00
发布数40
最新版本名称1.8.1 (发布于 2022-07-21 13:23:44)
第一版名称1.0.0 (发布于 )
用户参与
星数500
关注者数33
派生数215
提交数243
已启用问题?
问题数116
打开的问题数3
拉请求数111
打开的拉请求数5
关闭的拉请求数30
项目设置
已启用Wiki?
已存档?
是复刻?
已锁定?
是镜像?
是私有?