Эта страница переведена машинным способом и может содержать ошибки. Читать оригинал на английском

Элементы

Выделение текста

View с selectable делает так, что тексты внутри него выделяются вместе, как на веб-странице: одно выделение тянется от места в одном тексте до места в другом, через views, элементы Text и TextView в порядке чтения. Если сделать транскрипт чата выделяемым, выделение может начаться в одном сообщении и закончиться в следующем. Copy помещает выделенный текст в буфер обмена: тексты, расположенные рядом, разделяются табуляцией, остальные переводом строки. В Rust это задаётся через view().selectable(true), в TSX через <View selectable>; можно ли выделить отдельный текст, определяет его стиль userSelect.

el-text-selection.tsx
el-text-selection.tsxLive
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")),
        )
}

Раскладка и внешний вид view определяются стилями приложения, а содержимое задаётся его дочерними элементами. Само выделение принадлежит платформе: view ничего не рисует для него сам.

#Транскрипт чата

Транскрипт в одном выделяемом view выделяется как единая страница: перетаскивание начинается в одном ответе и заканчивается в другом, а Copy забирает текст каждого сообщения между ними.

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()),
        )),
    )
}

#Как создаётся выделение

ПлатформаКак создаётся выделение
macOS, Windows, Linux, GPUIПеретащите указатель по текстам; двойной щелчок выделяет слово, тройной абзац, а перетаскивание после них продолжает выделение по словам или абзацам. Shift+щелчок расширяет выделение. Ctrl / Cmd+A выделяет всё в view, Ctrl / Cmd+C копирует, Escape или нажатие вне view снимает выделение.
iOS, AndroidДолгое нажатие выделяет слово; маркеры платформы расширяют выделение, а в её меню редактирования есть Copy и Select All.
WebСобственное выделение браузера с его жестами, меню и сочетаниями клавиш.

#Что выделяется

  • Исключённые тексты: текст с userSelect: "none" (.select_none() в Rust, класс select-none; например, метка или подпись кнопки) пропускается выделением и его жестами.
  • Вложенные views: выделяемый view внутри другого является частью внешнего, поэтому одно выделение охватывает оба.
  • TextView: TextView с selectable выделяется как самостоятельный блок: его абзацы, элементы списков, ячейки и блоки кода выделяются вместе. Внутри выделяемого view он входит во внешнее выделение.
  • Отдельные тексты: текст с userSelect: "text" вне выделяемых views выделяется сам по себе, как описано в Text.
  • Внешний вид определяется подсветкой платформы в selectionColor каждого текста (selection:text-*).
  • Списки: в виртуализированном List выделение охватывает смонтированные строки; строки, переработанные за пределами видимой области, из выделения выпадают.

#См. также

  • View: проп selectable.
  • Text: userSelect, selectionColor и выделение отдельного текста.
  • TextView: документы, блоки которых выделяются как одно целое.