From 506dcd4221741262596e33467612cd0eb83f1b24 Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Wed, 18 Sep 2024 09:03:11 +0200
Subject: [PATCH] Select entity: add state (#34792)
---
source/_integrations/select.markdown | 15 ++++++++++++---
.../integrations/select/state_select.png | Bin 0 -> 108143 bytes
2 files changed, 12 insertions(+), 3 deletions(-)
create mode 100644 source/images/integrations/select/state_select.png
diff --git a/source/_integrations/select.markdown b/source/_integrations/select.markdown
index 209d070a4a4..4b9d0b8d7de 100644
--- a/source/_integrations/select.markdown
+++ b/source/_integrations/select.markdown
@@ -11,16 +11,25 @@ ha_codeowners:
ha_integration_type: entity
---
-Keeps track on `select` entities in your environment, their state, and allows
+The **Select** {% term integration %} keeps track of the `select` {% term entities %} in your environment, their state, and allows
you to control them. This integration allows other integrations to offer
a limited set of selectable options for the entity.
{% include integrations/building_block_integration.md %}
+## The state of a select entity
+
+The state of a select entity is the value of the currently selected option.
+
+
+
+Screenshot showing the state of a select entity in the developer tools.
+
+
## Actions
-The select entity exposes additional actions to control the entity in, for example,
-automation or scripts. These actions can be created via the UI, but are
+The select {% term entity %} exposes additional {% term actions %} to control the entity in, for example,
+{% term automation %} or {% term scripts %}. These actions can be created via the UI, but are
also available in YAML (for which examples are provided below).
### Action `select.select_first`
diff --git a/source/images/integrations/select/state_select.png b/source/images/integrations/select/state_select.png
new file mode 100644
index 0000000000000000000000000000000000000000..a99fa534e093bfd63a4fc74b05ebeb6834d29d09
GIT binary patch
literal 108143
zcmXuK18`(r+qT`YZQHhOPHbBfI}_WQOl;c|Yhv5BZGU|~|NB>0HFoV?t9!527tZro
zkxGhE2(Y-Y0000%Mp|42001Ke06<2dA%V|>u=WtZmk?_)F(nx>F=9t&2McREa{z!k
z(KnG#x?dQ7s7G)BDuvV?*$G-Jn?53n+Xf>_iDUt`nm0}FEr=39CMvpcN5}D|UdzqV
zX=$-f9T}X6cnVQ5icw|nJ4rMe8!7JncGH*0V;khlJH6b(5nqX8T$*A}l(K`?wYvb%
z7n&@>I5Pb$i<)wmr~7Jm|6D)D(ku7f<$;zb8ALG9^UrCRM5hRUm-T7Zb0k?6HO;{B
zfGMPY!b{?L!?;5h9OAo|#ej6_Q6$-bXnyP=r-g(VMGk2kZH46PSIjueD#
zJ3_}cFnIpcBoZE#fD)lxsIBRf%m(3ahMC5rr=^YIQ?P`Rnk25?J`!e~ybHH@50B>O
zr|WbJe<6MW=R~_VT5#Y*L7K=(i37g>d*pSMCIbM(02y%+HP5w+Y#%+fkP~XtQq!nfa!cx|-HEcRwvq@9O6Nj;g<0o6o5lB-jr6V{}2cy&}vb1z`IGlFa+rRD+kOUqQ*t2S%9}a)eG+Is{CI1jSRsB6TGt+z7vW+Ng
zY)n%6BiCXoi|1mkIXW+oSVctzo5N;-!~Z?oW6SvIV)b`w>ip7Dm}ovRJNxhca3nNL
z%%O#H)zwBzq}raZH@D*7jM;nfr8(YFcX!T$A2(v%A9r$o_nF%pGm7b44upe)gUgRT
zY?f1I*IQk_HgD}#rPBO|N3K!ir4Q;kq#R;IDJPoMI-z=uNS>`Flb==fV7^_!%9%gq
z*Dr4bYxyjoc9;}zJ$$0kvIs!D$Q_yul>_(S@MbH}%jW2i0exk+f|XY2$N*E3I}Y`B
zWq{Q{nR>pOZ9O0sl7JEf9H38&bEbuUi>rnU1{fTbRl_A4mBrwZgp;g}0xg6Hkz`So
zgBXqSoCqjq#&IpzqE#6!e~hRgg^jUy(qh)jP`SIiYyJLukBp3TYH@_J%@Xsp4v9V>
za9{e?WoGH%E8|-h8E4A}oO~NwE_sNp?1gY=k*D&FW(k77UiKATHq^^v$ZlBh>F$XE
zm{)eTY3)AbJdxeDpR0y~+tFn!qs&ihe0{AhU;{2Poa>;GX_8B736+xy4pyH9ubqY3
zRwmv~A)q~&5Kcf-R7Pv2g|2hX=t0q#X4gg`B$t@7;uJGSvWoG*a?GjKJ0D*e;f3Xo
z73+8*QRkY)E-X7!J6zbhmP63FvD
zKPp{&w94d;ViTsVtWpZUb!yAp2fhH>?n;3h?0IRiPJLjbLI;ixE75X&ls3>~(OV@)
zC4qqygeYOc0&zM@ZMukFMCGITlUF!jDWO2RXoX%`wnu_FVAbxAPC@)mfsY|ycZ`u3
zUsDU>eh!lu|EJWaQ2!wKaagh)a;?V;%q?3*I9P&t1aT$CS*E1pG**6-kKiIph=QT`
z-AbYnaT-o|u=Qgq3?@C5u@{EuyoR$ac-@(I*Pa5XFd9c2Oj)vXJ*a}ZH*F?_Rn38w
zA1WLtyXQQWm8;QWy_*xh2Kd8xGJsl6H92oldDRReu0T->Q6oF;O9!WG)$Zu?dHZZ`KtjffW6UCRX=qZ{8b=Md#M%MSGfJO+NGEj9=Z~
zbN({-It~hk?j6~Sm6}lG+R)Izr1UeyJ*Lk`va%iKU!f2_&+QF?HO>Q#yXGI^~jgzDbhQ84%-rOb!
zJC53fxtt0Tj?X2BumC3P6QiQe)LM>c8g|
z+lKqJq2hn9d73qDX8x$saoMEXOpYT|1p$O!DM(FA7L&FObflN{fFwtys%TW}41yu?
z@668{V(5V>&UBXlPWtm_>9Kqf<)*Q{>s|iWG3%RDcp9(FLv!k{eb&)JPO6H
zBzWgN3{5GTP2&`dInwqmB6XYl94j2^gz>|L#YO$aj<0Y+Z@0I0OtTsR;inA#=6
z;FM33r{nf5_d?(ILR(O!f2;GT=`yP@)>nK#K=-s^Zixrax{d*5G-CzCpeLk(E
z9c5uv7o>oxbob=U^ikH91&3pN{O`1?#dUj~Vp|5#p*^*QF?7HJ4<)?CZLfakl8fV%
zs7w@Uv(%zz;URit^HVYf%aaR!Ej{zOCX+r2OzZ)kuxvlZoquEg643=4cQRy7ng(3%eciYuEsR(>yF`8hU
z=xd!Et~(BK&SzuE50*AoPR}LJPu8cyQ8De4NA^^H&t=DbdGA_yjHH~OWHK@B7Y52U
zjD3VIOVWVUg@~BF=i%lr7ZlclUR_GaCO*)7M$YoZ{VcUR)B&z2=+AO@eC|B;h1%3;
z{EWA|lwZG7sm?an<8GC=aJSdv^i&k5!X&dxd9>Gu{E6&3s+cI+a4L
z#u!)ug?RHym2)#E83ElCR$erNz}X5H`UsSW#(X@3iaQnBTW|CuPYhu9MF>z#%qVck
zm&!p^rL72VxoBjmnH#k>T0_KR7`}*Ezcia<#7lnW>pFcD9%tc;xBJUxQ(1;c*s?lw
zkWKn+UDlG^DyIiqdRgz(Zm{8D&toy{(+VHK)aumH0L&oisOQk5(346s@;)G~g*
z;Ek*1wJh|ZdZ+xCIMRgtyPriiN$}=5*S!`mK=nG?7bQ(zdlUZo{?UU)ztyo3C@5+J
zO(BIamyLXPgh1y6O|zz#DJE5qr0oJtKGtqP^(}-D2vCYvETk-M#Z-2Jgywa&fyhHq
zx1$9_{YFJEry$4VG{{ha3N8r7mtfa&jcO3;SjMX6{!a#rNjoquI#l
z0-;U!clW+#PZ>%#kZl3o+{x%CWx6dAKv4I6B1pE?F>9ZQX&*G9Yt)5U1bq&e7mDw)
z_?A_PlG|!c7Tm!SO2XMtfW`dX&F`O+Ugz9e|D
zn#1=RwFZ;9Uk_B*4kE}SBO}6&xf`y^kgOFJgeL)bNcVl!PU(Y?MB~_WTB&bM<2gopU4J|}U5qgZ4ixujr(u_}=`+S!%
zbS;g=lgp|5V?W6W&vs0xdikeO@fbNFab+}V!1(*i)p5~jDE5#{6|WaI%0#N=i}IF0
zF=tPH0FZI5=@lhY3`9Cv6D7HlmpdLwqZVMVcliaBk_rH-Ad)}%#};6PhNqebyyr6L
zI%8FU89COIt>aL2y(743W6pc%lGvG{(si*X)2hoCmD
zDvmq89L5+K;F8HU6>jJv=;lBl8fIKf)H*3cjRYQBgf$$&@wp*Eb?||6ZXvR~XJMNJ
zL!D?XgEbb>oXZ+9Yez(428_Fe(gIiuAxqv(@?R?3o0@M%=ba~zdPcFX1|Kg!2ujhZi>aHPhW`IlqgPqQ+n^a`+0E%;OM`hO?bV#&||VCCK_?t9iGn7
z`U@rKYaZ4%U8I2bcY}nA1}ayICaMH6s>5K{FJKn3AUoPg&Jar-v>VG^1u(z=+!*sa3)mB-
zD#VM7)(zm5ffGgZR=@|;8WgZO^J(XwaoB{67bo<^#3~q-*;ouFw`@E#Y$PD^Tm;bc
zNw+4^j2p&xu?gk6d7T5SD!%~u)%c8t!6(;!eXD2jTA5VsuDs1I2wt|2JKW=6Zgf2R
zf5)}8T>(%xv$C^C9o_u#oo=~Li8fsIZuL5(5D=aEOCJ?`zdnM)DvIo3#zxXeINB=Q(Kf}EsPhFR;x&~N66>_eRS_ih1nRp}N
z04Z@s(%lNm50Vmd+4o$IHxnky}RV33L*hNo_FECLy`cM&*_+}*AMOWEK{
zdi9}#>u2SBAtGgMT=r%y2OyOW)$bFcc}xg3PY)h~#h@lS^;e*Mo-)0zSIaUD{t#lQ
zF-(UfwY4{_TY{Cd0SwZhuLbZVBq|E7T_bv$lQ!)S_ZJJyt1*~YLE^x$w3KzA@Q3X=
z>OI^jwcCiml-lVtCl-CQHNB$D&z~CTpG|l0eKakT+Ps+{QVPV5T}n3bne-*EuGqM0
zm;S)2q|m}!DEDJ!lCVC`+2ED))@e-$li}DDKd&MfJ_&w*+?$!1IZg{aOWRI&3zOh+
z+CiVhm}{qJH3WB+MA-0|Sy(iftmEYBGW#I3bxbQU;AF@J?Fxq#sa|6xd2{hT;sz`k
zUkIWGzBM|kC?Y&t!(_*7x#{K@=%eVL)}O^(oFMGU$Sns$irQVps{Um*
z-2NTUnQ|q%cZ$S%)=?WFdgpeM0YO!n$tY0-c6BU(r4X_
zbbrxEW527743|zIcZ0z~gQrSe$8OR7IPR;oz)B-<9GfDO;~<;Na#)
z$g080W;t%^t
zhoS;SzddQ_pZFe}&1{((dQtSzI8U=<*J29@`Wzmu9!!@s$^G&4vzw$3l&$-E+TU%N
z;Q7H*RrjR}LhjwzhgeK{Xmm_v7DJmozyEZh79l1Q
z@8X*G>oDk4FTJZ0G7+ww!+oVVP#!o_IJd2>6YjWt%;n}e)^5tuC)5<4uMG)6dIt@k
zKHsR|sk+1GfH9^{%D|!>cGlG^W@tdN@cIn)%=8EDgUFHl4qDpf;-V*guZhG*56z?y
zi->x#MiN;}=P0`K~+3lzW?zVFG|v6_WppSZ|kdp(M!7
zhRZZb@+dZsGx_fBZVVn*9F1xTGCuyqbN91=WDIs6uuqkimWKA&bXyLvqED@~ysgg9
z@AL7!SYZKHO2CEeVi|wk)DnGM-1Bxu2MY^puO(1XF)%-g$7O%<)J6>5c|XPXaplot
zI{t?tb>jNGwg+-&l53lsiz`*=^YjNudx!{CGVo_9C?Md*hPAmI-(7!yU2|tE3cj6?
zJzZ^%&*Y1}PJe$)gXBXbo1wxeD=R1MFrq|;j8me*ppxr_%9Dx&A^kBJ9V~k!AX|9W
zB-L)V!GH_~3GSPruu|tkZqerVXfILdwB$AlenK2l=iMydfDGfjy(ZK3%~(yFbXQzn
zFBdc^y^6?I_}Sgr!tJ}9Nh?vTF0T$%=)RJEG4r!kY
zAMrq!z%$4Or^4d@>jLlW870DbfO!!%d
z)||J#zMfh|mN|pLfT}x4S?(v2NVz>au0Ux0LXdJauq>&Tmn@$%8S)j?w+?uGmAc
z0L?}|XJy71P}QxHFa@~9!KmA@W{4JYC144MLcs1}fRwVMmt&wW>44tRRXvjNx}>!VK$wU+S_@rg0o
znI#F_Qf^wdfr~q6{7FKeDHQ`MlA?j6oMbzEV_F=dg*l+X={m$3ICQ)lY1YcN1e=5)&zIQ!
z>knsniX8M5Thgv1*<<9yxS-7NwQC$oXnP3o)!mv=jB5YM9<)u5rg?cmhx4aSr4|*f
zEr3hp|9qJLosx2!ef=w(spq5N2Rf^Z8^tP<5cT5{2dR4g(K*(Z$<@Epi9`@qr?2b?
zoO~xC9}P3dJ6liVPb{N_e-Fjjfv3<)9Z^Z@#a4=fG7m^c#tigE%iS&1^}UUWn9eq2
z+3w{;2kJE`3>PkjDO5U-1!I>b^r_Q(?kLs;=d2H*5m8zW2
zcWfndM}};P8@y4vQf++hVc$*S≦^3k8QAhY|YyG
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
-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