mirror of
https://github.com/vector-im/element-web.git
synced 2024-11-23 00:28:48 +08:00
c05c429803
Co-authored-by: github-merge-queue <118344674+github-merge-queue@users.noreply.github.com> Co-authored-by: github-merge-queue <github-merge-queue@users.noreply.github.com> Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> Co-authored-by: Florian Duros <florian.duros@ormaz.fr> Co-authored-by: Kim Brose <kim.brose@nordeck.net> Co-authored-by: Florian Duros <florianduros@element.io> Co-authored-by: R Midhun Suresh <hi@midhun.dev> Co-authored-by: dbkr <986903+dbkr@users.noreply.github.com> Co-authored-by: ElementRobot <releases@riot.im> Co-authored-by: dbkr <dbkr@users.noreply.github.com> Co-authored-by: David Baker <dbkr@users.noreply.github.com> Co-authored-by: Michael Telatynski <7t3chguy@gmail.com> Co-authored-by: Richard van der Hoff <1389908+richvdh@users.noreply.github.com> Co-authored-by: David Langley <davidl@element.io> Co-authored-by: Michael Weimann <michaelw@matrix.org> Co-authored-by: Timshel <Timshel@users.noreply.github.com> Co-authored-by: Sahil Silare <32628578+sahil9001@users.noreply.github.com> Co-authored-by: Will Hunt <will@half-shot.uk> Co-authored-by: Hubert Chathi <hubert@uhoreg.ca> Co-authored-by: Andrew Ferrazzutti <andrewf@element.io> Co-authored-by: Robin <robin@robin.town> Co-authored-by: Tulir Asokan <tulir@maunium.net>
19 lines
1.3 KiB
Markdown
19 lines
1.3 KiB
Markdown
# Skinning
|
|
|
|
Skinning in the context of the react-sdk is component replacement rather than CSS. This means you can override (replace)
|
|
any accessible component in the project to implement custom behaviour, look & feel, etc. Depending on your approach,
|
|
overriding CSS classes to apply custom styling is also possible, though harder to do.
|
|
|
|
At present, the react-sdk offers no stable interface for components - this means properties and state can and do change
|
|
at any time without notice. Once we determine the react-sdk to be stable enough to use as a proper SDK, we will adjust
|
|
this policy. In the meantime, skinning is done completely at your own risk.
|
|
|
|
The approach you take is up to you - we suggest using a module replacement plugin, as found in
|
|
[webpack](https://webpack.js.org/plugins/normal-module-replacement-plugin/), though you're free to use whichever build
|
|
system works for you. The react-sdk does not have any particular functions to call to load skins, so simply replace or
|
|
extend the components/stores/etc you're after and build. As a reminder though, this is done completely at your own risk
|
|
as we cannot guarantee a stable interface at this time.
|
|
|
|
Taking a look at [element-web](https://github.com/vector-im/element-web)'s approach to skinning may be worthwhile, as it
|
|
overrides some relatively simple components.
|