javascript
/
three.js
mirror of https://github.com/tazdij/three.js.git


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442
							<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>three.js / documentation</title>
    <meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
    <link type="text/css" rel="stylesheet" href="index.css">
</head>
<body>

    <div id="panel" class="collapsed">

        <h1><a href="http://threejs.org">three.js</a> / docs</h1>

        <a id="expandButton" href="#">
            <span></span>
            <span></span>
            <span></span>
        </a>

        <div class="filterBlock" >
            <input type="text" id="filterInput" placeholder="Type to filter">
            <a href="#" id="clearFilterButton">x</a>
        </div>

    </div>

    <iframe></iframe>

    <script src="list.js"></script>

    <script>

        var panel = document.getElementById( 'panel' );
        var clearFilterButton = document.getElementById( 'clearFilterButton' );
        var expandButton = document.getElementById( 'expandButton' );
        var filterInput = document.getElementById( 'filterInput' );
        var iframe = document.querySelector( 'iframe' );

        var pageProperties = {};
        var titles = {};
        var categoryElements = [];


// ----------------------------------------------------------------------------
// Initialization
// ----------------------------------------------------------------------------


        // Functionality for hamburger button (on small devices)

        expandButton.onclick = function ( event ) {

            event.preventDefault();
            panel.classList.toggle( 'collapsed' );

        };


        // Functionality for search/filter input field

        filterInput.oninput = function ( event ) {

            updateFilter();

        };


        // Functionality for filter clear button

        clearFilterButton.onclick = function ( event ) {

            event.preventDefault();

            filterInput.value = '';
            updateFilter();

        };


        // Activate content and title change on browser navigation

        window.onpopstate = createNewIframe;


        // Create the navigation panel and configure the iframe

        createNavigation();
        createNewIframe();


// ----------------------------------------------------------------------------
// Navigation Panel
// ----------------------------------------------------------------------------


        function createNavigation () {

            // Create the navigation panel using data from list.js

            var navigation = createAndAppendDOMElement( { type: 'div', parent: panel } );

            for ( var section in list ) {

                // Create sections

                var categories = list[ section ];

                var sectionHead = createAndAppendDOMElement( { type: 'h2', parent: navigation, content: section } )

                for ( var category in categories ) {

                    // Create categories

                    var pages = categories[ category ];

                    var categoryContainer = createAndAppendDOMElement( { type: 'div', parent: navigation } );
                    var categoryHead = createAndAppendDOMElement( { type: 'h3', parent: categoryContainer, content: category } );
                    var categoryContent = createAndAppendDOMElement( { type: 'ul', parent: categoryContainer } );

                    for ( var pageName in pages ) {

                        // Create page links

                        var pageURL = pages[ pageName ];

                        var listElement = createAndAppendDOMElement( { type: 'li', parent: categoryContent } );
                        var linkElement = createAndAppendDOMElement( { type: 'a', parent: listElement, content: pageName } );

                        // The href attribute is only used for the option to create a new tab by right click

                        linkElement.setAttribute( 'href', '#' + pageURL );

                        addClickHandlers( linkElement, pageURL );

                        // Gather the main properties for the current subpage

                        pageProperties[ pageName ] = {
                            section: section,
                            category: category,
                            pageURL: pageURL,
                            linkElement: linkElement
                        };

                    // Gather the document titles (used for easy access on browser navigation)

                    titles[ pageURL ] = pageName;

                    }

                    // Gather the category elements for easy access on filtering

                    categoryElements.push( categoryContent );

                }

            }

        };


        function createAndAppendDOMElement( properties ) {

            // Helper function for creating and appending new DOM elements

            var newElement = document.createElement( properties.type );

            properties.parent.appendChild( newElement );

            if ( properties.content ) {

                newElement.textContent = properties.content;

            }

            return newElement;

        }


        function addClickHandlers ( linkElement, pageURL ) {

            // Helper function for adding ClickHandlers to the page links

            linkElement.onclick = function ( event ) {

                event.preventDefault();

                window.location.hash = pageURL;
                createNewIframe();

                panel.classList.add( 'collapsed' );

            };

        };


// ----------------------------------------------------------------------------
// Query Strings (optional)
// ----------------------------------------------------------------------------


//        (uncomment the following lines and the first line in updateFilter(), if you want query strings):

//        filterInput.value = extractFromQueryString();
//        updateFilter();
//
//
//        function extractFromQueryString() {
//
//            var queryString = window.location.search;
//
//            if ( queryString.indexOf( '?q=' ) === -1 ) return '';
//
//            return queryString.substr( 3 );
//
//        }
//
//        function updateQueryString() {
//
//            var searchString = filterInput.value;
//            var query = '';
//
//            if (searchString !== '') {
//
//                query = '?q=' + searchString;
//
//            }
//
//            window.history.replaceState( {} , '', window.location.pathname + query + window.location.hash ); 
//
//        }


// ----------------------------------------------------------------------------
// Filtering
// ----------------------------------------------------------------------------


        function updateFilter() {

//            (uncomment the following line and the "Query strings" section, if you want query strings):
//            updateQueryString();

            var regExp = new RegExp( filterInput.value, 'gi' );

            for ( var pageName in pageProperties ) {
 
                var linkElement = pageProperties[ pageName ].linkElement;
                var categoryClassList = linkElement.parentElement.classList;
                var filterResults = pageName.match( regExp );

                if ( filterResults && filterResults.length > 0 ) {

                    // Accentuate matching characters

                    for ( var i = 0; i < filterResults.length; i++ ) {

                        var result = filterResults[ i ];

                        if ( result !== '' ) {
                            pageName = pageName.replace( result, '<b>' + result + '</b>' );
                        }

                    }

                    categoryClassList.remove( 'hidden' );
                    linkElement.innerHTML = pageName;

                } else {

                    // Hide all non-matching page names

                    categoryClassList.add( 'hidden' );

                }

            }

            displayFilteredPanel();

        }


        function displayFilteredPanel() {

            // Show/hide categories depending on their content
            // First check if at least one page in this category is not hidden

            categoryElements.forEach( function ( category ) {

                var pages = category.children;
                var pagesLength = pages.length;
                var sectionClassList = category.parentElement.classList;

                var hideCategory = true;

                for ( var i = 0; i < pagesLength; i ++ ) {

                    var pageClassList = pages[ i ].classList;

                    if ( ! pageClassList.contains( 'hidden' ) ) {

                        hideCategory = false;

                    }

                }

                // If and only if all page names are hidden, hide the whole category

                if ( hideCategory ) {

                    sectionClassList.add( 'hidden' );

                } else {

                    sectionClassList.remove( 'hidden' );

                }

            } );

        }


// ----------------------------------------------------------------------------
// Routing
// ----------------------------------------------------------------------------


        function setUrlFragment( pageName ) {

            // Handle navigation from the subpages (iframes):
            // First separate the memeber (if existing) from the page name,
            // then identify the subpage's URL and set it as URL fragment (re-adding the member)

            var splitPageName = decomposePageName( pageName, '.', '.' );

            var currentProperties = pageProperties[ splitPageName[ 0 ] ];

            if ( currentProperties ) {

                window.location.hash = currentProperties.pageURL + splitPageName[ 1 ];

                createNewIframe();

            }

        }


        function createNewIframe() {

            // Change the content displayed in the iframe
            // First separate the member part of the fragment (if existing)

            var hash = window.location.hash.substring( 1 );
            var splitHash = decomposePageName( hash, '.', '#' );

            // Creating a new Iframe instead of assigning a new src is
            // a cross-browser solution to allow normal browser navigation;
            // - only assigning a new src would result in two history states each time.

            // Note: iframe.contentWindow.location.replace(hash) should work, too,
            // but it doesn't work in Edge with links from the subpages!

            var oldIframe;
            var subtitle;

            oldIframe = iframe;
            iframe = oldIframe.cloneNode();

            if(hash) {

                iframe.src = splitHash[ 0 ] + '.html' + splitHash[ 1 ];
                subtitle = ' - ' + titles[ splitHash[ 0 ] ] + splitHash[ 1 ];

            } else {

                iframe.src = '';
                subtitle = '';

            }

            document.body.replaceChild( iframe, oldIframe );
            document.title = 'three.js docs' + subtitle;

        }


        function decomposePageName ( pageName, oldDelimiter, newDelimiter ) {

            // Helper function for separating the member (if existing) from the pageName
            // For example: 'Geometry.morphTarget' can be converted to 
            // ['Geometry', '.morphTarget'] or ['Geometry', '#morphTarget']
            // Note: According RFC 3986 no '#' allowed inside of an URL fragment!

            var parts = [];

            var dotIndex = pageName.indexOf( oldDelimiter );

            if ( dotIndex !== -1 ) {

                parts = pageName.split( oldDelimiter );
                parts[ 1 ] = newDelimiter + parts[ 1 ];

            } else {

                parts[ 0 ] = pageName;
                parts[ 1 ] = '';

            }

            return parts;

        }


// ----------------------------------------------------------------------------
// ASCII Art ;-)
// ----------------------------------------------------------------------------


        console.log( [
            '    __     __',
            ' __/ __\\  / __\\__   ____   _____   _____',
            '/ __/  /\\/ /  /___\\/ ____\\/ _____\\/ _____\\',
            '\\/_   __/ /   _   / /  __/ / __  / / __  /_   __   _____',
            '/ /  / / /  / /  / /  / / /  ___/ /  ___/\\ _\\/ __\\/ _____\\',
            '\\/__/  \\/__/\\/__/\\/__/  \\/_____/\\/_____/\\/__/ /  / /  ___/',
            '                                         / __/  /  \\__  \\',
            '                                         \\/____/\\/_____/'
        ].join( '\n' ) );


    </script>


</body>
</html>