Floating UI 使用经验分享 - Dialog

这篇具有很好参考价值的文章主要介绍了Floating UI 使用经验分享 - Dialog。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

上文:Floating UI 使用经验分享 - Popover

在本文中,我将分享如何使用 Floating UI 来创建另一种常见的浮动 UI 组件——Dialog(对话框)。Dialog 是一个浮动元素,显示需要立即关注的信息,他会出现在页面内容上并阻止与页面的交互,直到它被关闭。

它与弹出框有类似的交互,但有两个主要区别:

  • 它是模态的,并在对话框后面呈现一个背景,使后面的内容变暗,使页面的其余部分无法访问。
  • 它在视口中居中,不锚定到任何特定的参考元素。

一个可访问的对话框组件具有以下要点:

  • Dismissal:当用户按下 esc 键或在打开的对话框外按下时,它会关闭。
  • Role:元素被赋予相关的角色和 ARIA 属性,以便屏幕阅读器可以访问。
  • Focus management: 焦点完全被困在对话框中,必须由用户解除。

目标组件

目标:实现一个这样的 Dialog Demo 👇
Floating UI 使用经验分享 - Dialog,前端,笔记,ui,前端,javascript,react
接下来我们需要创建一个名为 Dialog 的 React 组件,它使用了 @floating-ui/react 库来创建一个可交互的浮动对话框。以下是对该组件的设想:

组件参数

Dialog 组件需要接受以下参数:

  • rootId:浮动元素的根元素,可选。
  • open:控制对话框是否打开的布尔值。
  • initialOpen:对话框初始是否打开的布尔值,默认为 false
  • onOpenChange:当对话框打开状态改变时的回调函数,接受一个布尔值参数。
  • render:一个函数,接受一个对象参数,该对象包含一个 close 方法,用于关闭对话框。该函数返回要在对话框中渲染的 React 节点。
  • className:应用于对话框的 CSS 类名。
  • overlayClass:应用于浮动覆盖层的 CSS 类名。
  • containerClass:应用于对话框容器的 CSS 类名。
  • isDismiss:一个布尔值,决定是否启用点击外部区域关闭对话框的功能,默认为 true
  • children:React 子元素,可以是一个按钮,点击后打开该弹窗。
  • showCloseButton:一个布尔值,决定是否显示关闭按钮,默认为 true

组件功能

Dialog 组件的主要功能是创建一个可交互的浮动对话框,它可以通过点击关闭按钮或点击对话框外部区域来关闭。对话框的打开和关闭状态可以通过 openonOpenChange 参数进行控制(受控),也可以通过内部状态进行自动管理(非受控)。

Dialog 组件使用了 @floating-ui/react 库的多个 Hook:

  • useFloating:用于管理对话框的打开和关闭状态。
  • useClickuseRoleuseDismiss:用于处理对话框的交互,如点击和角色管理。
  • useInteractions:用于获取和设置交互属性。

此外,Dialog 组件还使用了 FloatingPortalFloatingOverlayFloatingFocusManager 组件来创建浮动对话框的 UI。

完整代码

结合实际可以写出这样一个功能较为完整的 Dialog 案例,可以自定义遮罩层、内部元素的样式,也可以控制点击遮罩层是否关闭弹窗等,还可以结合 Framer-motion 制作弹窗动画等(以后有机会也写一篇)

import {  
  FloatingFocusManager,  
  FloatingOverlay,  
  FloatingPortal,  
  useClick,  
  useDismiss,  
  useFloating,  
  useInteractions,  
  useRole,  
} from '@floating-ui/react';  
import clsx from 'clsx';  
import React, { cloneElement, useState } from 'react';  
import { CgClose } from 'react-icons![](file:///C:\Users\34504\AppData\Roaming\Tencent\QQTempSys\3)6GH))S[9A2G57O0%MM45V.gif)';  
  
type DialogProps = {  
  rootId?: string;  
  open?: boolean;  
  initialOpen?: boolean;  
  onOpenChange?: (open: boolean) => void;  
  children?: JSX.Element;  
  render: (props: { close: () => void }) => React.ReactNode;  
  className?: string;  
  overlayClass?: string;  
  containerClass?: string;  
  isDismiss?: boolean;  
  showCloseButton?: boolean;  
};  
  
export default function Dialog({  
  initialOpen = false,  
  open: controlledOpen,  
  onOpenChange: setControlledOpen,  
  children,  
  className,  
  render,  
  rootId: customRootId,  
  overlayClass,  
  containerClass,  
  showCloseButton = true,  
  isDismiss = true,  
}: DialogProps) {  
  const [uncontrolledOpen, setUncontrolledOpen] = useState(initialOpen);  
  const open = controlledOpen ?? uncontrolledOpen;  
  const setOpen = setControlledOpen ?? setUncontrolledOpen;  
  
  const { reference, floating, context } = useFloating({  
    open,  
    onOpenChange: setOpen,  
  });  
  
  const click = useClick(context);  
  const role = useRole(context);  
  const dismiss = useDismiss(context, { enabled: isDismiss, outsidePressEvent: 'mousedown' });  
  
  const { getReferenceProps, getFloatingProps } = useInteractions([click, role, dismiss]);  
  
  const onClose = () => setOpen(false);  
  
  return (  
    <>  
      {children && cloneElement(children, getReferenceProps({ ref: reference, ...children.props }))}  
      <FloatingPortal id={customRootId}>  
        {open && (  
          <FloatingOverlay  
            className={clsx('absolute inset-0 z-10 flex h-full w-full items-center', overlayClass ?? 'bg-black/60')}  
            lockScroll  
          >  
            <div className={clsx('m-auto grid place-items-center', containerClass)}>  
              <FloatingFocusManager context={context}>  
                <div  
                  className={clsx('relative overflow-hidden rounded-md bg-white', className ?? 'mx-24')}  
                  ref={floating}  
                  {...getFloatingProps()}  
                >  
                  {showCloseButton && <CgClose className="absolute right-2 top-2 h-6 w-6 cursor-pointer" onClick={onClose} />}  
                  {render({ close: onClose })}  
                </div>  
              </FloatingFocusManager>  
            </div>  
          </FloatingOverlay>  
        )}  
      </FloatingPortal>  
    </>  
  );  
}

Basic Dialog Hooks

官方示例 👉 CodeSandbox demo

此示例演示如何创建用于单个实例的对话框以熟悉基础知识。

让我们看一下这个例子:

Open state

import {useState} from 'react';
 
function Dialog() {
  const [isOpen, setIsOpen] = useState(false);
}

isOpen 确定对话框当前是否在屏幕上打开。它用于条件渲染。

useFloating hook

useFloating hook

useFloating() hook为我们的对话提供上下文。我们需要传递一些信息:

  • open :来自我们上面的 useState() 挂钩的打开状态。
  • onOpenChange: 对话框打开或关闭时调用的回调函数。我们将使用它来更新我们的 isOpen 状态。
import {useFloating} from '@floating-ui/react';
 
function Dialog() {
  const [isOpen, setIsOpen] = useState(false);
 
  const {refs, context} = useFloating({
    open: isOpen,
    onOpenChange: setIsOpen,
  });
}

Interaction hooks

Interaction hooks

  • useClick() 添加了在单击引用元素打开或关闭对话框的功能。但是,对话框可能不会附加到引用元素,因此这是可选的。(一般对话框都是独立出来Portal的,也就是上下文是body)
  • useDismiss() 添加了当用户按下 esc 键或在对话框外按下时关闭对话框的功能。可以将其的 outsidePressEvent 选项设置为 'mousedown' 以便触摸事件变得懒惰并且不会穿过背景,因为默认行为是急切的。(不太好理解,大概是)
  • useRole()dialog 的正确 ARIA 属性添加到对话框和引用元素。

最后, useInteractions() 将他们所有的 props 合并到 prop getters 中,然后就可以用于渲染。

import {
  // ...
  useClick,
  useDismiss,
  useRole,
  useInteractions,
  useId,
} from '@floating-ui/react';
 
function Dialog() {
  const [isOpen, setIsOpen] = useState(false);
 
  const {refs, context} = useFloating({
    open: isOpen,
    onOpenChange: setIsOpen,
  });
 
  const click = useClick(context);
  const dismiss = useDismiss(context, {
    outsidePressEvent: 'mousedown',
  });
  const role = useRole(context);
 
  // Merge all the interactions into prop getters
  const {getReferenceProps, getFloatingProps} = useInteractions([
    click,
    dismiss,
    role,
  ]);
 
  // Set up label and description ids
  const labelId = useId();
  const descriptionId = useId();
}

Rendering

Rendering

现在我们已经设置了所有的变量和hook,可以渲染我们的元素了。

function Dialog() {
  // ...
  return (
    <>
      <button ref={refs.setReference} {...getReferenceProps()}>
        Reference element
      </button>
      {isOpen && (
        <FloatingOverlay
          lockScroll
          style={{background: 'rgba(0, 0, 0, 0.8)'}}
        >
          <FloatingFocusManager context={context}>
            <div
              ref={refs.setFloating}
              aria-labelledby={labelId}
              aria-describedby={descriptionId}
              {...getFloatingProps()}
            >
              <h2 id={labelId}>Heading element</h2>
              <p id={descriptionId}>Description element</p>
              <button onClick={() => setIsOpen(false)}>
                Close
              </button>
            </div>
          </FloatingFocusManager>
        </FloatingOverlay>
      )}
    </>
  );
}
  • {...getReferenceProps()} / {...getFloatingProps()} 上一篇说过,将 props 从交互挂钩传播到相关元素上。它们包含诸如 onClickaria-expanded 等道具。
FloatingPortal & FloatingOverlay & FloatingFocusManager
  • <FloatingOverlay /> 是一个在浮动元素后面渲染背景覆盖元素的组件,具有锁定主体滚动的能力。 FloatingOverlay docs
    • 提供了一个固定的基本样式,使背景内容变暗并阻止浮动元素后面的指针事件。
    • 它是一个常规的 <div/>,因此可以通过任何CSS解决方案进行样式设置。
  • <FloatingFocusManager />
    • FloatingPortal docs 一个管理和控制页面中浮动元素焦点的组件
    • 自动检测焦点变化,调整页面上的浮动元素的位置和状态,确保页面上所有元素的可访问性和可用性。
    • 默认情况通常将焦点捕获在内部
    • 它应该直接包裹浮动元素,并且只在对话框也被渲染时才被渲染。 FloatingFocusManager docs
      • <FloatingPortal />将浮动元素传送到给定的容器元素中——默认情况下,在应用程序根之外并进入 body。
      • 可以自定义 root,也就是可选择具有 id 的节点,或者创建它并将其附加到指定的根(body)
import {FloatingPortal} from '@floating-ui/react';
 
function Tooltip() {
  return (
    isOpen && (
      <FloatingPortal>
        <div>Floating element</div>
      </FloatingPortal>
    )
  );
}

本文Hexo博客链接🔗 https://ysx.cosine.ren/floating-ui-experience-dialog
xLog链接🔗 https://x.cosine.ren/floating-ui-experience-dialog
RSS订阅 📢 https://x.cosine.ren/feed/xml文章来源地址https://www.toymoban.com/news/detail-607422.html

到了这里,关于Floating UI 使用经验分享 - Dialog的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 图书管理系统:从数据库设计到前端展示的实战经验分享

    ✍✍计算机编程指导师 ⭐⭐个人介绍:自己非常喜欢研究技术问题!专业做Java、Python、微信小程序、安卓、大数据、爬虫、Golang、大屏等实战项目。 ⛽⛽实战项目:有源码或者技术上的问题欢迎在评论区一起讨论交流! ⚡⚡ Java实战 | SpringBoot/SSM Python实战项目 | Django 微信小

    2024年01月16日
    浏览(42)
  • 手记系列之五 ----- SQL使用经验分享

    CASE WHEN  意义: If(a==b) a=c; 用法:  1, CASE 字段 WHEN 字段结果1 THEN 字段显示结果1 WHEN 字段结果2 THEN 字段显示结果2 END  2, CASE WHEN 字段1=字段结果1 THEN 字段显示结果1 WHEN 字段2=字段结果2 THEN 字段显示结果2 END  意义: if(a==null) a=0; MySQL:IFNULL 用法:IFNULL(字段,0)别名 Oracle:NVL 用法:N

    2024年02月08日
    浏览(41)
  • 【经验分享】如何使用VSCode对比两个文件

    当有两个不同版本的文件,如何使用VSCode对比两个文件 长按 ctrl 选择想要对比的两个文件-----右键选择 将已选项进行比较 ----大功告成 大功告成

    2024年02月07日
    浏览(59)
  • 手记系列之七 ----- 分享Linux使用经验

    本篇文章主要介绍的关于本人在使用Linux记录笔记的一些使用方法和经验,温馨提示,本文有点长,约1.7w字,几十张图片,建议收藏查看。 tail -500f catalina.out ctrl+c 或kill -9 pid 临时快捷键设置: 执行XShell,输入 : alias \\\'aa=cd /etc/sysconfig\\\' , aa: 快捷键名称 永久快捷键设置: 首先输入你

    2024年02月06日
    浏览(48)
  • 使用Unity开发手机AR项目经验分享

           AR技术发展到现在也不新鲜了,开发AR的SDK也是五花八门,怎么选择是个问题。这篇文章提供了一套整体开发AR思路,还有后续兼容性问题的解决思路。         Unity开发手机AR项目主要是集成的ARCore和ARKit,ARCore面向Android手机而ARKit面向IOS,从Unity2019后Unity官方使用

    2024年02月11日
    浏览(50)
  • 手记系列之六 ----- 分享个人使用kafka经验

    本篇文章主要介绍的关于本人从刚工作到现在使用kafka的经验,内容非常多,包含了kafka的常用命令,在生产环境中遇到的一些场景处理,kafka的一些web工具推荐等等。由于kafka这块的记录以及经验是从我刚开始使用kafka,从2017年开始,可能里面有些内容过时,请见谅。温馨提

    2024年02月08日
    浏览(45)
  • Matlab 使用经验分享(常用函数介绍;矩阵常见计算)

    大家好!最近有很多朋友询问我关于 Matlab 的使用,于是我决定写一篇博客来分享一下我的经验。对于数学和编程爱好者来说,Matlab 是一个非常有用的工具。我自己在数学实验和数学建模竞赛中也经常使用它。那么,为什么 Matlab 这么受欢迎呢? MATLAB 是美国MathWorks 公司自2

    2024年02月10日
    浏览(41)
  • ARM DMA Controller PL330 使用经验分享

    DMAC提供一个AXI主接口来执行DMA传输,并提供两个APB从接口来控制其操作。DMAC采用TrustZone技术,其中一个APB接口运行在secure状态,另一个运行在非secure状态。 secure策略是ARM的TrustZone技术一部分。 整个DMA操作受一个小的指令集控制,这是与传统链表BD模式的不同之处。 由图中可

    2024年02月05日
    浏览(33)
  • vue中使用el-dialog设置弹窗对话框在前端显示为居中

    废话不多直接上图

    2024年02月01日
    浏览(45)
  • Vue中使用element-ui el-dialog弹窗最大化还原,拖拽,动态改变大小

    创建对应的js文件   先在指定稳定文件创建js文件,如src下创建diaLog.js文件,部分会提示红色爆红,可以不予理会,可以根据需求修改,如:弹框可拉伸最小宽高。   2. 在main.js的引用   同时为了防止冲突,需要关闭closeOnClickModal(弹窗默认点击遮罩改为不关闭),并添加标签

    2024年02月11日
    浏览(48)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包