--- title: 元素可见 order: 16 --- 当需要监测一个元素是否出现在可见区域时(比如列表滚动时是否曝光),可以通过 `` 组件来监测指定元素是否当前可见或者消失。 :::tip 小程序端不支持该能力。 ::: ## 安装组件依赖 `` 组件并不是内置组件,需要通过安装 `@ice/appear` 来引入。 ```bash $ npm i @ice/appear --save ``` ## 当元素进入可见状态时 ```jsx import VisibilityChange from '@ice/appear'; export default function Home() { return ( { console.log('onAppear') }} > show something ) } ``` ### 元素首次可见 有时候我们只需要元素首次可见的时机,例如发送曝光埋点,我们可以通过实现一个 `useOnce` 的自定义 `hook` 来实现: ```ts title="src/pages/home.tsx" import { useState } from 'react'; import VisibilityChange from '@ice/appear'; // 示例代码 function useOnce(fn) { const [called, setCalled] = useState(false); return (...args) => { if (!called) { setCalled(true); return fn(...args); } }; } export default function Index() { const handleAppearOnce = useOnce(() => { console.log('The first time view appeared.'); }); return (

Hello ice.js 3

); } ``` ## 当元素进入不可见状态时 ```jsx title="src/pages/home.tsx" import VisibilityChange from '@ice/appear'; export default function Home() { return ( { console.log('onDisappear') }} > show something ) } ``` :::caution 请注意,当元素使用 `transform` 等非触发 DOM 布局变更的行为使元素移动时,本组件的行为可能会失效。 :::