2
2
type : module
3
3
---
4
4
5
- ### User, room, and group mentions
5
+ ### User and room mentions
6
6
7
- This module allows users to mention other users, rooms, and groups
8
- within a room message. This is achieved by including a [ matrix.to
9
- URI] ( /appendices/#matrixto-navigation ) in the HTML body of an
10
- [ m.room.message] ( #mroommessage ) event. This module does not have any server-specific
7
+ This module allows users to mention other users and rooms within a room message.
8
+ This is achieved by including a [ Matrix URI] ( /appendices/#uris ) in the HTML body of
9
+ an [ m.room.message] ( #mroommessage ) event. This module does not have any server-specific
11
10
behaviour to it.
12
11
13
12
Mentions apply only to [ m.room.message] ( #mroommessage ) events where the ` msgtype ` is
@@ -28,7 +27,7 @@ To make a mention, reference the entity being mentioned in the
28
27
29
28
#### Client behaviour
30
29
31
- In addition to using the appropriate ` matrix.to URI` for the mention,
30
+ In addition to using the appropriate ` Matrix URI` for the mention,
32
31
clients should use the following guidelines when making mentions in
33
32
events to be sent:
34
33
@@ -40,7 +39,6 @@ events to be sent:
40
39
listed on the room. If no alias can be found, fall back to the room
41
40
ID. In all cases, use the alias/room ID being linked to as the
42
41
anchor's text.
43
- - When referencing groups, use the group ID as the anchor's text.
44
42
45
43
The text component of the anchor should be used in the event's ` body `
46
44
where the mention would normally be represented, as shown in the example
@@ -56,4 +54,11 @@ mention differently from other mentions, such as by using a red
56
54
background color to signify to the user that they were mentioned.
57
55
58
56
When clicked, the mention should navigate the user to the appropriate
59
- room, group, or user information.
57
+ user or room information.
58
+
59
+ {{% boxes/note %}}
60
+ Similar to legacy [ matrix.to URLs] ( /appendices/#matrixto-navigation ) ,
61
+ groups used to be representable by mentions. They follow a similar format
62
+ to room mentions, though using the group ID in both the link and anchor
63
+ text.
64
+ {{% /boxes/note %}}
0 commit comments