npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

react-script-tag-18

v5.2.1

Published

React Script Tag 18, updated a five year old package that had a very well written script loader tag utility for react, updating to now use TypeScript and React 18

Downloads

205

Readme

React Script Tag Updated for React 18

NPM Package

This react component is intended to be a drop-in replacement for the <script> html native tag. After you add it in any location of your react-app, the component will take care on appending the corresponding script tag to your app's document. It supports all the native attributes as well.

Outside Change Log

  • May 2024
    • Refactored for better extensibility, readability, and usage of React 18 features.
  • Dec 2022
    • This is a really well written little tool that actually allows for script loading to at least feel some what asynchronously loadable. Just saw it fall out of date with its packages so updated them and also using typescript now. Creating a seperate NPM package for now but if the original author wants to add these changes I'll be more than happy to delete the npm package.

Keywords: Blazing fast 🔥, Minimal 📦, and Simple 🤖

Table of Content

Installation

You can install this package thru npm or yarn:

yarn install react-script-tag-18

Usage

You can use the Script component anywhere. Once it is mounted, the component will proceed to load your script.

Example Usage

Run a demo in your browser, with code, using CodeSandbox here!

import React from 'react';
import ScriptTag from 'react-script-tag-18';

const MyProfileComponent = () => {
    
   
  const [jsLoaded , setJsLoaded] = React.useState(false);

    render() {
        return (
            <div>
            <div className="some-class-that-relies-on-profile-js" style={{
                alignItems: 'center',
                verticalAlign: 'middle',
                textAlign: 'center',
                display: 'flex-box',
                justifyContent: 'center',
                }}>
                
                </div>

            <ScriptTag src="https://platform.linkedin.com/badges/js/profile.js" 
                delayMs={500}
                onLoad={() => {
                console.log('My Profile.js script Loaded');
                setJsLoaded(true); // set some state variable to initiate a re-render
                  }}
                async={true}
             />

             </div>
        );
    }
}

export default MyProfileComponent;

It is recommended that the Script tag is placed in a component that only renders once in the entire life of your app. Otherwise, a new <script> tag will be appended each time the component mounts again. There are plans down the road to prevent this.

CDN Example

<!DOCTYPE html>
<html>
<head>
    <title>react-script-tag-18 cdn demo</title>
    <script src="https://cdn.jsdelivr.net/npm/react@18/umd/react.development.min.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/react-dom@18/umd/react-dom.production.min.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/lib/react-script-tag.umd.min.js"></script>

</head>

<body>
    <div id="root"></div>
    <script async="true" type="text/javascript">
      console.info('React version:', React.version);
        const  ScriptTag = window.ScriptTag;
        // state loaded
      
        const ScriptTagELemWrapperDiv =  () => {
            const [loaded, setLoaded] = React.useState(false);
            const [countdown, setCountdown] = React.useState(5);
            React.useEffect(() => {
                const interval = setInterval(() => {
                    setCountdown((prevCountdown) => prevCountdown - 1);
                }, 1000);
                return () => clearInterval(interval);
            }, []);
            const ScriptTagElem = React.createElement('div', {
                children: React.createElement(ScriptTag, {
                    src: 'https://platform.twitter.com/widgets.js',
                    type: 'text/javascript',
                    async: true,
                    delayMs: 4950,
                    onLoad:() => {
                        console.log('Script loaded');
                        setLoaded(true);
                    },
                    children: loaded ? 'Script loaded' : 'Script will be loaded in ' + countdown + (countdown === 1 ? ' second' : ' seconds'),
                }),

            });
            return ScriptTagElem;
        }
     


        ReactDOM.render(React.createElement(ScriptTagELemWrapperDiv), document.getElementById('root'));



    
    </script>
</body>

</html>

~~Deprecated Examples~~

At GumGum, we usually wrap the Script component as follow, to facilitate adding 3rd-parties. Here is an example, on how we add Qualaroo:

import Script from '../common/ScriptLoader';
import React from 'react';

class QualarooLoader extends React.Component {
    _onCreate = () => {
        window._kiq = window._kiq || [];
    };
    
    _onSuccess = () => {
        const userStr = localStorage.getItem('user');
        const user = JSON.parse(userStr);
        if (!user) return;

        const email = user.email;
        window._kiq.push(['identify', email]);
    };
    
    _onError = error => {
        throw new Error(`Could not load ${error.outerHTML}`);
    };

    render() {
        return (
            <Script
                src="//s3.amazonaws.com/ki.js/<id>/fFn.js"
                type="text/javascript"
                onCreate={this._onCreate}
                onSuccess={this._onSuccess}
                onError={this._onError}
                defer
            />
        );
    }
}

export default QualarooLoader;

We strongly suggest using the attributes async and defer (depending on your situation). Here is a good explanation.

Then we call our new wrapper in our app:

import React from 'react';
import Qualaroo from 'QualarooLoader';

class MyApp extends React.Component {
    /* ... */
    render() {
        return (
            <>
                {/* Other Components */}
                <Qualaroo delayMs={500}/>
            </>
        );
    }
}

API

src

string | required

URI that specifies the location of your script.

delayMs

number | defaults to 0

Artifically adds a delay in milliseconds after the component mounts, but before the script tag is appended to the document. Useful for scripts that are not necessary early on, and may conflict on the browser's request-limit.

onCreate

function() | defaults to Function.prototype

A callback function that is called just right after the script tag has been appended to the document.

onLoad

function(event: Event) | defaults to Function.prototype

This function is called after the script has been successfully loaded.

onError

function(error: Event) | defaults to throw new URIError(...)

If there is a problem loading your script, this function is called.

Other Props ⚠️

As stated previously, this component supports all the attributes that the html script tag supports. You simply have to pass it as props to the <Script> component. In fact, any other prop that is not listed above will be appended as-is to the native script tag.

We have tested it with the following attributes: type, chartset, async, defer, crossOrigin, and noModule. (Everything else should work nevertheless).

Roadmap

  • [x] Document the component
  • [x] Write examples
  • [ ] Write tests
  • [ ] Prevent appending scripts twice when component re-mounts

Feel free to file an issue to suggest changes!

Contributors

Thanks goes to these people (emoji key):

| Jose Santos💻 📖 ⚠️ 👀 🐛 💡 🤔 | Serge Basile 🤔 | | :---: | :---: |

This project follows the all-contributors specification. Contributions of any kind welcome!

License

MIT