从零开始-文件资源管理器-05-可视窗口优化

添加页脚功能

参考 MacOS 的 Finder 页脚格式

  • 显示当前文件夹下有多少项目
  • 当前磁盘可用空间(该功能暂缓再实现)
  • table 与 card 样式改变按钮

文件树

explorer/src/app/path/[[...path]]/layout-footer.tsx
explorer/src/app/path/[[...path]]/page.tsx
explorer/src/app/path/layout.tsx
explorer/src/components/display-type.tsx
explorer/src/components/readdir-count.tsx

文件路径:explorer/src/app/path/[[...path]]/layout-footer.tsx

页脚组件,目前包含当前页面项目总数、切换 table 与 card 呈现

'use client'
import React from 'react'
import { Flex, Layout, Space } from 'antd'
import ReaddirCount from '@/components/readdir-count'
import ChangeColumn from '@/components/change-column'
import DisplayType from '@/components/display-type'

const LayoutFooter: React.FC = () => {
  return (
    <Layout.Footer style={{ padding: '0px 20px' }}>
      <Flex style={{ width: '100%', height: '40px' }} align="center">
        <Flex flex={1}>
          <Space>
            <ReaddirCount />
          </Space>
        </Flex>

        <Flex justify="flex-end" flex={1}>
          <Space>
            <DisplayType />
          </Space>
        </Flex>
      </Flex>
    </Layout.Footer>
  )
}

export default LayoutFooter

文件路径:explorer/src/components/readdir-count.tsx

'use client'
import React from 'react'
import { Space } from 'antd'
import { usePathContext } from '@/app/path/context'

const ReaddirCount: React.FC = () => {
  const { readdir } = usePathContext()

  return (
    <Space>
      <span>{readdir.length}</span>
      <span>个项目</span>
    </Space>
  )
}

export default ReaddirCount

文件路径:explorer/src/app/path/[[...path]]/page.tsx

移除之前添加的切换显示样式按钮

'use client'
import React from 'react'
import CardDisplay from '@/app/path/[[...path]]/card-display'
import TableDisplay from '@/app/path/[[...path]]/tale-display'
import { usePathContext } from '@/app/path/context'

const Page: React.FC = () => {
  const { display_type } = usePathContext()

  return <>{display_type === 'table' ? <TableDisplay /> : <CardDisplay />}</>
}

export default Page

文件路径:explorer/src/components/display-type.tsx

改变显示状态组件。之前的按钮 display 文案变为 icon 区分显示

import React from 'react'
import { Button, Space } from 'antd'
import { usePathContext } from '@/app/path/context'
import { AppstoreOutlined, TableOutlined } from '@ant-design/icons'

const DisplayType: React.FC = () => {
  const { display_type, changeDisplayType } = usePathContext()

  return (
    <Space>
      {display_type === 'table' && (
        <Button
          icon={<AppstoreOutlined />}
          onClick={() => {
            changeDisplayType('card')
          }}
        />
      )}
      {display_type === 'card' && (
        <Button
          icon={<TableOutlined />}
          onClick={() => {
            changeDisplayType('table')
          }}
        />
      )}
    </Space>
  )
}

export default DisplayType

可视窗口优化

当前遇到问题

  1. 当页面内容超出浏览器高度时,会出现滚动条。这时页眉的面包屑与页脚功是否可视会被滚动条影响。需要一直固定在页眉与页脚
  2. 跳转再返回时默认是页面顶部。需要返回时滚动条需要定位至跳转前。

方案

  1. 可使用 position: fixed css 属性固定页眉与页脚。但内容区域需要减掉页眉与页脚的高度。由于是使用 antd 组件,页眉也页脚的高度不可控。
  2. 使用 flex:1 布局,然后给内容区域使用 flex: 1 自动撑满可用区域。为内容可视区域添加 overflow: scroll。可省去计算页眉与页脚的高度。
  3. 使用虚拟 scroll 组件。相对于原生滚动,可能会出现性能问题。

结合当前应用场景,使用方案 2 来处理页面滚动

文件树

explorer/src/app/path/[[...path]]/layout-content.tsx
explorer/src/app/path/[[...path]]/layout.tsx
explorer/src/app/path/[[...path]]/page.tsx
explorer/src/app/path/layout.tsx

文件路径:explorer/src/app/path/[[...path]]/layout-content.tsx

当点击时,记录当前滚动条的位置,用于返回时恢复滚动条

'use client'
import React, { useEffect, useRef } from 'react'
import { Layout } from 'antd'
import { usePathname } from 'next/navigation'

const height_map = new Map()

const LayoutContent: React.FC<React.PropsWithChildren> = ({ children }) => {
  const ref = useRef<HTMLDivElement>(null)
  const pathname = usePathname()

  useEffect(() => {
    const scroll_top = height_map.get(pathname) || 0

    if (scroll_top) {
      ref.current?.scrollTo(0, scroll_top)
    }
  }, [pathname, ref])

  return (
    <Layout.Content
      ref={ref}
      style={{
        overscrollBehavior: 'contain',
        overflowY: 'scroll',
      }}
      onClick={(e) => {
        height_map.set(pathname, e.currentTarget.scrollTop)
      }}
    >
      {children}
    </Layout.Content>
  )
}

export default LayoutContent

文件路径:explorer/src/app/path/[[...path]]/layout.tsx

将之前的面包屑组件移至上一层的 layout 中

import React from 'react'
import { readdir } from '@/explorer-manager/src/main.mjs'
import { PathContextProvider } from '@/app/path/context'
import LayoutFooter from '@/app/path/[[...path]]/layout-footer'
import LayoutContent from '@/app/path/[[...path]]/layout-content'

const Layout: React.FC<React.PropsWithChildren & { params: { path: string[] } }> = ({
  children,
  params: { path = [] },
}) => {
  const readdirList = readdir(path.join('/'), { only_dir: '0', only_file: '0', has_file_stat: '1' })

  return (
    <PathContextProvider value={readdirList}>
      <LayoutContent>{children}</LayoutContent>

      <LayoutFooter />
    </PathContextProvider>
  )
}

export default Layout

文件路径:explorer/src/app/path/layout.tsx

接管面包屑的 layout 组件,并添加 flex 的 css 属性。用于实现内部滚动

import React from 'react'
import ExplorerBreadcrumb from '@/components/explorer-breadcrumb'
import { Card } from 'antd'

const Layout: React.FC<React.PropsWithChildren> = ({ children }) => {
  return (
    <Card
      bordered={false}
      title={<ExplorerBreadcrumb />}
      style={{ height: '100%', display: 'flex', flexDirection: 'column' }}
      bodyStyle={{ padding: '16px 0 0 0', display: 'flex', flexDirection: 'column', flex: 1, overflow: 'hidden' }}
    >
      {children}
    </Card>
  )
}

export default Layout

效果

截屏2023-12-13 16.40.30.png

git-repo

yangWs29/share-explorer

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,634评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,951评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,427评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,770评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,835评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,799评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,768评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,544评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,979评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,271评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,427评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,121评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,756评论 3 324
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,375评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,579评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,410评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,315评论 2 352

推荐阅读更多精彩内容