Flex Viewer 开发教程(1)Flex Viewer配置文件

Flex Viewer的设计原则是SIMPLICITY(简单)。因为简单原则,Flex Viewer易于部署、配置和扩展。为了达到“简单”这个目的,Flex Viewer在设计和实现上未引入第三方框架。但是从其框架结构上,我们能捕捉到一些Flex框架中最佳实践的影子,比如事件机制就与PureMVC中的Notification机制类似。

其实,Flex Viewer本身就可以被认为是一个框架。在这个框架基础上,可以通过扩展快速实现业务系统原型。本文档将详细介绍如何在“简单”原则下实现自定义Widget,以及Widget如何与其它模块交互。

说明

本文档使用的代码位于widgets.FlexViewerInAction目录下。

 

Flex Viewer通过配置文件配置系统数据和功能,配置文件内容如下:

<?xml version="1.0" ?>

<configuration>

<title>ArcGIS Viewer for Flex</title>

<subtitle>a configurable web mapping application</subtitle>

<logo>assets/images/logo.png</logo>

<style>

   <colors>0xFFFFFF,0x333333,0x101010,0x000000,0xFFD700</colors>

   <alpha>0.8</alpha>

</style>

   <bing key="Al0VE_jsmagxk4LFghXGlK5JSHfC0tk-eHRubZv_eMYm6wzgQaStYks8g-wWcgk3"/>

    <!-- UI elements -->

   <widget left="10" top="50" config="widgets/Navigation/NavigationWidget.xml"

       url="widgets/Navigation/NavigationWidget.swf"/>

   <widget right="-2" bottom="-2" config="widgets/OverviewMap/OverviewMapWidget.xml"

    url="widgets/OverviewMap/OverviewMapWidget.swf"/>

   <widget right="20" top="55" config="widgets/MapSwitcher/MapSwitcherWidget.xml"

    url="widgets/MapSwitcher/MapSwitcherWidget.swf"/>

    <widget left="0" top="0" config="widgets/HeaderController/HeaderControllerWidget.xml"

    url="widgets/HeaderController/HeaderControllerWidget.swf"/>

 

   <map initialextent="-14083000 3139000 -10879000 5458000" top="40" wraparound180="true">

   <basemaps>

           <layer label="Streets" type="tiled" visible="true" alpha="1" url="http://server.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer"/>

           <layer label="Aerial" type="tiled" visible="false" alpha="1" url="http://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer"/>

           <layer label="Topo" type="tiled" visible="false" alpha="1" url="http://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer"/>

       </basemaps>

   <operationallayers>

           <layer label="Boundaries and Places" type="tiled" visible="false" url="http://server.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places_Alternate/MapServer"/>

           <layer label="Fires" type="feature" visible="false" alpha="1" info="widgets/InfoTemplates/SimpleInfoWinWidget.swf"

           infoconfig="widgets/InfoTemplates/IWT_Fires.xml"    url="http://sampleserver3.arcgisonline.com/ArcGIS/rest/services/Fire/Sheep/FeatureServer/0"/>

   </operationallayers>

</map>

    <!-- widgets organized into widget containers that manage close/open etc -->

    <!-- supported layout property options: horizontal(default)|float|vertical|fix-->

<widgetcontainer layout="horizontal">

       <widget label="Bookmarks" left="430" top="90" icon="assets/images/i_bookmark.png"

       config="widgets/Bookmark/BookmarkWidget.xml"

       url="widgets/Bookmark/BookmarkWidget.swf"/>

       <widget label="Find an address" left="100" top="90" preload="open" icon="assets/images/i_target.png"

       config="widgets/Locate/LocateWidget_Bing.xml"

       url="widgets/Locate/LocateWidget.swf"/>

       <widget label="Louisville Police" left="590" top="280" icon="assets/images/i_police.png"          config="widgets/Query/QueryWidget_Louisville_PoliceStations.xml"

        url="widgets/Query/QueryWidget.swf"/>

       <widget label="Search" left="80" top="280" icon="assets/images/i_search.png"

       config="widgets/Search/SearchWidget_Louisville.xml"

       url="widgets/Search/SearchWidget.swf"/>

       <widget label="Earthquakes (GeoRSS)" left="410" top="280" icon="assets/images/i_rss.png"

       config="widgets/GeoRSS/GeoRSSWidget.xml"

       url="widgets/GeoRSS/GeoRSSWidget.swf"/>

       <widget label="Draw and Measure" left="60" top="400" icon="assets/images/i_draw2.png"

       config="widgets/Draw/DrawWidget.xml"

       url="widgets/Draw/DrawWidget.swf"/>

       <widget label="Print" left="390" top="400" icon="assets/images/i_print.png"

       config="widgets/Print/PrintWidget.xml"

       url="widgets/Print/PrintWidget.swf"/>

</widgetcontainer>

</configuration>

    titleFlex Viewer自带Banner实现的标题;

    subtitleFlex Viewer自带Banner实现的副标题;

    logoFlex Viewer自带Banner实现的Logo图标;

    style:用来设置全局的组件样式,具体详见UIManager代码;

⑤⑥⑦⑧ UI Elements:指Control Widget,比如HeaderControllerWidgetNavigationWidget等这些提供系统级别功能的Widget

mapFlex Viewer用来设置地图属性,包括底图、业务图层;

widgetcontainerBusiness Widget的容器,用来管理Business WidgetBusiness Widget指提供业务功能的Widget

上述配置文件并未使用到所有可用的属性,比如在style中设置font属性,map中设置fullextent等,此处不一一列举,详见ConfigManager代码。

 


需要说明的是,基于Flex Viewer开发业务系统,一般通过实现自定义的Business Widget来实现具体的业务功能,通过修改或者自定义Control Widget实现符合需求的系统级别功能组件。所以,配置文件中的前三项并不是必须的,通常我们的业务系统需要更具特色的Banner实现。Flex Viewer各部分与配置文件的对应关系见下图:

 

 

 

  • 0
    点赞
  • 7
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
react-pdf-viewer是一个基于React的PDF阅读器组件库,由于其开源且易于使用的特点,被广泛应用于Web开发中。 以下是react-pdf-viewer的中文文档: ## 安装 使用npm安装: ``` npm install @react-pdf-viewer/core --save ``` 或者使用yarn安装: ``` yarn add @react-pdf-viewer/core ``` ## 使用 ```javascript import React from 'react'; import { Viewer } from '@react-pdf-viewer/core'; import '@react-pdf-viewer/core/lib/styles/index.css'; const App = () => ( <Viewer fileUrl="https://arxiv.org/pdf/quant-ph/0410100.pdf" /> ); export default App; ``` ## API ### Viewer PDF阅读器组件,提供一系列的props来控制阅读器的行为。 #### 属性 * `fileUrl: string`:必须的属性。PDF文件的URL。 * `defaultScale?: number | string`:PDF文件的默认缩放比例。可以是数字,也可以是字符串,例如“auto”、“page-width”、“page-fit”、“50%”等。默认值为“auto”。 * `initialPage?: number`:PDF文件的初始页数。默认值为1。 * `onDocumentLoad?(pdfDocument: PdfDocument) => void`:当PDF文件加载完成时调用的回调函数。 * `onPageChange?(page: number) => void`:当页码发生改变时调用的回调函数。 * `renderError?(error: Error) => React.ReactElement`:当加载PDF文件出错时的自定义渲染函数。 * `renderLoader?() => React.ReactElement`:当加载PDF文件时的自定义渲染函数。 * `theme?: ThemeContext`:阅读器的主题。默认为`defaultTheme`。 ### defaultLayoutPlugin 默认的布局插件,提供一系列的props来控制布局。 #### 属性 * `defaultScale?: number | string`:PDF文件的默认缩放比例。可以是数字,也可以是字符串,例如“auto”、“page-width”、“page-fit”、“50%”等。默认值为“auto”。 * `sidebarTabs?: Array<SidebarTab>`:侧边栏选项卡列表。默认为`[bookmarksTab, attachmentsTab]`。 * `sidebarWidth?: number`:侧边栏的宽度。默认为`280`。 * `thumbnailContainer?: (props: ThumbnailContainerProps) => React.ReactElement`:自定义缩略图容器组件。 * `topToolbar?: (props: ToolbarProps) => React.ReactElement`:自定义顶部工具栏组件。 * `zoom?(scale: number) => void`:缩放PDF文件的函数。当需要在自定义组件中调用缩放功能时,需要将此函数作为props传递给自定义组件。 ### defaultToolbarPlugin 默认的工具栏插件,提供一系列的props来控制工具栏。 #### 属性 * `numberOfPages?: number`:PDF文件的总页数。当PDF文件加载完成后,将自动更新此属性。 * `page?: number`:PDF文件的当前页码。当页码发生改变时,将自动更新此属性。 * `zoom?(scale: number) => void`:缩放PDF文件的函数。当需要在自定义组件中调用缩放功能时,需要将此函数作为props传递给自定义组件。 ### defaultTheme 默认的主题。 #### 属性 * `background?: string`:阅读器的背景色。默认为`#fff`。 * `color?: string`:阅读器的前景色。默认为`#000`。 * `primaryColor?: string`:阅读器的主色调。默认为`#4caf50`。 * `secondaryColor?: string`:阅读器的次色调。默认为`#2196f3`。 ## 示例 以下是一个包含自定义缩略图容器和工具栏的示例: ```javascript import React, { useState } from 'react'; import { Viewer, defaultLayoutPlugin, defaultToolbarPlugin, ThumbnailList, Toolbar } from '@react-pdf-viewer/core'; import '@react-pdf-viewer/core/lib/styles/index.css'; const App = () => { const [numPages, setNumPages] = useState(0); const [currentPage, setCurrentPage] = useState(0); const handleDocumentLoadSuccess = ({ numPages }) => { setNumPages(numPages); }; const handlePageChange = (page) => { setCurrentPage(page); }; const handleZoom = (scale) => { console.log(`Zoom to ${scale}`); }; const thumbnailContainer = (props) => ( <div style={{ padding: '16px 0' }}> <ThumbnailList {...props} /> </div> ); const topToolbar = (props) => ( <div style={{ padding: '16px 0' }}> <Toolbar {...props} pageIndex={currentPage} numberOfPages={numPages} zoom={handleZoom} /> </div> ); return ( <div style={{ display: 'flex', flexDirection: 'row', height: '100vh' }}> <Viewer fileUrl="https://arxiv.org/pdf/quant-ph/0410100.pdf" plugins={[ defaultLayoutPlugin({ thumbnailContainer, }), defaultToolbarPlugin({ topToolbar, }), ]} onDocumentLoadSuccess={handleDocumentLoadSuccess} onPageChange={handlePageChange} /> </div> ); }; export default App; ``` ## 参考 * [react-pdf-viewer官方文档](https://react-pdf-viewer.dev/)

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值