Sketch, популярный инструмент дизайна, завоевал огромную популярность среди дизайнеров и разработчиков благодаря возможности расширения с помощью плагинов. Эти плагины предоставляют дополнительные функции и возможности настройки для улучшения рабочего процесса проектирования. В этой статье блога мы углубимся в один важный аспект разработки плагина Sketch — настройки документа. Мы рассмотрим различные методы и примеры кода, чтобы продемонстрировать, как можно использовать настройки документа для создания мощных плагинов Sketch.

Метод 1: получение настроек документа

Одной из основных операций при разработке плагина Sketch является доступ к настройкам документа. Вы можете получить эти настройки с помощью объекта documentв Sketch API. Вот пример:

const document = sketch.getSelectedDocument();
const documentSettings = document.sketchObject.documentData().layerStyles(); // Example of accessing Layer Styles

Метод 2. Настройка параметров документа

Чтобы изменить настройки документа, вы можете использовать соответствующие методы, предоставляемые Sketch API. Вот пример того, как установить цвет фона документа:

const document = sketch.getSelectedDocument();
document.sketchObject.backgroundColor = MSImmutableColor.colorWithSVGString("#FFFFFF"); // Setting the background color to white

Метод 3. Создание пользовательских настроек документа

Плагины Sketch обеспечивают гибкость в создании пользовательских настроек документа, соответствующих вашим конкретным потребностям. Например, вы можете добавить настройку для управления макетом сетки. Вот фрагмент кода, показывающий, как создать собственную настройку сетки:

const document = sketch.getSelectedDocument();
const settings = document.sketchObject.documentData().gridSettings();
settings.setGridSize(8); // Set the grid size to 8 pixels

Метод 4: сохранение настроек документа

Чтобы гарантировать сохранение настроек документа между сеансами, вы можете использовать модуль SettingsSketch API. Этот модуль позволяет сохранять и получать настройки, специфичные для плагина. Вот пример того, как сохранить ранее созданную настройку сетки:

const document = sketch.getSelectedDocument();
const settings = sketch.Settings.documentSettingForKey(document, "gridSize");
settings.setSettingForKey(8, "gridSize"); // Persist the grid size setting

Метод 5: применение настроек документа к слоям

Настройки документа также можно применять к отдельным слоям в документе Sketch. Это позволяет детально контролировать внешний вид и поведение конкретных элементов. Вот пример того, как применить стиль слоя к выбранному слою:

const document = sketch.getSelectedDocument();
const selectedLayer = document.selectedLayers.layers[0];
const documentSettings = document.sketchObject.documentData().layerStyles();
const layerStyle = documentSettings.objects().firstObject();
selectedLayer.sharedStyle = layerStyle;

В этой статье мы рассмотрели различные методы использования настроек документа при разработке плагинов Sketch. Извлекая, устанавливая и сохраняя настройки документа, а также применяя их к отдельным слоям, вы можете открыть совершенно новый уровень настройки и контроля в Sketch. Поэкспериментируйте с этими методами и воспользуйтесь мощными возможностями плагинов Sketch.