Страница: ссылки на подстраницы
Владеющий блок page сохраняет только data.pageId; тело, название, значок и права доступа хранит ваше приложение. Блок page-link и встроенная ссылка <a data-blok-page-id="p1">Page</a> не владеют страницей. Они не сохраняют название, значок, URL или решение о доступе.
Используйте resolve для разрешённых метаданных и subscribe, чтобы обновлять их после изменения у хоста. Хост отправляет уведомления в той же вкладке после локальных правок и удалённых изменений. null означает отсутствие страницы, undefined оставляет нейтральное состояние, а { access: 'none' } означает отказ. Недоступная страница скрывает название, показывает замок и объясняет «Нет доступа» при клике или Enter.
Через search предлагайте только доступные страницы для вставки через @ и [[. Глобальный поиск и экран обратных ссылок принадлежат хосту. Обычные упоминания URL остаются ссылками на URL. Зарегистрируйте Page и PageLink с одной конфигурацией PageConfig; только Page вызывает create для новой владеющей страницы.
Для статичного HTML вызовите blocksToHtml(data, { pageInfo, pageHref }). pageInfo должен синхронно отдавать разрешённые метаданные. Отсутствующие, закрытые и неразрешённые страницы не получают URL от pageHref.
href строит URL из непрозрачного ID без названия. open обрабатывает обычный клик и Enter; клик с модификатором следует браузерной ссылке. Blok не загружает и не сохраняет тело страницы.
Импорт
import { Page } from '@bloklabs/core/tools';Конфигурация
| Опция | Тип | По умолчанию | Описание |
|---|---|---|---|
href | (pageId: string) => string | undefined | Строит URL страницы по её id. Blok ставит его на ссылку, поэтому Cmd/Ctrl-клик или клик средней кнопкой открывает страницу в новой вкладке. Без него у ссылки нет URL. Небезопасные схемы вроде |
pageIdFromHref | (href: string) => string | null | undefined | undefined | Превращает URL обратно в id страницы или возвращает |
open | (pageId: string, ctx: { event?: MouseEvent | KeyboardEvent }) => void | undefined | Открывает страницу. Blok вызывает его при обычном клике левой кнопкой. Без него клик ведёт на Enter открывает страницу и тогда, когда блок выбран с клавиатуры (Escape, затем стрелки). В этом случае Ещё Blok вызывает его один раз сразу после того, как пользователь вставил новую страницу из тулбокса. В этом случае |
resolve | (pageId: string) => PageInfo | null | undefined | Promise<…> | undefined | Возвращает текущие разрешённые метаданные страницы. Хост должен проверить права перед выдачей метаданных. |
create | (init: { pageId: string; document?: OutputData; title?: string; parentId?: string }) => void | { pageId: string } | Promise<…> | undefined | Создаёт страницу в вашем приложении. Blok вызывает его один раз на каждую новую страницу и передаёт id, который сгенерировал сам. Он никогда не вызывается при загрузке, вставке из буфера обмена, отмене, повторе, изменении от соавтора и в режиме только для чтения. Когда пользователь выбирает «Страница» в тулбоксе, Blok ждёт ответа. На пункте меню крутится спиннер, а блок появляется, когда промис разрешится. Верните Когда ваш код вставляет страницу через API без
С |
databasePages | boolean | false | Добавляет «База данных - на всю страницу» в раздел «База данных» тулбокса. Пункт создаёт подстраницу с новой базой данных и открывает её. Ссылка показывает значок таблицы, пока у страницы нет своего значка. Включайте его, только если |
createFromMention | boolean | false | Добавляет раздел «Новая страница» в меню Включайте его, только если |
search | (query: string) => Promise<readonly PageSearchResult[]> | undefined | Предлагает доступные страницы для встроенных ссылок через Меню Раздел «Ссылка на страницу» показывает результаты. В строке видны значок, название и С |
subscribe | (pageId: string, onChange: () => void) => (() => void) | void | undefined | Вызывает |
preview | (pageId: string) => OutputBlockData[] | null | undefined | Promise<…> | undefined | Возвращает разрешённые начальные блоки для предпросмотра при наведении. Blok запрашивает их только для доступной страницы. |
Формат данных
interface PageData {
pageId: string;
kind?: 'database'; // Set by "Database - Full page"
}{
"id": "pg001",
"type": "page",
"data": { "pageId": "p1" }
}Пример использования
import { Blok } from '@bloklabs/core';
import { Page, PageLink } from '@bloklabs/core/tools';
import { blocksToHtml } from '@bloklabs/core/view';
const pageUrl = (pageId) => `/pages/${pageId}`;
const pageConfig = {
href: pageUrl,
open: (pageId) => router.push(pageUrl(pageId)),
resolve: (pageId) => myApi.getAuthorizedPageInfo(pageId),
search: (query) => myApi.searchAccessiblePages(query),
subscribe: (pageId, onChange) => myApi.subscribePage(pageId, onChange),
};
const editor = new Blok({
holder: 'editor',
tools: {
page: {
class: Page,
config: {
...pageConfig,
// Return { pageId } to use your backend's id instead of Blok's.
create: async ({ pageId }) => ({ pageId: (await myApi.createPage(pageId)).id }),
},
},
'page-link': { class: PageLink, config: pageConfig },
},
});
const authorizedPageInfo = myApi.getAuthorizedPageInfoSnapshot();
const html = blocksToHtml(savedData, {
pageInfo: (pageId) => authorizedPageInfo.get(pageId),
pageHref: pageUrl,
});