React文字展開收起組件的實(shí)現(xiàn)示例

更新時(shí)間：2022年07月13日 10:06:02 作者：小黑豆豆

本文主要介紹了React文字展開收起組件的實(shí)現(xiàn)示例，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

前言

最近想把在項(xiàng)目中封裝的一些公用組件奉獻(xiàn)出來(lái)，畢竟獨(dú)樂(lè)樂(lè)不如眾樂(lè)樂(lè)，好東西就要大家分享。這次還是來(lái)聊實(shí)戰(zhàn)，主題就是文字展開收起組件的實(shí)現(xiàn)過(guò)程，這個(gè)需求在前端項(xiàng)目中也算常見的需求了，可能你已經(jīng)在項(xiàng)目中使用了自己或別人封裝的組件，但是這次還是希望你能耐心地看看我的實(shí)現(xiàn)過(guò)程，畢竟多一個(gè)思路也會(huì)讓你在后續(xù)的工作中游刃有余。

背景

老規(guī)矩，實(shí)戰(zhàn)項(xiàng)目必有背景。那還是先來(lái)聊聊這個(gè)文字展開收起組件產(chǎn)生的需求背景，需求其實(shí)就是要你把多余的文字省略顯示，然后有展開收起的按鈕可以操作。對(duì)，就是這么直白，上圖：

上圖是文字收起的圖示，超過(guò)一定的字?jǐn)?shù)那就收起省略顯示，并出現(xiàn)查看全部按鈕。

上圖顯示的就是操作了查看全部按鈕之后，文字需要全部顯示出來(lái)并有收起按鈕。還是來(lái)看一張gif圖的顯示最后該組件完成后的效果，如下圖：

開發(fā)

該組件還是使用React+typescript的技術(shù)棧，所以還是之前的老話，如果不是此技術(shù)棧的同學(xué)就只有參考實(shí)現(xiàn)思路，后續(xù)待不忙時(shí)再來(lái)提供其他技術(shù)棧對(duì)應(yīng)的版本。

文字展開收起組件的開發(fā)就沒有啥思考的點(diǎn)，就只需要在做的時(shí)候考慮一定字?jǐn)?shù)這個(gè)問(wèn)題，超過(guò)它截取文字并加上...，然后展開時(shí)展示所有文字即可，其它的操作基本是常規(guī)操作。話不多說(shuō)，直接往下看→

1.1 定義組件所需字段

interface IndexProps {
    content: string;    // 文本內(nèi)容
    maxLen?: number;   // 文字最大顯示長(zhǎng)度
    expandText?: string; // 展開按鈕文字
    collapseText?: string; // 收起按鈕文字
    contentRender: (text: string, handler: React.ReactNode) => React.ReactNode; // 自定義內(nèi)容
    onExpand?: (expanded: boolean) => void; // 展開、收起后觸發(fā)
}

可以看到文字展開收起組件需要用到上述6個(gè)字段，其中content，contentRender是必須傳入的，否則組件會(huì)報(bào)錯(cuò)，其他字段皆為可選字段，需要時(shí)就傳入不需要就會(huì)使用組件定義的默認(rèn)值。

1.2 獲取截?cái)嗪蟮奈淖?/h3>

獲取截?cái)嗪蟮奈淖?，其?shí)是根據(jù)字段maxLen來(lái)自動(dòng)獲取，maxLen設(shè)置的默認(rèn)值為300，即超過(guò)300個(gè)文字之后就會(huì)被截?cái)唷?code>maxLen的值是可以修改的，若你設(shè)置為200，即文字超過(guò)200就會(huì)被截取，故其為可選字段。代碼如下：

/**
 * 獲取截?cái)嗪蟮奈淖?
 * @param text
 */
const getText = (text: string): string => {
    return (text || '').slice(0, maxLen) + '...'
}

1.3 獲取展開收起按鈕

細(xì)心的小伙伴可以從1.1定義的字段中可以看到，其中contentRender這個(gè)字段代表的意思為自定義內(nèi)容，即該組件的內(nèi)容是可以自定義的。因?yàn)樵谠O(shè)計(jì)的時(shí)候，就考慮到該組件應(yīng)用的場(chǎng)景可能有點(diǎn)多，所以希望它是可以根據(jù)不同的需求場(chǎng)景來(lái)進(jìn)行自定義的，所以該組件的render內(nèi)容就只有此方法，如下：

return (
    <>{contentRender(body, getExpandBtn())}</>
)

contentRender方法其實(shí)接收兩個(gè)參數(shù)：text代表文本內(nèi)容，其實(shí)就是傳入的content，只不過(guò)它會(huì)根據(jù)判斷條件判斷是否被截??；在組件加載時(shí)，就會(huì)對(duì)其進(jìn)行如下判斷：

useEffect(() => {
    let contentBody = content || '';
    if (contentBody.length > maxLen) {
        contentBody = getText(contentBody);
        setShowBtn(true);
    }
    setBody(contentBody);
    return () => {
        setExpanded(false);
        setShowBtn(false);
    }
}, [content]);

通過(guò)上述代碼可以獲取到需要渲染的文本內(nèi)容，然后將其賦值給body，即它就是contentRender方法接收的第一個(gè)參數(shù)。

而第二個(gè)參數(shù)handler其實(shí)就是這里將要說(shuō)的，獲取展開收起按鈕的方法。如下：

/**
 * 獲取展開收起按鈕
 * @param status
 */
const getExpandBtn = (): React.ReactNode => (
    showBtn ? (
        <span
            className="custom-text-expanded-handler"
            onClick={() => expandToggle(!expanded)}
        >{expanded ? collapseText : expandText}
        </span>
    ) : null
)

從上可以看到，所謂的自定義其實(shí)就是我們可以對(duì)參數(shù)text進(jìn)行自定義，可以將其使用div包裹，或者對(duì)其樣式進(jìn)行自定義皆是可以的。而在我們的項(xiàng)目中，則是又寫一個(gè)名詞解釋組件對(duì)其自定義，名詞解釋組件可在下篇文章中簡(jiǎn)述。

1.4 展開收起邏輯

所謂的展開收起邏輯其實(shí)就是讓文字省略展示或者全部展示，而在這個(gè)過(guò)程中可以使用暴露出去的onExpand方法做其他邏輯操作，代碼如下：

/**
 * 展開、收起
 * @param status
 */
const expandToggle = (status: boolean) => {
    let text = status ? content : getText(content);
    setExpanded(status);
    setBody(text);
    onExpand(status);
}

1.5 完整代碼

好了，通過(guò)上述的簡(jiǎn)單介紹，組合代碼可以得到文字展開收起組件完整代碼。

1.5.1 邏輯代碼

創(chuàng)建index.tsx文件，并寫入如下所示代碼：

import * as React from 'react';
import {useEffect, useState} from "react";
import './index.scss';


interface IndexProps {
    content: string;    // 文本內(nèi)容
    maxLen?: number;   // 文字最大顯示長(zhǎng)度
    expandText?: string; // 展開按鈕文字
    collapseText?: string; // 收起按鈕文字
    contentRender: (text: string, handler: React.ReactNode) => React.ReactNode; // 自定義內(nèi)容
    onExpand?: (expanded: boolean) => void; // 展開、收起后觸發(fā)
}


/**
 * 自定義文字展開收起組件
 * @param props
 * @constructor
 */
const TextExpand = (props: IndexProps) => {
    const {
        content,
        maxLen = 300,
        expandText = '查看全部',
        collapseText = '收起',
        contentRender = (text: string, handler: React.ReactNode) => {},
        onExpand = (expanded: boolean) => {},
    } = props;
    const [body, setBody] = useState<any>(null);
    const [expanded, setExpanded] = useState<boolean>(false);
    const [showBtn, setShowBtn] = useState<boolean>(false);


    useEffect(() => {
        let contentBody = content || '';
        if (contentBody.length > maxLen) {
            contentBody = getText(contentBody);
            setShowBtn(true);
        }
        setBody(contentBody);
        return () => {
            setExpanded(false);
            setShowBtn(false);
        }
    }, [content])


    /**
     * 獲取截?cái)嗪蟮奈淖?
     * @param text
     */
    const getText = (text: string): string => {
        return (text || '').slice(0, maxLen) + '...'
    }


    /**
     * 獲取展開收起按鈕
     * @param status
     */
    const getExpandBtn = (): React.ReactNode => (
        showBtn ? (
            <span
                className="custom-text-expanded-handler"
                onClick={() => expandToggle(!expanded)}
            >{expanded ? collapseText : expandText}
            </span>
        ) : null
    )


    /**
     * 展開、收起
     * @param status
     */
    const expandToggle = (status: boolean) => {
        let text = status ? content : getText(content);
        setExpanded(status);
        setBody(text);
        onExpand(status);
    }


    return (
        <>{contentRender(body, getExpandBtn())}</>
    )
}

export default TextExpand;

1.5.2 樣式代碼

創(chuàng)建index.scss文件，同樣寫入如下代碼即可:

.custom-text-expanded-handler {
    margin-left: 6px;
    color: #545FD6;
    &:hover {
        color: #1890ff;
        cursor: pointer;
    }
}

1.6 安裝使用組件

組件寫好，那就來(lái)使用它。該組件已經(jīng)發(fā)布到npm上了，所以小伙伴們可以到npm上查看并下載，也可以通過(guò)如下命令進(jìn)行安裝使用：

npm i react-text-expand-collapse 或 yarn add react-text-expand-collapse

安裝好之后，在項(xiàng)目中引用使用：

// 引入組件
import TextExpand from 'react-text-expand-collapse/src/index';

// 使用
<div style={{
  width: 500,
  margin: '10px auto 0',
  color: '#333',
  fontSize: '12px',
  textAlign: 'left',
  backgroundColor: '#fff'
}}>
  <TextExpand
    content={str}
    maxLen={100}
    contentRender={(text: string, handler: any) => {
      return (
          <>
            <span>{text}</span>
            {handler}
          </>
      )
    }}
  />
</div>

最后實(shí)現(xiàn)效果，如下圖：