add: 跨域文档补充

docs/guide/faq.md

@@ -7,6 +7,57 @@
 
 跨域设置是否成功，可以看返回的响应头里面，是否有access-control-allow-origin字段
 
+解决跨域有以下几种方式：
+
+- 修改nginx或者apache配置
+
+只需要在server或者静态文件对应的location中添加 add_header Access-Control-Allow-Origin *;
+
+```shell
+ server {
+    add_header Access-Control-Allow-Origin *;
+ }
+```
+这种方式最简单，但是接口也跟着允许跨域了，如果你的文件只是在某个目录下，可以只针对具体配置设置允许跨域。
+
+```shell
+ server {
+    location /upload/ {
+        add_header Access-Control-Allow-Origin *;
+        root /opt/homebrew/etc/nginx;
+    }
+ }
+```
+这样配置只针对 /upload开头的请求生效。
+
+- 在后端静态服务中设置允许跨域
+
+在php加载的文件头部加入以下代码
+```php
+ header('Access-Control-Allow-Origin:*'); // *代表允许任何网址请求
+```
+
+node服务，以koa为例，可以使用koa-cors中间件
+```javascript
+const serve = require('koa-static');
+const Koa = require('koa');
+const app = new Koa();
+
+var cors = require('koa-cors');
+app.use(cors({
+    origin: '*'
+}));
+
+app.use(serve('.', {
+}));
+
+
+app.listen(3000);
+```
+
+各种语言都类似，可以自行百度查询
+
+
 ![描述][cros]
 
 ## 文件预览不出来

examples/docs/assets/guide_faq.md.3d8a2c63.lean.js

@@ -0,0 +1 @@
+import{_ as A,c as E,o as I,Q as C}from"./chunks/framework.1612f957.js";const t=JSON.parse('{"title":"常见问题","description":"","frontmatter":{},"headers":[],"relativePath":"guide/faq.md"}'),Q={name:"guide/faq.md"},i=C("",20),B=[i];function s(e,g,n,l,J,k){return I(),E("div",null,B)}const R=A(Q,[["render",s]]);export{t as __pageData,R as default};

examples/docs/config/index.html

@@ -18,7 +18,7 @@
 <span class="line"><span style="color:#A6ACCD;">  </span><span style="color:#89DDFF;">&quot;</span><span style="color:#C792EA;">minColLength</span><span style="color:#89DDFF;">&quot;</span><span style="color:#89DDFF;">:</span><span style="color:#A6ACCD;"> </span><span style="color:#F78C6C;">20</span><span style="color:#A6ACCD;"> </span></span>
 <span class="line"><span style="color:#89DDFF;">}</span></span>
 <span class="line"></span></code></pre></div><h2 id="staticfileurl-pdf特有属性" tabindex="-1">staticFileUrl [pdf特有属性] <a class="header-anchor" href="#staticfileurl-pdf特有属性" aria-label="Permalink to &quot;staticFileUrl [pdf特有属性]&quot;">​</a></h2><ul><li>类型： String</li></ul><p>pdf渲染时可能会请求一些bcmap文件，这些文件默认从 <a href="https://unpkg.com/pdfjs-dist@3.1.81/" target="_blank" rel="noreferrer">https://unpkg.com/pdfjs-dist@3.1.81/</a> 加载，但是可能存在网络不通问题，如果遇到这种问题，可以将这些文件放到自己静态目录，然后修改该属性，告诉组件去这里请求bcmap文件。</p><p>涉及的文件存放在当前github项目中examples/public/cmaps目录下，可将cmaps目录复制到你的静态服务目录下，然后修改staticFileUrl为cmaps文件夹对应的父地址，必须已http或https开头，如 <a href="http://yourdomain/static/" target="_blank" rel="noreferrer">http://yourdomain/static/</a></p></div></div></main><footer class="VPDocFooter" data-v-577a912e data-v-face870a><!--[--><!--]--><!----><div class="prev-next" data-v-face870a><div class="pager" data-v-face870a><!----></div><div class="pager" data-v-face870a><a class="pager-link next" href="/vue-office/examples/docs/config/event.html" data-v-face870a><span class="desc" data-v-face870a>下一页</span><span class="title" data-v-face870a>事件</span></a></div></div></footer><!--[--><!--]--></div></div></div></div></div><!----><!--[--><!--]--></div></div>
-    <script>__VP_HASH_MAP__ = JSON.parse("{\"guide_contact.md\":\"ced9e44d\",\"config_event.md\":\"d08100fe\",\"guide_preview-docx.md\":\"5e6e0ada\",\"guide_preview-pdf.md\":\"1182152d\",\"config_index.md\":\"c35b64bb\",\"index.md\":\"fb9fee08\",\"guide_preview-xlsx.md\":\"2a8a4b68\",\"guide_index.md\":\"425949a3\",\"guide_faq.md\":\"c3bde33b\"}")
+    <script>__VP_HASH_MAP__ = JSON.parse("{\"index.md\":\"fb9fee08\",\"guide_index.md\":\"425949a3\",\"guide_preview-docx.md\":\"5e6e0ada\",\"guide_preview-xlsx.md\":\"2a8a4b68\",\"config_event.md\":\"d08100fe\",\"config_index.md\":\"c35b64bb\",\"guide_contact.md\":\"ced9e44d\",\"guide_preview-pdf.md\":\"1182152d\",\"guide_faq.md\":\"3d8a2c63\"}")
 __VP_SITE_DATA__ = JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"vue-office\",\"description\":\"更简单的office文件预览\",\"base\":\"/vue-office/examples/docs/\",\"head\":[],\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"指南\",\"link\":\"/guide/\"},{\"text\":\"配置参考\",\"link\":\"/config/\"},{\"text\":\"演示预览效果\",\"link\":\"https://501351981.github.io/vue-office/examples/dist/\"}],\"outlineTitle\":\"跳转到\",\"docFooter\":{\"next\":\"下一页\",\"prev\":\"上一页\"},\"sidebar\":{\"/guide\":[{\"text\":\"指南\",\"items\":[{\"text\":\"快速上手\",\"link\":\"/guide/\"},{\"text\":\"docx文件预览\",\"link\":\"/guide/preview-docx\"},{\"text\":\"xlsx文件预览\",\"link\":\"/guide/preview-xlsx\"},{\"text\":\"pdf文件预览\",\"link\":\"/guide/preview-pdf\"},{\"text\":\"常见问题\",\"link\":\"/guide/faq\"},{\"text\":\"联系我\",\"link\":\"/guide/contact\"}]}],\"/config\":[{\"text\":\"配置参考\",\"items\":[{\"text\":\"属性\",\"link\":\"/config/\"},{\"text\":\"事件\",\"link\":\"/config/event\"}]}]},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/501351981/vue-office\"}]},\"locales\":{},\"scrollOffset\":90,\"cleanUrls\":false}")</script>
     
   </body>

examples/docs/guide/index.html

@@ -135,7 +135,7 @@
 <span class="line"><span style="color:#89DDFF;">}</span></span>
 <span class="line"><span style="color:#89DDFF;">&lt;/</span><span style="color:#F07178;">script</span><span style="color:#89DDFF;">&gt;</span></span>
 <span class="line"></span></code></pre></div></div></div></main><footer class="VPDocFooter" data-v-577a912e data-v-face870a><!--[--><!--]--><!----><div class="prev-next" data-v-face870a><div class="pager" data-v-face870a><!----></div><div class="pager" data-v-face870a><a class="pager-link next" href="/vue-office/examples/docs/guide/preview-docx.html" data-v-face870a><span class="desc" data-v-face870a>下一页</span><span class="title" data-v-face870a>docx文件预览</span></a></div></div></footer><!--[--><!--]--></div></div></div></div></div><!----><!--[--><!--]--></div></div>
-    <script>__VP_HASH_MAP__ = JSON.parse("{\"guide_contact.md\":\"ced9e44d\",\"config_event.md\":\"d08100fe\",\"guide_preview-docx.md\":\"5e6e0ada\",\"guide_preview-pdf.md\":\"1182152d\",\"config_index.md\":\"c35b64bb\",\"index.md\":\"fb9fee08\",\"guide_preview-xlsx.md\":\"2a8a4b68\",\"guide_index.md\":\"425949a3\",\"guide_faq.md\":\"c3bde33b\"}")
+    <script>__VP_HASH_MAP__ = JSON.parse("{\"index.md\":\"fb9fee08\",\"guide_index.md\":\"425949a3\",\"guide_preview-docx.md\":\"5e6e0ada\",\"guide_preview-xlsx.md\":\"2a8a4b68\",\"config_event.md\":\"d08100fe\",\"config_index.md\":\"c35b64bb\",\"guide_contact.md\":\"ced9e44d\",\"guide_preview-pdf.md\":\"1182152d\",\"guide_faq.md\":\"3d8a2c63\"}")
 __VP_SITE_DATA__ = JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"vue-office\",\"description\":\"更简单的office文件预览\",\"base\":\"/vue-office/examples/docs/\",\"head\":[],\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"指南\",\"link\":\"/guide/\"},{\"text\":\"配置参考\",\"link\":\"/config/\"},{\"text\":\"演示预览效果\",\"link\":\"https://501351981.github.io/vue-office/examples/dist/\"}],\"outlineTitle\":\"跳转到\",\"docFooter\":{\"next\":\"下一页\",\"prev\":\"上一页\"},\"sidebar\":{\"/guide\":[{\"text\":\"指南\",\"items\":[{\"text\":\"快速上手\",\"link\":\"/guide/\"},{\"text\":\"docx文件预览\",\"link\":\"/guide/preview-docx\"},{\"text\":\"xlsx文件预览\",\"link\":\"/guide/preview-xlsx\"},{\"text\":\"pdf文件预览\",\"link\":\"/guide/preview-pdf\"},{\"text\":\"常见问题\",\"link\":\"/guide/faq\"},{\"text\":\"联系我\",\"link\":\"/guide/contact\"}]}],\"/config\":[{\"text\":\"配置参考\",\"items\":[{\"text\":\"属性\",\"link\":\"/config/\"},{\"text\":\"事件\",\"link\":\"/config/event\"}]}]},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/501351981/vue-office\"}]},\"locales\":{},\"scrollOffset\":90,\"cleanUrls\":false}")</script>
     
   </body>

examples/docs/guide/preview-docx.html

@@ -126,7 +126,7 @@
 <span class="line"><span style="color:#89DDFF;">}</span></span>
 <span class="line"><span style="color:#89DDFF;">&lt;/</span><span style="color:#F07178;">script</span><span style="color:#89DDFF;">&gt;</span></span>
 <span class="line"></span></code></pre></div></div></div></main><footer class="VPDocFooter" data-v-577a912e data-v-face870a><!--[--><!--]--><!----><div class="prev-next" data-v-face870a><div class="pager" data-v-face870a><a class="pager-link prev" href="/vue-office/examples/docs/guide/" data-v-face870a><span class="desc" data-v-face870a>上一页</span><span class="title" data-v-face870a>快速上手</span></a></div><div class="has-prev pager" data-v-face870a><a class="pager-link next" href="/vue-office/examples/docs/guide/preview-xlsx.html" data-v-face870a><span class="desc" data-v-face870a>下一页</span><span class="title" data-v-face870a>xlsx文件预览</span></a></div></div></footer><!--[--><!--]--></div></div></div></div></div><!----><!--[--><!--]--></div></div>
-    <script>__VP_HASH_MAP__ = JSON.parse("{\"guide_contact.md\":\"ced9e44d\",\"config_event.md\":\"d08100fe\",\"guide_preview-docx.md\":\"5e6e0ada\",\"guide_preview-pdf.md\":\"1182152d\",\"config_index.md\":\"c35b64bb\",\"index.md\":\"fb9fee08\",\"guide_preview-xlsx.md\":\"2a8a4b68\",\"guide_index.md\":\"425949a3\",\"guide_faq.md\":\"c3bde33b\"}")
+    <script>__VP_HASH_MAP__ = JSON.parse("{\"index.md\":\"fb9fee08\",\"guide_index.md\":\"425949a3\",\"guide_preview-docx.md\":\"5e6e0ada\",\"guide_preview-xlsx.md\":\"2a8a4b68\",\"config_event.md\":\"d08100fe\",\"config_index.md\":\"c35b64bb\",\"guide_contact.md\":\"ced9e44d\",\"guide_preview-pdf.md\":\"1182152d\",\"guide_faq.md\":\"3d8a2c63\"}")
 __VP_SITE_DATA__ = JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"vue-office\",\"description\":\"更简单的office文件预览\",\"base\":\"/vue-office/examples/docs/\",\"head\":[],\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"指南\",\"link\":\"/guide/\"},{\"text\":\"配置参考\",\"link\":\"/config/\"},{\"text\":\"演示预览效果\",\"link\":\"https://501351981.github.io/vue-office/examples/dist/\"}],\"outlineTitle\":\"跳转到\",\"docFooter\":{\"next\":\"下一页\",\"prev\":\"上一页\"},\"sidebar\":{\"/guide\":[{\"text\":\"指南\",\"items\":[{\"text\":\"快速上手\",\"link\":\"/guide/\"},{\"text\":\"docx文件预览\",\"link\":\"/guide/preview-docx\"},{\"text\":\"xlsx文件预览\",\"link\":\"/guide/preview-xlsx\"},{\"text\":\"pdf文件预览\",\"link\":\"/guide/preview-pdf\"},{\"text\":\"常见问题\",\"link\":\"/guide/faq\"},{\"text\":\"联系我\",\"link\":\"/guide/contact\"}]}],\"/config\":[{\"text\":\"配置参考\",\"items\":[{\"text\":\"属性\",\"link\":\"/config/\"},{\"text\":\"事件\",\"link\":\"/config/event\"}]}]},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/501351981/vue-office\"}]},\"locales\":{},\"scrollOffset\":90,\"cleanUrls\":false}")</script>
     
   </body>

examples/docs/guide/preview-pdf.html

@@ -46,7 +46,7 @@
 <span class="line"><span style="color:#89DDFF;">}</span></span>
 <span class="line"><span style="color:#89DDFF;">&lt;/</span><span style="color:#F07178;">script</span><span style="color:#89DDFF;">&gt;</span></span>
 <span class="line"></span></code></pre></div><h2 id="上传文件预览" tabindex="-1">上传文件预览 <a class="header-anchor" href="#上传文件预览" aria-label="Permalink to &quot;上传文件预览&quot;">​</a></h2><p>和docx的上传文件预览一样，获取文件的ArrayBuffer，传给组件的src属性。</p></div></div></main><footer class="VPDocFooter" data-v-577a912e data-v-face870a><!--[--><!--]--><!----><div class="prev-next" data-v-face870a><div class="pager" data-v-face870a><a class="pager-link prev" href="/vue-office/examples/docs/guide/preview-xlsx.html" data-v-face870a><span class="desc" data-v-face870a>上一页</span><span class="title" data-v-face870a>xlsx文件预览</span></a></div><div class="has-prev pager" data-v-face870a><a class="pager-link next" href="/vue-office/examples/docs/guide/faq.html" data-v-face870a><span class="desc" data-v-face870a>下一页</span><span class="title" data-v-face870a>常见问题</span></a></div></div></footer><!--[--><!--]--></div></div></div></div></div><!----><!--[--><!--]--></div></div>
-    <script>__VP_HASH_MAP__ = JSON.parse("{\"guide_contact.md\":\"ced9e44d\",\"config_event.md\":\"d08100fe\",\"guide_preview-docx.md\":\"5e6e0ada\",\"guide_preview-pdf.md\":\"1182152d\",\"config_index.md\":\"c35b64bb\",\"index.md\":\"fb9fee08\",\"guide_preview-xlsx.md\":\"2a8a4b68\",\"guide_index.md\":\"425949a3\",\"guide_faq.md\":\"c3bde33b\"}")
+    <script>__VP_HASH_MAP__ = JSON.parse("{\"index.md\":\"fb9fee08\",\"guide_index.md\":\"425949a3\",\"guide_preview-docx.md\":\"5e6e0ada\",\"guide_preview-xlsx.md\":\"2a8a4b68\",\"config_event.md\":\"d08100fe\",\"config_index.md\":\"c35b64bb\",\"guide_contact.md\":\"ced9e44d\",\"guide_preview-pdf.md\":\"1182152d\",\"guide_faq.md\":\"3d8a2c63\"}")
 __VP_SITE_DATA__ = JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"vue-office\",\"description\":\"更简单的office文件预览\",\"base\":\"/vue-office/examples/docs/\",\"head\":[],\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"指南\",\"link\":\"/guide/\"},{\"text\":\"配置参考\",\"link\":\"/config/\"},{\"text\":\"演示预览效果\",\"link\":\"https://501351981.github.io/vue-office/examples/dist/\"}],\"outlineTitle\":\"跳转到\",\"docFooter\":{\"next\":\"下一页\",\"prev\":\"上一页\"},\"sidebar\":{\"/guide\":[{\"text\":\"指南\",\"items\":[{\"text\":\"快速上手\",\"link\":\"/guide/\"},{\"text\":\"docx文件预览\",\"link\":\"/guide/preview-docx\"},{\"text\":\"xlsx文件预览\",\"link\":\"/guide/preview-xlsx\"},{\"text\":\"pdf文件预览\",\"link\":\"/guide/preview-pdf\"},{\"text\":\"常见问题\",\"link\":\"/guide/faq\"},{\"text\":\"联系我\",\"link\":\"/guide/contact\"}]}],\"/config\":[{\"text\":\"配置参考\",\"items\":[{\"text\":\"属性\",\"link\":\"/config/\"},{\"text\":\"事件\",\"link\":\"/config/event\"}]}]},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/501351981/vue-office\"}]},\"locales\":{},\"scrollOffset\":90,\"cleanUrls\":false}")</script>
     
   </body>

examples/docs/guide/preview-xlsx.html

@@ -49,7 +49,7 @@
 <span class="line"><span style="color:#89DDFF;">}</span></span>
 <span class="line"><span style="color:#89DDFF;">&lt;/</span><span style="color:#F07178;">script</span><span style="color:#89DDFF;">&gt;</span></span>
 <span class="line"></span></code></pre></div><h2 id="上传文件预览" tabindex="-1">上传文件预览 <a class="header-anchor" href="#上传文件预览" aria-label="Permalink to &quot;上传文件预览&quot;">​</a></h2><p>和docx的上传文件预览一样，获取文件的ArrayBuffer，传给组件的src属性。</p></div></div></main><footer class="VPDocFooter" data-v-577a912e data-v-face870a><!--[--><!--]--><!----><div class="prev-next" data-v-face870a><div class="pager" data-v-face870a><a class="pager-link prev" href="/vue-office/examples/docs/guide/preview-docx.html" data-v-face870a><span class="desc" data-v-face870a>上一页</span><span class="title" data-v-face870a>docx文件预览</span></a></div><div class="has-prev pager" data-v-face870a><a class="pager-link next" href="/vue-office/examples/docs/guide/preview-pdf.html" data-v-face870a><span class="desc" data-v-face870a>下一页</span><span class="title" data-v-face870a>pdf文件预览</span></a></div></div></footer><!--[--><!--]--></div></div></div></div></div><!----><!--[--><!--]--></div></div>
-    <script>__VP_HASH_MAP__ = JSON.parse("{\"guide_contact.md\":\"ced9e44d\",\"config_event.md\":\"d08100fe\",\"guide_preview-docx.md\":\"5e6e0ada\",\"guide_preview-pdf.md\":\"1182152d\",\"config_index.md\":\"c35b64bb\",\"index.md\":\"fb9fee08\",\"guide_preview-xlsx.md\":\"2a8a4b68\",\"guide_index.md\":\"425949a3\",\"guide_faq.md\":\"c3bde33b\"}")
+    <script>__VP_HASH_MAP__ = JSON.parse("{\"index.md\":\"fb9fee08\",\"guide_index.md\":\"425949a3\",\"guide_preview-docx.md\":\"5e6e0ada\",\"guide_preview-xlsx.md\":\"2a8a4b68\",\"config_event.md\":\"d08100fe\",\"config_index.md\":\"c35b64bb\",\"guide_contact.md\":\"ced9e44d\",\"guide_preview-pdf.md\":\"1182152d\",\"guide_faq.md\":\"3d8a2c63\"}")
 __VP_SITE_DATA__ = JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"vue-office\",\"description\":\"更简单的office文件预览\",\"base\":\"/vue-office/examples/docs/\",\"head\":[],\"appearance\":true,\"themeConfig\":{\"nav\":[{\"text\":\"指南\",\"link\":\"/guide/\"},{\"text\":\"配置参考\",\"link\":\"/config/\"},{\"text\":\"演示预览效果\",\"link\":\"https://501351981.github.io/vue-office/examples/dist/\"}],\"outlineTitle\":\"跳转到\",\"docFooter\":{\"next\":\"下一页\",\"prev\":\"上一页\"},\"sidebar\":{\"/guide\":[{\"text\":\"指南\",\"items\":[{\"text\":\"快速上手\",\"link\":\"/guide/\"},{\"text\":\"docx文件预览\",\"link\":\"/guide/preview-docx\"},{\"text\":\"xlsx文件预览\",\"link\":\"/guide/preview-xlsx\"},{\"text\":\"pdf文件预览\",\"link\":\"/guide/preview-pdf\"},{\"text\":\"常见问题\",\"link\":\"/guide/faq\"},{\"text\":\"联系我\",\"link\":\"/guide/contact\"}]}],\"/config\":[{\"text\":\"配置参考\",\"items\":[{\"text\":\"属性\",\"link\":\"/config/\"},{\"text\":\"事件\",\"link\":\"/config/event\"}]}]},\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/501351981/vue-office\"}]},\"locales\":{},\"scrollOffset\":90,\"cleanUrls\":false}")</script>
     
   </body>

examples/docs/hashmap.json

@@ -1 +1 @@
-{"guide_contact.md":"ced9e44d","config_event.md":"d08100fe","guide_preview-docx.md":"5e6e0ada","guide_preview-pdf.md":"1182152d","config_index.md":"c35b64bb","index.md":"fb9fee08","guide_preview-xlsx.md":"2a8a4b68","guide_index.md":"425949a3","guide_faq.md":"c3bde33b"}
+{"index.md":"fb9fee08","guide_index.md":"425949a3","guide_preview-docx.md":"5e6e0ada","guide_preview-xlsx.md":"2a8a4b68","config_event.md":"d08100fe","config_index.md":"c35b64bb","guide_contact.md":"ced9e44d","guide_preview-pdf.md":"1182152d","guide_faq.md":"3d8a2c63"}