123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117 |
- <!DOCTYPE html>
- <html lang="zh">
- <head>
- <meta charset="utf-8" />
- <base href="../../../" />
- <script src="page.js"></script>
- <link type="text/css" rel="stylesheet" href="page.css" />
- </head>
- <body>
- [page:Loader] →
- <h1>[name]</h1>
- <p class="desc">
- 使用XMLHttpRequest来加载资源的低级类,并由大多数加载器内部使用。
- 它也可以直接用于加载任何没有对应加载器的文件类型。
- </p>
- <h2>代码示例</h2>
- <code>
- const loader = new THREE.FileLoader();
- //加载一个文本文件,并把结果输出到控制台上
- loader.load(
- // resource URL
- 'example.txt',
- // onLoad回调
- function ( data ) {
- // output the text to the console
- console.log( data )
- },
- // onProgress回调
- function ( xhr ) {
- console.log( (xhr.loaded / xhr.total * 100) + '% loaded' );
- },
- // onError回调
- function ( err ) {
- console.error( 'An error happened' );
- }
- );
- </code>
- <p>
- <em>注意:</em>
- 必须启用缓存
- <code>THREE.Cache.enabled = true;</code>
- 这是一个全局属性,只需要设置一次,供内部使用FileLoader的所有加载器使用。
- [page:Cache Cache] 是一个缓存模块,用于保存通过此加载器发出的每个请求的响应,因此每个文件都会被请求一次。
- </p>
- <h2>构造函数</h2>
- <h3>[name] ( [param:LoadingManager manager] )</h3>
- <p>
- [page:LoadingManager manager] — [page:LoadingManager loadingManager] 是加载器所使用的加载管理器。
- 默认为 [page:DefaultLoadingManager].
- </p>
- <h2>属性</h2>
- <p>共有属性请参见其基类[page:Loader]。</p>
- <h3>[property:String mimeType]</h3>
- <p>
- 详情 [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types mimeType].
- 请参考 [page:.setMimeType]。默认为 *undefined*。
- </p>
- <h3>[property:String responseType]</h3>
- <p>请求的响应类型。 请参考 [page:.setResponseType]. 默认为 *undefined*.</p>
- <h3>[property:String withCredentials]</h3>
- <p>
- XMLHttpRequest是否使用证书。 请参考 [page:.setWithCredentials].
- 默认为 *undefined*.
- </p>
- <h2>方法</h2>
- <p>共有方法请参见其基类[page:Loader]。</p>
- <h3>[method:undefined load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )</h3>
- <p>
- [page:String url] — 文件的URL或者路径,也可以为
- [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].<br />
- [page:Function onLoad] (可选) — 加载完成时将调用。回调参数将是加载的响应。<br />
- [page:Function onProgress] (可选) — 将在加载过程中进行调用。参数将是XMLHttpRequest实例,
- 其中包含 [page:Integer total] 和 [page:Integer loaded] 字节<br />
- [page:Function onError] (可选) — 在加载错误时被调用。<br /><br />
- 加载URL并将响应传递给onLoad函数。
- </p>
- <h3>[method:this setMimeType]( [param:String mimeType] )</h3>
- <p>
- 设置正在加载的文件预期类型 [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types mimeType]
- 。请注意,在许多情况下,这将自动确定,因此默认情况下它是 *undefined* 。
- </p>
- <h3>[method:this setResponseType]( [param:String responseType] )</h3>
- <p>
- 改变响应的类型,其类型有效值如下:<br />
- [page:String text] 或者空 string (默认) - 返回的数据类型为 [page:String string].<br />
- [page:String arraybuffer] - 加载的数据类型到一个数组buffer中 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer ArrayBuffer] 并进行返回。<br />
- [page:String blob] - 返回的数据为 [link:https://developer.mozilla.org/en/docs/Web/API/Blob Blob]。<br />
- [page:String document] - 使用 [link:https://developer.mozilla.org/en-US/docs/Web/API/DOMParser DOMParser] 解析文件。<br />
- [page:String json] - 将文件解析为 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse JSON.parse].<br />
- </p>
- <h2>源</h2>
- <p>
- [link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
- </p>
- </body>
- </html>
|