Elementos
Selección de texto
A View con selectable hace que los textos que contiene se seleccionen juntos, como los de una página web: una selección va desde un punto de un texto hasta un punto de otro, a través de vistas, elementos Text y TextView, en orden de lectura. Si haces seleccionable la transcripción de un chat, una selección puede empezar en un mensaje y terminar en el siguiente; Copiar coloca el texto seleccionado en el portapapeles, con los textos situados uno al lado del otro unidos por un tabulador y los demás por un salto de línea. En Rust se activa con view().selectable(true), en TSX con <View selectable>; que un texto individual pueda seleccionarse depende de su estilo userSelect.
import { mount, Scroll, signal, Text, View } from "nsh";
import { Input } from "nsh/base";
import { TextView } from "nsh/base";
import { platform } from "nsh";
import { field, ui } from "./palette";
const NOTES = "- Sync runs **in the background**\n- Conflicts merge *per field*";
function App() {
const pasted = signal("");
return (
<Scroll style={{ flex: 1, backgroundColor: ui().page }}>
<View style={{ width: "100%", maxWidth: 560, alignSelf: "center", padding: 20, paddingTop: 24, gap: 14 }}>
<Text style={{ fontSize: 22, fontWeight: "700", color: ui().text }}>selectable view</Text>
<Text style={{ color: ui().muted, lineHeight: 20 }}>
{platform.desktop
? "Drag with the mouse from the title into the list: one selection runs across them. Double click a word, triple click a paragraph, Ctrl / Cmd+C copies."
: "Long press a word, then drag the handles across the texts: one selection runs across them. Copy is in the menu."}
</Text>
<View selectable style={{ ...ui().card, borderRadius: 16, padding: 16, gap: 10 }}>
<Text style={{ fontSize: 17, fontWeight: "600", color: ui().text }}>Release notes</Text>
<Text style={{ color: ui().text, lineHeight: 22 }}>Version 2.4 moves the app to offline sync.</Text>
<TextView markdown={NOTES} />
<View style={{ flexDirection: "row", gap: 8 }}>
<Text style={{ userSelect: "none", color: ui().faint }}>
Updated (userSelect none)
</Text>
<Text style={{ color: ui().text }}>October 21</Text>
</View>
</View>
<Text style={{ fontSize: 12, color: ui().muted }}>Paste what you copied: the label marked userSelect none stays out of it.</Text>
<Input
multiline
value={pasted()}
onChange={({ value }) => pasted.set(value)}
placeholder="Paste here"
{...field({ style: { height: 110 } })}
/>
<Text style={{ fontSize: 12, color: ui().muted, fontVariant: ["tabular-nums"] }}>
{pasted().length} characters, {pasted() ? pasted().split("\n").length : 0} lines
</Text>
</View>
</Scroll>
);
}
mount(App);use nsh_base::text_view;
use nsh_core::prelude::*;
fn release_notes(notes: &'static str) -> impl IntoElement {
view()
.selectable(true)
.gap_3()
.p_4()
.child(text("Release notes").font_weight(FontWeight::SEMIBOLD))
.child(text_view().markdown(notes))
.child(
view()
.flex_row()
.gap_2()
.child(text("Updated").select_none().text_color(rgb(0x737373)))
.child(text("October 21")),
)
}import { Text, View } from "nsh";
import { TextView } from "nsh/base";
function ReleaseNotes(props: { notes: string }) {
return (
<View selectable class="gap-3 p-4">
<Text class="font-semibold">Release notes</Text>
<TextView markdown={props.notes} />
<View class="flex-row gap-2">
<Text style={{ userSelect: "none" }} class="text-neutral-500">Updated</Text>
<Text>October 21</Text>
</View>
</View>
);
}El diseño y el aspecto de la vista son los estilos de la app, y su contenido son sus hijos. La selección en sí es de la plataforma: la vista no dibuja nada propio para ella.
#Una transcripción de chat
Una transcripción dentro de una sola vista seleccionable se selecciona como una única página: un arrastre empieza en una respuesta y termina en otra, y Copiar toma el texto de todos los mensajes intermedios.
use nsh_base::text_view;
use nsh_core::prelude::*;
fn transcript(replies: Signal<Vec<SharedString>>) -> impl IntoElement {
scroll().flex_1().child(
view().selectable(true).p_4().gap_4().child(each(
replies,
|reply: &SharedString| reply.clone(),
|reply, _index| text_view().markdown(move || reply.get()),
)),
)
}import { Scroll, View } from "nsh";
import { TextView } from "nsh/base";
<Scroll class="flex-1">
<View selectable class="gap-4 p-4">
<Each of={replies}>{(reply) => <TextView markdown={reply()} />}</Each>
</View>
</Scroll>#Cómo se hace una selección
| Plataforma | Cómo se hace una selección |
|---|---|
| macOS, Windows, Linux, GPUI | Arrastra a través de los textos; un doble clic selecciona una palabra, un triple clic un párrafo, y un arrastre después de ellos continúa por palabras o párrafos. Shift+clic amplía la selección. Ctrl / Cmd+A selecciona todo en la vista, Ctrl / Cmd+C copia, Escape o una pulsación fuera la borra. |
| iOS, Android | Una pulsación larga selecciona una palabra; los controles de la plataforma la amplían, y su menú de edición tiene Copiar y Seleccionar todo. |
| Web | La selección propia del navegador, con sus gestos, su menú y sus atajos. |
#Qué selecciona
- Textos que quedan fuera: un texto con
userSelect: "none"(.select_none()en Rust, la claseselect-none; una etiqueta, el título de un botón) queda excluido de la selección y de sus gestos. - Vistas anidadas: una vista seleccionable dentro de otra forma parte de la exterior, de modo que una sola selección abarca ambas.
- TextView: un
TextViewconselectablese selecciona por su cuenta: sus párrafos, elementos de lista, celdas y bloques de código se seleccionan juntos. Dentro de una vista seleccionable se une a la selección exterior. - Textos individuales: un texto con
userSelect: "text"que no está en ninguna vista seleccionable se selecciona por sí solo, como describe Text. - El aspecto es el resaltado de la plataforma en el
selectionColorde cada texto (selection:text-*). - Listas: en un List virtualizado, una selección abarca las filas que están montadas; las filas recicladas fuera de la vista salen de ella.