blob: 69b8ec928a3588df1521a6d2a7e7972bab369956 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
|
# iced_selection
[](https://iced-selection.pml68.dev)
## Text selection API for [`iced`](https://iced.rs), with reference widget implementations.
Text in iced currently isn't selectable except for `TextEditor` and `TextInput`. This is my solution, but others exist as well (see [Special thanks](#special-thanks)).
Check out the examples, or read the [documentation](https://iced-selection.pml68.dev) to get an idea about the crate.
Roughly:
- `selection.rs`: The main selection API, built around iced's [`Paragraph`](https://docs.iced.rs/iced_graphics/text/paragraph/struct.Paragraph.html).
- `text.rs`: Reference implementation for a selectable text widget.
- `text/rich.rs`: Reference implementation for a selectable rich text widget.
- `markdown.rs`: A custom [`Viewer`](https://docs.iced.rs/iced/widget/markdown/trait.Viewer.html) and its corresponding custom methods.
- `lib.rs`: Helper methods, macros and re-exports.
## Wrapped text support
Wrapped text is supported, but by-line selection (`Shift + Up Arrow` / `Shift + Down Arrow` & triple-click mouse selection) will treat all wrapped segments as part of the same line.
## Installation
Simply add it to under your `Cargo.toml`'s `dependencies` section.
```toml
# ...
[dependencies]
iced = { git = "https://github.com/iced-rs/iced", branch = "master" }
iced_selection = { git = "git://git.pml68.dev/iced_selection" }
```
## Features
- `default`:
- `markdown`: Provides support for rendering markdown through a custom viewer.
## TODO
- [X] allow out-of-bounds selection dragging
- [X] custom markdown `Viewer`
- [X] double-click + drag for by-word selection
- [X] triple-click + drag for by-line selection
- [X] support wrapped lines
- [ ] fix by-line selection for wrapped line segments
- [ ] make "combining" multiple text widgets possible ([`feat/global-selectable`](https://git.pml68.dev/iced_selection/?h=feat/global-selectable))
## Special thanks
- [`iced`](https://iced.rs), for making this possible in the first place, and for the modified source code of `Text`, `Rich` and `Selection` (based on [`text_input/cursor.rs`](https://github.com/iced-rs/iced/blob/master/widget/src/text_input/cursor.rs)).
- [`Halloy`](https://halloy.chat), for its amazing selectable text implementation (check it out, but mind the GPLv3!).
- [`alex-ds13`](https://github.com/alex-ds13) for their incredible contributions to `iced_selection`.
|
