From 4fcf7b889b27b14db779d717c2e3e684d0845198 Mon Sep 17 00:00:00 2001
From: MiniPear <pearminipro@gmail.com>
Date: Tue, 30 May 2023 17:34:16 +0800
Subject: [PATCH] feat(interaction): emit legend filter

---
 .../api-chart-emit-legend-filter.spec.ts      |  56 +++++++++++--
 .../api/chart-emit-legend-filter/step0.png    | Bin 8759 -> 9916 bytes
 .../api/chart-emit-legend-filter/step1.png    | Bin 0 -> 11296 bytes
 .../plots/api/chart-emit-legend-filter.ts     |  75 ++++++------------
 site/docs/spec/interaction/legendFilter.zh.md |  28 +++++++
 site/examples/component/legend/demo/custom.ts |  30 ++++---
 src/interaction/legendFilter.ts               |  59 +++++++++++---
 7 files changed, 165 insertions(+), 83 deletions(-)
 create mode 100644 __tests__/integration/snapshots/api/chart-emit-legend-filter/step1.png

diff --git a/__tests__/integration/api-chart-emit-legend-filter.spec.ts b/__tests__/integration/api-chart-emit-legend-filter.spec.ts
index cdc38fde84..9b5b6a1f61 100644
--- a/__tests__/integration/api-chart-emit-legend-filter.spec.ts
+++ b/__tests__/integration/api-chart-emit-legend-filter.spec.ts
@@ -2,27 +2,67 @@ import { chartEmitLegendFilter as render } from '../plots/api/chart-emit-legend-
 import { createNodeGCanvas } from './utils/createNodeGCanvas';
 import { sleep } from './utils/sleep';
 import { kebabCase } from './utils/kebabCase';
+import { createPromise, dispatchFirstShapeEvent } from './utils/event';
 import './utils/useSnapshotMatchers';
+import './utils/useCustomFetch';
+import { LEGEND_ITEMS_CLASS_NAME } from '../../src/interaction/legendFilter';
 
 describe('chart.emit', () => {
   const dir = `${__dirname}/snapshots/api/${kebabCase(render.name)}`;
   const canvas = createNodeGCanvas(800, 500);
-  let chart;
 
-  it('chart.emit("legend:filter", options) should filter channel', async () => {
-    const values = render({
+  it('chart.on("legend:filter") should receive expected data.', async () => {
+    const { chart, finished } = render({
       canvas,
       container: document.createElement('div'),
     });
-    chart = values.chart;
-    await values.finished;
+    await finished;
     await sleep(20);
 
-    // Click legend item.
-    const [item] = values.items;
-    item.dispatchEvent(new CustomEvent('click'));
+    // chart.emit('legend:filter', options) should trigger slider.
+    chart.emit('legend:filter', {
+      data: { channel: 'color', values: ['Sports', 'Strategy'] },
+    });
     await sleep(20);
     await expect(canvas).toMatchCanvasSnapshot(dir, 'step0');
+
+    // chart.emit('legend:end', options) should reset.
+    chart.emit('legend:end', {});
+    await sleep(20);
+    await expect(canvas).toMatchCanvasSnapshot(dir, 'step1');
+
+    chart.off();
+
+    // chart.on("legend:end") should be called.
+    const [end, resolveEnd] = createPromise();
+    chart.on('legend:end', (event) => {
+      if (!event.nativeEvent) return;
+      resolveEnd();
+    });
+    dispatchFirstShapeEvent(canvas, LEGEND_ITEMS_CLASS_NAME, 'click', {
+      nativeEvent: true,
+    });
+    dispatchFirstShapeEvent(canvas, LEGEND_ITEMS_CLASS_NAME, 'click', {
+      nativeEvent: true,
+    });
+    await sleep(20);
+    await end;
+
+    // chart.on("legend:filter") should receive expected data.
+    const [filter, resolveHighlight] = createPromise();
+    chart.on('legend:filter', (event) => {
+      if (!event.nativeEvent) return;
+      expect(event.data).toEqual({
+        channel: 'color',
+        values: ['Strategy', 'Action', 'Shooter', 'Other'],
+      });
+      resolveHighlight();
+    });
+    dispatchFirstShapeEvent(canvas, LEGEND_ITEMS_CLASS_NAME, 'click', {
+      nativeEvent: true,
+    });
+    await sleep(20);
+    await filter;
   });
 
   afterAll(() => {
diff --git a/__tests__/integration/snapshots/api/chart-emit-legend-filter/step0.png b/__tests__/integration/snapshots/api/chart-emit-legend-filter/step0.png
index aa0752c1ae844abb2b6c1f8b89ddb4f7795e37fe..2c261813da22468a363a5f377ec976dba8890aff 100644
GIT binary patch
literal 9916
zcmeHtcTiJnzwSx`N$4Ob3MkT1s?v*qv0x~oC?Gv<L<lWW>CHr=ZZ`rNq)3&m!bYm}
z&Js4FB1L*nvMnH?L?RF=;jHZMoS8fKp1E_*AK%>j&74UlnY`;=Z~2wyd46x!{c~rn
zMFeF80RRxeo;m3V0B{lj!02cs)MD^)>NE6({KeM#B(TGKJ#8sW0f2)5_T=%4k=cvW
z5g8uCm)E~9=ll+bV-G&$`(641#qO28x^@QcHoH*)fBrR}9O_I*(qjEXPU2sDYS$FV
zQq}|+)ynFoF;&BQ+yfX&7mg_S^Y>qq_|Cuu@J@wO>&Z7<WZo2~KK$By#+25_{!n#e
zx#7!HQ&q&x8@*Zwu~g;%?z{8ww@`l5gD_FP(};4QFQV48;n&NubrU77Re~w1_A(br
zon1o1!h$1}*j_icSD!hTTza+idxExGy32O$g_T9Z%}vm))UeUHxaDZv#*f4{CbPUP
zeyBhH#Axes+_F3EonUQ8&8SyX%&SZ0zk6s)2i8m^3>G?goA-wvS(L=e*cA=#_OHqZ
z{Ya0%qd3eO+Xm+=G^!_{4i~E?K5-AUovbenV}3RaPQNdymV2q_qQ#SfZyxkFTK1L^
zOH)`ZRjSY-k8Ab9u_1JQI-+eqCyHwj=Tp|YF`w_#m9%YF<F+5Vp%Rm?n_pPy=L+>(
z*<$y3yB1y4_N)t;E(N!oORKKYsso-(1};rC_(>;p;=yik9+OWz=itznf~9&)4-XHI
zZfypwT0DB5^YQFHz>hn<5n8cA;C}D#sR_#EFM)9d&ybI@3c(l>p{C+D0{m{p{>%6`
z&u*Zm-!xeFjEw|OjWh<Y8wMB8%*-5LKjq>w`c!MY#%(bNpJ|b){O()ODL^y5oA7ct
z-~<WfT<*2Kj*^cht|kt1630gtCnIQaeejX&h?%IH{LicW`m~c}4CWo~3GW-2?_-}%
z+$>1#o*s$opPY>G$SfEPsF_IByZRv#jqA-eiAn4J;xNKoO(1KqUsfqEeh7aL)bC$I
zI!oM=u;Q;rjvbTbs<WgNG(}J$moMP<ipKI8i(bk~+;Mddw_wQ;RV&cOx&0zda+iQD
zLtSJfjN^c@J>`X*d?QKHlbNq|InhG+Fu!r0ex}`UMsN#9`WXW6<)1-bB+FOgy@k~l
zl8s;va9dIrsWoV8x9jvSIvdO`5pBrO^Xtt8U#&)O>vjI}y||^N1r;6^b__-A5HVV)
zjb5FnA(L#WSDZ2nj^Q&4AX7bnVmmiC_Y3&;g>AY8dh2CfT|{Jy7mc&;4E6IHcCXp8
z9{`OaJrYo(mZEGTvRBCb$K12zc%P9H*VX1)EiAQVP=A`!)cTofdzk&Tr%Ba*klV+b
zoCFO^gP(?sgetJlT1!;M4rm2+lYF60X8G4>%Gm1{sLHd@<vJCtqy6BId)wV}-@cj1
zM{3&->XBs&?X$uO2R0Ad53VDOR_|Go*nO5aeF=o+HdXA(m!+kpb^UD%)TCPHSwgaM
zjcq<J-p$At&<a-sbsrJqr*^J>xrbPWbMN;1MjNuyN){BKipI*+3ua{Yh%w~3_sFuO
znV@5AavmTp2_NtUb;z`L_{j~C+C(v<;nG(#LL@PXTN7OZoAeW4J?v{1X3mYP$kMTr
zR$v`RKYS6yMOA)DR-`m<%M_R?%J!~q{dv71HafFFtS94$k85T@8{gSw9rvoMJ*R;3
zmbHn(LH(A3bLv~%UnP_dAeQW?SK_J4mRRcNgO~_Y$X$w0Td%yMI!FuNDIU<znV6oQ
z-r2X;MP16`oVwIkDA;t=u-8}4Tkj9E%biS9ewT9x!*~oCSR*<nrZ6-j!a;LSLSJ9T
zk!L$>yUYTDR;rD+PI|YCl;9m&h7n=ri2FoZPims9(GufL9Kx<>lqq>vM0Tz7mscDe
zD;ENRu(KQylvyCJooZtQ-NSFPboa!|;rVi{w&LQz^O*(3f_K_A?89ajEXI%5T2m(!
zYk_)kjuNJOCKA)%@SFYdq>>;Ng^Ve|?2~h+kL{j=jYzuv3_;9H=+ctO-hc*4gpyV#
zVwKqM7#?ZZlfE)mfxI2;Q&SX@xVogo_c{bKXQr+pe*}#6yV@;(*8foK!wMZ63d<y!
zIK!9*%PYSOk(<z)w-#n|f&z*@beloT*#Vy8H`x024p|0)&X?B~#(n9J-AYH|-l?RQ
zJTVNOxMlNVB{@M_r{I!i$RDH3)Hgz>ulD77o~3>sVszYF_Xr>NWi~Z7?oq*Bmleq)
zN4IdFm6esvsygIuDY7o+pBppl6JgHJyP>zvQ<dw6n5*Bh)L3)-!D1QAA+RS!%_08#
z)Qvt*YQZ<X7moN3xXGiJ#`pPUpAVig!e{2XYVIKv4F`0jD7y-oXB2#6a#aiLo~$H5
zQ?#1bTG|it?RC~pH>%qTD0MCtV{LBL#8I`%pG_)Z7p2^#S?9qj(4op@UxwXW=9Y(H
z&%oVp=?Ijh8|g5mY&bp;4J-EcaeY=U(c8VbA16lN9M^zCEiqAs8MiAxY<YaapnrGO
z34wf;CPsH*U9&<>fmP<em&WN^IZMAl38AHsbqHS!gHs^bJTag@4K2quCOUe<TFmTg
zhEEc-A|3dLY?B*4o_@XAKW$0OvZkfcw3@C1F%Rsh&sScH#S=eqZ3aW_^UwKj3G0Uh
zs@M;DwBdSk%+}TE<IooK;FdYZV#1?7zkQUFqCC!NDjQ|WGP9JiP{(%MWM%5)yI~ja
zV^Vw17Z3NobT016LjaIVzj9UG6q&W27*2a-#j7A5%ogBH8{JA<FCI=6C1}d}=PjWB
zVIm>A9sSR{3_+H<LjRA+I>t7aVpV@jJZ(Kd-Ap|4nh=voFliR$Xy&_z$}j>ZnuB@_
zMU@pOf0hF`ZT%PJj)I{~f&A~$nC`!vC}{(Q<WY29(fRReehdl1mHbXt5a!bRnoT47
z!3YSaCZlF^)|<A=OAMGloQj=W(hBe`5KP(`Mh#3)Z{J_Ye(kLnzs1>&&rE~T(R+R0
znZZ!oJo1!OLgy2FX2_PO_w{!wshIqVPTDH8`<lt9ao_Y(hrv*%8n>4CiE6xyeU{<k
zOUI(nz@m%MjViKrsZ`}CT?qMlGYyzwU6qbSKW3D%2X@|CTU0u=<?Z*4Q7-cQB@ov9
zh^S4=rG!i!0a2t$*@B<C3eOi{&9{jL!KwXUqK>dUG2JvQ<($z&5%37*#?;KIu|6@0
z#>>)@ZtqqqUj#3dPad~tzo0zbbjFY(V+^@g7^cmqSW7_rVD_@{UGaeOgF&NO;Ibr!
z;m%pry^dmJzn)o~?teWM%`APPVw;wI+MhiAhg<24r{*5ZFc5~?viA0-_24t(gCN$Y
zK@ik6%3M7^n|G7@9)fHUELD!(Lx{ie$-?y01HG3#zIbs-(`yPc<20ltEbIqUAlUh8
zfoRa!lVAjKPC{c-)4FD=O~U-@Mh29l<X>JzZsOP?wOZ~Iy>6wo*JzND<sly(hd_*w
zS>Q9j8oe|7G<ZONTa-0xEg$zIFFYcm50zGkj}D?L7pB>~(8y$(k5z_K79TwizhBBv
zv|#*|BmkOFgd|#DGYL<=(<sGW$%@r?S0iAaw#K82Eg+0?Q@FdTGDg6Kv(}VI<X_l}
zF`AvBB%EGToegoQZB9%K3oKh7MVDq5N@}lhOc|I*Uw^h*&v{uSROGeVptG(p8*{{^
zmVpCm)iP^M=|l^9@MKf|ZP&)oZ*$7n_^ILH)yPkrF8Q0W$6LJGipt9gKZc4f%mVAs
zav|N}=1o=h=2w>ztb;i~RB!}Ko$@TYxCddrHs&+R<5%)}0Y2Ia3Z`Gaet6OiqbfIK
zi7&w*)N4C4s9#r{1%t5XD3s+IDaudIK`95}zx89A7X-T;(^YrGut0rX+u7T}-8kRG
z&8zc6MY5JC$Wcy37h5MFjkaS_U*}wG5MO)!BlN58YEPyPguGT%<t_+1Pg9kdROO#j
zpWmhA1(&gLn^&yI4qzSqVg-yF2UEx1dD_&|`P)w^?g%dop5tbLcY@1Ol(7Ng?$Q-2
z>$)s~_U)ZFyF$o=H!t_hj)iXSg@pDZ<~_x^E#Lmry<M~HLY4on^u`V(@x*udmBF1>
zLJ&1gI=t}!wbsG+?ZfY*+s6k+zeS%JNcz41o8TF$a#4#g2@>~@jsP}P<x_6}bx8N_
zLp)W+I$rtz`NE+Zf0G!vG(wWR3VMQaPmyx)*k=4jIgmig2fIj;B#Wm;SuW7VOz=)X
zw&+C?4RIHij#x&9AlFd2KzzUMcICqC6-;Ea@R%4!j-|}Ho-hv?`nhW9Jlx{0_}U1(
zo4iTxsH}WN0XU%@fpN~^GAvJ=NQHRhUgL&SVbIV6fZH&9Y^>7^ZY)uMNcKRwNM4o*
zjn6}DLG%IA%RggX1xMR6%yS;X-w9Y)-$RGvELej<Q^g>h9*(Jpl&|0x!MU~eGWYPg
z1GoljLlMj2-#0`9h6nDvIMyXMo#cdl|8YPqMC0SeryS)POpT;Q@G$J!UdC425ztb+
zF?O>jFmgwcsFvRyY4LEE8{Fl}mnMV;>QcP-ATe&UxY_qaxa@G+>Y4YWtn-rd)!*tB
zux7WN`9UGlFgQ%nxVf21c7W~hmArqmXg@b!3iOG$<91Tp2#TR%M($I;N4F}Rh>*Xa
zw)khJO3lEpaiT_mjpJ=+K2VW(m?%#?-@#EsPqzl5XVEiAIY15-tC#il9%$FTh)a4q
z&&CPOL&Exbk3Up_z(z%N<MC_kJn|s9gX}`msVM4R7i~8ob@};DQ__w@M*8x6H;i~J
zOPjOzOlto|oyoed4%AvhPQC?Y%Wn^0=cvkujv}p~5#R0wAWtd!0FVFY!avz0b{YsA
zY)ot{kW|SxCOft$k_P#tsMAKvt(OZG)>7&S9fUV*1pbWN2k#(HljRXD<FU6>p-zWT
zr2(*P<P;(nUau(|5q@I)0@y`%fG;COCx1K2^Y>FHSOqZksHGexM1DnCnwBKzUGdc*
zqpGg`V*s^ML6SEtw`WEkO5iQ{-s5u<aSfLzd?{=`6olef$Fpu>q6a~7`Zo9kG{*pP
zsi{sf1-1gEH#?8N&ornLw5V)JotDwqW9fL{7?%=WV&j<PRln1yK=FC3yy$Nj`pXMw
z1|PIE*<8d!wB+rZa`-%$OBp#<x!zrOZe-zI0i$-I<ou?6$-`P7d+Lfl<If^l&U&xh
z6&1Yo&`WK4GJFRSn`6%qYyU|SBGp~#IECAl&rhhRyjpJ10)>8cqT5IKB~`w<7BbC$
z?+(DyqDQw6zy3rzK{^EqdOY&)U5L6#02k;&hzHBv@mxX94Z1OgIfEECcR$SABkyW4
z<;D(@{mWYPGhYZx0*>VIYyNA1^uHLV{Fj#d#4#b=NZ444<J3{F0CMdIwU8rz%hmt^
z?hJDP@Ci&F<{?W(Nq%rO)&{^)rHhe$MLuyQA|;Fgjvj_3i_qjR`%@g^*~eKB6#I~q
z;h&=7IEcMMQ}7?6x-@<IRl2*?K8_$!j&<%oILQ>n!qN%k2E^k;gfm<XmNF(~nn0m*
z*g^Ghb78xn^EuG8`XuKXpsd?V1Enr2lnpn>_$$Z>#vXBB7pD*3#k&BTwSSz20!YTH
zxDO`x)}E4J;l<B8G%*2_t5%{rs!u&N1&_|m=$p57hROB+)|vd+I@vORe=+s(GwG$a
z5Hv%m@Za+$3I*~-%3R73DFiV%opz_T)P?N?*PmWsH$ro^tbpOx9cW78Wlp5YZ`JH9
z;$K4|TQPp3mDFmb_nQ_ZetH1?ZBV^%^S;Q(;z)U5CN(t?Na}lIQ2g(Cvl0R;fsF!r
ze7Oo9;wx~XpYx26hp60HV@sCbcqp`o_t;_t-4i@!|A~vL7aL0^9>9G%C7%GX**&0p
zU;QSJ`L%}TflI#h1mh9$-fh{p(U|lK$Vd~QAI$durgRGU9>BOkLWA4tF%U}O)m#*(
zZZ6x7vnEMCWF~2pv`u~oO71V>8QiVxWTaacHHZ^R?+$8oWowN0MZg_u>jHQyJi#_0
zG0_eS{`#VO2Xf~jsdb3Z;{b1faf}(RE#<o!Ne+Bv{x^6)@i^t{9&nT7N=XB^1w6q#
zR4zWSl-Hg`&gE}L&xJ&sf_@DhP{Ap)q}?-mCqZbmMMWDcdE)S%0{4%18+k%bWP^ZU
zhYoU%ktIOKrvpniJQTL<nFW%NT(q(9A6LH^A=v2SP$`c!YxoL8!dU98QA!#lCAvse
zEIA&tdSckYxFo*T?t&1S?>OtxVhKdC)RjRwzy*-Ze6xru!8?TU7FPFFo6aOz!oEtn
z?Yuz{VBE@{RcKttvzhL|O>DgyPF`WF1@0kgPWu|oTZUQ>OuRiYzfHs=FI9eGM26Sq
z(gR~{gPm4z5BP#mtazk#7LzByvh`751iXrLjC7m4V_lD;-w!TLh332tt)iPEYt^>z
zl2!eFyP9dJK*T!6XO_cTWjUI<q8uYSnyyH{7hIOk>pdU`Gzm<%7_{$xElFMm)~g%5
zcwWKY0PM({GI!<iKAupwAtYiN2?=;?lkPuN^A-$2Vtb(M7iZIA)}PPr$xlKOe8M8Z
z%dMVXt9RAO%rn`1AD~inDmV6LKV$Vd(WQ{7fZtrGT0U+K=!7*Mh^iF21exrgrGG92
zd|z4PQ-wzuBwF$rAGpLnB~UW`p2yNPmo(ggd+-aS2&2S2K995LtS-nmE6$I39z;R>
zsRp<p2=Y%CJf5QJwX+IDv#WRWSnB=pVmKWEs(?2Q6Lk>xU}9H04pjig*M<JRh@Fup
zKLCCM-`~9!H_mzeK2wCi3lqF-&4%K`tIVoAY)5@Q*r@f`AZti}%gQ#Oj{pCpaqwaD
zDEmi5yv1iygjlHRgXcN#0v$9D58m}Tef31v2-_4wDTDDqIhLJah&+z5=Y3{RUllb=
zFQD!I?t!x<u8tb^#@FVN++#bp7Zhf59m~qz#%NJj3|D^L)(BP4sIfI$LPQ#|;xV=~
zKDse|rd0hOgggze7xm|ICxv3+8TRPt8>AQR=T)J=m8&)dW>Q*YO8HvR!b<vuBXyN_
zkR?psZpwkD5uQ`84F0BXh5w=N|A*D(6Gz#RS4OPdf@_xWG{0q<sGL{{G9G9ix@!sr
z;Hl#MTBLh$Ygn8}xtsHvHtsM{OhKG$QV}D|t7W80!>fTLL_BOt*J|7Z^uWa%#%dCe
zvIY%@AWAu8vxp}7RISF!{Q+3Q4xsMBB`eprbK#;vCwOG>`*4yr{RpKZLa0KVV@@>A
zFE&yL6<BxghU!<JOfRgN*RV(+b&(c}&8clAxVk6pV|uxMIdWoxe`qAczx#+%OxQ^?
zH(;lLv8@Ch4%8voGV>J*F_ziHBWJ3v*>{xJRNl%OtXn7=nES3)?c+qf{$pN`ZClNV
ztoxCxX7kA*%6+Ez(c`LC>9pD}8IOvp@yE(j*59O(s{~xO*9f?szA&(uqD`}|x+aO9
z6*7!b?lKJ-`D0tv`Hb1CtJqTg_`e8F{vF5HNH@-wTy*)|vIiR_8}%nQ*yL)c<BTV`
zo32myz$p`j^H-P4O18prGWqW7QgmIUDDQkB;8D0fAzmaybjur)K)VSzT=m_tH=bP<
zqD+EY`ztC%cm?%u&Sr4BBYnQ-u@fn<k_Y1xp!I8>U;bszCH_kq@?YS5<$vAB6UTd_
z-h2g!E<_v{LAqz^ro@v99)<3JC7+x?tVlhqUU;nOnE~X%iOw)npcTQ{!%`&5LwMit
zAFW4$CFBCad{8$;Lbp|^<`LxVlWLF*P22XE)D1yYi~@rPru4UB59|)8jqViclu#1G
zcfC~p;{Wr;`fh<)x!Hj6ZHL{~`=hV?9mF*{S_CL1E(8und#Qc<(?-viE(^W@-v>=u
zSLW>u>o2~x?+6wk{nnmOv267-^OV4v-MNi^O)om@a<b_`5+8WB7H~#;wpxq#?jVeX
z>+vLf9{xg(RGwRhEw%Rf$d3yXhr%`tbuE#-C`XLAoX8aIBTuv}{xvb&)?(s-V3IEg
z&<ePT_S3H&%^s-6!lFtCcR#AWu=i9w>3US5h9cDYKY352hC-t{7AsTK-pJY2x4o#7
zqz=s;q>JOwGi%uSxo7m}&ijzDqGS6b`Hg|def7KM0vXXsYEycw*L$=tIJVxED*yBq
zdN{zB_bdRAhg?IZi6@Db?@AKWAl(Pg86JBS5E#si9T3gu9q(xo4H;J4eRKlJQq??g
z!^pik_Zj(_TeBVZXS5OHI3f?p-NWHyoPX};_r-cw`;=@=DI06X*F>t(FivEhe1fWE
z$gngOq_h#*$TdJ47N5ZC^t)`h7y>Q>((q-z5qO`Uuk=-R+ymAh?I{ADA5u%UBtfZm
zOL7<4K#O)1JIVaKFxxWTXUgEPWOPL{1m(`mNtoU5cZ^i1AVZ&rh%h2Dzm9PY=QtSa
z0H1}+^Y`+-42r(HtxK;XKcRej%ZKS^h_@g4EQ;yFVCLRkI%yn^Z8!=9xKyOE?7pRt
zTF|J0JK#XcmN`z7<wRF#KOQZ?+Qo_i=Svn`##tAjB55Y*2~AP%d4w9JV;Pah-zu`D
z#`t({8MgExOhY9&VHgy~h)*T3_*sYA@rvaY--aGB1-#)7DqF!jIxJZG&O060x_CSN
zHl-`Wuy-9sKZmJX>7eMO_DLiimsg^+j8k;(OT&dKzZHnL&ryT8>o7K&eD1vy^!&j?
zH~M+H7#hX74^>&F^gJ}mjpR;p8fS)MD%^qQ#C}XYS$ruT*=*ph3MP+*COO>ckA^Js
zKJsY(ZUzcWj0(<vzPKXAx<_eaej-(&wL+@|E|*bTM*IeMDE6gyXnh6yQ46-5>n4h_
zqsFu+VB0RY%@J7JhmksxxVj~l<Jj;(eCr^kxe49%)EeED0)6i}6oIr_6iiZ$Rccd-
zNhNDz(!29~2Q`B;;!PMNi%eog$U>uMO5$=|fF5(}C`0~TC*>xZrbIb~HA_<>OOqxm
zT?9C~ED2=m)8g+0E+0m${RSniQ3PS<&3Aei2KVCfmJh|}#G`)4vGVWj)n=q_GW35P
z>t*Tq!J^&G=#x#igh)n4!Y*T>tVN^RfBbQkP1Npvd$$rnmaeO4%?Am<F^Z5wD`xJO
zm6y@@F1_3RGNa`-{!e6&us)aTNpj5EJAJ2xr~Dn2va8mQVMtAaoI?!TZ!d%5V*CbG
zDefPC#8_ml2en^ge*1gYAlOhD{d9Yj!839vXhFGgJtQ#Ws|UuVM;(*?p(KbC-rlJ|
zQ_9XhCcr80De*((*Id)gUoE#Xc9`p-AR1;D&zR-Pl4&a0Rdv4-vpEMD1o`%B^vHI8
zuO4TBpb-1bEQe*uwrW45n8@CK*#G-jiq=h2sJ!xN@1fj45frM`4dWRU;u2As(R`vP
z_-`Z33e5hrQ_TLPmrY#i4R-zMN+Cs<GqN}}lqET|r<Ibxw9bo?lD4LLySa^TZTJOS
z3TxEbn4V|l@A?NoJLvI15#LprAwHI*B&W1?FuUy94QK9AMty}vOxv&hW&mTV8B1|)
zawl&JNC%n^>C;LnpFlhXFiy93fmvp!?tk1<C(GclG0v^Ghz~YQ5fMiq?E9E5Q0M*d
zdHAMhd(^Mu+Pi+DaIq(THlbYvZG(NKp$htE6uSNau{iw|C9R9gey~I7KN@+;?<G$G
zH$N7bRTT@Cv6Rv|0BPm_6aoLyIPoP4VS{aIlq8Eu<i^G85%n1j#p1c&O%qxEWojf7
z$}D&Q-JHzw7>fV`Nd$N@ViP8>YJPholAdr|)0!H7=FV9cE9&)XOID1P4r?7O3X0Zd
z=0Zo3P=+JYd<QX+SDBLn$=zE*^z*pW&W2Kv8oJ2(aG~x;&-YVd=LX6aF49Bj61YRG
z#e&L0aym%@^rVcuo~~ROCG8+LNHL@qnXl7;2g1B+H}9UaykveZmk3YO7hX4LrX}?I
znzdY>(isc&SU?Oc#HEhjyzC`1RCnEkTHWy-P{F&b9j<WbVC9P}r^6D+#g&Z9&?)6%
zoLp8rEls#q4m+U$6?}{D<B?k`3QvQ9Uc7o!3h~<8aj<H<uO=vt6}Wm`xhVLzoH7zb
zf+9p6;$B7>Dgv;E)d9P47DTx2ed6j;7^Q5Q(!aQQvNoIV4_LB9<E>(f#;x)8>yYt>
zu66;^hQd4Y^nu=sr>Nm_Gbm`=L3>$voERoOXn#GGIFk$Y3%{%swH@s7zq<=x$lihF
YgaxSRTQ9za9!CSPr_P=%!{BcH8<(Aopa1{>

literal 8759
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
J^+V9*{{ZU`F>wF@

diff --git a/__tests__/integration/snapshots/api/chart-emit-legend-filter/step1.png b/__tests__/integration/snapshots/api/chart-emit-legend-filter/step1.png
new file mode 100644
index 0000000000000000000000000000000000000000..f95abfcd57012650239e39238bd31b35e666c088
GIT binary patch
literal 11296
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
Jb`pE#e*ggWF%bX&

literal 0
HcmV?d00001

diff --git a/__tests__/plots/api/chart-emit-legend-filter.ts b/__tests__/plots/api/chart-emit-legend-filter.ts
index 65b116eaca..45092998a1 100644
--- a/__tests__/plots/api/chart-emit-legend-filter.ts
+++ b/__tests__/plots/api/chart-emit-legend-filter.ts
@@ -4,8 +4,13 @@ export function chartEmitLegendFilter(context) {
   const { container, canvas } = context;
 
   // button
-  const legend = document.createElement('div');
-  container.appendChild(legend);
+  const button = document.createElement('button');
+  button.innerText = 'filter';
+  container.appendChild(button);
+
+  const button1 = document.createElement('button');
+  button1.innerText = 'end';
+  container.appendChild(button1);
 
   // wrapperDiv
   const wrapperDiv = document.createElement('div');
@@ -29,59 +34,31 @@ export function chartEmitLegendFilter(context) {
     .encode('x', 'genre')
     .encode('y', 'sold')
     .encode('color', 'genre')
-    .animate(false)
-    .legend(false);
+    .animate(false);
 
   const finished = chart.render();
-  const assetValues: any = {
-    chart,
-    finished,
-  };
-
-  finished.then(() => {
-    const scale = chart.getScaleByChannel('color');
-    const { domain, range } = scale.getOptions();
-    const excludedValues: any[] = [];
 
-    assetValues.items = domain.map((text, i) => {
-      const span = document.createElement('span');
-      const color = range[i];
-
-      // Items' style.
-      span.innerText = text;
-      span.style.display = 'inline-block';
-      span.style.padding = '0.5em';
-      span.style.color = color;
-      span.style.cursor = 'pointer';
+  chart.on('legend:filter', (e) => {
+    const { nativeEvent, data } = e;
+    if (!nativeEvent) return;
+    console.log(data);
+  });
 
-      span.onclick = () => {
-        const index = excludedValues.findIndex((d) => d === text);
-        if (index === -1) {
-          excludedValues.push(text);
-          span.style.color = '#aaa';
-        } else {
-          excludedValues.splice(index, 1);
-          span.style.color = color;
-        }
-        onChange(excludedValues);
-      };
+  chart.on('legend:end', (e) => {
+    const { nativeEvent } = e;
+    if (!nativeEvent) return;
+    console.log('end');
+  });
 
-      return span;
+  button.onclick = () => {
+    chart.emit('legend:filter', {
+      data: { channel: 'color', values: ['Sports', 'Strategy'] },
     });
+  };
 
-    // Mount items.
-    for (const item of assetValues.items) legend.append(item);
-
-    function onChange(values: any[]) {
-      const selectedValues = domain.filter((d) => !values.includes(d));
-
-      // Emit Event.
-      chart.emit('legend:filter', {
-        channel: 'color',
-        values: selectedValues,
-      });
-    }
-  });
+  button1.onclick = () => {
+    chart.emit('legend:end', {});
+  };
 
-  return assetValues;
+  return { chart, finished };
 }
diff --git a/site/docs/spec/interaction/legendFilter.zh.md b/site/docs/spec/interaction/legendFilter.zh.md
index 2db26c965b..561b8355d5 100644
--- a/site/docs/spec/interaction/legendFilter.zh.md
+++ b/site/docs/spec/interaction/legendFilter.zh.md
@@ -28,3 +28,31 @@ chart.interaction('legendFilter', true);
 
 chart.render();
 ```
+
+## 案例
+
+### 触发交互
+
+```js
+chart.emit('legend:filter', {
+  data: { channel: 'color', values: ['Sports', 'Strategy'] },
+});
+
+chart.emit('legend:end', {});
+```
+
+### 获得数据
+
+```js
+chart.on('legend:filter', (e) => {
+  const { nativeEvent, data } = e;
+  if (!nativeEvent) return;
+  console.log(data);
+});
+
+chart.on('legend:end', (e) => {
+  const { nativeEvent } = e;
+  if (!nativeEvent) return;
+  console.log('end');
+});
+```
diff --git a/site/examples/component/legend/demo/custom.ts b/site/examples/component/legend/demo/custom.ts
index cb44372b56..aa5997ea6d 100644
--- a/site/examples/component/legend/demo/custom.ts
+++ b/site/examples/component/legend/demo/custom.ts
@@ -5,18 +5,22 @@ const chart = new Chart({
   container: 'container',
 });
 
+const data = [
+  { genre: 'Sports', sold: 275 },
+  { genre: 'Strategy', sold: 115 },
+  { genre: 'Action', sold: 120 },
+  { genre: 'Shooter', sold: 350 },
+  { genre: 'Other', sold: 150 },
+];
+
+const colorField = 'genre';
+
 chart
   .interval()
-  .data([
-    { genre: 'Sports', sold: 275 },
-    { genre: 'Strategy', sold: 115 },
-    { genre: 'Action', sold: 120 },
-    { genre: 'Shooter', sold: 350 },
-    { genre: 'Other', sold: 150 },
-  ])
+  .data(data)
   .encode('x', 'genre')
   .encode('y', 'sold')
-  .encode('color', 'genre')
+  .encode('color', colorField)
   .legend(false); // Hide built-in legends.
 
 chart.render().then(renderCustomLegend);
@@ -62,11 +66,11 @@ function renderCustomLegend(chart) {
   for (const item of items) legend.append(item);
 
   // Emit legendFilter event.
-  function onChange(values: any[]) {
+  function onChange(values) {
     const selectedValues = domain.filter((d) => !values.includes(d));
-    chart.emit('legend:filter', {
-      channel: 'color',
-      values: selectedValues,
-    });
+    const selectedData = data.filter((d) =>
+      selectedValues.includes(d[colorField]),
+    );
+    chart.changeData(selectedData);
   }
 }
diff --git a/src/interaction/legendFilter.ts b/src/interaction/legendFilter.ts
index 7bf39060fa..8de206b702 100644
--- a/src/interaction/legendFilter.ts
+++ b/src/interaction/legendFilter.ts
@@ -52,6 +52,8 @@ function legendFilter(
     label: labelOf, // given the legend returns the label
     datum, // given the legend returns the value
     filter, // invoke when dispatch filter event,
+    emitter,
+    channel,
     state = {} as Record<string, any>, // state options
   },
 ) {
@@ -79,7 +81,7 @@ function legendFilter(
   );
 
   const items: DisplayObject[] = Array.from(legends(root));
-  const selectedValues = items.map(datum);
+  let selectedValues = items.map(datum);
   const updateLegendState = () => {
     for (const item of items) {
       const value = datum(item);
@@ -105,7 +107,7 @@ function legendFilter(
       restoreCursor(root);
     };
 
-    const click = async () => {
+    const click = async (event) => {
       const value = datum(item);
       const index = selectedValues.indexOf(value);
       if (index === -1) selectedValues.push(value);
@@ -113,6 +115,22 @@ function legendFilter(
       if (selectedValues.length === 0) selectedValues.push(...items.map(datum));
       await filter(selectedValues);
       updateLegendState();
+
+      const { nativeEvent = true } = event;
+      if (!nativeEvent) return;
+      if (selectedValues.length === items.length) {
+        emitter.emit('legend:end', { nativeEvent });
+      } else {
+        // Emit events.
+        emitter.emit('legend:filter', {
+          ...event,
+          nativeEvent,
+          data: {
+            channel,
+            values: selectedValues,
+          },
+        });
+      }
     };
 
     // Bind and store handlers.
@@ -124,11 +142,35 @@ function legendFilter(
     itemPointerout.set(item, pointerout);
   }
 
+  const onFilter = async (event) => {
+    const { nativeEvent } = event;
+    if (nativeEvent) return;
+    const { data } = event;
+    const { channel: specifiedChannel, values } = data;
+    if (specifiedChannel !== channel) return;
+    selectedValues = values;
+    await filter(selectedValues);
+    updateLegendState();
+  };
+
+  const onEnd = async (event) => {
+    const { nativeEvent } = event;
+    if (nativeEvent) return;
+    selectedValues = items.map(datum);
+    await filter(selectedValues);
+    updateLegendState();
+  };
+
+  emitter.on('legend:filter', onFilter);
+  emitter.on('legend:end', onEnd);
+
   return () => {
     for (const item of items) {
       item.removeEventListener('click', itemClick.get(item));
       item.removeEventListener('pointerenter', itemPointerenter.get(item));
       item.removeEventListener('pointerout', itemPointerout.get(item));
+      emitter.off('legend:filter', onFilter);
+      emitter.off('legend:end', onEnd);
     }
   };
 }
@@ -168,17 +210,6 @@ export function LegendFilter() {
       return update(newOptions);
     };
 
-    if (!legends.length) {
-      const onFilter = (options) => {
-        const { values, channel } = options;
-        filter(channel, values);
-      };
-      emitter.on('legend:filter', onFilter);
-      return () => {
-        emitter.off('legend:filter', onFilter);
-      };
-    }
-
     const removes = legends.map((legend) => {
       const { name: channel, domain } = dataOf(legend).scales[0];
       return legendFilter(container, {
@@ -192,6 +223,8 @@ export function LegendFilter() {
         },
         filter: (value) => filter(channel, value),
         state: legend.attributes.state,
+        channel,
+        emitter,
       });
     });
     return () => {