React单页应用自定义页面离开确认弹框的方法

问题描述

项目技术栈是react+ant-design;

产品需求是在某个页面表单有信息输入或变更,用户未保存要离开该页面时,自定义提示用户提示,如果用户确认离开则跳转到新页面,否则留在当前页。

需求UI-已实现的.jpg

思考

在react单页应用中,需要根据用户的选择来是否跳转页面,也就是需要阻塞浏览器的页面跳转,类似<a>标签点击后的return false效果,待到用户操作后再执行后续操作。

首先,能想到的是浏览器的window.confirm方法,在交互上完全符合需求,那么自定义需求呢?经过查阅资料发现,目前主流浏览器都不支持该方法样式的自定义,因此放弃。

其次,就是react的方案,react中,控制页面路由的是react-router,若官方提供了这种能力便是更好的。于是,我查阅了其官方文档:http://react-guide.github.io/react-router-cn/docs/API.html、或者https://reacttraining.com/react-router/core/api/Prompt、中文版https://segmentfault.com/a/1190000014294604?utm_source=tag-newest

关键文档

由于项目中使用的是react-router-v4,所以直接查看最新的API(如果是较老版本有比较简单的实现,可参考https://blog.csdn.net/ISaiSai/article/details/53908903

一、Prompt组件

import { Prompt } from 'react-router-dom';
....
render(){
  return(
      <Prompt message="确定要离开?"  when={true}/>
  )
}

如上代码,可以使用react-router-dom的Prompt,在JSX的任意render方法中(不仅仅是在router组件中)都可以使用,使用后当前页面组件离开就会给用户提示信息,默认弹框为浏览器的window.confirm弹框。

  1. message: string
    当用户离开当前页面时,设置的提示信息。
    <Prompt message="确定要离开?" />
  2. message: func
    当用户离开当前页面时,设置的回掉函数,返回 true 时允许直接跳转
    <Prompt message={location => (
    Are you sue you want to go to ${location.pathname}?
    )} />
  3. when: bool
    通过设置一定条件要决定是否启用 Prompt,属性值为true时启用防止转换;

二、Router组件的getUserConfirmation方法

用于确认导航的函数,默认使用 window.confirm。例如,当从 /a 导航至 /b 时,会使用默认的 confirm 函数弹出一个提示,用户点击确定后才进行导航,否则不做任何处理。需要配合 <Prompt> 一起使用。

const getConfirmation = (message, callback) => {
  const allowTransition = window.confirm(message);
  callback(allowTransition);
}

<BrowserRouter getUserConfirmation={getConfirmation} />

实现方案

中心思想:阻塞页面,等待用户操作后异步处理页面跳转(router变更)。

探索一:Prompt既然是组件,那么在组件内使用state变更的方式去render是否可行?

尝试如下代码:

...
<Prompt
   message = {(location)=>{
     return this.state.customPromt,
     }
   }
  />
...

实践证明这是不行的,prompt组件的message方法被同步调用了,不能达到阻塞页面跳转的效果。

探索二:尝试async/await

既然是要异步执行,那么就可以尝试async/await的异步处理方式,同步写。恰好message也可以是一个function。于是,新的尝试代码如下:

...
handlePrompt = async () => {
    const leaveConfirm = new Promise((res, rej) => {
        confirm({
            content: 'Are you sure?',
            onOk() {
                res(true);
            },
            onCancel() {
                res(false);
            },
        });
    });

    const leave = await leaveConfirm;
    return leave ;
}
...
<Prompt message={(location) => {this.handlePrompt} />
...

满怀期待,然后...还是不行。仔细查阅文档发现,message方法返回的是一个字符串或者true,返回字符串则调用浏览器默认的prompt方法阻塞页面跳转,和直接使用window.prompt同效果,不符合需求;返回true则直接跳转。

message: func

Will be called with the next location and action the user is attempting to navigate to. Return a string to show a prompt to the user or true to allow the transition.

以上尝试代码,虽然添加了异步方法,也会执行异步函数,但是始终会跳转页面,经查原因为:https://github.com/ReactTraining/react-router/issues/6669

探索三:getUserConfirmation方法,https://github.com/ReactTraining/history#customizing-the-confirm-dialog

前两种方案都失败了,那么再次阅读文档发现,getUserConfirmation方法就是提供给我们自定义用的,默认情况下,当页面使用了prompt组件后,调用的getUserConfirmation方法是浏览器默认的window.prompt。如果需要自定义,直接覆盖即可。

简单示例代码如下:

const getConfirmation = (message, callback) => {
  const allowTransition = window.confirm(message);
  callback(allowTransition);
}

<BrowserRouter getUserConfirmation={getConfirmation} />

ps:注意该方法需要写在BrowserRouter 或 MemoryRouter 上。

那么接下来的问题,就是将自定义的或者其他UI组件融合到该方法内。
已实现的代码如下:

import { Modal } from 'antd';
...
function getConfirmation(message, callback) { // 至关重要的callback方法,可以异步执行
    if (!G.pageChangeConfirm) { // G.pageChangeConfirm为页面内的全局变量,用于数据交互与条件判断
        callback(true);
        return;
    }
    Modal.confirm({
        title: '离开该页面,表单信息将不被保留?是否确定离开该页面?',
        content: '',
        okText: '离开',
        cancelText: '取消',
        onOk() {
            callback(true);
        },
        onCancel() {
            callback(false);
        },
    });
}

ReactDOM.render((
    <BrowserRouter
        getUserConfirmation={getConfirmation}
    >
        <App />
    </BrowserRouter>
    , document.getElementById('react-wraper')
);
...

探索四:查看GitHub的issue,查找其他解决方案

花了半天时间,在issue中找到了这个帖子https://github.com/ReactTraining/react-router/issues/4635,感兴趣的可以看下讨论过程。其中提到了两种解决方案:

  1. getUserConfirmation,类似我上方的解决方案,可运行的完整参考代码:https://codepen.io/pshrmn/pen/MpOpEY

  2. history.block,利用history的API,需要withRouter包装,传送门:https://github.com/ReactTraining/react-router/issues/4635#issuecomment-297828995

探索五:阅读源码,https://unpkg.com/react-router-dom@5.0.1/umd/react-router-dom.js,该部分工作没有做完,感兴趣的可以先研究研究,这里先把代码拿出来。

结论:有至少2种方法可以实现prompt自定义,getUserConfirmation和history.block,如果您有更好的解决方案,期待您的反馈。

最后:以上方法页面刷新时无效,那么刷新页面怎么实现类似功能呢?

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

推荐阅读更多精彩内容